.\" $HeadURL$ $LastChangedRevision$
.\"
.pso ade-config --format=man
.so \*[ade_include_prefix]/ade.man
.pso js-config --format=man
.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 \-l 
.I file
|
.B \-\-lockfile=\fIfile\fR
]
[
.B \-r
.I resource\fB:\fIamount\fR[\fB:\fIaffinousness\fR][\fB,...\fR]
|
.B \-\-resources=\fIresource\fB:\fIamount\fR[\fB:\fIaffinousness\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 \-l \fIfile\fR, \fB\-\-lockfile=\fIfile
Sets the location of
.B jsd\fR's
lockfile. See also
.B ENVIRONMENT 
below.
.TP
.B \-r \fIresource\fB:\fIamount\fR[\fB:\fIaffinousness\fR][\fB,...\fR], \fB\-\-resources=\fIresource\fB:\fIamount\fR[\fB:\fIaffinousness\fR][\fB,...\fR]
Specifies the names of the resources, the amounts of each of them initially available and whether jobs wish to be told via environment variables (see below) which resources they are to use.
.I resource
must adhere to the usual definition of a word; 
.I amount 
must be an integer;
.I affinousness
must be a logical (i.e. one of
\fBtrue\fR, \fBfalse\fR, \fBt\fR, \fBf\fR, \fByes\fR, \fBno\fR, \fBy\fR, \fBn\fR, \fB1 \fRor \fB0\fR).
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
.TP
.B /tmp/jsd-\fIusername\fB.lock
.B Jsd\fR's
lockfile
.br
.ne 5
.SH ENVIRONMENT VARIABLES
.TP 25
.B JSD_LOCKFILE
May be set to overrule the default lockfile location (see 
.B FILES
above).
.TP
.B JS_\fIresource\fB_AFFINITY
For affinous resources, this is set to the specific resources that have been allocated, e.g.:
.IP
.nf
.fam C
.B JS_CPU_AFFINITY=0,1,2,3,16,17,18,19
.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:y
.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 amount of each resource that currently
executing jobs are consuming and if a job can be executed
without exceeding the specified maximum available amounts of all
resources, then it runs that job.
See also the
.B CAVEATS
section of
.B jss\fR(1).
.PP
Currently, affinity is not enforced, although the related 
environment variables are set in a job's execution environment.
.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]