MOUNT_SMBFS(8)

NAME
mount_smbfs - mounts a shared resource from an SMB file server

SYNOPSIS
mount_smbfs [-I host] [-M cmode[/smode]] [-N] [-O cowner[:cgroup]/sowner[:sgroup]] [-R retrycount] [-T timeout] [-U user] [-W workgroup] [-d mode] [-f mode] [-g gid] [-h] [-n opt] [-u uid] //[workgroup; ][user[ password ]@] server[ /share] path

DESCRIPTION
The mount_smbfs command mounts a share from a remote server using SMB/CIFS protocol.

The options are:

-I host
    Do not use NetBIOS name resolver and connect directly to host, which can be either a valid DNS name or an IP address.

-M cmode[/smode]
    Assign access rights to the newly created connection.

-N  Do not ask for a password. At run time, mount_smbfs reads the ~/.nsmbrc file for additional configuration parameters and a password. If no password is found the mount_smbfs prompts for it.

-O cowner[:cgroup]/sowner[:sgroup]
    Assign owner/group attributes to the newly created connection.

-R retrycount
    How many retries should be done before the SMB requester decides to drop the connection.

-T timeout
    Timeout in seconds for each request.

-U user
    Specifies the user name to be used in the authentication request.

-W workgroup
    Specifies the workgroup to be used in the authentication request.

-f mode, -d mode
    Specify permissions that should be assigned to files and directories. The values must be specified as octal numbers. Default value for the file mode is taken from mount point, default value for the dir mode adds execute permission where the file mode gives read permission. Note that these permissions can differ from the rights granted by SMB server.

-h  Prints a help message, much like the SYNOPSIS above.

-n opt
    Set opt option to affect file name lookups. opt can be one of the following:

    Value
        Meaning

    long
        No long names. Server supports only "8.3" format.

-u uid, -g gid
    User id and group id assigned to files. The default is owner and group id from directory where the volume is mounted.

    //[workgroup; ][user[ password ]@] server[ /share] The mount_smbfs command will use server as the NetBIOS name of remote computer, user as the remote user name and share as the resource name on a remote server. Workgroup and/or password may be specified here. If user is omitted the logged in user id will be used. Omitting share is an error when mount_smbfs is run from the command line, otherwise a browsing dialogue is presented.

path
    Path to mount point.

FILES
~/.nsmbrc
    Keeps static parameters for connections and other information. See ./examples/dot.nsmbrc for details.

EXAMPLES
The following illustrate how to connect to an SMB server SAMBA as user GUEST to mount PUBLIC:

    mount_smbfs -I samba.mydomain.com //guest@samba/public /smb/public

BUGS
Please report bugs to Apple.

AUTHORS
Boris Popov <bp@butya.kz>, <bp@freebsd.org>