.\" $HeadURL$ $LastChangedRevision$
.\" vim: filetype=nroff
.\"
.TH JSD 1 "ADE_APP_TOKEN_RELEASE_DATE_MAN"
.SH NAME
jsd \- job scheduler daemon
.br
.ne 5
.SH SYNOPSIS
.B jsd
\*[ade_standard_synopsis_component]
[
.B \-r
.I res\fB:\fIqty\fR[\fB,...\fR]
|
.B \-\-resources=\fIres\fB:\fIqty\fR[\fB,...\fR]
]
[
.B \-\-suspend
]
.br
.ne 5
.SH DESCRIPTION
.B Jsd
is a very simple job scheduler daemon. It "manages" an
arbitrary set of system resources (e.g. memory, CPUs, disk space) 
and executes jobs that have been submitted (see
.B jss\fR(1))
when their demand for resources can be met.
.br
.ne 5
.SH CONFIGURATION
None
.br
.ne 5
.SH OPTIONS
\*[ade_standard_options_component]
.TP
.B \-r \fIres\fB:\fIqty\fR[\fB,...\fR], \fB\-\-resources=\fIres\fB:\fIqty\fR[\fB,...\fR]
Specifies the names of the resources and the quantities of each of them initially available.
.I res
must adhere to the usual definition of a word; 
.I qty 
must be an integer.
It is an error for no resources to be specified.
.TP
.B \-\-suspend
Start 
.B jsd
with the scheduler suspended. See 
.B jsc\fR(1)'s 
.B suspend 
and
.B resume 
commands for more information.
.br
.ne 5
.SH EXIT STATUS
On success
.B jsd
returns zero. On failure it returns non-zero and displays a diagnostic
message.
.br
.ne 5
.SH FILES
None.
.br
.ne 5
.SH ENVIRONMENT VARIABLES
.TP 25
.B JS_NAME\fR or \fBLOGNAME
If
.B JS_NAME
is set then it is used to set the name of the instance of
.B jsd\fR(1).
If that is not set then
.B LOGNAME
is used instead.
If that is also not set then an error occurs.
.TP
.B JS_\fIres\fB_AFFINITY
Set to the specific resources that have been allocated, e.g.:
.IP
.nf
.fam C
.B JS_CPU_AFFINITY=0-3,16-19
.fam T
.fi
.TP
.B JS_\fIres\fB_LIMIT
Set to the count of resources that have been allocated, e.g.:
.IP
.nf
.fam C
.B JS_CPU_LIMIT=8
.fam T
.fi
.br
.ne 5
.SH EXAMPLES
This command manages some standard resources:
.IP
.nf
.fam C
.B MEM=$(head -1 /proc/meminfo | awk '{ print $2 }')
.B CPU=$(grep -c '^processor' /proc/cpuinfo)
.B jsd --resources=mem:$MEM,cpu:$CPU
.fam T
.fi
.PP
This command manages some considerably less standard resources:
.IP
.nf
.fam C
.B jsd --resources=alexis:1,suzie:1,peter:1,jane:1
.fam T
.fi
.br
.ne 5
.SH CAVEATS
.B Jsd
has no understanding of resource types; it simply
maintains a list of the quantity of each resource that currently
executing jobs are consuming and if a job can be executed
without exceeding the specified maximum available quantities of all
resources, then it runs that job.
See also the
.B CAVEATS
section of
.B jss\fR(1).
.PP
Affinity is enforced through 
.B jsd\fR's
use of
.B js\-shepherd\fR. 
.B js\-shepherd\fR
is currently not documented.
.br
.ne 5
.SH STANDARDS
This manual page documents version ADE_APP_TOKEN_RELEASE_ID of
.B jsd\fR.
.br
.ne 5
.SH SEE ALSO
js-config(1), jsc(1), jsq(1), jss(1), taskset(1)
.br
.ne 5
.SH AUTHOR
ADE_APP_TOKEN_AUTHOR_NAME <ADE_APP_TOKEN_AUTHOR_EMAIL>
.br
.ne 5
.SH COPYRIGHT & DISTRIBUTION POLICY
Copyright (C) 2015-ADE_APP_TOKEN_RELEASE_YEAR ADE_APP_TOKEN_AUTHOR_NAME
\*[ade_standard_copyright_component]