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

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