[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.9.56.1

1.9.56.1! yamt        1: .\"    $NetBSD: atexit.3,v 1.9 2003/08/07 16:43:38 agc 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.
1.9       agc        18: .\" 3. Neither the name of the University nor the names of its contributors
1.1       cgd        19: .\"    may be used to endorse or promote products derived from this software
                     20: .\"    without specific prior written permission.
                     21: .\"
                     22: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
                     23: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
                     24: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
                     25: .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
                     26: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
                     27: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
                     28: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
                     29: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
                     30: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
                     31: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
                     32: .\" SUCH DAMAGE.
                     33: .\"
1.5       perry      34: .\"     from: @(#)atexit.3     8.1 (Berkeley) 6/4/93
1.1       cgd        35: .\"
1.5       perry      36: .Dd June 4, 1993
1.1       cgd        37: .Dt ATEXIT 3
                     38: .Os
                     39: .Sh NAME
                     40: .Nm atexit
                     41: .Nd register a function to be called on exit
1.6       perry      42: .Sh LIBRARY
                     43: .Lb libc
1.1       cgd        44: .Sh SYNOPSIS
1.8       wiz        45: .In stdlib.h
1.1       cgd        46: .Ft int
                     47: .Fn atexit "void (*function)(void)"
                     48: .Sh DESCRIPTION
                     49: The
                     50: .Fn atexit
                     51: function
                     52: registers the given
                     53: .Ar function
                     54: to be called at program exit, whether via
                     55: .Xr exit 3
                     56: or via return from the program's
                     57: .Em main .
                     58: Functions so registered are called in reverse order;
                     59: no arguments are passed.
                     60: At least 32 functions can always be registered,
                     61: and more are allowed as long as sufficient memory can be allocated.
                     62: .Sh RETURN VALUES
                     63: .Rv -std atexit
                     64: .Sh ERRORS
1.3       jtc        65: .Bl -tag -width Er
1.1       cgd        66: .It Bq Er ENOMEM
                     67: No memory was available to add the function to the list.
                     68: The existing list of functions is unmodified.
                     69: .El
                     70: .Sh SEE ALSO
1.9.56.1! yamt       71: .Xr at_quick_exit 3 ,
        !            72: .Xr exit 3 ,
        !            73: .Xr quick_exit 3
1.1       cgd        74: .Sh STANDARDS
                     75: The
                     76: .Fn atexit
                     77: function
                     78: conforms to
                     79: .St -ansiC .

CVSweb <webmaster@jp.NetBSD.org>