rudial (and friends) tools provide access to RUSS services via the command line/shell.
The dial call is central to RUSS. It is what connects a client to a server, after which, one or more I/O streams between them are set up for inter-process communication. Three I/O streams are standard and connected to stdin, stdout, and stderr.
rudial takes an operation value such as execute, list, help and a service path which is a /-separated list of names specifying the service to use and how to get to it. The operation tells the service what to do: execute the service, list subservices, return help information for the service(s).
rudial also takes an optional set of key=value attribute settings and an argument list. All items are passed as strings. The exit value of the service is returned by
Some convenience programs are provided to shorten the invocation:
rudial, ruexec, ruhelp, ruls - Client-side tools for accessing
rudial [<option>] <op> <spath> [<arg> ...]
ruexec [<option>] <spath> [<arg> ...]
ruhelp [<option>] <spath> [<arg> ...]
ruls [<option>] <spath> [<arg> ...]
These client-side tools are used to dial (connect to) a russ
serivce. When connected to a russ service, file descriptors are
returned, corresponding to stdin, stdout, stderr of the ser‐
vice, and can be used as usual. (Note that the file descriptors
returned depends on the service.)
The standard exit code mechanism functions as usual and, in
most cases, is returned by the service. Common exit codes are 0
for success, 1 for error. When there is a problem with the dial
step, and exit code of 126 or 127 may be returned.
Pass a "name=value" string to the service.
Set the buffer size for reading and writing operations.
Allow given amount of time to dial before aborting and
returning an error exit code.
rudial is the generic form and takes a russ operation (<op>):
Execute the service <spath> on behalf of the client
help Return help for the server or service associated with
list Return a list of services at the <spath>.
The service path <spath> identifies a service as found in the
service hierarchy of a russ server.
To reduce verbosity of the rudial call, some helper programs
are provided. All but ruls are direct replacements.
ruexec is equivalent to "rudial execute".
ruhelp is equivalent to "rudial help".
ruls is equivalent to "rudial list" except when the <spath> is
a local filesystem object (e.g., directory). In such a case, a
modified directory listing is output. This is helpful when nav‐
igating the filesystem and russ services.
Written by John Marshall.
Report bugs to: <...>.
Copyright © 2014 John Marshall.
Unless otherwise indicated, this software is available under
the terms of the ls Apache License version 2.
russ 5.x RUDIAL(1)
To list the system services:
+ is shorthand for the
To list services of a server (e.g., the debug server):
To get help from the debug server:
To execute the
daytime debug service:
To pass input over stdin:
echo hello | ruexec +/debug/echo
To pass file input over stdin:
cat /etc/hostname | ruexec +/debug/echo
or by using the
ruexec -i /etc/hostname +/debug/echo