version 1.31, 2007/03/01 22:36:25 |
version 1.32, 2007/03/01 22:51:57 |
|
|
uses a collection of predefined message |
uses a collection of predefined message |
.Em facilities |
.Em facilities |
that each contain a list of message |
that each contain a list of message |
.Sy types |
.Em types |
specifying which types of messages to send to that |
specifying which types of messages to send to that facility. |
.Em facility . |
|
The local client |
The local client |
.Pq Nm rdist |
|
and the remote server |
and the remote server |
.Pq Xr rdistd 1 |
|
each maintain their own copy |
each maintain their own copy |
of what types of messages to log to what facilities. |
of what types of messages to log to what facilities. |
.Pp |
.Pp |
The |
The |
.Fl l |
.Fl l |
.Ar local_logopts |
.Ar local_logopts |
option to |
option specifies the logging options to use locally; |
.Nm |
|
tells |
|
.Nm |
|
what logging options to use locally. |
|
The |
|
.Fl L |
.Fl L |
.Ar remote_logopts |
.Ar remote_logopts |
option to |
specifies the logging options to pass to the remote server. |
.Nm |
|
tells |
|
.Nm |
|
what logging options to pass to the remote |
|
.Em rdistd |
|
server. |
|
.Pp |
.Pp |
.Em logopts |
Logging options should be of the form: |
should be of the form: |
|
.Pp |
.Pp |
.D1 facility=types:facility=types... |
.D1 facility=types:facility=types... |
.Pp |
.Pp |
The valid facility names are: |
The valid facility names are: |
.Bl -tag -width Ds |
.Bl -tag -width Ds -offset indent |
.It Ic stdout |
|
Messages to standard output. |
|
.It Ic file |
.It Ic file |
Log to a file. |
Log to a file. |
To specify the file name, use the format |
To specify the file name, use the format |
|
|
For example: |
For example: |
.Pp |
.Pp |
.Dl file=/tmp/rdist.log=all,debug |
.Dl file=/tmp/rdist.log=all,debug |
.It Ic syslog |
|
Use the |
|
.Xr syslogd 8 |
|
facility. |
|
.It Ic notify |
.It Ic notify |
Use the internal |
Use the internal |
.Nm |
.Nm |
|
|
to specify what messages are mailed to the |
to specify what messages are mailed to the |
.Ic notify |
.Ic notify |
address. |
address. |
|
.It Ic stdout |
|
Messages to standard output. |
|
.It Ic syslog |
|
Use the |
|
.Xr syslogd 8 |
|
facility. |
.El |
.El |
.Pp |
.Pp |
.Em types |
.Ar types |
should be a comma separated list of message types. |
should be a comma separated list of message types. |
Each message type specified enables that message level. |
Each message type specified enables that message level. |
This is unlike the |
This is unlike the |
.Xr syslog 3 |
.Xr syslog 3 |
system facility which uses an ascending order scheme. |
system facility which uses an ascending order scheme. |
The following are the valid |
The following are the valid types: |
.Em types : |
.Bl -tag -width Ds -offset indent |
.Bl -tag -width Ds |
.It Ic all |
|
All but debug messages. |
.It Ic change |
.It Ic change |
Things that change. |
Things that change. |
This includes files that are installed or updated in some way. |
This includes files that are installed or updated in some way. |
|
.It Ic debug |
|
Debugging information. |
|
.It Ic ferror |
|
Fatal errors. |
.It Ic info |
.It Ic info |
General information. |
General information. |
|
.It Ic nerror |
|
Normal errors that are not fatal. |
.It Ic notice |
.It Ic notice |
General info about things that change. |
General info about things that change. |
This includes things like making directories which are needed in order |
This includes things like making directories which are needed in order |
to install a specific target, but which are not explicitly specified in the |
to install a specific target, but which are not explicitly specified in the |
.Pa distfile . |
.Pa distfile . |
.It Ic nerror |
|
Normal errors that are not fatal. |
|
.It Ic ferror |
|
Fatal errors. |
|
.It Ic warning |
.It Ic warning |
Warnings about errors which are not as serious as |
Warnings about errors which are not as serious as |
.Ic nerror |
.Ic nerror |
type messages. |
type messages. |
.It Ic debug |
|
Debugging information. |
|
.It Ic all |
|
All but debug messages. |
|
.El |
.El |
.Pp |
.Pp |
Here is a sample command line option: |
Here is a sample command line option: |