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