.\" $HeadURL: http://dione.no-ip.org/svn/ade/tags/1.7.1/lib/templates/rsd/man/rsd.1 $ $LastChangedRevision: 4972 $
.\"
.pso ade-config --format=man
.so \*[ade_include_prefix]/ade.man
.pso rsd-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,...\fR]
|
.B \-\-resources=\fIresource\fB:\fIamount\fR[\fB,...\fR]
]
.br
.ne 5
.SH DESCRIPTION
.B Jsd
is a very simple job scheduler daemon. It "manages" an
arbitrary set of system resources (e.g. RAM, cores, 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,...\fR], \fB\-\-resources=\fIresource\fB:\fIamount\fR[\fB,...\fR]
Specifies the resources and the amounts of each of them that
are initially available on the system.
.I resource
must adhere to the usual definition of a word; 
.I amount 
must be an integer.
It is an error for no resources to be specified.
.br
.ne 5
.SH EXIT STATUS
On success
.B rsd
returns zero. On failure it returns non-zero and displays a diagnostic
message.
.br
.ne 5
.SH FILES
.TP
.B /tmp/rsd-\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).
.br
.ne 5
.SH EXAMPLES
This command manages some standard resources:
.IP
.nf
.fam C
.B jsd --resources=ram:$(head -1 /proc/meminfo | awk '{ print $2 }'),cores:$(grep -c '^processor' /proc/cpuinfo),fsfree:$(df /tmp/ | xargs echo | awk '{ print $11 }')
.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 submitted job can be executed
without exceeding the specified maximum available amounts of all
resources then it executes that job.
See also the
.B CAVEATS
section of
.B jss\fR(1).
.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), jsq(1), jss(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]