75 lines
2.5 KiB
Groff
75 lines
2.5 KiB
Groff
.\" 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),
|