X-Git-Url: http://gitweb.michael.orlitzky.com/?a=blobdiff_plain;f=doc%2Fhtsnrc.example;h=6ddcebeeafda540e27589a12deb9f1fc1cc539cc;hb=fdd40277556133bd14cf0a3f13749f4663b5f3ba;hp=0c265575f215adcacb351c3502aaf8be2fb53dd3;hpb=52e788e676ea2a67ad20b23d2e5c5b351f27b834;p=dead%2Fhtsn.git

diff --git a/doc/htsnrc.example b/doc/htsnrc.example
index 0c26557..6ddcebe 100644
--- a/doc/htsnrc.example
+++ b/doc/htsnrc.example
@@ -3,61 +3,98 @@
 # needs to go in %APPDATA%, or C:\Users\<username>\Application Data.
 
 
-# The username used to connect to the feed.
+# Run in the background as a daemon?
 #
-# Default: none (required)
+# Default: false
 #
-# username = "whoever"
+# daemonize = True
 
 
-# The password used to connect to the feed.
+# A list of hostnames that supply the feed. You probably don't need to
+# change this, but you can.
 #
-# Default: none (required)
+# Default: ["feed1.sportsnetwork.com",
+#           "feed2.sportsnetwork.com",
+#           "feed3.sportsnetwork.com"]
 #
-# password = "whatever"
+# feed-hosts = [ "hostname1", "hostname2", ... ]
 
 
-# By default, htsn will output the XML files to the current working
+# If you specify a file path here, logs will be written to it
+# (possibly in addition to syslog). Can be either a relative or
+# absolute path. It will not be auto-rotated; use something like
+# logrotate for that.
+#
+# Default: none
+#
+# log_file = /var/log/htsn/htsn.log
+
+
+# How verbose should the logs be? Valid levels are,
+#
+#   "INFO", "WARNING", "ERROR"
+#
+# (there are others, but we don't emit them.)
+#
+# Default: "INFO"
+#
+# log_level = "WARNING"
+
+
+# By default, XML files will be written to the current working
 # directory. Often this is not desirable, and you would rather save
 # them to a specific location. Specify it here.
 #
-# Default: "." (here)
+# Default: "."
 #
 # output-directory = "/var/lib/htsn"
 
 
-# A list of hostnames that supply the feed.
+# The password associated with your TSN username.
 #
-# Default: ["feed1.sportsnetwork.com",
-#           "feed2.sportsnetwork.com",
-#           "feed3.sportsnetwork.com"]
+# Default: none (required)
 #
-# feed-hosts = [ "hostname1", "hostname2", ... ]
+# password = "whatever"
 
 
-# Do you want to log to syslog? If so, the log_file option below will
-# be ignored. This will log to the event log on Windows.
+# (Daemon mode only) Create a PID file in the given location. This is
+# used by the init system on Unix to keep track of the running daemon.
 #
-# Default: True
+# Default: /run/htsn.pid
 #
-# syslog = False
+# pidfile = /var/run/htsn.pid
 
 
-# If syslog = False, which file should we use for a log? Can be either
-# a relative or absolute path. It will not be auto-rotated; use
-# something log logrotate for that.
+# (Daemon mode only) Run htsn as the specified system grup. The PID
+# file is written before privileges are dropped, so the only
+# privileges needed by htsn are those necessary to write the XML files
+# and (optionally) the log file.
 #
-# Default: htsn.log
+# Default: the current group
 #
-# log_file = /var/log/htsn/htsn.log
+# run-as-group = htsn
 
 
-# How verbose should the logs be? Valid levels are,
+# (Daemon mode only) Run htsn as the specified system user. The PID
+# file is written before privileges are dropped, so the only
+# privileges needed by htsn are those necessary to write the XML files
+# and (optionally) the log file.
 #
-#   "INFO", "WARNING", "ERROR"
+# Default: the current user
 #
-# (there are others, but we don't emit them.)
+# run-as-user = htsn
+
+# Do you want to log to syslog? On Windows this will attempt to
+# communicate (over UDP) with a syslog daemon on localhost, which will
+# most likely not work.
 #
-# Default: "INFO"
+# Default: False
 #
-# log_level = "WARNING"
+# syslog = True
+
+
+# The username used to connect to the feed.
+#
+# Default: none (required)
+#
+# username = "whoever"