man/man5/afpd.conf.5.tmpl

   1 '\" t
   2 .\"     Title: afpd.conf
   3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
   5 .\"      Date: 15 Aug 2011
   6 .\"    Manual: Netatalk 2.2
   7 .\"    Source: Netatalk 2.2
   8 .\"  Language: English
   9 .\"
  10 .TH "AFPD\&.CONF" "5" "15 Aug 2011" "Netatalk 2.2" "Netatalk 2.2"
  11 .\" -----------------------------------------------------------------
  12 .\" * set default formatting
  13 .\" -----------------------------------------------------------------
  14 .\" disable hyphenation
  15 .nh
  16 .\" disable justification (adjust text to left margin only)
  17 .ad l
  18 .\" -----------------------------------------------------------------
  19 .\" * MAIN CONTENT STARTS HERE *
  20 .\" -----------------------------------------------------------------
  21 .SH "NAME"
  22 afpd.conf \- Configuration file used by afpd(8) to determine the setup of its file sharing services
  23 .SH "DESCRIPTION"
  24 .PP
  25 :ETCDIR:/afpd\&.conf
  26 is the configuration file used by
  27 \fBafpd\fR
  28 to determine the behavior and configuration of the different virtual file servers that it provides\&.
  29 .PP
  30 Any line not prefixed with # is interpreted\&. The configuration lines are composed like: server name [ options ] If a
  31 \fB\-\fR
  32 is used instead of a server name, the default server is specified\&. Server names must be quoted if they contain spaces\&. They must not contain ":" or "@"\&. The path name must be a fully qualified path name, or a path name using either the ~ shell shorthand or any of the substitution variables, which are listed below\&.
  33 .PP
  34 .if n \{\
  35 .sp
  36 .\}
  37 .RS 4
  38 .it 1 an-trap
  39 .nr an-no-space-flag 1
  40 .nr an-break-flag 1
  41 .br
  42 .ps +1
  43 \fBNote\fR
  44 .ps -1
  45 .br
  46 .PP
  47 Each server has to be configured on a
  48 \fBsingle\fR
  49 line\&. Though, using "\e" character, newline escaping is supported\&.
  50 .sp .5v
  51 .RE
  52 The possible options and their meanings are:
  53 .SH "APPLEVOLUMES FILES"
  54 .PP
  55 \-defaultvol \fI[path]\fR
  56 .RS 4
  57 Specifies path to AppleVolumes\&.default file (default is
  58 :ETCDIR:/AppleVolumes\&.default)\&.
  59 .RE
  60 .PP
  61 \-systemvol \fI[path]\fR
  62 .RS 4
  63 Specifies path to AppleVolumes\&.system file (default is
  64 :ETCDIR:/AppleVolumes\&.system)\&.
  65 .RE
  66 .PP
  67 \-[no]uservol
  68 .RS 4
  69 Enables or disables reading of the users\' individual volumes file entirely\&.
  70 .RE
  71 .PP
  72 \-[no]uservolfirst
  73 .RS 4
  74 Enables or disables reading of the users\' individual volumes file before processing the global
  75 AppleVolumes\&.default
  76 file\&.
  77 .RE
  78 .SH "AUTHENTICATION METHODS"
  79 .PP
  80 \-uamlist \fI[uams list]\fR
  81 .RS 4
  82 Comma separated list of UAMs\&. (The default is uams_dhx\&.so,uams_dhx2\&.so)\&.
  83 .sp
  84 The most commonly used UAMs are:
  85 .PP
  86 uams_guest\&.so
  87 .RS 4
  88 allows guest logins
  89 .RE
  90 .PP
  91 uams_clrtxt\&.so
  92 .RS 4
  93 (uams_pam\&.so or uams_passwd\&.so) Allow logins with passwords transmitted in the clear\&. (legacy)
  94 .RE
  95 .PP
  96 uams_randum\&.so
  97 .RS 4
  98 allows Random Number and Two\-Way Random Number Exchange for authentication (requires a separate file containing the passwords, either :ETCDIR:/afppasswd file or the one specified via
  99 \fB\-passwdfile\fR\&. See
 100 \fBafppasswd\fR(1)
 101 for details\&. (legacy)
 102 .RE
 103 .PP
 104 uams_dhx\&.so
 105 .RS 4
 106 (uams_dhx_pam\&.so or uams_dhx_passwd\&.so) Allow Diffie\-Hellman eXchange (DHX) for authentication\&.
 107 .RE
 108 .PP
 109 uams_dhx2\&.so
 110 .RS 4
 111 (uams_dhx2_pam\&.so or uams_dhx2_passwd\&.so) Allow Diffie\-Hellman eXchange 2 (DHX2) for authentication\&.
 112 .RE
 113 .PP
 114 uam_gss\&.so
 115 .RS 4
 116 Allow Kerberos V for authentication (optional)
 117 .RE
 118 .RE
 119 .PP
 120 \-uampath \fI[path]\fR
 121 .RS 4
 122 Sets the default path for UAMs for this server (default is :ETCDIR:/uams)\&.
 123 .RE
 124 .PP
 125 \-k5keytab \fI[path]\fR, \-k5service \fI[service]\fR, \-k5realm \fI[realm]\fR
 126 .RS 4
 127 These are required if the server supports the Kerberos 5 authentication UAM\&.
 128 .RE
 129 .PP
 130 \-ntdomain, \-ntseparator
 131 .RS 4
 132 Use for eg\&. winbind authentication, prepends both strings before the username from login and then tries to authenticate with the result through the availabel and active UAM authentication modules\&.
 133 .RE
 134 .PP
 135 \-adminauthuser
 136 .RS 4
 137 Specifying eg
 138 \fB\-adminauthuser root\fR
 139 whenever a normal user login fails, afpd will try to authenticate as the specified
 140 \fBadminauthuser\fR\&. If this succeeds, a normal session is created for the original connecting user\&. Said differently: if you know the password of
 141 \fBadminauthuser\fR, you can authenticate as any other user\&.
 142 .RE
 143 .SH "CODEPAGE OPTIONS"
 144 .PP
 145 With OS X Apple introduced the AFP3 protocol\&. One of the big changes was, that AFP3 uses Unicode names encoded as Decomposed UTF\-8 (UTF8\-MAC)\&. Previous AFP/OS versions used codepages like MacRoman, MacCentralEurope, etc\&.
 146 .PP
 147 To be able to serve AFP3 and older clients at the same time,
 148 \fBafpd\fR
 149 needs to be able to convert between UTF\-8 and Mac codepages\&. Even OS X clients partly still rely on codepages\&. As there\'s no way,
 150 \fBafpd\fR
 151 can detect the codepage a pre AFP3 client uses, you have to specify it using the
 152 \fB\-maccodepage\fR
 153 option\&. The default is MacRoman, which should be fine for most western users\&.
 154 .PP
 155 As
 156 \fBafpd\fR
 157 needs to interact with unix operating system as well, it need\'s to be able to convert from UTF8\-MAC/MacCodepage to the unix codepage\&. By default
 158 \fBafpd\fR
 159 uses the systems LOCALE, or ASCII if your system doesn\'t support locales\&. You can set the unix codepage using the
 160 \fB\-unixcodepage\fR
 161 option\&. If you\'re using extended characters in the configuration files for
 162 \fBafpd\fR, make sure your terminal matches the
 163 \fB\-unixcodepage\fR\&.
 164 .PP
 165 \-unixcodepage [\fICODEPAGE\fR]
 166 .RS 4
 167 Specifies the servers unix codepage, e\&.g\&. "ISO\-8859\-15" or "UTF8"\&. This is used to convert strings to/from the systems locale, e\&.g\&. for authenthication, server messages and volume names\&. Defaults to LOCALE if your system supports it, otherwise ASCII will be used\&.
 168 .RE
 169 .PP
 170 \-maccodepage [\fICODEPAGE\fR]
 171 .RS 4
 172 Specifies the mac clients codepage, e\&.g\&. "MAC_ROMAN"\&. This is used to convert strings and filenames to the clients codepage for OS9 and Classic, i\&.e\&. for authentication and AFP messages (SIGUSR2 messaging)\&. This will also be the default for the volumes maccharset\&. Defaults to MAC_ROMAN\&.
 173 .RE
 174 .SH "PASSWORD OPTIONS"
 175 .PP
 176 \-loginmaxfail [\fInumber\fR]
 177 .RS 4
 178 Sets the maximum number of failed logins, if supported by the UAM (currently none)
 179 .RE
 180 .PP
 181 \-passwdfile [\fIpath\fR]
 182 .RS 4
 183 Sets the path to the Randnum UAM passwd file for this server (default is :ETCDIR:/afppasswd)\&.
 184 .RE
 185 .PP
 186 \-passwdminlen [\fInumber\fR]
 187 .RS 4
 188 Sets the minimum password length, if supported by the UAM
 189 .RE
 190 .PP
 191 \-[no]savepassword
 192 .RS 4
 193 Enables or disables the ability of clients to save passwords locally
 194 .RE
 195 .PP
 196 \-[no]setpassword
 197 .RS 4
 198 Enables or disables the ability of clients to change their passwords via chooser or the "connect to server" dialog
 199 .RE
 200 .SH "TRANSPORT PROTOCOLS"
 201 .PP
 202 \-[no]ddp
 203 .RS 4
 204 Enables or disables AFP\-over\-Appletalk\&. If
 205 \fB\-proxy\fR
 206 is specified, you must instead use
 207 \fB\-uamlist ""\fR
 208 to prevent DDP connections from working\&. (default is \-noddp)
 209 .RE
 210 .PP
 211 \-[no]tcp
 212 .RS 4
 213 Enables or disables AFP\-over\-TCP (default is \-tcp)
 214 .RE
 215 .PP
 216 \-transall
 217 .RS 4
 218 Make both available
 219 .RE
 220 .SH "TRANSPORT OPTIONS"
 221 .PP
 222 \-advertise_ssh
 223 .RS 4
 224 Allows Mac OS X clients (10\&.3\&.3\-10\&.4) to automagically establish a tunneled AFP connection through SSH\&. If this option is set, the server\'s answers to client\'s FPGetSrvrInfo requests contain an additional entry\&. It depends on both client\'s settings and a correctly configured and running
 225 \fBsshd\fR(8)
 226 on the server to let things work\&.
 227 .if n \{\
 228 .sp
 229 .\}
 230 .RS 4
 231 .it 1 an-trap
 232 .nr an-no-space-flag 1
 233 .nr an-break-flag 1
 234 .br
 235 .ps +1
 236 \fBNote\fR
 237 .ps -1
 238 .br
 239 Setting this option is not recommended since globally encrypting AFP connections via SSH will increase the server\'s load significantly\&. On the other hand, Apple\'s client side implementation of this feature in MacOS X versions prior to 10\&.3\&.4 contained a security flaw\&.
 240 .sp .5v
 241 .RE
 242 .RE
 243 .PP
 244 \-ddpaddr \fI[ddp address]\fR
 245 .RS 4
 246 Specifies the DDP address of the server\&. The default is to auto\-assign an address (0\&.0)\&. This is only useful if you are running AppleTalk on more than one interface\&.
 247 .RE
 248 .PP
 249 \-fqdn \fI[name:port]\fR
 250 .RS 4
 251 Specifies a fully\-qualified domain name, with an optional port\&. This is discarded if the server cannot resolve it\&. This option is not honored by AppleShare clients <= 3\&.8\&.3\&. This option is disabled by default\&. Use with caution as this will involve a second name resolution step on the client side\&. Also note that afpd will advertise this name:port combination but not automatically listen to it\&.
 252 .RE
 253 .PP
 254 \-hostname\fI [name]\fR
 255 .RS 4
 256 Use this instead of the result from calling hostname for dertermening which IP address to advertise, therfore the hostname is resolved to an IP which is the advertised\&. This is NOT used for listening and it is also overwritten by
 257 \fB\-ipaddr\fR\&.
 258 .RE
 259 .PP
 260 \-ipaddr \fI[ip address]\fR
 261 .RS 4
 262 Specifies the IP address that the server should advertise
 263 \fBand\fR
 264 listens to\&. The default is advertise the first IP address of the system, but to listen for any incoming request\&. The network address may be specified either in dotted\-decimal format for IPv4 or in hexadecimal format for IPv6\&. This option also allows to use one machine to advertise the AFP\-over\-TCP/IP settings of another machine via NBP
 265 when used together with the
 266 \fB\-proxy\fR
 267 option\&.
 268 .PP
 269 \fBExample.\ \&afpd.conf onfiguration line\fR
 270 .sp
 271 .if n \{\
 272 .RS 4
 273 .\}
 274 .nf
 275               fluxxus \-hostname afp\&.example\&.org \-ipaddr 192\&.168\&.0\&.1 \-fqdn www\&.example\&.com
 276
 277 .fi
 278 .if n \{\
 279 .RE
 280 .\}
 281 .sp
 282
 283 \fBResult\fR
 284 .sp
 285 (UTF8) Server name: fluxxus, Listening and advertised network address: 192\&.168\&.0\&.1, Advertised network address: www\&.example\&.com, hostname is not used\&.
 286 .RE
 287 .PP
 288 \-port \fI[port number]\fR
 289 .RS 4
 290 Allows a different TCP port to be used for AFP\-over\-TCP\&. The default is 548\&.
 291 .RE
 292 .PP
 293 \-proxy
 294 .RS 4
 295 Runs an AppleTalk proxy server for the specified AFP\-over\-TCP server\&. If the address and port aren\'t given, then the first IP address of the system and port 548 will be used\&. If you don\'t want the proxy server to act as a DDP
 296 server as well, set
 297 \fB\-uamlist ""\fR\&.
 298 .RE
 299 .PP
 300 \-server_quantum \fI[number]\fR
 301 .RS 4
 302 This specifies the DSI server quantum\&. The default value is 303840\&. The maximum value is 0xFFFFFFFFF, the minimum is 32000\&. If you specify a value that is out of range, the default value will be set\&. Do not change this value unless you\'re absolutely sure, what you\'re doing
 303 .RE
 304 .PP
 305 \-dsireadbuf \fI[number]\fR
 306 .RS 4
 307 Scale factor that determines the size of the DSI/TCP readahead buffer, default is 12\&. This is multiplies with the DSI server quantum (default ~300k) to give the size of the buffer\&. Increasing this value might increase throughput in fast local networks for volume to volume copies\&.
 308 \fINote\fR: This buffer is allocated per afpd child process, so specifying large values will eat up large amount of memory (buffer size * number of clients)\&.
 309 .RE
 310 .PP
 311 \-tcprcvbuf \fI[number]\fR
 312 .RS 4
 313 Try to set TCP receive buffer using setsockpt()\&. Often OSes impose restrictions on the applications ability to set this value\&.
 314 .RE
 315 .PP
 316 \-tcpsndbuf \fI[number]\fR
 317 .RS 4
 318 Try to set TCP send buffer using setsockpt()\&. Often OSes impose restrictions on the applications ability to set this value\&.
 319 .RE
 320 .PP
 321 \-nozeroconf
 322 .RS 4
 323 Disable automatic Zeroconf
 324 service registration if support was compiled in\&.
 325 .RE
 326 .PP
 327 \-slp
 328 .RS 4
 329 Register this server using the Service Location Protocol (if SLP
 330 support was compiled in)\&.
 331 .RE
 332 .SH "MISCELLANEOUS OPTIONS"
 333 .PP
 334 \-admingroup \fI[group]\fR
 335 .RS 4
 336 Allows users of a certain group to be seen as the superuser when they log in\&. This option is disabled by default\&.
 337 .RE
 338 .PP
 339 \-authprintdir \fI[path]\fR
 340 .RS 4
 341 Specifies the path to be used (per server) to store the files required to do CAP\-style print authentication which papd will examine to determine if a print job should be allowed\&. These files are created at login and if they are to be properly removed, this directory probably needs to be umode 1777\&.
 342 .if n \{\
 343 .sp
 344 .\}
 345 .RS 4
 346 .it 1 an-trap
 347 .nr an-no-space-flag 1
 348 .nr an-break-flag 1
 349 .br
 350 .ps +1
 351 \fBNote\fR
 352 .ps -1
 353 .br
 354 \fB\-authprintdir\fR
 355 will only work for clients connecting via DDP\&. Almost all modern Clients will use TCP\&.
 356 .sp .5v
 357 .RE
 358 .RE
 359 .PP
 360 \-client_polling
 361 .RS 4
 362 With this switch enabled, afpd won\'t advertise that it is capable of server notifications, so that connected clients poll the server every 10 seconds to detect changes in opened server windows\&.
 363 \fINote\fR: Depending on the number of simultaneously connected clients and the network\'s speed, this can lead to a significant higher load on your network!
 364 .if n \{\
 365 .sp
 366 .\}
 367 .RS 4
 368 .it 1 an-trap
 369 .nr an-no-space-flag 1
 370 .nr an-break-flag 1
 371 .br
 372 .ps +1
 373 \fBNote\fR
 374 .ps -1
 375 .br
 376 Do not use this option any longer as Netatalk 2\&.x correctly supports server notifications, allowing connected clients to update folder listings in case another client changed the contents\&.
 377 .sp .5v
 378 .RE
 379 .RE
 380 .PP
 381 \-closevol
 382 .RS 4
 383 Immediately unmount volumes removed from AppleVolumes files on SIGHUP sent to the afp master process\&.
 384 .RE
 385 .PP
 386 \-cnidserver \fI[ipaddress:port]\fR
 387 .RS 4
 388 Specifies the IP address and port of a cnid_metad server, required for CNID dbd backend\&. Defaults to localhost:4700\&. The network address may be specified either in dotted\-decimal format for IPv4 or in hexadecimal format for IPv6\&.\-
 389 .RE
 390 .PP
 391 \-dircachesize\fI entries\fR
 392 .RS 4
 393 Maximum possible entries in the directory cache\&. The cache stores directories and files\&. It is used to cache the full path to directories and CNIDs which considerably speeds up directory enumeration\&.
 394 .sp
 395 Default size is 8192, maximum size is 131072\&. Given value is rounded up to nearest power of 2\&. Each entry takes about 100 bytes, which is not much, but remember that every afpd child process for every connected user has its cache\&.
 396 .RE
 397 .PP
 398 \-fcelistener \fIhost[:port]\fR
 399 .RS 4
 400 Enables sending FCE events to the specified
 401 \fIhost\fR, default
 402 \fIport\fR
 403 is 12250 if not specified\&. Specifying mutliple listeners is done by having this option once for each of them\&.
 404 .RE
 405 .PP
 406 \-fceevents \fIfmod,fdel,ddel,fcre,dcre,tmsz\fR
 407 .RS 4
 408 Speficies which FCE events are active, default is
 409 \fIfmod,fdel,ddel,fcre,dcre\fR\&.
 410 .RE
 411 .PP
 412 \-fcecoalesce \fIall|delete|create\fR
 413 .RS 4
 414 Coalesce FCE events\&.
 415 .RE
 416 .PP
 417 \-fceholdfmod \fIseconds\fR
 418 .RS 4
 419 This determines the time delay in seconds which is always waited if another file modification for the same file is done by a client before sending an FCE file modification event (fmod)\&. For example saving a file in Photoshop would generate multiple events by itself because the application is opening, modifying and closing a file mutliple times for every "save"\&. Defautl: 60 seconds\&.
 420 .RE
 421 .PP
 422 \-guestname \fI[name]\fR
 423 .RS 4
 424 Specifies the user that guests should use (default is "nobody")\&. The name should be quoted\&.
 425 .RE
 426 .PP
 427 \-[no]icon
 428 .RS 4
 429 [Don\'t] Use the platform\-specific icon\&. Recent Mac OS don\'t display it any longer\&.
 430 .RE
 431 .PP
 432 \-keepsessions
 433 .RS 4
 434 Enable "Continuous AFP Service"\&. This means the ability to stop the master afpd process with a SIGQUIT signal, possibly install an afpd update and start the afpd process\&. Existing AFP sessions afpd processes will remain unaffected\&. Technically they will be notified of the master afpd shutdown, sleep 15\-20 seconds and then try to reconnect their IPC channel to the master afpd process\&. If this reconnect fails, the sessions are in an undefined state\&. Therefor it\'s absolutely critical to restart the master process in time!
 435 .RE
 436 .PP
 437 \-loginmesg \fI[message]\fR
 438 .RS 4
 439 Sets a message to be displayed when clients logon to the server\&. The message should be in
 440 \fBunixcodepage\fR
 441 and should be quoted\&. Extended characters are allowed\&.
 442 .RE
 443 .PP
 444 \-mimicmodel \fImodel\fR
 445 .RS 4
 446 Specifies the icon model that appears on clients\&. Defaults to off\&. Examples: RackMac (same as Xserve), PowerBook, PowerMac, Macmini, iMac, MacBook, MacBookPro, MacBookAir, MacPro, AppleTV1,1, AirPort\&.
 447 .RE
 448 .PP
 449 \-noacl2maccess
 450 .RS 4
 451 Don\'t map filesystem ACLs to effective permissions\&.
 452 .RE
 453 .PP
 454 \-nodebug
 455 .RS 4
 456 Disables debugging\&.
 457 .RE
 458 .PP
 459 \-sleep \fI[number]\fR
 460 .RS 4
 461 AFP 3\&.x waits
 462 \fInumber\fR
 463 hours before disconnecting clients in sleep mode\&. Default is 10 hours\&.
 464 .RE
 465 .PP
 466 \-signature { user:<text> | auto }
 467 .RS 4
 468 Specify a server signature\&. This option is useful while running multiple independent instances of afpd on one machine (eg\&. in clustered environments, to provide fault isolation etc\&.)\&. Default is "auto"\&. "auto" signature type allows afpd generating signature and saving it to
 469 :ETCDIR:/afp_signature\&.conf
 470 automatically (based on random number)\&. "host" signature type switches back to "auto" because it is obsoleted\&. "user" signature type allows administrator to set up a signature string manually\&. The maximum length is 16 characters\&.
 471 .PP
 472 \fBExample.\ \&Three server definitions using 2 different server signatures\fR
 473 .sp
 474 .if n \{\
 475 .RS 4
 476 .\}
 477 .nf
 478 first \-signature user:USERS
 479 second \-signature user:USERS
 480 third \-signature user:ADMINS
 481 .fi
 482 .if n \{\
 483 .RE
 484 .\}
 485
 486
 487 First two servers will appear as one logical AFP service to the clients \- if user logs in to first one and then connects to second one, session will be automatically redirected to the first one\&. But if client connects to first and then to third, will be asked for password twice and will see resources of both servers\&. Traditional method of signature generation causes two independent afpd instances to have the same signature and thus cause clients to be redirected automatically to server (s)he logged in first\&.
 488 .RE
 489 .PP
 490 \-volnamelen \fI[number] \fR
 491 .RS 4
 492 Max length of UTF8\-MAC volume name for Mac OS X\&. Note that Hangul is especially sensitive to this\&.
 493 .sp
 494 .if n \{\
 495 .RS 4
 496 .\}
 497 .nf
 498 73:  limit of Mac OS X 10\&.1
 499 80:  limit for Mac OS X 10\&.4/10\&.5 (default)
 500 255: limit of spec
 501 .fi
 502 .if n \{\
 503 .RE
 504 .\}
 505 .sp
 506 Mac OS 9 and earlier are not influenced by this, because Maccharset volume name is always limitted to 27 bytes\&.
 507 .RE
 508 .SH "LOGGING OPTIONS"
 509 .PP
 510 \-setuplog "\fI<logtype> <loglevel> [<filename>]\fR"
 511 .RS 4
 512 Specify that any message of a loglevel up to the given
 513 \fBloglevel\fR
 514 should be logged to the given file\&. If the filename is ommited the loglevel applies to messages passed to syslog\&.
 515 .sp
 516 By default (no explicit
 517 \fB\-setuplog\fR
 518 and no buildtime configure flag
 519 \fB\-\-with\-logfile\fR) afpd logs to syslog with a default logging setup equivalent to
 520 \fB"\-setuplog default log_info\fR"\&.
 521 .sp
 522 If build with
 523 \fB\-\-with\-logfile\fR
 524 (default logfile
 525 \fI/var/log/netatalk\&.log\fR) or
 526 \fB\-\-with\-logfile=somefile\fR
 527 afpd defaults to a setup that is equivalent to "\fB\-setuplog default log_info [\fR\fB\fInetatalk\&.log|somefile]\fR\fR"\&.
 528 .sp
 529 logtypes: Default, AFPDaemon, Logger, UAMSDaemon
 530 .sp
 531 loglevels: LOG_SEVERE, LOG_ERROR, LOG_WARN, LOG_NOTE, LOG_INFO, LOG_DEBUG, LOG_DEBUG6, LOG_DEBUG7, LOG_DEBUG8, LOG_DEBUG9, LOG_MAXDEBUG
 532 .if n \{\
 533 .sp
 534 .\}
 535 .RS 4
 536 .it 1 an-trap
 537 .nr an-no-space-flag 1
 538 .nr an-break-flag 1
 539 .br
 540 .ps +1
 541 \fBNote\fR
 542 .ps -1
 543 .br
 544 The config is case\-ignoring
 545 .sp .5v
 546 .RE
 547 .PP
 548 \fBExample.\ \&Useful default config\fR
 549 .sp
 550 .if n \{\
 551 .RS 4
 552 .\}
 553 .nf
 554 \- \-setuplog "default log_info /var/log/afpd\&.log"
 555 .fi
 556 .if n \{\
 557 .RE
 558 .\}
 559 .PP
 560 \fBExample.\ \&Debugging config\fR
 561 .sp
 562 .if n \{\
 563 .RS 4
 564 .\}
 565 .nf
 566 \- \-setuplog "default log_maxdebug /var/log/afpd\&.log"
 567 .fi
 568 .if n \{\
 569 .RE
 570 .\}
 571 .PP
 572 \fBExample.\ \&afpd logging to different files\fR
 573 .sp
 574 .if n \{\
 575 .RS 4
 576 .\}
 577 .nf
 578 \- \-setuplog "default log_info /var/log/afpd\&.log" \e
 579 \-setuplog "UAMSDaemon log_maxdebug /var/log/uams\&.log"
 580 .fi
 581 .if n \{\
 582 .RE
 583 .\}
 584 .RE
 585 .PP
 586 \-unsetuplog "\fI<logtype> [<filename>]\fR"
 587 .RS 4
 588 Note that for
 589 \fBunsetuplog\fR
 590 specifying any string as filename is sufficient for the config parser to distinguish between requests to disable syslog logging or file\-logging\&.
 591 .PP
 592 \fBExample.\ \&Disable afpd logging set at build-time from configure\fR
 593 .sp
 594 .if n \{\
 595 .RS 4
 596 .\}
 597 .nf
 598 \- \-unsetuplog "default \-"
 599 .fi
 600 .if n \{\
 601 .RE
 602 .\}
 603 .RE
 604 .SH "DEBUG OPTIONS"
 605 .PP
 606 These options are useful for debugging only\&.
 607 .PP
 608 \-tickleval \fI[number]\fR
 609 .RS 4
 610 Sets the tickle timeout interval (in seconds)\&. Defaults to 30\&.
 611 .RE
 612 .PP
 613 \-timeout \fI[number]\fR
 614 .RS 4
 615 Specify the number of tickles to send before timing out a connection\&. The default is 4, therefore a connection will timeout after 2 minutes\&.
 616 .RE
 617 .SH "EXAMPLES"
 618 .PP
 619 \fBExample.\ \&afpd.conf default configuration\fR
 620 .sp
 621 .if n \{\
 622 .RS 4
 623 .\}
 624 .nf
 625 \- \-tcp \-noddp \-uamlist uams_dhx\&.so,uams_dhx2\&.so \-nosavepassword
 626 .fi
 627 .if n \{\
 628 .RE
 629 .\}
 630 .PP
 631 \fBExample.\ \&afpd.conf MacCyrillic setup / UTF8 unix locale\fR
 632 .sp
 633 .if n \{\
 634 .RS 4
 635 .\}
 636 .nf
 637 \- \-maccodepage mac_cyrillic \-unixcodepage utf8
 638 .fi
 639 .if n \{\
 640 .RE
 641 .\}
 642 .PP
 643 \fBExample.\ \&afpd.conf setup for Kerberos V auth with newline escaping\fR
 644 .sp
 645 .if n \{\
 646 .RS 4
 647 .\}
 648 .nf
 649 \- \-uamlist uams_dhx\&.so,uams_dhx2\&.so,uams_guest\&.so,uams_gss\&.so \e
 650 \-k5service afpserver \-k5keytab /path/to/afpserver\&.keytab \e
 651 \-k5realm YOUR\&.REALM \-fqdn your\&.fqdn\&.namel:548
 652 .fi
 653 .if n \{\
 654 .RE
 655 .\}
 656 .PP
 657 \fBExample.\ \&afpd.conf letting afpd appear as three servers on the net\fR
 658 .sp
 659 .if n \{\
 660 .RS 4
 661 .\}
 662 .nf
 663 "Guest Server" \-uamlist uams_guest\&.so \-loginmesg "Welcome guest!"
 664 "User Server" \-uamlist uams_dhx2\&.so \-port 12000
 665 "special" \-ddp \-notcp \-defaultvol <path> \-systemvol <path>
 666 .fi
 667 .if n \{\
 668 .RE
 669 .\}
 670 .SH "SEE ALSO"
 671 .PP
 672 \fBafpd\fR(8),
 673 \fBafppasswd\fR(1),
 674 \fBAppleVolumes.default\fR(5),
 675 \fBafp_signature.conf\fR(5),
 676 \fBcnid_metad\fR(8)