~ubuntu-branches/ubuntu/precise/netatalk/precise

« back to all changes in this revision

Viewing changes to config/afpd.conf.tmpl

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Rittau
  • Date: 2004-01-19 12:43:49 UTC
  • Revision ID: james.westby@ubuntu.com-20040119124349-es563jbp0hk0ae51
Tags: upstream-1.6.4
ImportĀ upstreamĀ versionĀ 1.6.4

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
#
 
2
# CONFIGURATION FOR AFPD
 
3
#
 
4
# Each line defines a virtual server that should be available.
 
5
# Empty lines and lines beginning with `#' are ignored.
 
6
# Options in this file will override both compiled-in defaults
 
7
# and command line options.
 
8
#
 
9
# Format:
 
10
#  - [options]                to specify options for the default server
 
11
#  "Server name" [options]   to specify an additional server
 
12
#
 
13
# The following options are available:
 
14
#   Transport Protocols:
 
15
#     -[no]tcp       Make AFP-over-TCP [not] available
 
16
#     -[no]ddp       Make AFP over AppleTalk [not] available. if you
 
17
#                    have -proxy specified, specify -uamlist "" to 
 
18
#                    prevent ddp connections from working.
 
19
#
 
20
#     -transall      Make both available (default)
 
21
#
 
22
#   Transport Options:
 
23
#     -ipaddr <w.x.y.z>   Specifies the IP address the server should respond
 
24
#                         to (default is the first IP address of the system)
 
25
#                         This option also allows one machine to advertise
 
26
#                         TCP/IP for another machine.
 
27
#     -server_quantum <number> 
 
28
#                         Specifies the DSI server quantum. The minimum
 
29
#                         value is 1MB. The max value is 0xFFFFFFFF. If you 
 
30
#                         specify a value that is out of range, you'll get 
 
31
#                         the default value (currently the minimum).
 
32
#     -admingroup <groupname>
 
33
#                         Specifies the group of administrators who should all
 
34
#                         be seen as the superuser when they log in.  Default
 
35
#                         is disabled.
 
36
#     -ddpaddr x.y        Specifies the DDP address of the server. the 
 
37
#                         default is to auto-assign an address
 
38
#                         (0.0). this is only useful if you're running
 
39
#                         on a multihomed host.
 
40
#     -port <number>      Specifies the TCP port the server should respond
 
41
#                         to (default is 548)
 
42
#     -fqdn <name:port>   specify a fully-qualified domain name (+
 
43
#                         optional port). this gets discarded if the
 
44
#                         server can't resolve it. this is not honored
 
45
#                         by appleshare clients <= 3.8.3 (default: none)
 
46
#     -proxy              Run an AppleTalk proxy server for specified AFP/TCP
 
47
#                         server (if address/port aren't given, then
 
48
#                         first IP address of the system/548 will be used).
 
49
#                         if you don't want the proxy server to act as
 
50
#                         a ddp server as well, set -uamlist to an
 
51
#                         empty string.
 
52
#     -noslp              Don't register this server with the Service
 
53
#                         Location Protocol.
 
54
#
 
55
#
 
56
#   Authentication Methods:
 
57
#     -uampath <path>  Use this path to look for User Authentication Modules.
 
58
#                      (default: :UAMS_PATH:)
 
59
#     -uamlist <a,b,c> Comma-separated list of UAMs. (default:
 
60
#                      uams_guest.so,uams_clrtxt.so,uams_dhx.so) 
 
61
#
 
62
#                      some commonly available UAMs:
 
63
#                      uams_guest.so: Allow guest logins
 
64
#
 
65
#                      uams_clrtxt.so: (uams_pam.so or uams_passwd.so)
 
66
#                                     Allow logins with passwords
 
67
#                                     transmitted in the clear. 
 
68
#
 
69
#                      uams_randnum.so: Allow Random Number and Two-Way
 
70
#                                      Random Number exchange for
 
71
#                                      authentication.
 
72
#
 
73
#                      uams_dhx.so: (uams_dhx_pam.so or uams_dhx_passwd.so)
 
74
#                                   Allow Diffie-Hellman eXchange
 
75
#                                   (DHX) for authentication.
 
76
#
 
77
#   Password Options:
 
78
#     -[no]savepassword   [Don't] Allow clients to save password locally
 
79
#     -passwdfile <path>  Use this path to store Randnum
 
80
#                         passwords. (Default: :ETCDIR:/afppasswd. The only
 
81
#                         other useful value is ~/.passwd. See 'man afppasswd'
 
82
#                         for details.)
 
83
#     -passwdminlen <#>   minimum password length. may be ignored.
 
84
#     -[no]setpassword    [Don't] Allow clients to change their passwords.
 
85
#     -loginmaxfail <#>   maximum number of failed logins. this may be
 
86
#                         ignored if the uam can't handle it.
 
87
#
 
88
#   AppleVolumes files:
 
