summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDavid Oberhollenzer <david.oberhollenzer@tele2.at>2018-08-28 22:12:17 +0200
committerDavid Oberhollenzer <david.oberhollenzer@tele2.at>2018-08-31 10:14:06 +0200
commit34aff498edf05f95e7e622632440b2fc967b01a8 (patch)
treec19974ca6d0d6a7559d0fb1d6e3933c16b7df0e7
parentb5c6e9d392b4d8368286f2dd807d668c7213965a (diff)
Add man page for syslog command
Signed-off-by: David Oberhollenzer <david.oberhollenzer@tele2.at>
-rw-r--r--Makefile.am1
-rw-r--r--cmd/Makemodule.am1
-rw-r--r--cmd/syslog.147
3 files changed, 49 insertions, 0 deletions
diff --git a/Makefile.am b/Makefile.am
index 2b88dcc..648631a 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -14,6 +14,7 @@ helperdir = @SCRIPTDIR@
helper_PROGRAMS =
helper_SCRIPTS =
+dist_man1_MANS =
dist_man8_MANS =
include lib/Makemodule.am
diff --git a/cmd/Makemodule.am b/cmd/Makemodule.am
index e68a244..7e5bab7 100644
--- a/cmd/Makemodule.am
+++ b/cmd/Makemodule.am
@@ -33,6 +33,7 @@ syslog_LDFLAGS = $(AM_LDFLAGS)
syslog_LDADD = libinit.a
bin_PROGRAMS += syslog
+dist_man1_MANS += cmd/syslog.1
endif
dist_man8_MANS += cmd/shutdown.8
diff --git a/cmd/syslog.1 b/cmd/syslog.1
new file mode 100644
index 0000000..382b568
--- /dev/null
+++ b/cmd/syslog.1
@@ -0,0 +1,47 @@
+.TH syslog 1 "August 2018" "Pygos Init"
+.SH NAME
+syslog \- send a log message to the syslog daemon
+.SH SYNOPSIS
+.B syslog
+[options] message..
+.SH DESCRIPTION
+The syslog command concatenates all non option arguments to a single message
+that it sends to the syslog daemon.
+.SH OPTIONS
+.TP
+.BR \-h , " \-\-help"
+Display a brief help text, a list of available facilities, log levels, all the
+default setting and exit.
+.TP
+.BR \-V , " \-\-version"
+Print version information and exit.
+.TP
+.BR \-f , " \-\-facility " \fIfacility\fP
+Logging facility name or numeric identifier. Use
+.B \-\-help
+to get a list of all available facility names.
+.TP
+.BR \-l , " \-\-level " \fIlevel\fP
+A log level number from 0 to 8 with 8 being most severe, or a name from
+.I debug
+to
+.I emergency.
+Use
+.B \-\-help
+to get a list of all available log level names.
+.TP
+.BR \-i , " \-\-ident " \fIname\fP
+Program name to specify to syslog. If not set, "(shell)" is used as sensible
+default to indicate that the message came from the command line.
+.TP
+.BR \-c , " \-\-console"
+Try to write directly to the console if opening the syslog socket fails.
+.SH AVAILABILITY
+This program is part of the Pygos init system.
+.SH COPYRIGHT
+Copyright \(co 2018 David Oberhollenzer
+.br
+License: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
+.br
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.