1mount_smbfs(1M) System Administration Commands mount_smbfs(1M)
2
6 mount_smbfs, umount_smbfs - mount and unmount a shared resource from a
7 CIFS file server
8
10 /sbin/mount [-F smbfs] [generic-options] [-o name=value] [-O] resource
11 /sbin/mount [-F smbfs] [generic-options] [-o name=value] [-O] mount-point
14 /sbin/mount [-F smbfs] [generic-options] [-o name=value]
17 [-O] resource mount-point
18 /sbin/umount [-F smbfs] [generic-options] mount-point
21
24 The mount utility attaches a named resource, resource, to the file sys‐
25 tem hierarchy at the path name location, mount-point, which must
26 already exist.
27 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 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 If the resource is not listed in the /etc/vfstab file, the command line
43 must specify both resource and mount-point.
44 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 The network/smb/client service must be enabled to successfully mount a
53 CIFS share. This service is enabled, by default.
54 To enable the service, enter the following svcadm(1M) command:
57 # svcadm enable network/smb/client
59 Operands
63 The mount command supports the following operands:
64 resource //[workgroup;][user[:password]@]server/share
66 The name of the resource to be mounted. In addition to its name,
70 you can specify the following information about the resource:
71 o password is the password associated with user. If pass‐
73 word is not specified, the mount first attempts to use
74 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 o server is the DNS or NetBIOS name of the remote com‐
79 puter.
80 o share is the resource name on the remote server.
82 o user is the remote user name. If user is omitted, the
84 logged in user ID is used.
85 o workgroup is the name of the workgroup or the Windows
87 domain in which the user name is defined.
88 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 mount-point
98 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 sys‐
101 tems in the /etc/mnttab file. See the mnttab(4) man page.
102
105 See the mount(1M) man page for the list of supported generic-options.
106 -o name=value or
108 -o name
109 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 dirperms=octaltriplet
115 Specifies the permissions to be assigned to directories. The
117 value must be specified as an octal triplet, such as 755. The
118 default value for the directory mode is taken from the
119 fileperms setting, with execute permission added where
120 fileperms has read permission.
121 Note that these permissions have no relation to the rights
123 granted by the CIFS server.
124 fileperms=octaltriplet
127 Specifies the permissions to be assigned to files. The value
129 must be specified as an octal triplet, such as 644. The default
130 value is 700.
131 Note that these permissions have no relation to the rights
133 granted by the CIFS server.
134 gid=groupid
137 Assigns the specified group ID to files. The default value is
139 the group ID of the directory where the volume is mounted.
140 intr|nointr
143 Enable (or disable) cancellation of smbfs(7FS) I/O operations
145 when the user interrupts the calling thread (for example, by
146 hitting Ctrl-C while an operation is underway). The default is
147 intr (interruption enabled), so cancellation is normally
148 allowed.
149 noprompt
152 Suppresses the prompting for a password when mounting a share.
154 This property enables you to permit anonymous access to a
155 share. Anonymous access does not require a password.
156 The mount operation fails if a password is required, the
158 noprompt property is set, and no password is stored by the
159 smbutil login command.
160 retry_count=number
163 Specifies the number of SMBFS retries to attempt before the
165 connection is marked as broken. By default, 4 attempts are
166 made.
167 The retry_count property value set by the mount command over‐
169 rides the global value set in SMF or the value set in your
170 .nsmbrc file.
171 timeout=seconds
174 Specifies the CIFS request timeout. By default, the timeout is
176 15 seconds.
177 The timeout property value set by the mount command overrides
179 the global value set in SMF or the value set in your .nsmbrc
180 file.
181 uid=userid
184 Assigns the specified user ID files. The default value is the
186 owner ID of the directory where the volume is mounted.
187 xattr|noxattr
190 Enable (or disable) Solaris Extended Attributes in this mount
192 point. This option defaults to xattr (enabled Extended
193 Attributes), but note: if the CIFS server does not support CIFS
194 "named streams", smbfs(7FS) forces this option to noxattr. When
195 a mount has the noxattr option, attempts to use Solaris
196 Extended attributes fail with EINVAL.
197 -O
201 Overlays mount. Allow the file system to be mounted over an exist‐
203 ing mount point, making the underlying file system inaccessible. If
204 a mount is attempted on a pre-existing mount point without setting
205 this flag, the mount fails, producing the error "device busy."
206
209 Example 1 Mounting an SMBFS Share
210 The following example shows how to mount the /tmp share from the nano
213 server in the SALES workgroup on the local /mnt mount point. You must
214 supply the password for the root user to successfully perform the mount
215 operation.
216 # mount -F smbfs "//SALES;root@nano.sfbay/tmp" /mnt
219 Password:
220 Example 2 Verifying That an SMBFS File System Is Mounted
224 The following example shows how to mount the /tmp share from the nano
227 server on the local /mnt mount point. You must supply the password for
228 the root user to successfully perform the mount operation.
229 # mount -F smbfs //root@nano.sfbay/tmp /mnt
232 Password:
233 You can verify that the share is mounted in the following ways:
238 o View the file system entry in the /etc/mnttab file.
240 # grep root /etc/mnttab
242 //root@nano.sfbay/tmp /mnt smbfs dev=4900000 1177097833
243 o View the output of the mount command.
247 # mount | grep root
249 /mnt on //root@nano.sfbay/tmp read/write/setuid/devices/dev=4900000 on
250 Fri Apr 20 13:37:13 2007
251 o View the output of the df /mnt command.
255 # df /mnt
257 /mnt (//root@nano.sfbay/tmp): 3635872 blocks -1 files
258 Obtain information about the mounted share by viewing the output of the
263 df -k /mnt command.
264 # df -k /mnt
267 Filesystem kbytes used avail capacity Mounted on
268 //root@nano.sfbay/tmp
269 1882384 64448 1817936 4% /mnt
270 Example 3 Unmounting a CIFS Share
274 This example assumes that a CIFS share has been mounted on the /mnt
277 mount point. The following command line unmounts the share from the
278 mount point.
279 # umount /mnt
282
286 /etc/mnttab
287 Table of mounted file systems.
289 /etc/dfs/fstypes
292 Default distributed file system type.
294 /etc/vfstab
297 Table of automatically mounted resources.
299 $HOME/.nsmbrc
302 User-settable mount point configuration file to store the descrip‐
304 tion for each connection.
305
308 See the attributes(5) man page for descriptions of the following
309 attributes:
310 ┌─────────────────────────────┬─────────────────────────────┐
315 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
316 ├─────────────────────────────┼─────────────────────────────┤
317 │Availability │SUNWsmbfscu │
318 ├─────────────────────────────┼─────────────────────────────┤
319 │Interface Stability │Committed │
320 └─────────────────────────────┴─────────────────────────────┘
321
323 smbutil(1), mount(1M), mountall(1M), svcadm(1M), acl(2), fcntl(2),
324 link(2), mknod(2), mount(2), symlink(2), umount(2), mnttab(4), nsm‐
325 brc(4), vfstab(4), attributes(5), pcfs(7FS), smbfs(7FS)
326
328 This manual page contains material originally authored by Boris Popov,
329 bpATbutya.kz, bpATFreeBSD.org.
330
332 The Solaris CIFS client always attempts to use gethostbyname() to
333 resolve host names. If the host name cannot be resolved, the CIFS
334 client uses NetBIOS name resolution (NBNS). By default, the Solaris
335 CIFS client permits the use of NBNS to enable Solaris CIFS clients in
336 Windows environments to work without additional configuration.
337 Since NBNS has been exploited in the past, you might want to disable
340 it. To disable NBNS, set the nbns-enabled service management facility
341 property to false. By default, nbns-enabled is set to true.
342 If the directory on which a file system is to be mounted is a symbolic
345 link, the file system is mounted on the directory to which the symbolic
346 link refers, rather than being mounted on top of the symbolic link
347 itself.
348SunOS 5.11 31 Mar 2009 mount_smbfs(1M)