Return to nfabort.3 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / new / notes / man

Annotation of 43BSDTahoe/new/notes/man/nfabort.3, revision 1.1.1.1

1.1       root        1: .TH NFABORT 3 "University of Illinois"
                      2: .SH NAME
                      3: nfabort \- dump core and log it in a notesfile
                      4: .SH SYNOPSIS
                      5: .B "nfabort"
                      6: (
                      7: .BR "notesfile" ","
                      8: .BR "message" ","
                      9: .BR "title" ","
                     10: .BR "cname" ","
                     11: .B "exitcode"
                     12: )
                     13: .br
                     14: .B "char"
                     15: .BR "*notesfile" ","
                     16: .BR "*message" ","
                     17: .BR "*title" ","
                     18: .BR "*cname" ","
                     19: .B "exitcode"
                     20: .PP
                     21: .B cc ... \-lnfcom
                     22: .SH DESCRIPTION
                     23: .I "Nfabort"
                     24: provides user programs with a convenient way to
                     25: generate a core image,
                     26: move it to a save place,
                     27: and
                     28: log the action in a notesfile.
                     29: .PP
                     30: The
                     31: .I "notesfile"
                     32: parameter specifies the notesfile to receive a copy
                     33: of the string
                     34: .I "message"
                     35: with a line appended detailing the final resting
                     36: place of the core image.
                     37: The text is inserted into the notesfile as
                     38: a base note with
                     39: .I title
                     40: taken from the parameter list.
                     41: .I "Cname"
                     42: is the prefix of the pathname of where to place the core image.
                     43: This is suffixed with ``.integer'' to yield the full pathname.
                     44: The integer is generated from the pid of the current process.
                     45: .PP
                     46: After generating and saving the core image
                     47: and
                     48: placing the message in the notesfile,
                     49: .I nfabort
                     50: terminates the current process with the exit code
                     51: specified by the
                     52: .I "exitcode"
                     53: parameter.
                     54: .PP
                     55: .I Nfabort
                     56: calls
                     57: .I nfcomment
                     58: to insert the message into the notesfile.
                     59: .SH BUGS
                     60: Certain conditions, such as running out of memory,
                     61: will cause 
                     62: .I nfabort
                     63: to fail.
                     64: .PP
                     65: .I Nfabort
                     66: will fail to log the message if it can't fork a child
                     67: process.
                     68: .PP
                     69: The final resting place of the core image will not be logged
                     70: if
                     71: .I "nfabort"
                     72: can't allocate memory for temporary strings.
                     73: .SH FILES
                     74: .PD 0
                     75: .TP 35
                     76: /usr/lib/libnfcom.a
                     77: -lnfcom library
                     78: .PD
                     79: .SH SEE ALSO
                     80: malloc(3),
                     81: nfcomment(3),
                     82: nfpipe(1),
                     83: notes(1),
                     84: popen(3S),
                     85: system(3),
                     86: .br
                     87: .ul
                     88: The Notesfile Reference Manual
                     89: .SH AUTHORS
                     90: .nf
                     91: Ray Essick (uiucdcs!essick, essick%[email protected])
                     92: Department of Computer Science
                     93: University of Illinois at Urbana-Champaign
                     94: Urbana, IL
                     95: .fi

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.