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