nfabort - dump core and log it in a notesfile
nfabort ( notesfile, message, title, cname, exitcode )
char *notesfile, *message, *title, *cname, exitcode
cc ... -lnfcom
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 param-
Nfabort calls nfcomment to insert the message into the notesfile.
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.
/usr/lib/libnfcom.a -lnfcom library
malloc(3), nfcomment(3), nfpipe(1), notes(1), popen(3S), system(3),
The Notesfile Reference Manual
Ray Essick (uiucdcs!essick, email@example.com)
Department of Computer Science
University of Illinois at Urbana-Champaign
University of Illinois NFABORT(3)