.TH diod 8 "2015-03-31" "diod-1.0.24" "diod"
.SH NAME
diod \- distributed I/O daemon
.SH SYNOPSIS
.B diod
.I "[OPTIONS]"
.SH DESCRIPTION
.B diod
is the distributed I/O daemon server, which
implements I/O forwarding on Linux clusters.
.LP
Configuration is read from the diod.conf (5) config file.
Some configuration can be overridden on the command line, as described below.
.SH OPTIONS
.TP
.I "-f, --foreground"
Do not change working directory to /var/run,
drop the controlling terminal, or run in the background.
Send logs to stderr not syslog, unless sent somewhere else by \fI\-L\fR.
.TP
.I "-r, --rfdno INT"
.TP
.I "-w, --wfdno INT"
Serve a connected client inherited on the specified read and write
file descriptors.  For file descriptors connected bidirectionally,
the two options may be set to the same value.
.TP
.I "-l, --listen address"
Set the listen address.  The address may be in the form of
HOST:PORT, IP:PORT, or /path/to/unix_domain_socket form (default 0.0.0.0:564).
This option may be specified more than once.
It overrides the \fIlisten\fR config file setting.
.TP
.I "-t, --nwthreads INT"
Set the number of worker threads to spawn to handle 9P operations
for each unique aname.
This option overrides the \fInwthreads\fR setting in diod.conf (5).
The default is 16.
.TP
.I "-e, --export PATH"
Set the file system to be exported.
This option may be specified more than once.
It overrides the \fIexports\fR setting in diod.conf (5).
.TP
.I "-E, --export-all"
Export everything in the server's /proc/mounts.
.TP
.I "-o, --export-opts OPT[,OPT,...]"
Set global export options.
This option overrides the \fIexportopts\fR setting in diod.conf (5).
.TP
.I "-n, --no-auth"
This option allows users to attach without security credentials.
It overrides  the \fIauth_required\fR setting in diod.conf (5).
.TP
.I "-N, --no-userdb"
This option disables password/group lookups.
It allows any uid to attach and assumes gid=uid, and supplementary groups
contain only the primary gid.
It overrides  the \fIuserdb\fR setting in diod.conf (5).
.TP
.I "-S, --allsquash"
Remap all users to the squash user.
The attaching user need not be present in the server's password file.
This option overrides the \fIallsquash\fR setting in diod.conf (5).
.TP
.I "-U, --squashuser"
Set the squash user.  The default is nobody.
This option overrides the \fIsquashuser\fR setting in diod.conf (5).
Note: if \fBdiod\fR is not run as root, the effective uid overrides
the \fIsquashuser\fR.
.TP
.I "-u, --runas-uid UID"
Run the server as UID and only allow that user to attach.
If invoked as root, \fBdiod\fR sets real and effective uid, gid, and
supplementary groups to those belonging to UID.
.TP
.I "-L, --logdest DEST"
Set the destination for logging.  Possible destinations are
\fIsyslog:facility:level\fR,
\fIstderr\fR,
\fIstdout\fR, or
a file name.
This option overrides the \fIlogdest\fR setting in diod.conf (5).
.TP
.I "-d, --debug MASK"
Set the debug mask.  The bit values are:
.br
0x01 - log decoded 9P protocol messages
.br
.TP
.I "-c, --config-file PATH"
Set config file path.
.SH "FILES"
/usr/sbin/diod
.br
/etc/diod.conf
.SH "SEE ALSO"
diod.conf (5), mount.diod (8), hosts_access (5)