NAME¶

diodcli - perform file operations by attaching directly to diod server

SYNOPSIS¶

diodcli [OPTIONS] read PATH
diodcli [OPTIONS] write PATH
diodcli [OPTIONS] mkdir PATH
diodcli [OPTIONS] stat PATH
diodcli [OPTIONS] ls [--long] [PATH ...]
diodcli [OPTIONS] null
diodcli [OPTIONS] getxattr PATH NAME
diodcli [OPTIONS] setxattr [--create|--replace] PATH NAME VALUE
diodcli [OPTIONS] delxattr PATH NAME
diodcli [OPTIONS] showmount [--long]
diodcli [OPTIONS] date [--set-time]

DESCRIPTION¶

diodcli connects to a diod server, attaches to the mount point aname, and performs a file operation.

OPTIONS¶

These are the options that apply to all subcommands:

-a, --aname NAME

The file system name on the server (default "ctl"). Note that the "ctl" synthetic file system must be explicitly exported.

-s, --server NAME

The server in IP[:PORT], HOST[:PORT], or /path/to/socket form (default localhost:564).

-m, --msize SIZE

The maximum request size including 9P headers (default 65536).

-u, --uid UID

Try to attach to the server as the specified user (default your effective uid).

-p, --privport

Connect from a socket bound to a port in the range of 512-1023, available to root only. This can be used in conjunction with the privport export option.

-t, --trace

Show 9P protocol on stderr.

SUBCOMMANDS¶

read

Read a file and write to stdout.

write

Read stdin to EOF and write to a file.

mkdir

Create a directory.

stat

Display file status. The compatible stat(1) format string is:

mode=%f owner=%u:%g size=%s blocks=%b blocksize=%o links=%h \
device=%t:%T mtime=%Y ctime=%Z atime=%X

ls

List directory contents.

null

Once attached, do nothing.

getxattr

Get the value of an extended attribute.

setxattr

Set the value of an extended attribute.

delxattr

Remove an extended attribute.

showmount

List the server's connected clients. By default, the client list is compressed into one line in hostlist form, with domain suffixes removed. With --long, the clients are listed one per line, without compression or abbreviation.

date

Show the server system time. If --set-time is specified, the local system time is updated to match the server's. This may be useful in a pre-boot environment prior to authenticating with MUNGE, to avoid running afoul of its replay attack prevention.

SEE ALSO¶

diod (8)