manpages.info - online man pages   

Mac OS X / Darwin man pages : mount_afp (8)
mount_afp (8)

Table of Contents

Name

mount_afp - mount an afp (AppleShare) filesystem

Synopsis

mount_afp [-i] [-o options] afp_url node

Description

The mount_afp command mounts the AFP volume denoted by the afp_url 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 followed 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.

afp_url
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[:zonename]/volume

Denotes the afp server and sharepoint to mount. It may also contain 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.

Examples

The following example illustrates how to mount the afp volume idisk.mac.com/membername/ at the mount point /Volumes/mntpnt/:

mount_afp afp://membername:memberpass@idisk.mac.com/membername/ /Volumes/mntpnt/

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

mount_afp 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:

mount_afp afp://;AUTH=Client%20Krb%20v2@myserver/myVolume /Volumes/myVolume

See Also

mount(2) , unmount(2) , mount(8)

History

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

Return Values

0
mount_afp successfully mounted the volume directory.

[ENODEV]
The server volume could not be mounted by mount_afp because the server was not found or because the sharepoint does not exist, or because node does not have proper access.

[EACCES]
The volume could not be mounted by mount_afp because the user did not provide proper authentication credentials.

Table of Contents