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