diff --git a/man/syslogd.8 b/man/syslogd.8 index ccc1ecb..6e5df9f 100644 --- a/man/syslogd.8 +++ b/man/syslogd.8 @@ -14,11 +14,12 @@ .Sh SYNOPSIS .Nm .Op Fl ?46Adhnv -.Op Fl b Ar :SVC -.Op Fl f Ar FILE -.Op Fl m Ar SECONDS -.Op Fl P Ar FILE -.Op Fl p Ar SOCK +.Op Fl b Ar addr[:port] +.Op Fl b Ar :port +.Op Fl f Ar file +.Op Fl m Ar sec +.Op Fl P Ar file +.Op Fl p Ar sock .Op Fl R Ar size[:count] .Sh DESCRIPTION .Nm @@ -70,7 +71,7 @@ When starts up it reads its main configuration file .Pa /etc/syslog.conf , or an alternate file given with the -.Fl f Ar FILE +.Fl f Ar file option. For details on how to configure syslog priority (facility.severity) filtering, see .Xr syslog.conf 5 . @@ -91,11 +92,18 @@ tries to send the message to only one address even if the host has more than one A or AAAA record. If this option is specified, .Nm tries to send the message to all addresses. +.It Fl b Ar address[:service] .It Fl b Ar :service -Bind to a specific port. The port can be specified as a service name or -number. The default service is +Bind to a specific address and/or port. The address can be specified as +a hostname, and the port as a service name. If an IPv6 address is +specified, it should be enclosed with +.Sq \&[ +and +.Sq \&] . +The default service is .Ql syslog -(514/udp). +(514/udp). This option can be specified multiple times to bind to +multiple addresses and/or ports. .It Fl d Turns on debug mode. This implicitly enables .Fl n @@ -106,7 +114,7 @@ TTY. SIGUSR1 is required to confirm continued debug messages when the daemon has finished started up. See the .Sx DEBUGGING section for more information. -.It Fl f Ar FILE +.It Fl f Ar file Specify an alternative configuration file instead of the default .Pa /etc/syslog.conf . .It Fl h @@ -115,7 +123,7 @@ hosts. Specifying this switch on the command line will cause the log daemon to forward any remote messages it receives to forwarding hosts which have been defined. This can cause syslog loops that fill up hard disks quite fast and thus needs to be used with caution. -.It Fl m Ar SECONDS +.It Fl m Ar seconds .Nm logs a mark timestamp regularly. The default interval between two .Ql -- MARK -- @@ -133,11 +141,11 @@ Run in foreground, required when run from a modern init/supervisor. See your system .Xr init 1 for details. -.It Fl P Ar FILE +.It Fl P Ar file Specify an alternate file in which to store the process ID. The default is .Pa /var/run/syslog.pid . -.It Fl p Ar SOCK +.It Fl p Ar socket Specify an alternate UNIX domain socket instead of the default .Pa /dev/log . When a single diff --git a/src/syslogd.c b/src/syslogd.c index ab703c2..3b2c09a 100644 --- a/src/syslogd.c +++ b/src/syslogd.c @@ -191,14 +191,16 @@ static int addpeer(struct peer *pe0) int usage(int code) { printf("Usage:\n" - " syslogd [-46Adnrvh?] [-f FILE] [-l HOST] [-m SEC] [-P PID_FILE]\n" - " [-p SOCK_PATH] [-R SIZE[:NUM]]\n" + " syslogd [-46Adnrvh?] [-b :PORT] [-b ADDR[:PORT]] [-f FILE] [-m SEC]\n" + " [-P PID_FILE] [-p SOCK_PATH] [-R SIZE[:NUM]]\n" "\n" "Options:\n" " -4 Force IPv4 only\n" " -6 Force IPv6 only\n" " -A Send to all addresses in DNS A, or AAAA record\n" - " -b :SRV Bind to a specific internet port, default syslog/514, requires -r\n" + " -b ADDR:SERVICE" + " -b :SRV Bind to a specific address and/or port. The address can be specifed\n" + " as a hostname ath the port as as ervice name, default syslog/514\n" " -d Enable debug mode\n" " -f FILE Alternate .conf file, default: /etc/syslog.conf\n" " -h Forward messages from other hosts also to remote syslog host(s)\n" @@ -210,8 +212,6 @@ int usage(int code) " -R S[:R] Enable log rotation. The size argument (S) takes k/M/G qualifiers,\n" " e.g. 2M for 2 MiB. The optional rotations argument default to 5.\n" " Rotation can also be defined per log file in syslog.conf\n" - " -r Act as remote syslog sink for other hosts, default is secure mode,\n" - " i.e., syslogd does not bind to any internet address:port by default\n" "\n" " -? Show this help text\n" " -v Show program version and exit\n"