pd.if.org Git - pdclib/blob - man3/abort.3

   1 .\" This file is part of the Public Domain C Library (PDCLib).
   2 .\" Permission is granted to use, modify, and / or redistribute at will.
   3 .\"
   4 .Dd
   5 .Dt abort 3
   6 .Os
   7 .\"
   8 .Sh NAME
   9 .Nm abort
  10 .Nd abnormal process termination
  11 .\"
  12 .Sh SYNOPSIS
  13 .In stdlib.h
  14 .Fn "noreturn void abort" "void"
  15 .\"
  16 .Sh DESCRIPTION
  17 .Fn abort
  18 causes abnormal process termination to occur.
  19 .\"
  20 .Pp
  21 First,
  22 .Dv SIGABRT
  23 will be raised, as if by
  24 .Fn raise SIGABRT .
  25 If the signal is not being caught, or the handler which catches the signal
  26 returns,
  27 .Fn abort
  28 will then proceed to cause the process to terminate with a failure exit status.
  29 It is implementation defined whether any open
  30 .Vt FILE
  31 streams are flushed before the process exits.
  32 .\"
  33 .Sh IMPLEMENTATION NOTES
  34 PDCLib implements termination (in the case that the
  35 .Dv SIGABRT
  36 handler returns) by calling
  37 .Fn _Exit EXIT_FAILURE .
  38 Therefore, stream flushing rules for
  39 .Nm
  40 follow those defined for
  41 .Fn _Exit .
  42 .\"
  43 .Sh SEE ALSO
  44 .Xr exit 3
  45 .Xr quick_exit 3
  46 .Xr _Exit 3
  47 .Xr raise 3
  48 .\"
  49 .Sh STANDARDS
  50 .Fn abort
  51 is first defined in
  52 .St -isoC-90 .