1NFABORT(3)                 Library Functions Manual                 NFABORT(3)
2
3
4

NAME

6       nfabort - dump core and log it in a notesfile
7

SYNOPSIS

9       nfabort ( notesfile, message, title, cname, exitcode )
10       char *notesfile, *message, *title, *cname, exitcode
11
12       cc ... -lnfcom
13

DESCRIPTION

15       Nfabort provides user programs with a convenient way to generate a core
16       image, move it to a save place, and log the action in a notesfile.
17
18       The notesfile parameter specifies the notesfile to receive  a  copy  of
19       the  string  message  with  a line appended detailing the final resting
20       place of the core image.  The text is inserted into the notesfile as  a
21       base  note with title taken from the parameter list.  Cname is the pre‐
22       fix of the pathname of where to place the core image.  This is suffixed
23       with ``.integer'' to yield the full pathname.  The integer is generated
24       from the pid of the current process.
25
26       After generating and saving the core image and placing the  message  in
27       the  notesfile,  nfabort  terminates  the current process with the exit
28       code specified by the exitcode parameter.
29
30       Nfabort calls nfcomment to insert the message into the notesfile.
31

BUGS

33       Certain conditions, such as running out of memory, will  cause  nfabort
34       to fail.
35
36       Nfabort will fail to log the message if it can't fork a child process.
37
38       The final resting place of the core image will not be logged if nfabort
39       can't allocate memory for temporary strings.
40

FILES

42       /usr/lib/libnfcom.a                -lnfcom library
43

SEE ALSO

45       malloc(3), nfcomment(3), nfpipe(1), notes(1), popen(3S), system(3),
46       The Notesfile Reference Manual
47

AUTHORS

49       Ray Essick (uiucdcs!essick, essick%uiuc@csnet-relay.arpa)
50       Department of Computer Science
51       University of Illinois at Urbana-Champaign
52       Urbana, IL
53
54
55
56                            University of Illinois                  NFABORT(3)