.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
.TH TLSDATED 5 "JANUARY 2013" "File Formats and Conversions"
.SH NAME
tlsdated.conf \- tlsdated config file
.SH SYNTAX
\fBtlsdated.conf\fR is the configuration file for the \fBtlsdated(8)\fR daemon.
The config file is formatted as a list of key-value pairs, one per line,
separated by whitespace. Whitespace inside values is preserved, so
.RS
foo   bar baz quxx
.RE
represents the key \fBfoo\fR mapping to the value \fBbar baz quxx\fR. Empty
lines and lines beginning with \fB#\fR are ignored; leading whitespace on lines
is stripped. For boolean options, the value \fByes\fR or no value at all
indicates that the option should be switched on, and all other values indicate
that the option should be switched off. \fINote that trailing whitespace is
preserved in values.\fR
.SH OPTIONS
.IP "base-path [string]"
Sets the path to tlsdated's cache directory.
.IP "dry-run [bool]"
If enabled, don't actually adjust the system time.
.IP "jitter [int]"
Add or subtract up to this many seconds from the steady-state interval when
checking. This helps prevent correlation between sequential checks and smooth
load on time hosts.
.IP "max-tries [int]"
How many times to try running the tlsdate subprocess.
.IP "min-steady-state-interval [int]"
Do not check more than once this many seconds when in steady state.
.IP "should-load-disk [bool]"
If enabled, try loading the current timestamp out of the cache directory.
.IP "should-netlink [bool]"
If enabled, use a netlink socket to get network events; otherwise, read network
events from stdin.
.IP "should-save-disk [bool]"
If enabled, save the current timestamp to the cache directory every so often and
at exit.
.IP "should-sync-hwclock [bool]"
If enabled, set the hwclock to the fetched time.
.IP "steady-state-interval [int]"
Check at least once this many seconds when in steady state.
.IP "subprocess-timeout [int]"
How many seconds to wait for the subprocess to exit.
.IP "verbose [bool]"
If enabled, tlsdated will be annoyingly verbose in syslog and on stdout.
.IP "wait-between-tries [int]"
How long to wait between runs of the subprocess.
.SH SOURCES
You can list one or more sources to fetch time from. The format of these is:
.RS 4
source
.RS 4
host www.example.com
.br
port 443
.br
proxy socks5://127.0.0.1:9050
.RE
end
.RE
.SH BUGS
It's likely! Let us know by contacting jacob@appelbaum.net

Note that
.B tlsdated(8)
is in Beta, and may not work as expected.
.SH AUTHOR
Jacob Appelbaum <jacob at appelbaum dot net>
.SH "SEE ALSO"
.B tlsdate(1),
.B tlsdate-helper(1),
.B tlsdated(8),