\fBslurmrestd\fR is REST API interface for Slurm. It can be used in two modes:

.TP
Inetd Mode: slurmrestd will read and write to STDIN and STDOUT. It can detect if
it is connected to a socket or a locally TTY (interactive mode).

.TP
Listen Mode: slurmrestd will open a listening socket on each requested
host:port pair or UNIX socket.

.TP
.SH "OPTIONS"

.TP
\fB[host:port]\fR
Hostname and port to listen against. Host may be (IPv4/IPv6) IP or a resolvable
hostname. Hostnames are only looked up at startup and do not change for the
life of the process.
.TP
\fBunix:/path/to/socket\fR
Listen on local UNIX socket. Must have permission to create socket in
filesystem.
.TP
\fB\-f <file>\fR
Read Slurm configuration from the specified file. See \fBNOTES\fR below.
.TP
\fB\-g <group id>\fR
Change group id (and drop supplemental groups) before processing client
request. This should be a unique group with no write access or special
permissions. Do not set this user to SlurmUser or root.
.TP
\fB\-h\fR
Help; print a brief summary of command options.
.TP
\fB\-t <THREAD COUNT>\fR
Specify number of threads to use to process client connections.
Ignored in inetd mode. Default: 20
.TP
\fB\-u <user id>\fR
Change user id before processing client request. This should be a unique group
with no write access or special permissions. Do not set this user to SlurmUser
or root.
.TP
\fB\-v\fR
Verbose operation. Multiple \fB\-v\fR's increase verbosity.
Higher verbosity levels will have significant performance impact.
.TP
\fB\-V\fR
Print version information and exit.

.SH "ENVIRONMENT VARIABLES"
The following environment variables can be used to override settings
.RS
\fBslurmrestd\fR will shutdown cleanly.
.RE
.TP
\fBSIGPIPE\fR
This signal is explicitly ignored.

.SH "NOTES"
slurmrestd is designed to run with AuthAltTypes outside of the Munge cluster
when configured AuthAltTypes supports this.

.SH "COPYING"
Copyright (C) 2019-2020 SchedMD LLC.
.LP
This file is part of Slurm, a resource management program.
For details, see <https://slurm.schedmd.com/>.
.LP
Slurm is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your option)
any later version.
.LP
Slurm is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
details.

.SH "SEE ALSO"
\fBslurm.conf\fR(5), \fBslurmctld\fR(8), \fBslurmdbd\fR(8)

Man(1) output converted with man2html