Server: Maximum comment size is limited (configurable)

[subauth.git] / etc / subauthd

diff --git a/etc/subauthd b/etc/subauthd
index 6f92259e3b0f08955cf65c9d73d5b22160712be2..8268151ddcbb8372a626fce43ea4083e6caee0ec 100644 (file)
--- a/etc/subauthd
+++ b/etc/subauthd
@@ -1,20 +1,64 @@
 SubauthD {
+       # Path to local socket over which clients communicate with the daemon
        SocketPath      @INSTALL_RUN_DIR@/subauthd.socket
-       MaxConnections  1000
+
+       # Path to database of users and accounts
        Database        @INSTALL_STATE_DIR@/subauthd.db
+
+       # An optional path to a key for signing temporary tokens.
+       # If it is defined, temporary tokens survive daemon restart. Otherwise,
+       # the daemon creates a new key on every startup.
        TempKeyFile     @INSTALL_STATE_DIR@/subauthd-temp-key
 
+       # Maximum number of simultaneous client connections
+       MaxConnections  1000
+
+       # Maximum packet size (default: 16k)
+       MaxPacketSize   16k
+
+       # Maximum size of a user comment (default: 100)
+       MaxCommentSize  100
+
+#ifndef CONFIG_LOCAL
+       # Log to a given stream (configured below)
+       LogStream       syslog
+#endif
+
+       # Authentication zones: each zone contains accounts for local users
+       # (at most one per user), zones are completely independent.
        Zone {
+               # Name of the zone
                Name            mail
+
+               # One-line description
                Description     E-mail
+
+               # Allow automatic creation of accounts: when a user tries to create
+               # a password/token in a zone where he has no account, the account is
+               # created. If turned off, all accounts must be created explicitly
+               # by the super-user.
                AutoCreateAcct  1
+
+               # Allow users to set a password
                AllowPasswd     1
+
+               # Allow users to create a token, set maximum number of tokens per user
                AllowTokens     16
+
+               # Allow users to create a temporary token, set maximum lifetime of such token
                MaxTempValidity 3600
        }
+}
+#ifndef CONFIG_LOCAL
 
-       Zone {
-               Name            web
-               AllowPasswd     1
+# Logging rules (see LibUCW documentation for full explanation)
+
+Logging {
+       Stream {
+               Name            syslog
+               SyslogFacility  auth
+               SyslogPID       0
+               Levels:remove   debug
        }
 }
+#endif