8:afpd

From Linux Man Pages

Jump to: navigation, search
      afpd - AppleTalk Filing Protocol daemon
      

Contents

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/netatalk/AppleVolumes.system  and  one  of /etc/netatalk/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/netatalk/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/netatalk/AppleVolumes.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/netatalk/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/netatalk/AppleVolumes.default
             list of default volumes to mount
 
      /etc/netatalk/AppleVolumes.system
             list of volumes to offer all users
 
      ~/AppleVolumes
             user's list of volumes to mount
 
      /etc/netatalk/netatalk/msg/message.pid
             contains messages to be sent to users.

BUGS

RELATED

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

CATEGORY

Personal tools