mount_smbfs(8) - NetBSD Manual Pages

MOUNT_SMBFS(8)          NetBSD System Manager's Manual          MOUNT_SMBFS(8)


NAME

     mount_smbfs -- mount a shared resource from an SMB/CIFS file server


SYNOPSIS

     mount_smbfs [-E cs1:cs2] [-I host] [-L locale] [-M crights:srights] [-N]
                 [-O cowner:cgroup/sowner:sgroup] [-R retrycount] [-T timeout]
                 [-W workgroup] [-c case] [-d mode] [-f mode] [-g gid]
                 [-n opt] [-u uid] //user@server/share node


DESCRIPTION

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

     The options are as follows:

     -E cs1:cs2
             Specifies local (cs1) and server's (cs2) character sets.

     -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.

     -L locale
             Use locale for lower/upper case conversion routines.  Set the
             locale for case conversion.  By default, mount_smbfs tries to use
             an environment variable LC_* to determine it.

     -M crights:srights
             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, 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.

     -W workgroup
             This option specifies the workgroup to be used in the authentica-
             tion request.

     -c case
             Set a case option which affects name representation.  case can be
             one of the following:

             Value  Meaning

             l      All existing file names are converted to lower case.
                    Newly created file gets a lower case.

             u      All existing file names are converted to upper case.
                    Newly created file gets an upper case.

     -f mode, -d mode
             Specify permissions that should be assigned to files and directo-
             ries.  The values must be specified as octal numbers.  Default
             value for the file mode is taken from mount point, default value
             for the directory mode adds execute permission where the file
             mode gives read permission.

             Note that these permissions can differ from the rights granted by
             SMB server.

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

     //user@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.  If your connections are
             refused, try using the -I option and use a server name of
             `*SMBSERVER'.

     node    Path to mount point.


FILES

     /etc/nsmb.conf   System wide parameters for smbfs mounts.
     ~/.nsmbrc        Keeps static parameters for connections and other infor-
                      mation.  See /usr/share/examples/smbfs/dot.nsmbrc for
                      details.


EXAMPLES

     The following example illustrate how to connect to SMB server SAMBA as
     user GUEST, and mount shares PUBLIC and TMP:

           mount_smbfs -I samba.mydomain.com //guest@samba/public /smb/public
           mount_smbfs -I 192.168.20.3 -E koi8-r:cp866 //guest@samba/tmp /smb/tmp

     If you keep on getting "Connection reset by peer" errors, try:

           mount_smbfs -N -I 10.0.0.4 //'*SMBSERVER'/tmp /smb/tmp

     It is possible to use fstab(5) for smbfs mounts:

           //guest@samba/public    /smb/public     smbfs  rw,noauto 0   0


SEE ALSO

     smbutil(1), mount(8)


HISTORY

     Support for SMBFS first appeared in FreeBSD 4.4.  It has been ported to
     NetBSD and first appeared in NetBSD 2.0.


AUTHORS

     Boris Popov <bp@butya.kz>, <bp@FreeBSD.org>.  NetBSD port done by
     Matt Debergalis <deberg@NetBSD.org>, and
     Jaromir Dolecek <jdolecek@NetBSD.org>.


BUGS

     The -E option works only if you mount with rump_smbfs(8) instead of
     mount_smbfs.

     The -c option is not implemented yet.  It is silently ignored for now.

NetBSD 9.2                     November 17, 2014                    NetBSD 9.2