Annotation of src/lib/libc/stdlib/atexit.3, Revision 1.11
1.11 ! wiz 1: .\" $NetBSD: atexit.3,v 1.10 2013/04/26 18:29:55 christos 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.11 ! wiz 71: .Xr at_quick_exit 3 ,
! 72: .Xr exit 3 ,
1.10 christos 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>