afpd



afpd(8)                            Netatalk                            afpd(8)




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
       /etc/atalk//AppleVolumes.system   and   one   of  /etc/atalk//AppleVol-
       umes.default,  ~/AppleVolumes,  or  ~/.AppleVolumes.  The  AppleVolumes
       files  is used to specify volumes to mount and file name extension map-
       pings. It is formatted as follows, one specification per line: pathname
       [ volumename ] .extension [ type [ creator ] ] If volumename is unspec-
       ified, 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 begin-
       ning 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 -set-
              passwd 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  /etc/atalk//AppleVol-
              umes.default.

       -s systemvolumes
              Specifies that systemvolumes should be read for a list of volume
              that all users will be offered, instead of /etc/atalk//AppleVol-
              umes.system.

       -u     Read the user’s AppleVolumes file first. This option causes vol-
              ume 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
              /etc/atalk//netatalk/afpd.conf.)

       -U uams
              Comma-separated  list of UAMs to use for the authentication pro-
              cess. (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 configura-
              tion 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 min-
              utes. 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

       /etc/atalk//AppleVolumes.default
              list of default volumes to mount

       /etc/atalk//AppleVolumes.system
              list of volumes to offer all users

       ~/AppleVolumes
              user’s list of volumes to mount

       /etc/atalk//netatalk/msg/message.pid
              contains messages to be sent to users.


BUGS


SEE ALSO

       hosts_access(5),   afpd.conf(5),   AppleVolumes.default(5),   AppleVol-
       umes.system(5).




2.0.2                             06 Jan 2004                          afpd(8)

Man(1) output converted with man2html