.TH taskd 5 2015-05-10 "${PACKAGE_STRING}" "User Manuals"

.SH NAME
taskdrc \- Configuration details for the taskd(1) server

.SH CONFIGURATION VARIABLES

Valid variable names and their default values are:

.TP
.B ca.cert
Fully qualified path to the CA certificate.  Optional.

.TP
.B ciphers
List of GnuTLS ciphers to use.  Default is "NORMAL".  See your GnuTLS
documentation for full details.

.TP
.B confirmation=on
Determines whether certain commands are confirmed.  Defaults to on.

.TP
.B client.cert
Fully qualified path of the client cert.  This is used by the 'client' command.

.TP
.B debug=off
Logs debugging information.

.TP
.B debug.tls=0
GnuTLS log level, an integer from 0 to 9, where 0 means no logging, and 9
means sensitive data leaks.  Caution!

.TP
.B extensions=<path>
Fully qualified path of the Taskserver extension scripts.  Currently there are
none.

.TP
.B family=IPv4
Specifies the address family to use.  Can be 'IPv4', 'IPv6', or not specified
which means 'any'.  Default is no value.

.TP
.B ip.log=on
Logs the IP addresses of incoming requests.

.TP
.B log=/tmp/taskd.log
Fully-qualified path name to the Taskserver log file.  Alternately, specifying
the value '-' will cause all logging to go to STDOUT.  This does not apply when
the server is run as a daemon.

.TP
.B pid.file=/tmp/taskd.pid
Fully-qualified path name to the Taskserver PID file.  This is used by
the 'taskdctl' script to start/stop the daemon.

.TP
.B queue.size=10
Size of the connection backlog.  See 'man listen'.

.TP
.B request.limit=1048576
Size limit of incoming requests, in bytes.  Use a value of zero '0' to indicate
no size limit.

.TP
.B server=localhost:53589
The address (IPv4, IPv6 or DNS) of the Taskserver, followed by a colon and the
port number.

.TP
.B server.cert
Fully qualified path to the server certificate.

.TP
.B server.crl
Fully qualified path to the server certificate revocation list.

.TP
.B server.key
Fully qualified path to the server key.

.TP
.B trust
Trust level of the server, which determines how the client certificates are
verified.  If the value is 'allow all' then no verification is performed.
Defaults to 'strict'.

Note that sending the HUP signal to the Taskserver causes a configuration
file reload before the next request is handled.

.SH ENVIRONMENT VARIABLES

Environment variables provide values that would otherwise be required at the
command line.

.TP
.B TASKDDATA=<root>
Most command require either '\-\-data <root>' or this environment variable.  If
both are provided, the command line overrides the environment.

.SH "CREDITS & COPYRIGHTS"
Copyright (C) 2012 \- 2015, Göteborg Bit Factory.

Taskserver is distributed under the MIT license. See
http://www.opensource.org/licenses/mit-license.php for more information.

.SH SEE ALSO
.BR taskd(1), taskdctl(1)

For more information regarding Taskserver, see the following:

.TP
The official site at
<http://taskwarrior.org>

.TP
The official code repository at
<https://git.tasktools.org/scm/tm/taskd.git>

.TP
You can contact the project by emailing
<support@taskwarrior.org>

.SH REPORTING BUGS
.TP
Bugs in Taskserver may be reported to the issue-tracker at
<http://taskwarrior.org

