term% cat index.txt PERROR(2)                     System Calls Manual                    PERROR(2)
NAME
       perror, syslog - system error messages
SYNOPSIS
       #include <u.h>
       #include <libc.h>
       void perror(char *s)
       void syslog(int cons, char *logname, char *fmt, ...)
DESCRIPTION
       Perror  produces  a  short error message on the standard error file de‐
       scribing the last error encountered during a call to the system.  First
       the  argument string s is printed, then a colon, then the message and a
       newline.  If s is 0, only the error message and newline are printed.
       Syslog logs messages in the file named  by  logname  in  the  directory
       /sys/log;  the file must already exist and should be append-only.  Log‐
       name must contain no slashes.  The  message  is  a  line  with  several
       fields: the name of the machine writing the message; the date and time;
       the message specified by the print(2) format fmt and any following  ar‐
       guments; and a final newline.  If cons is set or the log file cannot be
       opened, the message is also printed on the system console.  Syslog  can
       be used safely in multi-threaded programs.
SOURCE
       /sys/src/libc/port/perror.c
       /sys/src/libc/9sys/syslog.c
SEE ALSO
       intro(2), errstr(2), the %r format in print(2)
BUGS
       Perror is a holdover; the %r format in print(2) is preferred.
                                                                     PERROR(2)