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