MOUNTAFP(8)              BSD System Manager's Manual             MOUNTAFP(8)

NAME
     mountafp -- mount an afp (AppleShare) filesystem

SYNOPSIS
     mountafp [-i] [-o options] afpurl node

DESCRIPTION
     The mountafp command mounts the AFP volume denoted by the afpurl
     afp://[user[;AUTH=uamname][:password]@]host[:port]/volumename at the
     mount point indicated by node.

     This command is normally executed by mount(8) when the -t afp option is
     used. If the -i option is not used, all the required information to
     establish a login to the remote server must be available in the afp URL,
     including username & password if needed.

     The arguments and options are:

     -i      Interactive mode, you are prompted for the password if you did
             not supply one in the url.

     -o      Options passed to mount(2) are specified with the -o option fol-
             lowed by a comma separated string of options. See the mount(8)
             man page for possible options and their meanings. Additional
             options supported by the AFP Client are as follows:

             nobrowse
                     Indicate to the Carbon subsystem that this volume is not
                     to be displayed to the user.

             automounted
                     Set flags on the mountpoint to indicate that the volume
                     has been mounted by the automounter.

     afpurl
             There are two forms of afp URL, one for TCP/IP and one for
             AppleTalk:

             afp:/[user[;AUTH=uamname][:password]@]host[:port]/volume

             afp:/at/[user[;AUTH=uamname][:password]@]servername[:zone-
             name]/volume

             Denotes the afp server and sharepoint to mount. It may also con-
             tain the username & password required to log into the server.
             uamname is the protocol name of the authentication method.  If
             port is not specified, then port 548 is used.

     node    Path to mount point, which must be a directory that the user has
             write permissions for.

EXAMPLES
     The following example illustrates how to mount the afp volume server.com-
     pany.com/volumename/ at the mount point /Volumes/mntpnt:

           mkdir /Volumes/mntpnt
           mountafp afp:/username:userpass@server.company.com/volumename/ /Volumes/mntpnt

     This example shows the proper url to use to mount the volume guestVolume
     from the afp server myserver as guest:

           mkdir /Volumes/guest
           mountafp "afp:/;AUTH=No%20User%20Authent@myserver/guestVolume" /Volumes/guest

     This example shows the proper url to use to mount the volume myVolume
     from the afp server myserver using Kerberos authentication:

           mkdir /Volumes/myVolume
           mountafp "afp:/;AUTH=Client%20Krb%20v2@myserver/myVolume" /Volumes/myVolume


SEE ALSO
     mount(2), unmount(2), mount(8)

HISTORY
     The mountafp command first appeared Mac OS X version 10.0. Kerberos
     authentication was added in Mac OS X version 10.2

RETURN VALUES
     0                  mountafp successfully mounted the volume directory.

     [ENODEV (19)]      The server volume could not be mounted by mountafp
                        because the server was not found or because the share-
                        point does not exist, or because node does not have
                        proper access.

     [EACES (13)]      The volume could not be mounted by mountafp because
                        the user did not provide proper authentication creden-
                        tials.

     [ENOTDIR (20)]     The volume could not be mounted by mountafp because
                        the mountpoint was not a directory.

Mac OS X                          May 8, 2002                         Mac OS X