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
+++ new/usr/src/man/man1m/mount_smbfs.1m
1 1 '\" te
2 2 .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved.
3 3 .\" Portions Copyright 1994-2008 The FreeBSD Project. All rights reserved.
4 4 .\" Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and
5 5 .\" the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.THIS SOFTWARE IS PROVIDED
6 6 .\" BY THE AUTHOR AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
7 7 .\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
8 8 .\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
9 -.TH MOUNT_SMBFS 1M "Mar 31, 2009"
9 +.\" Copyright 2012 Nexenta Systems, Inc. All rights reserved.
10 +.TH MOUNT_SMBFS 1M "Jan 2, 2012"
10 11 .SH NAME
11 12 mount_smbfs, umount_smbfs \- mount and unmount a shared resource from a CIFS
12 13 file server
13 14 .SH SYNOPSIS
14 15 .LP
15 16 .nf
16 17 \fB/sbin/mount\fR [\fB-F smbfs\fR] [\fIgeneric-options\fR] [\fB-o\fR \fIname\fR\fB=\fR\fIvalue\fR] [\fB-O\fR] \fIresource\fR
17 18 .fi
18 19
19 20 .LP
20 21 .nf
21 22 \fB/sbin/mount\fR [\fB-F smbfs\fR] [\fIgeneric-options\fR] [\fB-o\fR \fIname\fR\fB=\fR\fIvalue\fR] [\fB-O\fR] \fImount-point\fR
22 23 .fi
23 24
24 25 .LP
25 26 .nf
26 27 \fB/sbin/mount\fR [\fB-F smbfs\fR] [\fIgeneric-options\fR] [\fB-o\fR \fIname\fR\fB=\fR\fIvalue\fR]
27 28 [\fB-O\fR] \fIresource\fR \fImount-point\fR
28 29 .fi
29 30
30 31 .LP
31 32 .nf
32 33 \fB/sbin/umount\fR [\fB-F smbfs\fR] [\fIgeneric-options\fR] \fImount-point\fR
33 34 .fi
34 35
35 36 .SH DESCRIPTION
36 37 .sp
37 38 .LP
38 39 The \fBmount\fR utility attaches a named resource, \fIresource\fR, to the file
39 40 system hierarchy at the path name location, \fImount-point\fR, which must
40 41 already exist.
41 42 .sp
42 43 .LP
43 44 If \fImount-point\fR has any contents prior to the \fBmount\fR operation, those
44 45 contents remain hidden until the resource is unmounted. An authorized user with
45 46 the \fBSYS_MOUNT\fR privilege can perform a \fBmount\fR operation. Also, a user
46 47 can perform SMBFS mount operations on a directory the user owns.
47 48 .sp
48 49 .LP
49 50 If the resource is listed in the \fB/etc/vfstab\fR file, you can specify either
50 51 \fIresource\fR or \fImount-point\fR as the \fBmount\fR command will consult the
51 52 \fB/etc/vfstab\fR file for more information. If the \fB-F\fR option is omitted,
52 53 \fBmount\fR takes the file system type from the entry in the \fB/etc/vfstab\fR
53 54 file.
54 55 .sp
55 56 .LP
56 57 If the resource is not listed in the \fB/etc/vfstab\fR file, the command line
57 58 must specify both \fIresource\fR and \fImount-point\fR.
58 59 .sp
59 60 .LP
60 61 The \fBumount\fR utility detaches a mounted file system from the file system
61 62 hierarchy. An authorized user with the \fBSYS_MOUNT\fR privilege can perform a
62 63 \fBumount\fR operation. Also, a user can perform SMBFS unmount operations on a
63 64 directory the user owns.
64 65 .sp
65 66 .LP
66 67 The \fBnetwork/smb/client\fR service must be enabled to successfully mount a
67 68 CIFS share. This service is enabled, by default.
68 69 .sp
69 70 .LP
70 71 To enable the service, enter the following \fBsvcadm\fR(1M) command:
71 72 .sp
72 73 .in +2
73 74 .nf
74 75 # \fBsvcadm enable network/smb/client\fR
75 76 .fi
76 77 .in -2
77 78 .sp
78 79
79 80 .SS "Operands"
80 81 .sp
81 82 .LP
82 83 The \fBmount\fR command supports the following operands:
83 84 .sp
84 85 .ne 2
85 86 .na
86 87 \fB\fIresource\fR
87 88 //[\fIworkgroup\fR;][\fIuser\fR[:\fIpassword\fR]@]\fIserver\fR/\fIshare\fR\fR
88 89 .ad
89 90 .sp .6
90 91 .RS 4n
91 92 .sp
92 93 .LP
93 94 The name of the resource to be mounted. In addition to its name, you can
94 95 specify the following information about the resource:
95 96 .RS +4
96 97 .TP
97 98 .ie t \(bu
98 99 .el o
99 100 \fIpassword\fR is the password associated with \fIuser\fR. If \fIpassword\fR is
100 101 not specified, the mount first attempts to use the password stored by the
101 102 \fBsmbutil login\fR command (if any). If that password fails to authenticate,
102 103 the \fBmount_smbfs\fR prompts you for a password.
103 104 .RE
104 105 .RS +4
105 106 .TP
106 107 .ie t \(bu
107 108 .el o
108 109 \fIserver\fR is the DNS or NetBIOS name of the remote computer.
109 110 .RE
110 111 .RS +4
111 112 .TP
112 113 .ie t \(bu
113 114 .el o
114 115 \fIshare\fR is the resource name on the remote server.
115 116 .RE
116 117 .RS +4
117 118 .TP
118 119 .ie t \(bu
119 120 .el o
120 121 \fIuser\fR is the remote user name. If \fIuser\fR is omitted, the logged in
121 122 user ID is used.
122 123 .RE
123 124 .RS +4
124 125 .TP
125 126 .ie t \(bu
126 127 .el o
127 128 \fIworkgroup\fR is the name of the workgroup or the Windows domain in which the
128 129 user name is defined.
129 130 .sp
130 131 If the resource includes a workgroup, you must escape the semicolon that
131 132 appears after the workgroup name to prevent it from being interpreted by the
132 133 command shell. For instance, surround the entire resource name with double
133 134 quotes: \fBmount -F smbfs "//SALES;george@RSERVER" /mnt\fR.
134 135 .RE
135 136 .RE
136 137
137 138 .sp
138 139 .ne 2
139 140 .na
140 141 \fB\fImount-point\fR\fR
141 142 .ad
142 143 .sp .6
143 144 .RS 4n
144 145 The path to the location where the file system is to be mounted or unmounted.
145 146 The \fBmount\fR command maintains a table of mounted file systems in the
146 147 \fB/etc/mnttab\fR file. See the \fBmnttab\fR(4) man page.
147 148 .RE
148 149
149 150 .SH OPTIONS
150 151 .sp
151 152 .LP
152 153 See the \fBmount\fR(1M) man page for the list of supported
153 154 \fIgeneric-options\fR.
154 155 .sp
155 156 .ne 2
156 157 .na
157 158 \fB\fB-o\fR \fIname\fR\fB=\fR\fIvalue\fR or\fR
|
↓ open down ↓ |
138 lines elided |
↑ open up ↑ |
158 159 .ad
159 160 .br
160 161 .na
161 162 \fB\fB-o\fR \fIname\fR\fR
162 163 .ad
163 164 .sp .6
164 165 .RS 4n
165 166 Sets the file system-specific properties. You can specify more than one
166 167 name-value pair as a list of comma-separated pairs. No spaces are permitted in
167 168 the list. The properties are as follows:
169 +
168 170 .sp
169 171 .ne 2
170 172 .na
173 +\fB\fBacl\fR|\fBnoacl\fR\fR
174 +.ad
175 +.sp .6
176 +.RS 4n
177 +Enable (or disable) presentation of Access Control Lists (ACLs)
178 +on files and directories under this \fBsmbfs\fR(7FS) mount.
179 +The default behavior is \fBnoacl\fR, which presents files and
180 +directories as owned by the owner of the mount point and having
181 +permissions based on \fBfileperms\fR or \fBdirperms\fR.
182 +With the \fBacl\fR mount option, files are presented with ACLs
183 +obtained from the SMB server.
184 +Setting the \fBacl\fR mount option is not advised unless the system
185 +is joined to an Active Directory domain and using \fBldap\fR(1)
186 +so it can correctly present ACL identities from the SMB server.
187 +.RE
188 +
189 +.sp
190 +.ne 2
191 +.na
171 192 \fB\fBdirperms=\fR\fIoctaltriplet\fR\fR
172 193 .ad
173 194 .sp .6
174 195 .RS 4n
175 196 Specifies the permissions to be assigned to directories. The value must be
176 197 specified as an octal triplet, such as \fB755\fR. The default value for the
177 198 directory mode is taken from the \fBfileperms\fR setting, with execute
178 199 permission added where \fBfileperms\fR has read permission.
179 200 .sp
180 201 Note that these permissions have no relation to the rights granted by the CIFS
181 202 server.
182 203 .RE
183 204
184 205 .sp
185 206 .ne 2
186 207 .na
187 208 \fB\fBfileperms=\fR\fIoctaltriplet\fR\fR
188 209 .ad
189 210 .sp .6
190 211 .RS 4n
191 212 Specifies the permissions to be assigned to files. The value must be specified
192 213 as an octal triplet, such as \fB644\fR. The default value is \fB700\fR.
193 214 .sp
194 215 Note that these permissions have no relation to the rights granted by the CIFS
195 216 server.
196 217 .RE
197 218
198 219 .sp
199 220 .ne 2
200 221 .na
201 222 \fB\fBgid=\fR\fIgroupid\fR\fR
202 223 .ad
203 224 .sp .6
204 225 .RS 4n
205 226 Assigns the specified group ID to files. The default value is the group ID of
206 227 the directory where the volume is mounted.
207 228 .RE
208 229
209 230 .sp
210 231 .ne 2
211 232 .na
212 233 \fB\fBintr\fR|\fBnointr\fR\fR
213 234 .ad
214 235 .sp .6
215 236 .RS 4n
216 237 Enable (or disable) cancellation of \fBsmbfs\fR(7FS) I/O operations when the
217 238 user interrupts the calling thread (for example, by hitting Ctrl-C while an
218 239 operation is underway). The default is \fBintr\fR (interruption enabled), so
219 240 cancellation is normally allowed.
220 241 .RE
221 242
222 243 .sp
223 244 .ne 2
224 245 .na
225 246 \fB\fBnoprompt\fR\fR
226 247 .ad
227 248 .sp .6
228 249 .RS 4n
229 250 Suppresses the prompting for a password when mounting a share. This property
230 251 enables you to permit anonymous access to a share. Anonymous access does not
231 252 require a password.
232 253 .sp
233 254 The \fBmount\fR operation fails if a password is required, the \fBnoprompt\fR
234 255 property is set, and no password is stored by the \fBsmbutil login\fR command.
235 256 .RE
236 257
237 258 .sp
238 259 .ne 2
239 260 .na
240 261 \fB\fBretry_count=\fR\fInumber\fR\fR
241 262 .ad
242 263 .sp .6
243 264 .RS 4n
244 265 Specifies the number of SMBFS retries to attempt before the connection is
245 266 marked as broken. By default, 4 attempts are made.
246 267 .sp
247 268 The \fBretry_count\fR property value set by the \fBmount\fR command overrides
248 269 the global value set in SMF or the value set in your \fB\&.nsmbrc\fR file.
249 270 .RE
250 271
251 272 .sp
252 273 .ne 2
253 274 .na
254 275 \fB\fBtimeout=\fR\fIseconds\fR\fR
255 276 .ad
256 277 .sp .6
257 278 .RS 4n
258 279 Specifies the CIFS request timeout. By default, the timeout is 15 seconds.
259 280 .sp
260 281 The \fBtimeout\fR property value set by the \fBmount\fR command overrides the
261 282 global value set in SMF or the value set in your \fB\&.nsmbrc\fR file.
262 283 .RE
263 284
264 285 .sp
265 286 .ne 2
266 287 .na
267 288 \fB\fBuid=\fR\fIuserid\fR\fR
268 289 .ad
269 290 .sp .6
270 291 .RS 4n
271 292 Assigns the specified user ID files. The default value is the owner ID of the
272 293 directory where the volume is mounted.
273 294 .RE
274 295
275 296 .sp
276 297 .ne 2
277 298 .na
278 299 \fB\fBxattr\fR|\fBnoxattr\fR\fR
279 300 .ad
280 301 .sp .6
281 302 .RS 4n
282 303 Enable (or disable) Solaris Extended Attributes in this mount point. This
283 304 option defaults to \fBxattr\fR (enabled Extended Attributes), but note: if the
284 305 CIFS server does not support CIFS "named streams", \fBsmbfs\fR(7FS) forces this
285 306 option to \fBnoxattr\fR. When a mount has the \fBnoxattr\fR option, attempts to
286 307 use Solaris Extended attributes fail with EINVAL.
287 308 .RE
288 309
289 310 .RE
290 311
291 312 .sp
292 313 .ne 2
293 314 .na
294 315 \fB\fB-O\fR\fR
295 316 .ad
296 317 .sp .6
297 318 .RS 4n
298 319 Overlays mount. Allow the file system to be mounted over an existing mount
299 320 point, making the underlying file system inaccessible. If a mount is attempted
300 321 on a pre-existing mount point without setting this flag, the mount fails,
301 322 producing the error "device busy."
302 323 .RE
303 324
304 325 .SH EXAMPLES
305 326 .LP
306 327 \fBExample 1 \fRMounting an SMBFS Share
307 328 .sp
308 329 .LP
309 330 The following example shows how to mount the \fB/tmp\fR share from the
310 331 \fBnano\fR server in the \fBSALES\fR workgroup on the local \fB/mnt\fR mount
311 332 point. You must supply the password for the \fBroot\fR user to successfully
312 333 perform the mount operation.
313 334
314 335 .sp
315 336 .in +2
316 337 .nf
317 338 # \fBmount -F smbfs "//SALES;root@nano.sfbay/tmp" /mnt\fR
318 339 Password:
319 340 .fi
320 341 .in -2
321 342 .sp
322 343
323 344 .LP
324 345 \fBExample 2 \fRVerifying That an SMBFS File System Is Mounted
325 346 .sp
326 347 .LP
327 348 The following example shows how to mount the \fB/tmp\fR share from the
328 349 \fBnano\fR server on the local \fB/mnt\fR mount point. You must supply the
329 350 password for the \fBroot\fR user to successfully perform the mount operation.
330 351
331 352 .sp
332 353 .in +2
333 354 .nf
334 355 # \fBmount -F smbfs //root@nano.sfbay/tmp /mnt\fR
335 356 Password:
336 357 .fi
337 358 .in -2
338 359 .sp
339 360
340 361 .sp
341 362 .LP
342 363 You can verify that the share is mounted in the following ways:
343 364 .RS +4
344 365 .TP
345 366 .ie t \(bu
346 367 .el o
347 368 View the file system entry in the \fB/etc/mnttab\fR file.
348 369 .sp
349 370 .in +2
350 371 .nf
351 372 # \fBgrep root /etc/mnttab\fR
352 373 //root@nano.sfbay/tmp /mnt smbfs dev=4900000 1177097833
353 374 .fi
354 375 .in -2
355 376 .sp
356 377
357 378 .RE
358 379 .RS +4
359 380 .TP
360 381 .ie t \(bu
361 382 .el o
362 383 View the output of the \fBmount\fR command.
363 384 .sp
364 385 .in +2
365 386 .nf
366 387 # \fBmount | grep root\fR
367 388 /mnt on //root@nano.sfbay/tmp read/write/setuid/devices/dev=4900000 on
368 389 Fri Apr 20 13:37:13 2007
369 390 .fi
370 391 .in -2
371 392 .sp
372 393
373 394 .RE
374 395 .RS +4
375 396 .TP
376 397 .ie t \(bu
377 398 .el o
378 399 View the output of the \fBdf /mnt\fR command.
379 400 .sp
380 401 .in +2
381 402 .nf
382 403 # \fBdf /mnt\fR
383 404 /mnt (//root@nano.sfbay/tmp): 3635872 blocks -1 files
384 405 .fi
385 406 .in -2
386 407 .sp
387 408
388 409 .RE
389 410 .sp
390 411 .LP
391 412 Obtain information about the mounted share by viewing the output of the \fBdf
392 413 -k /mnt\fR command.
393 414
394 415 .sp
395 416 .in +2
396 417 .nf
397 418 # \fBdf -k /mnt\fR
398 419 Filesystem kbytes used avail capacity Mounted on
399 420 //root@nano.sfbay/tmp
400 421 1882384 64448 1817936 4% /mnt
401 422 .fi
402 423 .in -2
403 424 .sp
404 425
405 426 .LP
406 427 \fBExample 3 \fRUnmounting a CIFS Share
407 428 .sp
408 429 .LP
409 430 This example assumes that a CIFS share has been mounted on the \fB/mnt\fR mount
410 431 point. The following command line unmounts the share from the mount point.
411 432
412 433 .sp
413 434 .in +2
414 435 .nf
415 436 # \fBumount /mnt\fR
416 437 .fi
417 438 .in -2
418 439 .sp
419 440
420 441 .SH FILES
421 442 .sp
422 443 .ne 2
423 444 .na
424 445 \fB\fB/etc/mnttab\fR\fR
425 446 .ad
426 447 .sp .6
427 448 .RS 4n
428 449 Table of mounted file systems.
429 450 .RE
430 451
431 452 .sp
432 453 .ne 2
433 454 .na
434 455 \fB\fB/etc/dfs/fstypes\fR\fR
435 456 .ad
436 457 .sp .6
437 458 .RS 4n
438 459 Default distributed file system type.
439 460 .RE
440 461
441 462 .sp
442 463 .ne 2
443 464 .na
444 465 \fB\fB/etc/vfstab\fR\fR
445 466 .ad
446 467 .sp .6
447 468 .RS 4n
448 469 Table of automatically mounted resources.
449 470 .RE
450 471
451 472 .sp
452 473 .ne 2
453 474 .na
454 475 \fB\fB$HOME/.nsmbrc\fR\fR
455 476 .ad
456 477 .sp .6
457 478 .RS 4n
458 479 User-settable mount point configuration file to store the description for each
459 480 connection.
460 481 .RE
461 482
462 483 .SH ATTRIBUTES
463 484 .sp
464 485 .LP
465 486 See the \fBattributes\fR(5) man page for descriptions of the following
466 487 attributes:
467 488 .sp
468 489
469 490 .sp
470 491 .TS
471 492 box;
|
↓ open down ↓ |
291 lines elided |
↑ open up ↑ |
472 493 c | c
473 494 l | l .
474 495 ATTRIBUTE TYPE ATTRIBUTE VALUE
475 496 _
476 497 Interface Stability Committed
477 498 .TE
478 499
479 500 .SH SEE ALSO
480 501 .sp
481 502 .LP
482 -\fBsmbutil\fR(1), \fBmount\fR(1M), \fBmountall\fR(1M), \fBsvcadm\fR(1M),
503 +\fBldap\fR(1), \fBsmbutil\fR(1),
504 +\fBmount\fR(1M), \fBmountall\fR(1M), \fBsvcadm\fR(1M),
483 505 \fBacl\fR(2), \fBfcntl\fR(2), \fBlink\fR(2), \fBmknod\fR(2), \fBmount\fR(2),
484 506 \fBsymlink\fR(2), \fBumount\fR(2), \fBmnttab\fR(4), \fBnsmbrc\fR(4),
485 507 \fBvfstab\fR(4), \fBattributes\fR(5), \fBpcfs\fR(7FS), \fBsmbfs\fR(7FS)
486 508 .SH AUTHORS
487 509 .sp
488 510 .LP
489 511 This manual page contains material originally authored by Boris Popov,
490 512 \fBbpATbutya.kz\fR, \fBbpATFreeBSD.org\fR.
491 513 .SH NOTES
492 514 .sp
493 515 .LP
494 516 The Solaris CIFS client always attempts to use \fBgethostbyname()\fR to resolve
495 517 host names. If the host name cannot be resolved, the CIFS client uses NetBIOS
496 518 name resolution (NBNS). By default, the Solaris CIFS client permits the use of
497 519 NBNS to enable Solaris CIFS clients in Windows environments to work without
498 520 additional configuration.
499 521 .sp
500 522 .LP
501 523 Since NBNS has been exploited in the past, you might want to disable it. To
502 524 disable NBNS, set the \fBnbns-enabled\fR service management facility property
503 525 to \fBfalse\fR. By default, \fBnbns-enabled\fR is set to \fBtrue\fR.
504 526 .sp
505 527 .LP
506 528 If the directory on which a file system is to be mounted is a symbolic link,
507 529 the file system is mounted on the directory to which the symbolic link refers,
508 530 rather than being mounted on top of the symbolic link itself.
|
↓ open down ↓ |
16 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX