nfabort(3) [bsd man page]

NFABORT(3)						     Library Functions Manual							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

							      University of Illinois							NFABORT(3)

NFDUMP(8)						      System Manager's Manual							 NFDUMP(8)

NAME

       nfdump, nfload - notesfile dump/load programs

SYNOPSIS

       nfdump notesfile

       nfload [ -Ddirectory ] notesfile

DESCRIPTION

       Nfdump and nfload are used to convert notesfile data base formats.

       Nfdump  converts  the  specified  notesfile  to a portable ASCII format and writes it to standard output.  Some diagnostics are produced on
       stderr.	Nfdump can be run by any user; access to a particular notesfile is governed by that notesfile's access list.

       Nfload is used on the output from nfdump to create a new notesfile.  The -D option specifies an alternate base directory for the notesfile.
       If unspecified, this defaults to ``/usr/spool/notes''.  Nfload reads standard input for the ASCII representation of the notesfile.

       Typical	use  of  these	two programs occurs when converting an existing notesfile data base to a new format.  The nfdump program should be
       compiled with the older structure definitions while nfload is compiled with the newer structures.  The data base can then be converted with
       a shell script of the following nature:

	    mkdir .OLD
	    mv * .OLD
	    for i in `ls .OLD`
	    do
		 echo $i start
		 nfdump $i | nfload -D/usr/spool/newnotes $i
	    done
		 echo $i done
	    echo ALL DONE
	    rm -rf .OLD

       This assumes that the old data base is in ``/usr/spool/notes'' and the new data base is to be placed in ``/usr/spool/newnotes''.  After the
       conversion is complete, one can move the old data base from ``/usr/spool/notes'' to ``/usr/spool/oldformat'' and the  new  data	base  from
       ``/usr/spool/newnotes'' to ``/usr/spool/notes''.

FILES

SEE ALSO

       notes(1),
       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

       Rob Kolstad (kolstad@convex.UUCP)
       CONVEX Computer Corporation
       Richardson, TX

							      University of Illinois							 NFDUMP(8)