RSTYXD(8) RSTYXD(8)
NAME
rstyxd, styxd - Styx-based remote execution and file service
SYNOPSIS
auxi/rstyxd alg ...
auxi/styxd alg ...
DESCRIPTION
These services are normally started by 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.
Both commands first authenticate the incoming call using
keyring-auth(2) via security-auth(2). On successful authori-
sation, 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 ssl(3) to protect the
data exchanged with the server. Each alg names a digest or
encryption algorithm that the server will allow the client
to use, in any form accepted by ssl; the special name none
is usually listed, to allow the client to choose not to use
ssl.
Styxd provides Styx file service to its client. Having
authorised the client and optionally established ssl, as
described above, it exports its name space (usually the name
space inherited from svc(8)) on the connection using
Sys->export (see sys-dial(2)).
Rstyxd provides a remote-execution service. Having autho-
rised the client and optionally established 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 rstyxd reads as a
utf(6)-encoded string. The string contains a command, which
is parsed into arguments, following the quoting conventions
of sh(1). The first argument is the command name. Rstyxd
prepares a modified name space in which to run the command.
It mounts the connection (standard input) on /n/client,
binds /n/client/dev onto /dev, and opens the new /dev/cons
(ie, the remote client's /dev/cons) on file descriptors 0, 1
and 2. Finally, it executes the command.
FILES
/n/client mount point used by rstyxd
/usr/user/keyring/default server's authentication data when
svc(8) run as given user
Page 1 Plan 9 (printed 12/21/24)
RSTYXD(8) RSTYXD(8)
SOURCE
/appl/cmd/auxi/rstyxd.b
/appl/cmd/auxi/styxd.b
SEE ALSO
keyring-auth(2), security-auth(2), getauthinfo(8)
Page 2 Plan 9 (printed 12/21/24)