| @@ -1,121 +1,120 @@ | | | @@ -1,121 +1,120 @@ |
1 | .\" $NetBSD: logger.1,v 1.16 2020/06/25 15:21:56 jruoho Exp $ | | 1 | .\" $NetBSD: logger.1,v 1.17 2020/06/26 15:46:28 wiz Exp $ |
2 | .\" | | 2 | .\" |
3 | .\" Copyright (c) 1983, 1990, 1993 | | 3 | .\" Copyright (c) 1983, 1990, 1993 |
4 | .\" The Regents of the University of California. All rights reserved. | | 4 | .\" The Regents of the University of California. All rights reserved. |
5 | .\" | | 5 | .\" |
6 | .\" Redistribution and use in source and binary forms, with or without | | 6 | .\" Redistribution and use in source and binary forms, with or without |
7 | .\" modification, are permitted provided that the following conditions | | 7 | .\" modification, are permitted provided that the following conditions |
8 | .\" are met: | | 8 | .\" are met: |
9 | .\" 1. Redistributions of source code must retain the above copyright | | 9 | .\" 1. Redistributions of source code must retain the above copyright |
10 | .\" notice, this list of conditions and the following disclaimer. | | 10 | .\" notice, this list of conditions and the following disclaimer. |
11 | .\" 2. Redistributions in binary form must reproduce the above copyright | | 11 | .\" 2. Redistributions in binary form must reproduce the above copyright |
12 | .\" notice, this list of conditions and the following disclaimer in the | | 12 | .\" notice, this list of conditions and the following disclaimer in the |
13 | .\" documentation and/or other materials provided with the distribution. | | 13 | .\" documentation and/or other materials provided with the distribution. |
14 | .\" 3. Neither the name of the University nor the names of its contributors | | 14 | .\" 3. Neither the name of the University nor the names of its contributors |
15 | .\" may be used to endorse or promote products derived from this software | | 15 | .\" may be used to endorse or promote products derived from this software |
16 | .\" without specific prior written permission. | | 16 | .\" without specific prior written permission. |
17 | .\" | | 17 | .\" |
18 | .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND | | 18 | .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND |
19 | .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | | 19 | .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
20 | .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | | 20 | .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
21 | .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE | | 21 | .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE |
22 | .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | | 22 | .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL |
23 | .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | | 23 | .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS |
24 | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | | 24 | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) |
25 | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | | 25 | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT |
26 | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | | 26 | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY |
27 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | | 27 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF |
28 | .\" SUCH DAMAGE. | | 28 | .\" SUCH DAMAGE. |
29 | .\" | | 29 | .\" |
30 | .\" @(#)logger.1 8.1 (Berkeley) 6/6/93 | | 30 | .\" @(#)logger.1 8.1 (Berkeley) 6/6/93 |
31 | .\" | | 31 | .\" |
32 | .Dd June 25, 2020 | | 32 | .Dd June 25, 2020 |
33 | .Dt LOGGER 1 | | 33 | .Dt LOGGER 1 |
34 | .Os | | 34 | .Os |
35 | .Sh NAME | | 35 | .Sh NAME |
36 | .Nm logger | | 36 | .Nm logger |
37 | .Nd make entries in the system log | | 37 | .Nd make entries in the system log |
38 | .Sh SYNOPSIS | | 38 | .Sh SYNOPSIS |
39 | .Nm | | 39 | .Nm |
40 | .Op Fl cins | | 40 | .Op Fl cins |
41 | .Op Fl d Ar SD | | 41 | .Op Fl d Ar SD |
42 | .Op Fl f Ar file | | 42 | .Op Fl f Ar file |
43 | .Op Fl m Ar msgid | | 43 | .Op Fl m Ar msgid |
44 | .Op Fl p Ar pri | | 44 | .Op Fl p Ar pri |
45 | .Op Fl t Ar tag | | 45 | .Op Fl t Ar tag |
46 | .Op Ar message ... | | 46 | .Op Ar message ... |
47 | .Sh DESCRIPTION | | 47 | .Sh DESCRIPTION |
48 | .Nm | | 48 | .Nm |
49 | provides a shell command interface to the | | 49 | provides a shell command interface to the |
50 | .Xr syslog 3 | | 50 | .Xr syslog 3 |
51 | system log module. | | 51 | system log module. |
52 | .Pp | | 52 | .Pp |
53 | Options: | | 53 | Options: |
54 | .Pp | | | |
55 | .Bl -tag -width "messageXX" | | 54 | .Bl -tag -width "messageXX" |
56 | .It Fl c | | 55 | .It Fl c |
57 | Log to console as a fallback | | 56 | Log to console as a fallback |
58 | .Dv ( LOG_CONS ) : | | 57 | .Dv ( LOG_CONS ) : |
59 | if the message cannot be passed to | | 58 | if the message cannot be passed to |
60 | .Xr syslogd 8 , | | 59 | .Xr syslogd 8 , |
61 | the message is written to | | 60 | the message is written to |
62 | .Pa /dev/console . | | 61 | .Pa /dev/console . |
63 | .It Fl d Ar sd | | 62 | .It Fl d Ar sd |
64 | Log this in the structured data (SD) field. | | 63 | Log this in the structured data (SD) field. |
65 | .Po | | 64 | .Po |
66 | .Ar sd | | 65 | .Ar sd |
67 | has to be passed as one argument and will require careful quoting when used from | | 66 | has to be passed as one argument and will require careful quoting when used from |
68 | the shell. | | 67 | the shell. |
69 | .Pc | | 68 | .Pc |
70 | .It Fl f Ar file | | 69 | .It Fl f Ar file |
71 | Log the specified file. | | 70 | Log the specified file. |
72 | .It Fl i | | 71 | .It Fl i |
73 | Log the process id of the logger process | | 72 | Log the process id of the logger process |
74 | with each line | | 73 | with each line |
75 | .Dv ( LOG_PID ) . | | 74 | .Dv ( LOG_PID ) . |
76 | .It Fl m Ar msgid | | 75 | .It Fl m Ar msgid |
77 | The MSGID used for the message. | | 76 | The MSGID used for the message. |
78 | .It Fl n | | 77 | .It Fl n |
79 | Open log file immediately | | 78 | Open log file immediately |
80 | .Dv ( LOG_NDELAY ) . | | 79 | .Dv ( LOG_NDELAY ) . |
81 | .It Fl p Ar pri | | 80 | .It Fl p Ar pri |
82 | Enter the message with the specified priority. | | 81 | Enter the message with the specified priority. |
83 | The priority may be specified numerically or as a | | 82 | The priority may be specified numerically or as a |
84 | .Dq facility.level | | 83 | .Dq facility.level |
85 | pair. | | 84 | pair. |
86 | For example, | | 85 | For example, |
87 | .Dq \-p local3.info | | 86 | .Dq \-p local3.info |
88 | logs the message(s) as | | 87 | logs the message(s) as |
89 | .Ar info Ns rmational | | 88 | .Ar info Ns rmational |
90 | level in the | | 89 | level in the |
91 | .Ar local3 | | 90 | .Ar local3 |
92 | facility. | | 91 | facility. |
93 | The default is | | 92 | The default is |
94 | .Dq user.notice . | | 93 | .Dq user.notice . |
95 | .It Fl s | | 94 | .It Fl s |
96 | Log the message to standard error, as well as the system log | | 95 | Log the message to standard error, as well as the system log |
97 | .Dv ( LOG_PERROR ) . | | 96 | .Dv ( LOG_PERROR ) . |
98 | .It Fl t Ar tag | | 97 | .It Fl t Ar tag |
99 | Mark every line in the log with the specified | | 98 | Mark every line in the log with the specified |
100 | .Ar tag . | | 99 | .Ar tag . |
101 | .It Ar message | | 100 | .It Ar message |
102 | Write the message to log; if not specified, and the | | 101 | Write the message to log; if not specified, and the |
103 | .Fl f | | 102 | .Fl f |
104 | flag is not provided, standard input is logged. | | 103 | flag is not provided, standard input is logged. |
105 | .El | | 104 | .El |
106 | .Sh EXIT STATUS | | 105 | .Sh EXIT STATUS |
107 | .Ex -std logger | | 106 | .Ex -std logger |
108 | .Sh EXAMPLES | | 107 | .Sh EXAMPLES |
109 | .Bd -literal -offset indent -compact | | 108 | .Bd -literal -offset indent -compact |
110 | logger System rebooted | | 109 | logger System rebooted |
111 | | | 110 | |
112 | logger \-p local0.notice \-t HOSTIDM \-f /dev/idmc | | 111 | logger \-p local0.notice \-t HOSTIDM \-f /dev/idmc |
113 | .Ed | | 112 | .Ed |
114 | .Sh SEE ALSO | | 113 | .Sh SEE ALSO |
115 | .Xr syslog 3 , | | 114 | .Xr syslog 3 , |
116 | .Xr syslogd 8 | | 115 | .Xr syslogd 8 |
117 | .Sh STANDARDS | | 116 | .Sh STANDARDS |
118 | The | | 117 | The |
119 | .Nm | | 118 | .Nm |
120 | utility conforms to | | 119 | utility conforms to |
121 | .St -p1003.2-92 . | | 120 | .St -p1003.2-92 . |