[BACK]Return to atexit.3 CVS log [TXT][DIR] Up to [cvs.NetBSD.org] / src / lib / libc / stdlib

Annotation of src/lib/libc/stdlib/atexit.3, Revision 1.6.12.2

1.6.12.2! nathanw     1: .\"    $NetBSD: atexit.3,v 1.6.12.1 2002/03/08 21:35:44 nathanw Exp $
1.4       thorpej     2: .\"
1.5       perry       3: .\" Copyright (c) 1990, 1991, 1993
                      4: .\"    The Regents of the University of California.  All rights reserved.
1.1       cgd         5: .\"
                      6: .\" This code is derived from software contributed to Berkeley by
                      7: .\" Chris Torek and the American National Standards Committee X3,
                      8: .\" on Information Processing Systems.
                      9: .\"
                     10: .\" Redistribution and use in source and binary forms, with or without
                     11: .\" modification, are permitted provided that the following conditions
                     12: .\" are met:
                     13: .\" 1. Redistributions of source code must retain the above copyright
                     14: .\"    notice, this list of conditions and the following disclaimer.
                     15: .\" 2. Redistributions in binary form must reproduce the above copyright
                     16: .\"    notice, this list of conditions and the following disclaimer in the
                     17: .\"    documentation and/or other materials provided with the distribution.
                     18: .\" 3. All advertising materials mentioning features or use of this software
                     19: .\"    must display the following acknowledgement:
                     20: .\"    This product includes software developed by the University of
                     21: .\"    California, Berkeley and its contributors.
                     22: .\" 4. Neither the name of the University nor the names of its contributors
                     23: .\"    may be used to endorse or promote products derived from this software
                     24: .\"    without specific prior written permission.
                     25: .\"
                     26: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
                     27: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
                     28: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
                     29: .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
                     30: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
                     31: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
                     32: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
                     33: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
                     34: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
                     35: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
                     36: .\" SUCH DAMAGE.
                     37: .\"
1.5       perry      38: .\"     from: @(#)atexit.3     8.1 (Berkeley) 6/4/93
1.1       cgd        39: .\"
1.5       perry      40: .Dd June 4, 1993
1.1       cgd        41: .Dt ATEXIT 3
                     42: .Os
                     43: .Sh NAME
                     44: .Nm atexit
                     45: .Nd register a function to be called on exit
1.6       perry      46: .Sh LIBRARY
                     47: .Lb libc
1.1       cgd        48: .Sh SYNOPSIS
1.6.12.1  nathanw    49: .Fd #include \*[Lt]stdlib.h\*[Gt]
1.1       cgd        50: .Ft int
                     51: .Fn atexit "void (*function)(void)"
                     52: .Sh DESCRIPTION
                     53: The
                     54: .Fn atexit
                     55: function
                     56: registers the given
                     57: .Ar function
                     58: to be called at program exit, whether via
                     59: .Xr exit 3
                     60: or via return from the program's
                     61: .Em main .
                     62: Functions so registered are called in reverse order;
                     63: no arguments are passed.
                     64: At least 32 functions can always be registered,
                     65: and more are allowed as long as sufficient memory can be allocated.
                     66: .Sh RETURN VALUES
                     67: .Rv -std atexit
                     68: .Sh ERRORS
1.3       jtc        69: .Bl -tag -width Er
1.1       cgd        70: .It Bq Er ENOMEM
                     71: No memory was available to add the function to the list.
                     72: The existing list of functions is unmodified.
                     73: .El
                     74: .Sh SEE ALSO
                     75: .Xr exit 3
                     76: .Sh STANDARDS
                     77: The
                     78: .Fn atexit
                     79: function
                     80: conforms to
                     81: .St -ansiC .

CVSweb <webmaster@jp.NetBSD.org>