.TH RSTYXD 8.SH NAMErstyxd, styxd \- Styx-based remote execution and file service.SH SYNOPSIS.B auxi/rstyxd.I alg\&....PP.B auxi/styxd.I alg\&....SH DESCRIPTIONThese services are normally started by.IR svc (8)in response to incoming network calls.Each expects the standard input to be connected to the client;unusually, it is both read and written..PPBoth commands first authenticate the incoming call using.IR keyring-auth (2)via.IR security-auth (2).On successful authorisation, the server setsits user identity to that of the caller,and the client can request that a digest and/or encryptionalgorithm be applied using.IR ssl (3)to protect the data exchanged with the server.Each.I algnames a digest or encryption algorithm that the server will allowthe client to use,in any form accepted by.IR ssl ;the special name.B noneis usually listed, to allow the client to choose not to use.IR ssl ..PP.I Styxdprovides Styx file service to its client.Having authorised the client and optionally established.IR ssl ,as described above,it exports its name space (usually the name space inherited from.IR svc (8))on the connection using.B Sys->export(see.IR sys-dial (2))..PP.I Rstyxdprovides a remote-execution service.Having authorised the client and optionally established.IR ssl ,as described above,it reads a single line from its standard input.The line contains a decimal value that is the count of the numberof bytes that follow,which.I rstyxdreads as a.IR utf (6)-encodedstring.The string contains a command, which is parsed into arguments,following the quotingconventions of.IR sh (1).The first argument is the command name..I Rstyxdprepares a modified name space in whichto run the command.It mounts the connection (standard input) on.BR /n/client ,binds.BR /n/client/devonto.BR /dev ,and opens the new.B /dev/cons(ie, the remote client's.BR /dev/cons )on file descriptors 0, 1 and 2.Finally, it executes the command..SH FILES.TF /usr/user/keyring/default.TP.B /n/clientmount point used by.I rstyxd.TP.BI /usr/ user /keyring/defaultserver's authentication data when.IR svc (8)run as given.I user.SH SOURCE.B /appl/cmd/auxi/rstyxd.b.br.B /appl/cmd/auxi/styxd.b.SH SEE ALSO.IR keyring-auth (2),.IR security-auth (2),.IR getauthinfo (8)
.TH RSTYXD 8
.SH NAME
rstyxd, styxd \- Styx-based remote execution and file service
.SH SYNOPSIS
.B auxi/rstyxd
.I alg
\&...
.PP
.B auxi/styxd
.I alg
\&...
.SH DESCRIPTION
These services are normally started by
.IR svc (8)
in response to incoming network calls.
Each expects the standard input to be connected to the client;
unusually, it is both read and written.
.PP
Both commands first authenticate the incoming call using
.IR keyring-auth (2)
via
.IR security-auth (2).
On successful authorisation, the server sets
its user identity to that of the caller,
and the client can request that a digest and/or encryption
algorithm be applied using
.IR ssl (3)
to protect the data exchanged with the server.
Each
.I alg
names a digest or encryption algorithm that the server will allow
the client to use,
in any form accepted by
.IR ssl ;
the special name
.B none
is usually listed, to allow the client to choose not to use
.IR ssl .
.PP
.I Styxd
provides Styx file service to its client.
Having authorised the client and optionally established
.IR ssl ,
as described above,
it exports its name space (usually the name space inherited from
.IR svc (8))
on the connection using
.B Sys->export
(see
.IR sys-dial (2)).
.PP
.I Rstyxd
provides a remote-execution service.
Having authorised the client and optionally established
.IR ssl ,
as described above,
it reads a single line from its standard input.
The line contains a decimal value that is the count of the number
of bytes that follow,
which
.I rstyxd
reads as a
.IR utf (6)-encoded
string.
The string contains a command, which is parsed into arguments,
following the quoting
conventions of
.IR sh (1).
The first argument is the command name.
.I Rstyxd
prepares a modified name space in which
to run the command.
It mounts the connection (standard input) on
.BR /n/client ,
binds
.BR /n/client/dev
onto
.BR /dev ,
and opens the new
.B /dev/cons
(ie, the remote client's
.BR /dev/cons )
on file descriptors 0, 1 and 2.
Finally, it executes the command.
.SH FILES
.TF /usr/user/keyring/default
.TP
.B /n/client
mount point used by
.I rstyxd
.TP
.BI /usr/ user /keyring/default
server's authentication data when
.IR svc (8)
run as given
.I user
.SH SOURCE
.B /appl/cmd/auxi/rstyxd.b
.br
.B /appl/cmd/auxi/styxd.b
.SH SEE ALSO
.IR keyring-auth (2),
.IR security-auth (2),
.IR getauthinfo (8)