xref: /freebsd/lib/libc/stdlib/abort.3 (revision 23d2383783ad04ff89f3c63354e0b28bd457a05b)
158f0484fSRodney W. Grimes.\" Copyright (c) 1990, 1991, 1993
258f0484fSRodney W. Grimes.\"	The Regents of the University of California.  All rights reserved.
358f0484fSRodney W. Grimes.\"
458f0484fSRodney W. Grimes.\" This code is derived from software contributed to Berkeley by
558f0484fSRodney W. Grimes.\" the American National Standards Committee X3, on Information
658f0484fSRodney W. Grimes.\" Processing Systems.
758f0484fSRodney W. Grimes.\"
858f0484fSRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without
958f0484fSRodney W. Grimes.\" modification, are permitted provided that the following conditions
1058f0484fSRodney W. Grimes.\" are met:
1158f0484fSRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright
1258f0484fSRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer.
1358f0484fSRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright
1458f0484fSRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer in the
1558f0484fSRodney W. Grimes.\"    documentation and/or other materials provided with the distribution.
163fb3b97cSEd Maste.\" 3. Neither the name of the University nor the names of its contributors
1758f0484fSRodney W. Grimes.\"    may be used to endorse or promote products derived from this software
1858f0484fSRodney W. Grimes.\"    without specific prior written permission.
1958f0484fSRodney W. Grimes.\"
2058f0484fSRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
2158f0484fSRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
2258f0484fSRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
2358f0484fSRodney W. Grimes.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
2458f0484fSRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
2558f0484fSRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
2658f0484fSRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2758f0484fSRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2858f0484fSRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2958f0484fSRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
3058f0484fSRodney W. Grimes.\" SUCH DAMAGE.
3158f0484fSRodney W. Grimes.\"
3258f0484fSRodney W. Grimes.\"     @(#)abort.3	8.1 (Berkeley) 6/4/93
337f3dea24SPeter Wemm.\" $FreeBSD$
3458f0484fSRodney W. Grimes.\"
35*23d23837SEric van Gyzen.Dd May 28, 2018
3658f0484fSRodney W. Grimes.Dt ABORT 3
3758f0484fSRodney W. Grimes.Os
3858f0484fSRodney W. Grimes.Sh NAME
3958f0484fSRodney W. Grimes.Nm abort
4058f0484fSRodney W. Grimes.Nd cause abnormal program termination
4125bb73e0SAlexey Zelkin.Sh LIBRARY
4225bb73e0SAlexey Zelkin.Lb libc
4358f0484fSRodney W. Grimes.Sh SYNOPSIS
448aefde06SJeroen Ruigrok van der Werven.In stdlib.h
4558f0484fSRodney W. Grimes.Ft void
4658f0484fSRodney W. Grimes.Fn abort void
4758f0484fSRodney W. Grimes.Sh DESCRIPTION
4858f0484fSRodney W. GrimesThe
4958f0484fSRodney W. Grimes.Fn abort
5058f0484fSRodney W. Grimesfunction causes abnormal program termination to occur, unless the
5158f0484fSRodney W. Grimessignal
5258f0484fSRodney W. Grimes.Dv SIGABRT
5358f0484fSRodney W. Grimesis being caught and the signal handler does not return.
5458f0484fSRodney W. Grimes.Pp
5590a720bcSAlexander LangerAny open streams are flushed and closed.
56e348b8eaSJeroen Ruigrok van der Werven.Sh IMPLEMENTATION NOTES
57e348b8eaSJeroen Ruigrok van der WervenThe
58e348b8eaSJeroen Ruigrok van der Werven.Fn abort
59e348b8eaSJeroen Ruigrok van der Wervenfunction is thread-safe.
60e348b8eaSJeroen Ruigrok van der WervenIt is unknown if it is async-cancel-safe.
6158f0484fSRodney W. Grimes.Sh RETURN VALUES
6258f0484fSRodney W. GrimesThe
63bf5a138eSMike Pritchard.Fn abort
6458f0484fSRodney W. Grimesfunction
6558f0484fSRodney W. Grimesnever returns.
6658f0484fSRodney W. Grimes.Sh SEE ALSO
674c72d794SEric van Gyzen.Xr abort2 2 ,
6858f0484fSRodney W. Grimes.Xr sigaction 2 ,
6978b0b234SMike Pritchard.Xr exit 3
7058f0484fSRodney W. Grimes.Sh STANDARDS
7158f0484fSRodney W. GrimesThe
7258f0484fSRodney W. Grimes.Fn abort
7358f0484fSRodney W. Grimesfunction
7458f0484fSRodney W. Grimesconforms to
7590a720bcSAlexander Langer.St -p1003.1-90 .
76e348b8eaSJeroen Ruigrok van der WervenThe
77e348b8eaSJeroen Ruigrok van der Werven.Fn abort
78e348b8eaSJeroen Ruigrok van der Wervenfunction also conforms to
79e348b8eaSJeroen Ruigrok van der Werven.St -isoC-99
80e348b8eaSJeroen Ruigrok van der Wervenwith the implementation specific details as noted above.
81