bsd man page for nfabort

NFABORT(3)						     Library Functions Manual							NFABORT(3)

NAME
       nfabort - dump core and log it in a notesfile

SYNOPSIS
       nfabort ( notesfile, message, title, cname, exitcode )
       char *notesfile, *message, *title, *cname, exitcode

       cc ... -lnfcom

DESCRIPTION
       Nfabort provides user programs with a convenient way to generate a core image, move it to a save place, and log the action in a notesfile.

       The  notesfile  parameter  specifies the notesfile to receive a copy of the string message with a line appended detailing the final resting
       place of the core image.  The text is inserted into the notesfile as a base note with title taken from the parameter list.   Cname  is  the
       prefix  of  the	pathname of where to place the core image.  This is suffixed with ``.integer'' to yield the full pathname.  The integer is
       generated from the pid of the current process.

       After generating and saving the core image and placing the message in the notesfile, nfabort terminates the current process with  the  exit
       code specified by the exitcode parameter.

       Nfabort calls nfcomment to insert the message into the notesfile.

BUGS
       Certain conditions, such as running out of memory, will cause nfabort to fail.

       Nfabort will fail to log the message if it can't fork a child process.

       The final resting place of the core image will not be logged if nfabort can't allocate memory for temporary strings.

FILES
       /usr/lib/libnfcom.a		  -lnfcom library

SEE ALSO
       malloc(3), nfcomment(3), nfpipe(1), notes(1), popen(3S), system(3),
       The Notesfile Reference Manual

AUTHORS
       Ray Essick (uiucdcs!essick, essick%uiuc@csnet-relay.arpa)
       Department of Computer Science
       University of Illinois at Urbana-Champaign
       Urbana, IL

							      University of Illinois							NFABORT(3)