xref: /freebsd/lib/libc/stdlib/abort.3 (revision dc36d6f9bb1753f3808552f3afd30eda9a7b206a)
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.\"
32*23d23837SEric van Gyzen.Dd May 28, 2018
3358f0484fSRodney W. Grimes.Dt ABORT 3
3458f0484fSRodney W. Grimes.Os
3558f0484fSRodney W. Grimes.Sh NAME
3658f0484fSRodney W. Grimes.Nm abort
3758f0484fSRodney W. Grimes.Nd cause abnormal program termination
3825bb73e0SAlexey Zelkin.Sh LIBRARY
3925bb73e0SAlexey Zelkin.Lb libc
4058f0484fSRodney W. Grimes.Sh SYNOPSIS
418aefde06SJeroen Ruigrok van der Werven.In stdlib.h
4258f0484fSRodney W. Grimes.Ft void
4358f0484fSRodney W. Grimes.Fn abort void
4458f0484fSRodney W. Grimes.Sh DESCRIPTION
4558f0484fSRodney W. GrimesThe
4658f0484fSRodney W. Grimes.Fn abort
4758f0484fSRodney W. Grimesfunction causes abnormal program termination to occur, unless the
4858f0484fSRodney W. Grimessignal
4958f0484fSRodney W. Grimes.Dv SIGABRT
5058f0484fSRodney W. Grimesis being caught and the signal handler does not return.
5158f0484fSRodney W. Grimes.Pp
5290a720bcSAlexander LangerAny open streams are flushed and closed.
53e348b8eaSJeroen Ruigrok van der Werven.Sh IMPLEMENTATION NOTES
54e348b8eaSJeroen Ruigrok van der WervenThe
55e348b8eaSJeroen Ruigrok van der Werven.Fn abort
56e348b8eaSJeroen Ruigrok van der Wervenfunction is thread-safe.
57e348b8eaSJeroen Ruigrok van der WervenIt is unknown if it is async-cancel-safe.
5858f0484fSRodney W. Grimes.Sh RETURN VALUES
5958f0484fSRodney W. GrimesThe
60bf5a138eSMike Pritchard.Fn abort
6158f0484fSRodney W. Grimesfunction
6258f0484fSRodney W. Grimesnever returns.
6358f0484fSRodney W. Grimes.Sh SEE ALSO
644c72d794SEric van Gyzen.Xr abort2 2 ,
6558f0484fSRodney W. Grimes.Xr sigaction 2 ,
6678b0b234SMike Pritchard.Xr exit 3
6758f0484fSRodney W. Grimes.Sh STANDARDS
6858f0484fSRodney W. GrimesThe
6958f0484fSRodney W. Grimes.Fn abort
7058f0484fSRodney W. Grimesfunction
7158f0484fSRodney W. Grimesconforms to
7290a720bcSAlexander Langer.St -p1003.1-90 .
73e348b8eaSJeroen Ruigrok van der WervenThe
74e348b8eaSJeroen Ruigrok van der Werven.Fn abort
75e348b8eaSJeroen Ruigrok van der Wervenfunction also conforms to
76e348b8eaSJeroen Ruigrok van der Werven.St -isoC-99
77e348b8eaSJeroen Ruigrok van der Wervenwith the implementation specific details as noted above.
78