Added mans, edited readme

sources/queued.1

@@ -0,0 +1,76 @@
+.TH queued 1  "December 24, 2013" "version 1.1.0" "USER COMMANDS"
+.SH NAME
+queued - daemon for starting jobs to queue of calculations
+.SH SYNOPSIS
+.B queued
+[ -c /etc/queued.conf ] [ -v | --version ] [ -h | --help ]
+.SH DESCRIPTION
+.B queued
+is a simple daemon written on BASH for starting jobs to queue of calculations in the background.
+.SH OPTIONS
+.TP
+-c /etc/queued.conf
+Full path to configuration file. Default is '/etc/queued.conf'.
+.TP
+-h, --help
+Show help and exit.
+.TP
+-v, --version
+Show version and exit.
+.SH FILES
+.TP
+/usr/lib/systemd/system/queued.service
+Systemd service file.
+.TP
+/etc/queued.conf
+Configuration file.
+.SH EXAMPLES
+.TP
+# systemctl start queued.service
+Start daemon with parameters that are described in configuration file.
+.TP
+# systemctl enable queued.service
+Enable daemon autostart.
+.SH USAGE WITH SYSTEMD
+If you need change path to configuration file, copy standart service file to /etc directory:
+.PP
+.nf
+# cp /usr/lib/systemd/system/queued.service /etc/systemd/system/queued-my-profile.service
+.fi
+.PP
+Then replace path to configuration file to your option. For example,
+.PP
+.B from:
+.nf
+ExecStart=/usr/bin/queued
+.fi
+.B to
+.nf
+ExecStart=/usr/bin/queued -c /path/to/new/queued.conf
+.fi
+.PP
+Copy configuration file and edit it:
+.PP
+.nf
+# cp /etc/queued.conf /path/to/new/queued.conf
+# $EDITOR /path/to/new/queued.conf
+.fi
+.PP
+Then start service:
+.PP
+.nf
+# systemctl start queued-my-profile.service
+.fi
+.SH ERRORS
+Use
+.B journalctl
+to determine errors:
+.nf
+  [II] - information string
+  [WW] - warning
+  [EE] - error
+.fi
+.SH SEE ALSO
+.BR queued.conf (5)
+.SH AUTHOR
+Evgeniy Alexeev aka arcanis <\fIesalexeev@gmail.com\fR>

sources/queued.conf.5

@@ -0,0 +1,44 @@
+.TH queued.conf 5
+.SH NAME
+queued.conf - queued configuration file
+.SH SYNOPSIS
+/etc/queued.conf
+.SH DESCRIPTION
+This file configures various parameters of 
+.BR queued (1).
+.SH OPTIONS
+.TP
+.I WORKDIR=
+Full path to directory with source jobs. Default is
+.B /var/lib/queued/work.
+This directory must contain source scripts
+.B script-name
+, a priority file (it is not necessary)
+.B script-name.pr
+and a file with username (it is not necessary too)
+.B script-name.user.
+.TP
+.I JOBDIR=
+Full path to directory with running jobs. Default is
+.B /var/lib/queued/job.
+All job files will be moved here.
+.TP
+.I QUEUEFILE=
+Full path to file with queue list. Default is
+.B /var/lib/queued/queue.
+.TP
+.I PRIORITY=
+Default priority. Default is
+.B 0.
+The higher the value, the higher the priority of the task
+.TP
+.I SLEEPTIME=
+Time interval in minutes. Default is
+.B 5.
+.TP
+.I STARTASUSER=
+Default user. Default is
+.B root.
+This user will own created files.
+.SH SEE ALSO
+.BR queued (1)