Return to nfabort.3 CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / notes / man

Annotation of 43BSD/contrib/notes/man/nfabort.3, revision 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.