1QOTD.CONF(5) System Manager's Manual QOTD.CONF(5)
2
3
4
6 qotd.conf - The QOTD daemon configuration file
7
9 /etc/qotd.conf
10
12 qotdd(8) reads configuration options from /etc/qotd.conf, or some other
13 file specified by the -c argument. This file contains lines of keyword-
14 arguments pairs, which describe how the daemon is to behave. Empty
15 lines or those starting with `#' are ignored and treated as comments.
16 Optionally, you can surround your arguments with single or double
17 quotes in order to represent arguments containing spaces. However you
18 cannot specify escape sequences inside the quotes.
19
20 The supported keywords and their possible meanings are as follows. Key‐
21 words and their arguments are case-insensitive, except for filenames.
22 Some options take a boolean, meaning you can write either `yes',
23 `true', or `1' to enable an option, or `no', `false', or `0' to disable
24 it.
25
26 TransportProtocol
27 Which transport protocol to use. This setting is either `udp' or
28 `tcp'. By default TCP is used.
29
30 InternetProtocol
31 Which IP protocol to use. This setting is either `ipv4', `ipv6',
32 or `both'. The default behavior is to listen on both IPv4 and
33 IPv6.
34
35 Port Specifies an alternate port to listen on. The default value is
36 `17', which is the port specified by RFC 865.
37
38 StrictChecking
39 When this option is enabled, the daemon will perform checks on
40 the permissions of files, and will refuse to start if the files
41 are writeable by those other than the calling user. This argu‐
42 ment is almost equivlent to the --lax argument, but obviously
43 does not apply to configuration file, since it must be read
44 before this option can be extracted. The default option is
45 `yes'.
46
47 DropPrivileges
48 Takes a boolean. If this option is set, then once a connection
49 is established, the program will drop privileges and run itself
50 as the daemon user. However, if PidFile is set, the daemon will
51 check the permissions on the directory of the containing direc‐
52 tory. If the program will lack the permissions to delete the pid
53 file, the daemon will quit. The default option is `yes'.
54
55 PidFile
56 Specifies what pid file is to be used by the daemon. If this
57 value is `none' or `/dev/null', then no pid file is written. The
58 default is /run/qotd.pid, but if there is no /run directory,
59 then /var/run/qotd.pid will be used instead.
60
61 RequirePidFile
62 If the daemon is unable to write to the pid file for any reason
63 and this option is set, then the daemon will quit. Otherwise,
64 the attempt to produce a pid file will be treated as an warning.
65 This setting is ignored if PidFile is set to `none'. This
66 option is a boolean, and the default argument is `yes'.
67
68 JournalFile
69 This option specifies what file the daemon uses to log status
70 messages. If this file is set to `-', then the program's stan‐
71 dard output is used, and if the value is set to `none' or
72 `/dev/null', then the journal output is suppressed. The default
73 behavior is to use standard output as the journal.
74
75 QuotesFile
76 The source of the quotations to be displayed to the user. Note
77 that any null bytes (`\0') found in the quotes file will be read
78 as spaces instead. The default is to use the pre-installed
79 quotes located at /usr/share/qotd/quotes.txt.
80
81 QuoteDivider
82 How quotes in the quotes file are separated. There are currently
83 three possible options: `line', `percent', or `file'. If the
84 value is `line', then each non-empty line is treated as a quota‐
85 tion to be possibly transmitted. If `percent' is set, then the
86 program is instructed to separate each quote with a line that
87 has only a percent sign (`%') on it. More specifically, the pro‐
88 gram looks for a sequence of newline, percent sign, and newline,
89 and separates the string there. This is the same format that is
90 used by fortune(6). If `file' is used, then the whole file is
91 treated as one quote. The default argument is `line'.
92
93 PadQuotes
94 Whether to place whitespace around the quotes to make them look
95 nicer. When this is disabled, the daemon will only transmit the
96 quotation itself. This option is a boolean, and the default
97 argument is `yes'.
98
99 DailyQuotes
100 Whether to choose a random quote every day, or for every visit.
101 If this option is set, then the same randomly-chosen quotation
102 will be provided for all visits on the same day. Otherwise, each
103 visit will yield a different quotation. This option is a bool‐
104 ean, and the default argument is `yes'.
105
106 AllowBigQuotes
107 RFC 865 specifies that quotes should be no bigger than 512
108 bytes. If this option is set, then this limit is ignored. Other‐
109 wise, quotes are automatically truncated to meet the byte limit.
110 The default behavior is to disable this option.
111
113 qotdd(8)
114
116 Ammon Smith (ammon.i.smith@gmail.com)
117
118
119
120qotd 0.11.1 2016-01-29 QOTD.CONF(5)