]> gitweb.michael.orlitzky.com - dead/htsn.git/blob - doc/htsnrc.example
Update pidfile documentation.
[dead/htsn.git] / doc / htsnrc.example
1 # Example configuration file for htsn. For this to take effect, you
2 # would need to place it in either the user or global configuration
3 # directories.
4 #
5 # For a user, that's either $HOME/.htsnrc on Unix or
6 # %APPDATA%\.htsnrc (e.g. C:\Users\<username>\Application
7 # Data\.htsnrc) on Windows.
8 #
9 # The global configuration directory is determined by Cabal. The
10 # "sysconfdir" parameter during the "configure" step will be used. On
11 # Unix, it's probably /etc, and this file will need to go in
12 # /etc/htsnrc.
13
14 # Run in the background as a daemon?
15 #
16 # Default: false
17 #
18 # daemonize = true
19
20
21 # A list of hostnames that supply the feed. You probably don't need to
22 # change this, but you can.
23 #
24 # Default: ["feed1.sportsnetwork.com",
25 # "feed2.sportsnetwork.com",
26 # "feed3.sportsnetwork.com"]
27 #
28 # feed_hosts = [ "hostname1", "hostname2", ... ]
29
30
31 # If you specify a file path here, logs will be written to it
32 # (possibly in addition to syslog). Can be either a relative or
33 # absolute path. It will not be auto-rotated; use something like
34 # logrotate for that.
35 #
36 # Default: none
37 #
38 # log_file = "/var/log/htsn/htsn.log"
39
40
41 # How verbose should the logs be? Valid levels are,
42 #
43 # "INFO", "WARNING", "ERROR"
44 #
45 # (there are others, but we don't emit them.)
46 #
47 # Default: "INFO"
48 #
49 # log_level = "WARNING"
50
51
52 # By default, XML files will be written to the current working
53 # directory. Often this is not desirable, and you would rather save
54 # them to a specific location. Specify it here.
55 #
56 # Default: "."
57 #
58 # output_directory = "/var/lib/htsn"
59
60
61 # The password associated with your TSN username.
62 #
63 # Default: none (required)
64 #
65 # password = "whatever"
66
67
68 # (Daemon mode only) Create a PID file in the given location. This is
69 # used by the init system on Unix to keep track of the running
70 # daemon.
71 #
72 # If necessary, its parent directory will be created with owner/group
73 # set to the appropriate user/group, but at most one directory will be
74 # created (that is, we won't create an entire directory tree).
75 #
76 # Default: /run/htsn/htsn.pid
77 #
78 # pidfile = /var/run/htsn/htsn.pid
79
80
81 # (Daemon mode only) Run htsn as the specified system grup. The PID
82 # file is written before privileges are dropped, so the only
83 # privileges needed by htsn are those necessary to write the XML files
84 # and (optionally) the log file.
85 #
86 # Default: the current group
87 #
88 # run_as_group = "htsn"
89
90
91 # (Daemon mode only) Run htsn as the specified system user. The PID
92 # file is written before privileges are dropped, so the only
93 # privileges needed by htsn are those necessary to write the XML files
94 # and (optionally) the log file.
95 #
96 # Default: the current user
97 #
98 # run_as_user = "htsn"
99
100 # Do you want to log to syslog? On Windows this will attempt to
101 # communicate (over UDP) with a syslog daemon on localhost, which will
102 # most likely not work.
103 #
104 # Default: false
105 #
106 # syslog = true
107
108
109 # The username used to connect to the feed.
110 #
111 # Default: none (required)
112 #
113 # username = "whoever"