History

20090219-1239

Charles.Forsyth committed 17 years ago

Commit bc26b881 parent 63eadad1 file · +29 −45Browse files

Unified · Split

man/8/rstyxd+29−45
@@ -1,53 +1,11 @@
11 .TH RSTYXD 8
22 .SH NAME
3−rstyxd, styxd \- Styx-based remote execution and file service
3+rstyxd \- Styx-based remote execution and file service
44 .SH SYNOPSIS
55 .B auxi/rstyxd
66 .I alg
77 \&...
8−.PP
9−.B auxi/styxd
10−.I alg
11−\&...
128 .SH DESCRIPTION
13−These services are normally started by
14−.IR svc (8)
15−in response to incoming network calls.
16−Each expects the standard input to be connected to the client;
17−unusually, it is both read and written.
18−.PP
19−Both commands first authenticate the incoming call using
20−.IR keyring-auth (2)
21−via
22−.IR security-auth (2).
23−On successful authorisation, the server sets
24−its user identity to that of the caller,
25−and the client can request that a digest and/or encryption
26−algorithm be applied using
27−.IR ssl (3)
28−to protect the data exchanged with the server.
29−Each
30−.I alg
31−names a digest or encryption algorithm that the server will allow
32−the client to use,
33−in any form accepted by
34−.IR ssl ;
35−the special name
36−.B none
37−is usually listed, to allow the client to choose not to use
38−.IR ssl .
39−.PP
40−.I Styxd
41−provides Styx file service to its client.
42−Having authorised the client and optionally established
43−.IR ssl ,
44−as described above,
45−it exports its name space (usually the name space inherited from
46−.IR svc (8))
47−on the connection using
48−.B Sys->export
49−(see
50−.IR sys-dial (2)).
519 .PP
5210 .I Rstyxd
5311 provides a remote-execution service.
@@ -82,6 +40,34 @@ and opens the new · 28 unmodified lines
8240 .BR /dev/cons )
8341 on file descriptors 0, 1 and 2.
8442 Finally, it executes the command.
43+.PP
44+.I Rstyxd
45+is normally started by
46+.IR svc (8)
47+in response to incoming network calls.
48+It expects the standard input to be connected to the client;
49+unusually, it is both read and written.
50+It
51+first authenticates the incoming call using
52+.IR keyring-auth (2)
53+via
54+.IR security-auth (2).
55+On successful authorisation, the server sets
56+its user identity to that of the caller,
57+and the client can request that a digest and/or encryption
58+algorithm be applied using
59+.IR ssl (3)
60+to protect the data exchanged with the server.
61+Each
62+.I alg
63+names a digest or encryption algorithm that the server will allow
64+the client to use,
65+in any form accepted by
66+.IR ssl ;
67+the special name
68+.B none
69+is usually listed, to allow the client to choose not to use
70+.IR ssl .
8571 .SH FILES
8672 .TF /usr/user/keyring/default
8773 .TP
@@ -96,8 +82,6 @@ run as given · 8 unmodified lines
9682 .I user
9783 .SH SOURCE
9884 .B /appl/cmd/auxi/rstyxd.b
99−.br
100−.B /appl/cmd/auxi/styxd.b
10185 .SH SEE ALSO
10286 .IR keyring-auth (2),
10387 .IR security-auth (2),