mount_afp(8) [mojave man page]
MOUNT_AFP(8) BSD System Manager's Manual MOUNT_AFP(8) NAME
mount_afp -- mount an afp (AppleShare) filesystem SYNOPSIS
mount_afp [-i] [-s] [-k] [-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. -s Soft mount (default). Network errors, e.g. timeouts, will be retried for a much shorter amount of time. If the network errors per- sist, then the mount will be force unmounted. -k Hard mount. Network errors, e.g. timeouts, will be retried for an extended amount of time. If the network errors persist, then the mount will be force unmounted. -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, which must be a directory that the user has write permissions for. EXAMPLES
The following example illustrates how to mount the afp volume server.company.com/volumename/ at the mount point /Volumes/mntpnt: mkdir /Volumes/mntpnt mount_afp 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 (if no uam and no username, then use guest uam): mkdir /Volumes/guest mount_afp "afp://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 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 (19)] 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 (13)] The volume could not be mounted by mount_afp because the user did not provide proper authentication credentials. [ENOTDIR (20)] The volume could not be mounted by mount_afp because the mountpoint was not a directory. Mac OS X May 8, 2002 Mac OS X
Check Out this Related Man Page
mnthome(1) BSD General Commands Manual mnthome(1) NAME
mnthome -- mount an AFP (AppleShare) home directory with the correct privileges SYNOPSIS
mnthome [-v] [-d] [-m mntpath] [-n] [-b] [-p password] [-i] [-x mount point] [-u] [-s] DESCRIPTION
The mnthome command unmounts the AFP (AppleShare) home directory that was automounted as guest, and remounts it with the correct privileges by logging into the AFP server using the current username and password. This command also allows you to have guest access turned off on your AFP server too and still have AFP home directories work with "su". When you ssh into another computer using an account that has an AFP home directory or you "su <netuser>" where <netuser> is an AFP home directory user, then the resulting home directory will not have the correct access privileges. This is because automount is assuming NFS behavior which assumes that all computers share the same user/group privileges and mounts volumes using "no security" and lets the client enforce privileges based on the current user. AFP is different since the privileges are based on the user that logged into the server. Since automount does not put up an authentication dialog asking for an user name and password, automount mounts the fileserver using guest login. Thus you end up with getting the world access privileges and the privileges are shown via "mapping". You also would have to allow guest access to the server to that sharepoint. Mapping makes all the files/folders appear like they are owned by the current user. Even those items not really owned by the current user show up as being owned by the current user. The server provides user access rights (UARights) which is a summary of what the access rights are regardless of the category (owner, group, world) from which they were obtained. When doing "mapping", the AppleShare client will take these UARights and show them as the owner rights. So, everything looks like it is owned by the current user and the owner rights are set to the UARights. Thus if you had access to that file/folder before, then you still do. The options are: -v Display version number. -d Print debugging information. -m Alternative mount point is specified with the -m option followed by a path to an existing directory. Normally, the volume is mounted in /Network/Servers/ or /var/automount/Network/Servers/. -n Do not force the unmount of the previous mount point. -b Exec the user's shell after mount of home. -p A password may be specified with the -p option followed by a password. If this option is not used, then the user will be prompted to enter in a password. -i Display information about the AFP home mount point. -u Attempt to unmount the current home directory mount. -x This option must be followed by a path to an existing AFP mount point. Display information about the mount point. -s Skip preflight check to see if the currently mounted home directory is already correctly mounted for the user. EXAMPLES
The following example illustrates how to mount an AFP home directory: mnthome This example shows how to print the debugging information and provide a password: mnthome -d -p foobar SEE ALSO
mount(2), unmount(2), mount(8) mount_afp(8) BUGS
I get the mounting url from the "home_loc" attribute and the mountpath from the "home" attribute (with the path from home_loc subtracted out). If your AFP home directory automounts in a different location, then you need to use the -m option to specify an alternative mount point. I cant figure out how to cd out of the current home dir so I can do the unmount and then restore the user back into the new home dir. If you are in the AFP home directory when you use mnthome, you automatically get put back into that same directory when mnthome leaves. If mnthome works, then your current directory is a dead directory and you need to "cd ~" to get to your new home directory. If the server with the home directory was already mounted by another user, you will not be able to replace it with a mount made by your user id. The original mount must be first unmounted by the mounting user or root. HISTORY
The mnthome command first appeared Mac OS X version 10.3. RETURN VALUES
0 mnthome successfully remounted the AFP home directory. [EINVAL] Invalid arguements were passed in. [EPERM] The current AFP home directory could not be unmounted by mnthome because the current user does not have the correct access. The current AFP home directory was probably mounted by another user first. [EAUTH] Incorrect password. Mac OS X August 4, 2004 Mac OS X