1 058b0118 2005-01-03 devnull .TH SYSFATAL 3
 2 058b0118 2005-01-03 devnull .SH NAME
 3 d93fca6a 2005-02-11 devnull syslog, sysfatal \- system error messages
 4 058b0118 2005-01-03 devnull .SH SYNOPSIS
 5 058b0118 2005-01-03 devnull .B #include <u.h>
 6 058b0118 2005-01-03 devnull .br
 7 058b0118 2005-01-03 devnull .B #include <libc.h>
 8 058b0118 2005-01-03 devnull .PP
 9 058b0118 2005-01-03 devnull .B
10 d93fca6a 2005-02-11 devnull void syslog(int cons, char *logname, char *fmt, ...)
11 d93fca6a 2005-02-11 devnull .PP
12 d93fca6a 2005-02-11 devnull .B
13 058b0118 2005-01-03 devnull void sysfatal(char *fmt, ...)
14 058b0118 2005-01-03 devnull .SH DESCRIPTION
15 058b0118 2005-01-03 devnull .I Sysfatal
16 058b0118 2005-01-03 devnull prints to standard error the name of the running program,
17 058b0118 2005-01-03 devnull a colon and a space, 
18 058b0118 2005-01-03 devnull the message described by the
19 d32deab1 2020-08-16 rsc .MR print (3)
20 058b0118 2005-01-03 devnull format string
21 058b0118 2005-01-03 devnull .I fmt
22 058b0118 2005-01-03 devnull and subsequent arguments, and a newline.
23 058b0118 2005-01-03 devnull It then calls
24 d32deab1 2020-08-16 rsc .MR exits (3)
25 058b0118 2005-01-03 devnull with the formatted message as argument.
26 058b0118 2005-01-03 devnull The program's name is the value of
27 058b0118 2005-01-03 devnull .BR argv0 ,
28 058b0118 2005-01-03 devnull which will be set if the program uses the
29 d32deab1 2020-08-16 rsc .MR arg (3)
30 058b0118 2005-01-03 devnull interface to process its arguments.
31 058b0118 2005-01-03 devnull If
32 058b0118 2005-01-03 devnull .B argv0
33 058b0118 2005-01-03 devnull is null, it is ignored and the following colon and space are suppressed.
34 d93fca6a 2005-02-11 devnull .PP
35 d93fca6a 2005-02-11 devnull .I Syslog
36 d93fca6a 2005-02-11 devnull logs messages in the file named by
37 d93fca6a 2005-02-11 devnull .I logname
38 d93fca6a 2005-02-11 devnull in the directory
39 d93fca6a 2005-02-11 devnull .B \*9/log ;
40 d93fca6a 2005-02-11 devnull the file must already exist and is opened append-only.
41 d93fca6a 2005-02-11 devnull .I Logname
42 d93fca6a 2005-02-11 devnull must contain no slashes.
43 d93fca6a 2005-02-11 devnull The message is a line with several fields:
44 d93fca6a 2005-02-11 devnull the name of the machine writing the message;
45 d93fca6a 2005-02-11 devnull the date and time;
46 d93fca6a 2005-02-11 devnull the message specified by the 
47 d32deab1 2020-08-16 rsc .MR print (3)
48 d93fca6a 2005-02-11 devnull format
49 d93fca6a 2005-02-11 devnull .I fmt
50 d93fca6a 2005-02-11 devnull and any following arguments;
51 d93fca6a 2005-02-11 devnull and a final newline.
52 d93fca6a 2005-02-11 devnull If
53 d93fca6a 2005-02-11 devnull .I cons
54 d93fca6a 2005-02-11 devnull is set or the log file cannot be opened, the message is also printed
55 d93fca6a 2005-02-11 devnull on the system console.
56 d93fca6a 2005-02-11 devnull .I Syslog
57 d93fca6a 2005-02-11 devnull can be used safely in multi-threaded programs.
58 058b0118 2005-01-03 devnull .SH SOURCE
59 c3674de4 2005-01-11 devnull .B \*9/src/lib9/sysfatal.c
60 881e5d1e 2008-07-21 t.lainson .br
61 881e5d1e 2008-07-21 t.lainson .B \*9/src/lib9/syslog.c
62 058b0118 2005-01-03 devnull .SH "SEE ALSO"
63 d32deab1 2020-08-16 rsc .MR intro (3) ,
64 d32deab1 2020-08-16 rsc .MR errstr (3) ,
65 058b0118 2005-01-03 devnull the
66 058b0118 2005-01-03 devnull .B %r
67 058b0118 2005-01-03 devnull format in
68 d32deab1 2020-08-16 rsc .MR print (3)