X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~mdw/git/tripe/blobdiff_plain/f7b5d10863b6d9e083dc15c821db8d5e1d2f3f89..c4e05a1a9831c923f2a4a68a0178116f55d5ddf0:/client/tripectl.1.in diff --git a/client/tripectl.1.in b/client/tripectl.1.in index 0724b8a6..e01df128 100644 --- a/client/tripectl.1.in +++ b/client/tripectl.1.in @@ -24,10 +24,10 @@ .\" Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. . .\"-------------------------------------------------------------------------- -.so ../defs.man.in \" @@@PRE@@@ +.so ../common/defs.man \" @@@PRE@@@ . .\"-------------------------------------------------------------------------- -.TH tripectl 1 "19 February 2001" "Straylight/Edgeware" "TrIPE: Trivial IP Encryption" +.TH tripectl 1tripe "19 February 2001" "Straylight/Edgeware" "TrIPE: Trivial IP Encryption" . .\"-------------------------------------------------------------------------- .SH "NAME" @@ -39,12 +39,14 @@ tripectl \- simple client for TrIPE . .B tripectl .RB [ \-w ] +.RB [ \-W +.IR things ] .RB [ \-\fIoptions ] .RI [ command .RI [ args ]...] .br .B tripectl -.RB [ \-Dl ] +.RB [ \-Dlt ] .RB [ \-f .IR file ] .RB [ \-\fIoptions ] @@ -200,7 +202,9 @@ and options. .TP .BI "\-G, \-\-setgid=" group -Set gid to that of +If the current effective uid is zero (i.e., the daemon was invoked as +.BR root ) +then set gid to that of .I group (either a group name or integer gid) after initialization. If a new .BR tripe (8) @@ -221,15 +225,41 @@ trace messages are logged with severity .BI "\-f, \-\-logfile=" file Write warnings and trace messages to .IR file . -On receipt of a +The +.I file +may be +.RB ` \- ' +to request output to stdout, or +.RB ` ! ' +to request output to stderr. If a proper filename is given (rather than +one of these special tokens), then on receipt of a .B SIGHUP signal, .B tripectl -will close its log file and reopen a new one with the same name. This -is useful when you rotate logs. +will close its log file and reopen a new one with the same name; this is +useful when you rotate logs. +.TP +.B "\-t, \-\-no-timestamp" +When logging to a file (with +.BR \-f ), +don't prefix log items with a timestamp. This is useful when the log +output is being captured by some process which will add its own +timestamps anyway. .TP .B "\-w, \-\-warnings" Write warnings to standard error even when running noninteractively. +.TP +.BI "\-W, \-\-watch=" things +When running as a client, arrange to receive asynchronous messages as +described by +.IR things , +which should be a trace list suitable for passing to the server's +.B WATCH +command: see +.BR tripe-admin (5) +for more details. This overrides the +.B \-w +flag in noninteractive use. .SS "Interactive use" With no arguments, .B tripectl