ERRLOG(3)

NAME

     errlog - Routines for logging history and informational mes-
     sages

SYNOPSIS

     #include <soi_error.h>

     void die (int status, char *fmt, ...);

     void ignore (char *fmt, ...);

     int setlogfile (char *filename);

     int sethistory (char *filename);

     void report_msg (char *fmt, ...);

     void write_history (char *fmt, ...);

     void write_logfile (char *fmt, ...);

DESCRIPTION

     These functions provide run-time  methods  of  handling  the
     messages  generated by the virtual message functions history
     and errorlog in encapsulated functions.

     report_msg() unconditionally writes its message  on  stderr.
     write_history()  and write_logfile() behave the same way,but
     write (append) their messages to the file  pointers  set  by
     sethistory() (stdout by default) and setlogfile() (stderr by
     default), respectively.  die() reports it message to stderr,
     and  then  unconditionally  exits  the  program with status.
     ignore() does nothing at all.

     sethistory() sets the history  file  pointer  to  the  named
     file.  It returns 0 if the file pointer can be set, 1 other-
     wise.  The file pointer is stdout by default.   setlogfile()
     sets the logging file pointer to the named file.  It returns
     0 if the file pointer can be set,  1  otherwise.   The  file
     pointer is stderr by default.

BUGS

HISTORY

     23-Apr-93  Rick Bogart:  created for SOI V 0.7.
     27-Oct-94  SOI Version 0.9