chiark / gitweb /
server: Repurpose the flags in `peerspec'.
[tripe] / server / tripe-admin.5.in
index 6901dc4130de409a71956b75332ca76dcc560573..21426747a5f1e33ec9a6debb5a3c9d4f904c3f4e 100644 (file)
@@ -180,7 +180,7 @@ indicates that a background command succeeded or failed, respectively.
 A background command will never issue an
 .B OK
 or
-.B BGINFO
+.B INFO
 response: it will always detach and then issue any
 .B BGINFO
 lines followed by
@@ -214,7 +214,8 @@ command.
 .SP
 .BI "SVCCLAIM " service " " version
 Another client has claimed a later version of the named
-.I service.  The recipient is no longer the provider of this service.
+.IR service .
+The recipient is no longer the provider of this service.
 .SP
 .BI "SVCJOB " jobid " " service " " command " " args \fR...
 Announces the arrival of a new job.  The
@@ -261,7 +262,7 @@ permitted; if omitted, the default port 4070 is used.  Name resolution
 does not block the main server, but will block the requesting client,
 unless the command is run in the background.
 .PP
-If, on input, no recognised address family token is found, the following
+If, on input, no recognized address family token is found, the following
 tokens are assumed to represent an
 .B INET
 address.  Addresses output by the server always have an address family
@@ -320,7 +321,7 @@ the peer's public key is assumed to be in the file
 option on the command line).  The
 .I address
 is the network address (see above for the format) at which the peer can
-be contacted.  The following options are recognised.
+be contacted.  The following options are recognized.
 .RS
 .\"+opts
 .TP
@@ -347,6 +348,12 @@ or
 for days, hours, minutes, or seconds respectively; if no suffix is
 given, seconds are assumed.
 .TP
+.BI "\-key " tag
+Use the public key
+.I tag
+to authenticate the peer.  The default is to use the key tagged
+.IR peer .
+.TP
 .BI "\-tunnel " tunnel
 Use the named tunnel driver, rather than the default.
 .\"-opts
@@ -522,6 +529,12 @@ The tunnel driver used for this peer.
 .B keepalive
 The keepalive interval, in seconds, or zero if no keepalives are to be
 sent.
+.TP
+.B key
+The key tag being used for the peer, as passed to the
+.B ADD
+command.  (You don't get a full key-id, since that might change while
+the daemon's running.)
 .RE
 .SP
 .BI "PING \fR[" options "\fR] " peer
@@ -978,8 +991,19 @@ is already the tag of an outstanding job.
 .SP
 .BI "unknown-command " token
 The command
-.B token
-was not recognised.
+.I token
+was not recognized.
+.SP
+.BI "unknown-jobid " jobid
+(For
+.BR SVCOK ,
+.BR SVCFAIL ,
+and
+.BR SVCINFO .)
+The token
+.I jobid
+is not recognized as identifying an outstanding job.  It may have just
+been cancelled.
 .SP
 .BI "unknown-peer " name
 (For
@@ -1412,6 +1436,9 @@ Configuring the Linux TUN/TAP interface failed.
 .BI "TUN " ifname " " tun-name " read-error " ecode " " message
 Reading from the tunnel device failed.
 .SP
+.BI "TUN " ifname " " tun-name " write-error " ecode " " message
+Writing from the tunnel device failed.
+.SP
 .BI "TUN " ifname " slip bad-escape"
 The SLIP driver encountered a escaped byte it wasn't expecting to see.
 The erroneous packet will be ignored.