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>
   1 '\" te
   2 .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved.
   3 .\" Portions Copyright 1994-2008 The FreeBSD Project. All rights reserved.
   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 .\" 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 .\" 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 .\" 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 .\" 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"

  10 .SH NAME
  11 mount_smbfs, umount_smbfs \- mount and unmount a shared resource from a CIFS
  12 file server
  13 .SH SYNOPSIS
  14 .LP
  15 .nf
  16 \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 .fi
  18 
  19 .LP
  20 .nf
  21 \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 .fi
  23 
  24 .LP
  25 .nf
  26 \fB/sbin/mount\fR [\fB-F smbfs\fR] [\fIgeneric-options\fR] [\fB-o\fR \fIname\fR\fB=\fR\fIvalue\fR]
  27      [\fB-O\fR] \fIresource\fR \fImount-point\fR
  28 .fi
  29 


 148 
 149 .SH OPTIONS
 150 .sp
 151 .LP
 152 See the \fBmount\fR(1M) man page for the list of supported
 153 \fIgeneric-options\fR.
 154 .sp
 155 .ne 2
 156 .na
 157 \fB\fB-o\fR \fIname\fR\fB=\fR\fIvalue\fR or\fR
 158 .ad
 159 .br
 160 .na
 161 \fB\fB-o\fR \fIname\fR\fR
 162 .ad
 163 .sp .6
 164 .RS 4n
 165 Sets the file system-specific properties. You can specify more than one
 166 name-value pair as a list of comma-separated pairs. No spaces are permitted in
 167 the list. The properties are as follows:

 168 .sp
 169 .ne 2
 170 .na



















 171 \fB\fBdirperms=\fR\fIoctaltriplet\fR\fR
 172 .ad
 173 .sp .6
 174 .RS 4n
 175 Specifies the permissions to be assigned to directories. The value must be
 176 specified as an octal triplet, such as \fB755\fR. The default value for the
 177 directory mode is taken from the \fBfileperms\fR setting, with execute
 178 permission added where \fBfileperms\fR has read permission.
 179 .sp
 180 Note that these permissions have no relation to the rights granted by the CIFS
 181 server.
 182 .RE
 183 
 184 .sp
 185 .ne 2
 186 .na
 187 \fB\fBfileperms=\fR\fIoctaltriplet\fR\fR
 188 .ad
 189 .sp .6
 190 .RS 4n


 462 .SH ATTRIBUTES
 463 .sp
 464 .LP
 465 See the \fBattributes\fR(5) man page for descriptions of the following
 466 attributes:
 467 .sp
 468 
 469 .sp
 470 .TS
 471 box;
 472 c | c
 473 l | l .
 474 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 475 _
 476 Interface Stability     Committed
 477 .TE
 478 
 479 .SH SEE ALSO
 480 .sp
 481 .LP
 482 \fBsmbutil\fR(1), \fBmount\fR(1M), \fBmountall\fR(1M), \fBsvcadm\fR(1M),

 483 \fBacl\fR(2), \fBfcntl\fR(2), \fBlink\fR(2), \fBmknod\fR(2), \fBmount\fR(2),
 484 \fBsymlink\fR(2), \fBumount\fR(2), \fBmnttab\fR(4), \fBnsmbrc\fR(4),
 485 \fBvfstab\fR(4), \fBattributes\fR(5), \fBpcfs\fR(7FS), \fBsmbfs\fR(7FS)
 486 .SH AUTHORS
 487 .sp
 488 .LP
 489 This manual page contains material originally authored by Boris Popov,
 490 \fBbpATbutya.kz\fR, \fBbpATFreeBSD.org\fR.
 491 .SH NOTES
 492 .sp
 493 .LP
 494 The Solaris CIFS client always attempts to use \fBgethostbyname()\fR to resolve
 495 host names. If the host name cannot be resolved, the CIFS client uses NetBIOS
 496 name resolution (NBNS). By default, the Solaris CIFS client permits the use of
 497 NBNS to enable Solaris CIFS clients in Windows environments to work without
 498 additional configuration.
 499 .sp
 500 .LP
 501 Since NBNS has been exploited in the past, you might want to disable it. To
 502 disable NBNS, set the \fBnbns-enabled\fR service management facility property
   1 '\" te
   2 .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved.
   3 .\" Portions Copyright 1994-2008 The FreeBSD Project. All rights reserved.
   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 .\" 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 .\" 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 .\" 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 .\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
   9 .\" Copyright 2012 Nexenta Systems, Inc.  All rights reserved.
  10 .TH MOUNT_SMBFS 1M "Jan 2, 2012"
  11 .SH NAME
  12 mount_smbfs, umount_smbfs \- mount and unmount a shared resource from a CIFS
  13 file server
  14 .SH SYNOPSIS
  15 .LP
  16 .nf
  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
  18 .fi
  19 
  20 .LP
  21 .nf
  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
  23 .fi
  24 
  25 .LP
  26 .nf
  27 \fB/sbin/mount\fR [\fB-F smbfs\fR] [\fIgeneric-options\fR] [\fB-o\fR \fIname\fR\fB=\fR\fIvalue\fR]
  28      [\fB-O\fR] \fIresource\fR \fImount-point\fR
  29 .fi
  30 


 149 
 150 .SH OPTIONS
 151 .sp
 152 .LP
 153 See the \fBmount\fR(1M) man page for the list of supported
 154 \fIgeneric-options\fR.
 155 .sp
 156 .ne 2
 157 .na
 158 \fB\fB-o\fR \fIname\fR\fB=\fR\fIvalue\fR or\fR
 159 .ad
 160 .br
 161 .na
 162 \fB\fB-o\fR \fIname\fR\fR
 163 .ad
 164 .sp .6
 165 .RS 4n
 166 Sets the file system-specific properties. You can specify more than one
 167 name-value pair as a list of comma-separated pairs. No spaces are permitted in
 168 the list. The properties are as follows:
 169 
 170 .sp
 171 .ne 2
 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
 192 \fB\fBdirperms=\fR\fIoctaltriplet\fR\fR
 193 .ad
 194 .sp .6
 195 .RS 4n
 196 Specifies the permissions to be assigned to directories. The value must be
 197 specified as an octal triplet, such as \fB755\fR. The default value for the
 198 directory mode is taken from the \fBfileperms\fR setting, with execute
 199 permission added where \fBfileperms\fR has read permission.
 200 .sp
 201 Note that these permissions have no relation to the rights granted by the CIFS
 202 server.
 203 .RE
 204 
 205 .sp
 206 .ne 2
 207 .na
 208 \fB\fBfileperms=\fR\fIoctaltriplet\fR\fR
 209 .ad
 210 .sp .6
 211 .RS 4n


 483 .SH ATTRIBUTES
 484 .sp
 485 .LP
 486 See the \fBattributes\fR(5) man page for descriptions of the following
 487 attributes:
 488 .sp
 489 
 490 .sp
 491 .TS
 492 box;
 493 c | c
 494 l | l .
 495 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 496 _
 497 Interface Stability     Committed
 498 .TE
 499 
 500 .SH SEE ALSO
 501 .sp
 502 .LP
 503 \fBldap\fR(1), \fBsmbutil\fR(1),
 504 \fBmount\fR(1M), \fBmountall\fR(1M), \fBsvcadm\fR(1M),
 505 \fBacl\fR(2), \fBfcntl\fR(2), \fBlink\fR(2), \fBmknod\fR(2), \fBmount\fR(2),
 506 \fBsymlink\fR(2), \fBumount\fR(2), \fBmnttab\fR(4), \fBnsmbrc\fR(4),
 507 \fBvfstab\fR(4), \fBattributes\fR(5), \fBpcfs\fR(7FS), \fBsmbfs\fR(7FS)
 508 .SH AUTHORS
 509 .sp
 510 .LP
 511 This manual page contains material originally authored by Boris Popov,
 512 \fBbpATbutya.kz\fR, \fBbpATFreeBSD.org\fR.
 513 .SH NOTES
 514 .sp
 515 .LP
 516 The Solaris CIFS client always attempts to use \fBgethostbyname()\fR to resolve
 517 host names. If the host name cannot be resolved, the CIFS client uses NetBIOS
 518 name resolution (NBNS). By default, the Solaris CIFS client permits the use of
 519 NBNS to enable Solaris CIFS clients in Windows environments to work without
 520 additional configuration.
 521 .sp
 522 .LP
 523 Since NBNS has been exploited in the past, you might want to disable it. To
 524 disable NBNS, set the \fBnbns-enabled\fR service management facility property