1 MOUNT_SMBFS(1M)              Maintenance Commands              MOUNT_SMBFS(1M)
   2 
   3 NAME
   4      mount_smbfs, umount_smbfs - mount and unmount a shared resource from an
   5      SMB file server
   6 
   7 SYNOPSIS
   8      mount [-F smbfs] [generic-options] [-o name[=value]] [-O] resource
   9      mount [-F smbfs] [generic-options] [-o name[=value]] [-O] mount-point
  10      mount [-F smbfs] [generic-options] [-o name[=value]] [-O]
  11            resource mount-point
  12      umount [-F smbfs] [generic-options] mount-point
  13 
  14 DESCRIPTION
  15      The mount utility attaches a named resource, resource, to the file system
  16      hierarchy at the path name location, mount-point, which must already
  17      exist.
  18 
  19      The mount utility attaches a named resource, resource, to the file system
  20      hierarchy at the path name location, mount-point, which must already
  21      exist.
  22 
  23      If mount-point has any contents prior to the mount operation, those
  24      contents remain hidden until the resource is unmounted.  An authorized
  25      user with the SYS_MOUNT privilege can perform a mount operation.  Also, a
  26      user can perform SMBFS mount operations on a directory the user owns.
  27 
  28      If the resource is listed in the /etc/vfstab file, you can specify either
  29      resource or mount-point as the mount command will consult the /etc/vfstab
  30      file for more information.  If the -F option is omitted, mount takes the
  31      file system type from the entry in the /etc/vfstab file.
  32 
  33      If the resource is not listed in the /etc/vfstab file, the command line
  34      must specify both resource and mount-point.
  35 
  36      The umount utility detaches a mounted file system from the file system
  37      hierarchy.  An authorized user with the SYS_MOUNT privilege can perform a
  38      umount operation.  Also, a user can perform SMBFS unmount operations on a
  39      directory the user owns.
  40 
  41      The network/smb/client service must be enabled to successfully mount an
  42      SMB share.  This service is enabled, by default.
  43 
  44      To enable the service, enter the following svcadm(1M) command:
  45 
  46      # svcadm enable network/smb/client
  47 
  48    Operands
  49      The mount command supports the following operands:
  50 
  51      resource //[workgroup;][user[:password]@]server/share
  52              The name of the resource to be mounted.  In addition to its name,
  53              you can specify the following information about the resource:
  54 
  55              o   password is the password associated with user.  If password
  56                  is not specified, the mount first attempts to use the
  57                  password stored by the smbutil login command (if any).  If
  58                  that password fails to authenticate, the mount_smbfs prompts
  59                  you for a password.
  60 
  61              o   server is the DNS or NetBIOS name of the remote computer.
  62 
  63              o   share is the resource name on the remote server.
  64 
  65              o   user is the remote user name.  If user is omitted, the logged
  66                  in user ID is used.
  67 
  68              o   workgroup is the name of the workgroup or the Windows domain
  69                  in which the user name is defined.
  70 
  71                  If the resource includes a workgroup, you must escape the
  72                  semicolon that appears after the workgroup name to prevent it
  73                  from being interpreted by the command shell.  For instance,
  74                  surround the entire resource name with double quotes:
  75 
  76                  mount -F smbfs "//SALES;george@RSERVER" /mnt
  77 
  78      mount-point
  79              The path to the location where the file system is to be mounted
  80              or unmounted.  The mount command maintains a table of mounted
  81              file systems in the /etc/mnttab file.  See the mnttab(4) man
  82              page.
  83 
  84 OPTIONS
  85      See the mount(1M) man page for the list of supported generic-options.
  86 
  87      -o name[=value]
  88              Sets the file system-specific properties.  You can specify more
  89              than one name-value pair as a list of comma-separated pairs.  No
  90              spaces are permitted in the list.  The properties are as follows:
  91 
  92              acl|noacl
  93                      Enable (or disable) presentation of Access Control Lists
  94                      (ACLs) on files and directories under this smbfs(7FS)
  95                      mount.  The default behavior is noacl, which presents
  96                      files and directories as owned by the owner of the mount
  97                      point and having permissions based on fileperms or
  98                      dirperms.  With the acl mount option, files are presented
  99                      with ACLs obtained from the SMB server.  Setting the acl
 100                      mount option is not advised unless the system is joined
 101                      to an Active Directory domain and using ldap(1) so it can
 102                      correctly present ACL identities from the SMB server.
 103 
 104              dirperms=octaltriplet
 105                      Specifies the permissions to be assigned to directories.
 106                      The value must be specified as an octal triplet, such as
 107                      `755'.  The default value for the directory mode is taken
 108                      from the fileperms setting, with execute permission added
 109                      where fileperms has read permission.
 110 
 111                      Note that these permissions have no relation to the
 112                      rights granted by the SMB server.
 113 
 114              fileperms=octaltriplet
 115                      Specifies the permissions to be assigned to files.  The
 116                      value must be specified as an octal triplet, such as
 117                      `644'.  The default value is `700'.
 118 
 119                      Note that these permissions have no relation to the
 120                      rights granted by the SMB server.
 121 
 122              gid=groupid
 123                      Assigns the specified group ID to files.  The default
 124                      value is the group ID of the directory where the volume
 125                      is mounted.
 126 
 127              intr|nointr
 128                      Enable (or disable) cancellation of smbfs(7FS) I/O
 129                      operations when the user interrupts the calling thread
 130                      (for example, by hitting Ctrl-C while an operation is
 131                      underway).  The default is intr (interruption enabled),
 132                      so cancellation is normally allowed.
 133 
 134              noprompt
 135                      Suppresses the prompting for a password when mounting a
 136                      share.  This property enables you to permit anonymous
 137                      access to a share.  Anonymous access does not require a
 138                      password.
 139 
 140                      The mount operation fails if a password is required, the
 141                      noprompt property is set, and no password is stored by
 142                      the smbutil login command.
 143 
 144              retry_count=number
 145                      Specifies the number of SMBFS retries to attempt before
 146                      the connection is marked as broken.  By default, 4
 147                      attempts are made.
 148 
 149                      The retry_count property value set by the mount command
 150                      overrides the global value set in SMF or the value set in
 151                      your .nsmbrc file.
 152 
 153              timeout=seconds
 154                      Specifies the SMB request timeout.  By default, the
 155                      timeout is 15 seconds.
 156 
 157                      The timeout property value set by the mount command
 158                      overrides the global value set in SMF or the value set in
 159                      your .nsmbrc file.
 160 
 161              uid=userid
 162                      Assigns the specified user ID files.  The default value
 163                      is the owner ID of the directory where the volume is
 164                      mounted.
 165 
 166              xattr|noxattr
 167                      Enable (or disable) Extended Attributes in this mount
 168                      point.  This option defaults to xattr (enabled Extended
 169                      Attributes), but note: if the SMB server does not support
 170                      SMB "named streams", smbfs(7FS) forces this option to
 171                      noxattr.  When a mount has the noxattr option, attempts
 172                      to use Extended attributes fail with EINVAL.
 173 
 174      -O      Overlays mount.  Allow the file system to be mounted over an
 175              existing mount point, making the underlying file system
 176              inaccessible.  If a mount is attempted on a pre-existing mount
 177              point without setting this flag, the mount fails, producing the
 178              error "device busy."
 179 
 180 FILES
 181      /etc/mnttab                       Table of mounted file systems.
 182 
 183      /etc/dfs/fstypes                  Default distributed file system type.
 184 
 185      /etc/vfstab                       Table of automatically mounted
 186                                        resources.
 187 
 188      $HOME/.nsmbrc                     User-settable mount point configuration
 189                                        file to store the description for each
 190                                        connection.
 191 
 192 EXAMPLES
 193      Example 1 Mounting an SMBFS Share
 194              The following example shows how to mount the /tmp share from the
 195              nano server in the SALES workgroup on the local /mnt mount point.
 196              You must supply the password for the root user to successfully
 197              perform the mount operation.
 198 
 199              # mount -F smbfs "//SALES;root@nano.sfbay/tmp" /mnt
 200              Password:
 201 
 202      Example 2 Verifying That an SMBFS File System Is Mounted
 203              The following example shows how to mount the /tmp share from the
 204              nano server on the local /mnt mount point.  You must supply the
 205              password for the root user to successfully perform the mount
 206              operation.
 207 
 208              # mount -F smbfs //root@nano.sfbay/tmp /mnt
 209              Password:
 210 
 211              You can verify that the share is mounted in the following ways:
 212 
 213              o   View the file system entry in the /etc/mnttab file.
 214 
 215                  # grep root /etc/mnttab
 216                  //root@nano.sfbay/tmp   /mnt    smbfs   dev=4900000     1177097833
 217 
 218              o   View the output of the `mount' command.
 219 
 220                  # mount | grep root
 221                  /mnt on //root@nano.sfbay/tmp read/write/setuid/devices/dev=4900000 on
 222                  Fri Apr 20 13:37:13 2007
 223 
 224              o   View the output of the `df /mnt' command.
 225 
 226                  # df /mnt
 227                  /mnt               (//root@nano.sfbay/tmp): 3635872 blocks       -1 files
 228 
 229              Obtain information about the mounted share by viewing the output
 230              of the `df -k /mnt' command.
 231 
 232              # df -k /mnt
 233              Filesystem            kbytes    used   avail capacity  Mounted on
 234              //root@nano.sfbay/tmp
 235                                    1882384   64448 1817936     4%    /mnt
 236 
 237      Example 3 Unmounting an SMB Share
 238              This example assumes that an SMB share has been mounted on the
 239              /mnt mount point.  The following command line unmounts the share
 240              from the mount point.
 241 
 242              # umount /mnt
 243 
 244 INTERFACE STABILITY
 245      Committed
 246 
 247 SEE ALSO
 248      ldap(1), smbutil(1), mount(1M), mountall(1M), svcadm(1M), acl(2),
 249      fcntl(2), link(2), mknod(2), mount(2), symlink(2), umount(2), mnttab(4),
 250      nsmbrc(4), vfstab(4), attributes(5), pcfs(7FS), smbfs(7FS)
 251 
 252 AUTHORS
 253      This manual page contains material originally authored by Boris Popov
 254      <bp@butya.kz>, <bp@FreeBSD.org>.
 255 
 256 NOTES
 257      The SMB client always attempts to use gethostbyname(3NSL) to resolve host
 258      names.  If the host name cannot be resolved, the SMB client uses NetBIOS
 259      name resolution (NBNS).  By default, the SMB client permits the use of
 260      NBNS to enable SMB clients in Windows environments to work without
 261      additional configuration.
 262 
 263      Since NBNS has been exploited in the past, you might want to disable it.
 264      To disable NBNS, set the nbns-enabled service management facility
 265      property to false.  By default, nbns-enabled is set to true.
 266 
 267      If the directory on which a file system is to be mounted is a symbolic
 268      link, the file system is mounted on the directory to which the symbolic
 269      link refers, rather than being mounted on top of the symbolic link
 270      itself.
 271 
 272 NexentaStor                      March 4, 2018                     NexentaStor