socklog(8) [debian man page]

socklog(8)						      System Manager's Manual							socklog(8)

NAME

       socklog - small and secure syslogd replacement for use with runit

SYNOPSIS

       socklog [-rRU] [unix] [path]
       socklog [-rR] inet [ip] [port]
       socklog [-rR] ucspi [args]

DESCRIPTION

       socklog	is  run  under	runit's  runsv(8),  writing syslog messages it receives from unix domain socket path or an inet udp socket ip:port
       through a pipe provided by runsv(8) to a svlogd(8) process.

       socklog can be run as an ucspi application to listen to an unix domain stream socket and for more flexible distributed logging.

       If the environment variables $UID and/or $GID are present, socklog drops permissions to those ids after creating  and  binding  the  socket
       (not in ucspi mode).

       socklog	converts  syslog facility and priority information to names (facility.priority:) as found in /usr/include/syslog.h at compile time
       if present.

       On solaris socklog also accepts sun_stream as first argument. Please see the web page for details.

UNIX SOCKET

       socklog [ unix ] [ path ]

       Starting socklog with the 1st argument unix, socklog will listen to the unix domain socket path.  If path is omitted, the default  /dev/log
       is used.

       The 1st argument may be omitted, default is unix.

INET SOCKET

       socklog inet [ ip ] [ port ]

       Starting socklog with the 1st argument inet, socklog will listen to the inet udp socket ip:port.

       If ip starts with 0, socklog will bind to all local interfaces.

       If port is less or equal 1024, socklog must be run by root.

       port may be omitted, default is 514.  ip may be omitted, default is 0.

       socklog prepends a.b.c.d: to each syslog message it receives, where a.b.c.d is the ip address of the connecting system.

UCSPI MODE

       socklog ucspi [ args ]

       Starting socklog with the 1st argument ucspi, socklog will run as an ucspi application. Normally socklog will only be started in ucspi mode
       by an ucspi server tool, such as tcpsvd(8), tcpserver(1) or unixserver.

       For each arg, socklog will prepend $arg: to each syslog message, if the environment variable $arg is present (maximum is 8).

OPTIONS

       -r     raw.  Write the raw syslog messages (no conversion of facility and priority) to the pipe, additionally to the log messages with sys-
	      log facility and priority converted to names.

       -R     raw only.  Same as -r above, but write the raw syslog messages only.

       -U     respect umask.  Don't set umask to 0 before creating a unix domain socket, but respect the current setting of umask(2).  This option
	      only takes effect in unix mode.

SEE ALSO

       sv(8), runsvdir(8), runsv(8), svlogd(8), tryto(1), uncat(1), socklog-check(8), tcpsvd(8), nc(1)

	http://smarden.org/socklog/
	http://smarden.org/runit/

AUTHOR

       Gerrit Pape <pape@smarden.org>

																	socklog(8)

Check Out this Related Man Page

tryto(1)						      General Commands Manual							  tryto(1)

NAME

       tryto - tries to run a command limited by a timeout or number of tries, can be used to run as svlogd(8) processor.

SYNOPSIS

       tryto [-pPv] [-t sec] [-k ksec] [-n tries] prog

DESCRIPTION

       prog consist of one or more arguments.

       tryto  runs  and  watches  prog, feeding its standard input to prog's standard input.  If prog exits with a return code other then 0, tryto
       runs prog again after sleeping one second.

       If the number of retries reaches the maximal number of tries, tryto prints an error message and gives up.

       If the timeout sec seconds is reached and prog is still running, tryto sends a TERM signal to prog, waits ksec seconds for prog	to  termi-
       nate, then sends a KILL signal if prog still is there, and exits as soon as possible.

OPTIONS

       -t sec timeout.	Set the timeout to send TERM to prog to sec seconds.  Default is 180.

       -k ksec
	      kill timeout.  Set the timeout to send KILL to prog to ksec seconds.  Default is 5.

       -n tries
	      Set  the	maximal number of tries to tries.  If prog exited with a return code other that 0, tryto tries to rewind standard input to
	      the beginning using lseek(2) before starting prog again.	Default is 5.

       -p     processor.  Use this option if you run tryto as a svlogd(8) processor (see below).

       -P     process group.  Run prog in a new session and process group, and send signals on timeout to prog's process group instead of its pid.

       -v     verbose.	Print verbose messages to standard error.

PROCESSOR

       If tryto sees the -p option, tryto runs as a svlogd(8) or multilog(8) processor, making use of filedescriptors 4 and 5:

       Before starting prog, tryto moves the filedescriptor 5 to 2, so all error messages from tryto and prog will be saved in	svlogd(8)'s  state
       to be processed on the next run of tryto -p.

       After  starting prog, tryto first feeds all data it reads from filedescriptor 4 into prog's standard input, then all data from filedescrip-
       tor 0.

       If prog fails by timeout sec seconds or maximal number of tries, tryto prints all data from standard input to  standard	output,  an  error
       message to standard error, and exits with 0.

EXIT CODES

       If tryto itself fails, it returns 111.

       If tryto runs as a svlogd(8) processor, tryto returns 0 in all other cases.

       If prog was run successfully, tryto returns 0.

       If prog failed by timeout, tryto returns 100.

       If prog failed by maximal number of tries, tryto returns the last return code from prog.

SEE ALSO

       socklog(8), uncat(1), svlogd(8), multilog(8), lseek(2)

	http://smarden.org/socklog/
	http://smarden.org/runit/

AUTHOR

       Gerrit Pape <pape@smarden.org>

																	  tryto(1)

Linux and UNIX Man Pages

socklog(8) [debian man page]

Check Out this Related Man Page