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