- Large set of changes for config editing, rsync hardlinks etc
[BackupPC.git] / conf / hosts
index 5107955..8484e8b 100644 (file)
 #
 #     - The host name.  If this host is a static IP address this
 #       must the machine's IP host name (ie: something that can
-#       be looked up using nslookup or DSN).  If this is a DHCP
+#       be looked up using nslookup or DNS).  If this is a DHCP
 #       host then the host name must be the netbios name of the
-#       machine.
+#       machine.  It is possible to have a host name that contains
+#       spaces, but that is discouraged.  Escape a space with "\", eg:
 #
-#     - DHCP flag.  Set to 0 if this is a static IP address host.
-#       Otherwise, set to 1 for DHCP hosts.
+#                craigs\ pc
+#
+#     - DHCP flag.  Set to 0 if this is a static IP address host
+#       or if the machine can be found using nmblookup.  Otherwise,
+#       if the client can only be found by looking through the DHCP
+#       pool then set this to 1.
 #
 #     - User name (unix login/email name) of the user who "owns"
 #       or uses this machine.  This is the user who will be sent
 #       email about this machine, and this user will have permission
-#       to stop/start/browse/restore backups for this host.
+#       to stop/start/browse/restore backups for this host.  This
+#       user name must match the name the user authenticates with
+#       via apache.
+#
+#     - Optional additional user names (comma separated, no white space) of
+#       users who are also allowed to stop/start/browse/restore backups
+#       for this client via the CGI interface.  These users are not sent
+#       email.  These do not need to be valid email names; they simply
+#       need to match the name the user authenticates with via apache.
 #
 # AUTHOR
 #   Craig Barratt  <craig@arraycomm.com>
@@ -35,8 +48,9 @@
 #========================================================================
 
 #
-# The first non-comment line gives the field names and should not be edited!!
+# The first non-comment non-empty line gives the field names and should
+# not be edited!!
 #
-host        dhcp    user     # <--- do not edit this line
-#farside    0       craig    # <--- example static IP host entry
-#larson     1       bill     # <--- example DHCP host entry
+host        dhcp    user    moreUsers     # <--- do not edit this line
+#farside    0       craig   jill,jeff     # <--- example static IP host entry
+#larson     1       bill                  # <--- example DHCP host entry