89
#     -defaultvol <path>  Specifies path to AppleVolumes.default file
 
90
#                         (default :ETCDIR:/AppleVolumes.default,
 
91
#                         same as -f on command line)
 
92
#     -systemvol <path>   Specifies path to AppleVolumes.system file
 
93
#                         (default :ETCDIR:/AppleVolumes.system,
 
94
#                         same as -s on command line)
 
95
#     -[no]uservolfirst   [Don't] read the user's ~/AppleVolumes or
 
96
#                         ~/.AppleVolumes before reading
 
97
#                         :ETCDIR:/AppleVolumes.default
 
98
#                         (same as -u on command line)
 
99
#     -[no]uservol        [Don't] Read the user's volume file
 
100
#
 
101
#     -nlspath <path>     Prepend this path to each code page filename
 
102
#                         in volume options (default: :NLS_PATH:).
 
103
#
 
104
#   Miscellaneous:
 
105
#     -authprintdir <path> Specifies the path to be used (per server) to 
 
106
#                          store the files required to do CAP-style
 
107
#                          print authentication which papd will examine
 
108
#                          to determine if a print job should be allowed.
 
109
#                          These files are created at login and if they
 
110
#                          are to be properly removed, this directory
 
111
#                          probably needs to be umode 1777
 
112
#     -guestname "user"   Specifies the user name for the guest login
 
113
#                         (default "nobody", same as -g on command line)
 
114
#     -loginmesg "Message"  Client will display "Message" upon logging in
 
115
#                         (no default, same as -l "Message" on commandline)
 
116
#     -nodebug            Switch off debugging
 
117
#     -client_polling     With this switch enabled, afpd won't advertise
 
118
#                         that it is capable of server notifications, so that
 
119
#                         connected clients poll the server every 10 seconds
 
120
#                         to detect changes in opened server windows.
 
121
#                         Note: Depending on the number of simultaneously
 
122
#                         connected clients and the network's speed, this can
 
123
#                         lead to a significant higher load on your network!
 
124
#     -tickleval <number> Specify the tickle timeout interval (in seconds).
 
125
#                         Note, this defaults to 30 seconds, and really 
 
126
#                         shouldn't be changed.  If you want to control
 
127
#                         the server idle timeout, use the -timeout option.
 
128
#     -timeout <number>   Specify the number of tickles to send before
 
129
#                         timing out a connection.  The default is 4, therefore
 
130
#                         a connection will timeout in 2 minutes.
 
131
#     -icon               Use the platform-specific icon.
 
132
#     -[un]setuplog "<logtype> <loglevel> [<filename>]"
 
133
#                         Specify that the given loglevel should be applied
 
134
#                         to log messages of the given logtype and that 
 
135
#                         these messages should be logged to the given file.
 
136
#                         If the filename is ommited the loglevel applies to 
 
137
#                         messages passed to syslog.  
 
138
#                         Each logtype may have a loglevel applied to syslog 
 
139
#                         and a loglevel applied to a single file.  Latter
 
140
#                         -setuplog settings will override earlier ones of
 
141
#                         the same logtype (file or syslog).
 
142
#                         logtypes:  Default, Core, Logger, CNID, AFPDaemon
 
143
#                         loglevels: LOG_SEVERE, LOG_ERROR, LOG_WARN, LOG_NOTE,
 
144
#                                    LOG_INFO, LOG_DEBUG, LOG_DEBUG6, LOG_DEBUG7, 
 
145
#                                    LOG_DEBUG8, LOG_DEBUG9, LOG_MAXDEBUG
 
146
#
 
147
#                         for example:
 
148
#                    -setuplog "logger log_maxdebug /var/log/netatalk-logger.log"
 
149
#                    -setuplog "afpdaemon log_maxdebug /var/log/netatalk-afp.log"
 
150
#                    -unsetuplog "default level file" 
 
151
#                    -setuplog "default log_maxdebug"
 
152
 
 
153
#               
 
154
# Some examples:
 
155
#
 
156
#       The simplest case is to not have an afpd.conf.
 
157
#
 
158
#       4 servers w/ names server1-3 and one w/ the hostname. servers
 
159
#       1-3 get routed to different ports with server 3 being bound 
 
160
#       specifically to address 192.168.1.3
 
161
#               -
 
162
#               server1 -port 12000
 
163
#               server2 -port 12001
 
164
#               server3 -port 12002 -ipaddr 192.168.1.3
 
165
#
 
166
#       a dedicated guest server, a user server, and a special
 
167
#       ddp-only server:
 
168
#               "Guest Volume" -uamlist uams_guest.so -loginmesg "Welcome guest!"
 
169
#               "User Volume" -uamlist uams_clrtxt.so -port 12000
 
170
#               "special" -notcp -defaultvol <path> -systemvol <path>
 
171
#
 
172
# default:
 
173
# - -transall -uamlist uams_clrtxt.so,uams_dhx.so -nosavepassword