Name

afpd — AppleTalk Filing Protocol daemon

Synopsis

afpd [-duptDTvI] [-f defaultvolumes] [-s systemvolumes] [-n nbpname] [-c maxconnections] [-g guest] [-P pidfile] [-S port] [-L message] [-F config] [-U uamsv] [-m umask]

Description

afpd provides an AppleTalk Filing Protocol (AFP) interface to the Unix file system. It is normally started at boot time from /etc/rc.

The list of volumes offered to the user is generated from AppleVolumes.system and one of AppleVolumes.default, ~/AppleVolumes, or ~/.AppleVolumes. The AppleVolumes files is used to specify volumes to mount and file name extension mappings. It is formatted as follows, one specification per line: pathname [ volumename ] .extension [ type [ creator ] ] If volumename is unspecified, the last component of pathname is used. No two volumes may have the same name. If type is unspecified '????' is used. If creator is unspecified 'UNIX' is used. The extension '.' sets the default creator and type for otherwise untyped Unix files. Blank lines and lines beginning with `#' are ignored.

Options

-d

Specifies that the daemon should not fork. If netatalk has been configured with --enable-debug1, a trace of all AFP commands will be written to stdout.

-p

Prevents clients from saving their passwords. (Equivalent to -nosavepasswd in afpd.conf.)

-t

Allows clients to change their passwords. (Equivalent to -setpasswd in afpd.conf.)

-D

Use DDP (AppleTalk) as transport protocol. (Equivalent to -ddp in afpd.cond.)

-T

Use TCP/IP as transport protocol. (Equivalent to -tcp in afpd.conf.)

-v

Print version information and exit.

-I

Use a platform specific icon. (Equivalent to -icon in afpd.conf.)

-f defaultvolumes

Specifies that defaultvolumes should be read for a list of default volumes to offer, instead of AppleVolumes.default.

-s systemvolumes

Specifies that systemvolumes should be read for a list of volume that all users will be offered, instead of AppleVolumes.system.

-u

Read the user's AppleVolumes file first. This option causes volume names in the user's AppleVolumes file to override volume names in the system's AppleVolumes file. The default is to read the system AppleVolumes file first. Note that this option doesn't effect the precendence of filename extension mappings: the user's AppleVolumes file always has precedence.

-n nbpname

Specifies that nbpname should be used for NBP registration, instead of the first component of the hostname in the local zone.

-c maxconnections

Specifies the maximum number of connections to allow for this afpd. The default is 20.

-g guest

Specifies the name of the guest account. The default is 'nobody'.

-P pidfile

Specifies the file in which afpd stores its process id.

-S port

Specifies the port to register with when doing AFPoverTCP. Defaults to 548. (Equivalent to -port in afpd.conf.)

-L message

Specifies the login message that will be sent to clients. (Equivalent to -loginmsg in afpd.conf.)

-F configfile

Specifies the configuration file to use. (Defaults to netatalk/afpd.conf.)

-U uams

Comma-separated list of UAMs to use for the authentication process. (Equivalent to -uamlist in afpd.conf.)

-m umask

Use this umask for the creation of folders in Netatalk.

SIGNALS

Signals that are sent to the main afpd process are propagated to the children, so all will be affected.

SIGHUP

Sending a SIGHUP to afpd will cause it to reload its configuration files.

SIGUSR1

The afpd process will send the message "The server is going down for maintenance." to the client and shut itself down in 5 minutes. New connections are not allowed. If this is sent to a child afpd, the other children are not affected. However, the main process will still exit, disabling all new connections.

SIGUSR2

The afpd process will look in the message directory configured at build time for a file named message.pid. For each one found, a the contents will be sent as a message to the associated AFP client. The file is removed after the message is sent. This should only be sent to a child afpd. Warning: If the --with-message-dir option was not used, this will kill the afpd process

To shut down a user's afpd process it is recommended that SIGKILL (-9) NOT be used, except as a last resort, as this may leave the CNID database in an inconsistent state. The safe way to terminate an afpd is to send it a SIGTERM (-15) signal and wait for it to die on its own.

FILES

AppleVolumes.default

list of default volumes to mount

AppleVolumes.system

list of volumes to offer all users

~/AppleVolumes

user's list of volumes to mount

netatalk/msg/message.pid

contains messages to be sent to users.

BUGS

SEE ALSO

hosts_access(5), afpd.conf(5), AppleVolumes.default(5), AppleVolumes.system(5).