1QOTD.CONF(5)                System Manager's Manual               QOTD.CONF(5)
2
3
4

NAME

6       qotd.conf - The QOTD daemon configuration file
7

SYNOPSIS

9       /etc/qotd.conf
10

DESCRIPTION

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

SEE ALSO

113       qotdd(8)
114

AUTHOR

116       Ammon Smith (ammon.i.smith@gmail.com)
117
118
119
120qotd 0.11.1                       2016-01-29                      QOTD.CONF(5)
Impressum