# SP Add Mount Subcommand

access: Administrators, Managers

Creates or resets a mountpoint.

> sp add mount {-r|--remote} REMOTE_FILE_SYSTEM [{-l|--local}
> LOCAL_MOUNT_POINT] [{-u|--user} USERNAME] [{-p|--password} PASSWORD]
> [{-W|--nowait}]

Argument | Description
--- | ---
{-r | --remote} | Specifies the remote server and file system to use. If the remote file system is exported via NFS, specify it using the following format: -r <server_name_ID>:<path> If the remote filesystem is exported via CIFS (Windows network share), specify it using the following format: -r //<server_name>/<share_name> Username and password options are only appropriate when mounting CIFS filesystems. In these examples, Server_Name is the IP address or hostname of the remote server. The required format for remote NFS and SMB mounts is as follows: NFS: server_name:/server_exported_mountpoint SMB: //server_name/windows_share_name
{-l | --local} | Optional; Specifies the local mount point to use. The only mountpoint supported is /mnt.
{-u | --username} | Specifies the Windows account username. In the case in which Windows domains are in force, specifying the domain may be required as in the following: -u <File_Server_Domain>\<username>
{-p | --password} | Specifies the Windows account password.
{-W | --nowait} | If --nowait is specified, there is no wait for asynchronous commands to complete.

Return Codes

Following are the return values for this command:

Code | Numeric Code | Description
--- | --- | ---
NWSE_Success | 0 | Command successfully completed.
NWSE_InvalidUsage | 1 | Invalid usage: bad parameter usage, conflicting options specified. The remote mount point was not specified.
NWSE_InvalidArgument | 4 | One or more arguments were incorrect or invalid. The local directory does not exist.
NWSE_NoPermission | 6 | Not authorized to perform this operation.
NWSE_NoMemory | 8 | Insufficient memory.
NWSE_Busy | 9 | Device or resource is busy.
NWSE_RPCConnected | 11 | RPC client already connected.
NWSE_RPCConnRefused | 12 | RPC connection refused.
NWSE_NoRouteToHost | 13 | No route to host (network down).
NWSE_HostDown | 14 | Host is down.
NWSE_UnknownError | 15 | Miscellaneous error not captured by other errors.

Note

- Several error messages may appear when executing an smb mount while mounting windows partitions. Check that the mount succeeded after the call by running the sp get mounts command.

Related Topics

System Management Commands

SP Command