shithub: purgatorio

ref: 654935ba71201d7215d9fcd96181a330ec6ff617
dir: /man/8/rstyxd/

View raw version
.TH RSTYXD 8
.SH NAME
rstyxd \- Styx-based remote execution and file service
.SH SYNOPSIS
.B auxi/rstyxd
.I alg
\&...
.SH DESCRIPTION
.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.
.PP
.I Rstyxd
is normally started by
.IR svc (8)
in response to incoming network calls.
It expects the standard input to be connected to the client;
unusually, it is both read and written.
It
first authenticates 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 .
.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
.SH SEE ALSO
.IR keyring-auth (2),
.IR security-auth (2),
.IR getauthinfo (8)