Print this page
Convert mount_smbfs.1m to mdoc

*** 1,364 **** MOUNT_SMBFS(1M) Maintenance Commands MOUNT_SMBFS(1M) - - NAME ! mount_smbfs, umount_smbfs - mount and unmount a shared resource from a ! CIFS file server SYNOPSIS ! /sbin/mount [-F smbfs] [generic-options] [-o name=value] [-O] resource - - /sbin/mount [-F smbfs] [generic-options] [-o name=value] [-O] mount-point - - - /sbin/mount [-F smbfs] [generic-options] [-o name=value] - [-O] resource mount-point - - - /sbin/umount [-F smbfs] [generic-options] mount-point - - DESCRIPTION ! The mount utility attaches a named resource, resource, to the file ! system hierarchy at the path name location, mount-point, which must ! already exist. If mount-point has any contents prior to the mount operation, those contents remain hidden until the resource is unmounted. An authorized ! user with the SYS_MOUNT privilege can perform a mount operation. Also, ! a user can perform SMBFS mount operations on a directory the user owns. - If the resource is listed in the /etc/vfstab file, you can specify - either resource or mount-point as the mount command will consult the - /etc/vfstab file for more information. If the -F option is omitted, - mount takes the file system type from the entry in the /etc/vfstab - file. - - If the resource is not listed in the /etc/vfstab file, the command line must specify both resource and mount-point. - The umount utility detaches a mounted file system from the file system ! hierarchy. An authorized user with the SYS_MOUNT privilege can perform ! a umount operation. Also, a user can perform SMBFS unmount operations ! on a directory the user owns. - The network/smb/client service must be enabled to successfully mount a - CIFS share. This service is enabled, by default. - - To enable the service, enter the following svcadm(1M) command: # svcadm enable network/smb/client - - Operands The mount command supports the following operands: resource //[workgroup;][user[:password]@]server/share - - - The name of the resource to be mounted. In addition to its name, you can specify the following information about the resource: ! o password is the password associated with user. If ! password is not specified, the mount first attempts to ! use the password stored by the smbutil login command (if ! any). If that password fails to authenticate, the ! mount_smbfs prompts you for a password. ! o server is the DNS or NetBIOS name of the remote ! computer. o share is the resource name on the remote server. ! o user is the remote user name. If user is omitted, the ! logged in user ID is used. ! o workgroup is the name of the workgroup or the Windows ! domain in which the user name is defined. ! If the resource includes a workgroup, you must escape ! the semicolon that appears after the workgroup name to ! prevent it from being interpreted by the command shell. ! For instance, surround the entire resource name with ! double quotes: mount -F smbfs "//SALES;george@RSERVER" ! /mnt. mount-point - The path to the location where the file system is to be mounted or - unmounted. The mount command maintains a table of mounted file - systems in the /etc/mnttab file. See the mnttab(4) man page. - - OPTIONS See the mount(1M) man page for the list of supported generic-options. ! -o name=value or ! -o name - Sets the file system-specific properties. You can specify more than - one name-value pair as a list of comma-separated pairs. No spaces - are permitted in the list. The properties are as follows: - - acl|noacl - Enable (or disable) presentation of Access Control Lists (ACLs) - on files and directories under this smbfs(7FS) mount. The - default behavior is noacl, which presents files and directories - as owned by the owner of the mount point and having permissions - based on fileperms or dirperms. With the acl mount option, - files are presented with ACLs obtained from the SMB server. - Setting the acl mount option is not advised unless the system - is joined to an Active Directory domain and using ldap(1) so it - can correctly present ACL identities from the SMB server. - - dirperms=octaltriplet ! Specifies the permissions to be assigned to directories. The ! value must be specified as an octal triplet, such as 755. The ! default value for the directory mode is taken from the ! fileperms setting, with execute permission added where ! fileperms has read permission. - Note that these permissions have no relation to the rights - granted by the CIFS server. - - fileperms=octaltriplet ! Specifies the permissions to be assigned to files. The value ! must be specified as an octal triplet, such as 644. The default ! value is 700. - Note that these permissions have no relation to the rights - granted by the CIFS server. - - gid=groupid - Assigns the specified group ID to files. The default value is - the group ID of the directory where the volume is mounted. - - intr|nointr - Enable (or disable) cancellation of smbfs(7FS) I/O operations - when the user interrupts the calling thread (for example, by - hitting Ctrl-C while an operation is underway). The default is - intr (interruption enabled), so cancellation is normally - allowed. - - noprompt - Suppresses the prompting for a password when mounting a share. - This property enables you to permit anonymous access to a - share. Anonymous access does not require a password. - The mount operation fails if a password is required, the ! noprompt property is set, and no password is stored by the ! smbutil login command. - retry_count=number - Specifies the number of SMBFS retries to attempt before the - connection is marked as broken. By default, 4 attempts are - made. - The retry_count property value set by the mount command ! overrides the global value set in SMF or the value set in your ! .nsmbrc file. - timeout=seconds ! Specifies the CIFS request timeout. By default, the timeout is ! 15 seconds. - The timeout property value set by the mount command overrides - the global value set in SMF or the value set in your .nsmbrc - file. - - uid=userid - Assigns the specified user ID files. The default value is the - owner ID of the directory where the volume is mounted. - - xattr|noxattr ! ! Enable (or disable) Solaris Extended Attributes in this mount point. This option defaults to xattr (enabled Extended ! Attributes), but note: if the CIFS server does not support CIFS ! "named streams", smbfs(7FS) forces this option to noxattr. When ! a mount has the noxattr option, attempts to use Solaris ! Extended attributes fail with EINVAL. ! -O ! Overlays mount. Allow the file system to be mounted over an ! existing mount point, making the underlying file system ! inaccessible. If a mount is attempted on a pre-existing mount point ! without setting this flag, the mount fails, producing the error ! "device busy." EXAMPLES Example 1 Mounting an SMBFS Share - - The following example shows how to mount the /tmp share from the nano - server in the SALES workgroup on the local /mnt mount point. You must - supply the password for the root user to successfully perform the mount - operation. - - # mount -F smbfs "//SALES;root@nano.sfbay/tmp" /mnt Password: - - Example 2 Verifying That an SMBFS File System Is Mounted - - The following example shows how to mount the /tmp share from the nano - server on the local /mnt mount point. You must supply the password for - the root user to successfully perform the mount operation. - - # mount -F smbfs //root@nano.sfbay/tmp /mnt Password: - - - You can verify that the share is mounted in the following ways: o View the file system entry in the /etc/mnttab file. # grep root /etc/mnttab //root@nano.sfbay/tmp /mnt smbfs dev=4900000 1177097833 - - o View the output of the mount command. - # mount | grep root /mnt on //root@nano.sfbay/tmp read/write/setuid/devices/dev=4900000 on Fri Apr 20 13:37:13 2007 - - o View the output of the df /mnt command. - # df /mnt /mnt (//root@nano.sfbay/tmp): 3635872 blocks -1 files - - - Obtain information about the mounted share by viewing the output of the - df -k /mnt command. - - # df -k /mnt Filesystem kbytes used avail capacity Mounted on //root@nano.sfbay/tmp 1882384 64448 1817936 4% /mnt - - Example 3 Unmounting a CIFS Share - - - This example assumes that a CIFS share has been mounted on the /mnt - mount point. The following command line unmounts the share from the - mount point. - - # umount /mnt - - FILES - /etc/mnttab - - Table of mounted file systems. - - - /etc/dfs/fstypes - - Default distributed file system type. - - - /etc/vfstab - - Table of automatically mounted resources. - - - $HOME/.nsmbrc - - User-settable mount point configuration file to store the - description for each connection. - - - ATTRIBUTES - See the attributes(5) man page for descriptions of the following - attributes: - - - - - +--------------------+-----------------+ - | ATTRIBUTE TYPE | ATTRIBUTE VALUE | - +--------------------+-----------------+ - |Interface Stability | Committed | - +--------------------+-----------------+ - SEE ALSO ldap(1), smbutil(1), mount(1M), mountall(1M), svcadm(1M), acl(2), ! fcntl(2), link(2), mknod(2), mount(2), symlink(2), umount(2), ! mnttab(4), nsmbrc(4), vfstab(4), attributes(5), pcfs(7FS), smbfs(7FS) AUTHORS ! This manual page contains material originally authored by Boris Popov, ! bpATbutya.kz, bpATFreeBSD.org. NOTES ! The Solaris CIFS client always attempts to use gethostbyname() to ! resolve host names. If the host name cannot be resolved, the CIFS ! client uses NetBIOS name resolution (NBNS). By default, the Solaris ! CIFS client permits the use of NBNS to enable Solaris CIFS clients in ! Windows environments to work without additional configuration. ! ! Since NBNS has been exploited in the past, you might want to disable ! it. To disable NBNS, set the nbns-enabled service management facility property to false. By default, nbns-enabled is set to true. - If the directory on which a file system is to be mounted is a symbolic link, the file system is mounted on the directory to which the symbolic link refers, rather than being mounted on top of the symbolic link itself. ! ! ! January 2, 2012 MOUNT_SMBFS(1M) --- 1,272 ---- MOUNT_SMBFS(1M) Maintenance Commands MOUNT_SMBFS(1M) NAME ! mount_smbfs, umount_smbfs - mount and unmount a shared resource from an ! SMB file server SYNOPSIS ! mount [-F smbfs] [generic-options] [-o name[=value]] [-O] resource ! mount [-F smbfs] [generic-options] [-o name[=value]] [-O] mount-point ! mount [-F smbfs] [generic-options] [-o name[=value]] [-O] ! resource mount-point ! umount [-F smbfs] [generic-options] mount-point DESCRIPTION ! The mount utility attaches a named resource, resource, to the file system ! hierarchy at the path name location, mount-point, which must already ! exist. + The mount utility attaches a named resource, resource, to the file system + hierarchy at the path name location, mount-point, which must already + exist. If mount-point has any contents prior to the mount operation, those contents remain hidden until the resource is unmounted. An authorized ! user with the SYS_MOUNT privilege can perform a mount operation. Also, a ! user can perform SMBFS mount operations on a directory the user owns. + If the resource is listed in the /etc/vfstab file, you can specify either + resource or mount-point as the mount command will consult the /etc/vfstab + file for more information. If the -F option is omitted, mount takes the + file system type from the entry in the /etc/vfstab file. If the resource is not listed in the /etc/vfstab file, the command line must specify both resource and mount-point. The umount utility detaches a mounted file system from the file system ! hierarchy. An authorized user with the SYS_MOUNT privilege can perform a ! umount operation. Also, a user can perform SMBFS unmount operations on a ! directory the user owns. + The network/smb/client service must be enabled to successfully mount an + SMB share. This service is enabled, by default. To enable the service, enter the following svcadm(1M) command: # svcadm enable network/smb/client Operands The mount command supports the following operands: resource //[workgroup;][user[:password]@]server/share The name of the resource to be mounted. In addition to its name, you can specify the following information about the resource: ! o password is the password associated with user. If password ! is not specified, the mount first attempts to use the ! password stored by the smbutil login command (if any). If ! that password fails to authenticate, the mount_smbfs prompts ! you for a password. ! o server is the DNS or NetBIOS name of the remote computer. o share is the resource name on the remote server. ! o user is the remote user name. If user is omitted, the logged ! in user ID is used. ! o workgroup is the name of the workgroup or the Windows domain ! in which the user name is defined. ! If the resource includes a workgroup, you must escape the ! semicolon that appears after the workgroup name to prevent it ! from being interpreted by the command shell. For instance, ! surround the entire resource name with double quotes: + mount -F smbfs "//SALES;george@RSERVER" /mnt mount-point + The path to the location where the file system is to be mounted + or unmounted. The mount command maintains a table of mounted + file systems in the /etc/mnttab file. See the mnttab(4) man + page. OPTIONS See the mount(1M) man page for the list of supported generic-options. ! -o name[=value] ! Sets the file system-specific properties. You can specify more ! than one name-value pair as a list of comma-separated pairs. No ! spaces are permitted in the list. The properties are as follows: acl|noacl + Enable (or disable) presentation of Access Control Lists + (ACLs) on files and directories under this smbfs(7FS) + mount. The default behavior is noacl, which presents + files and directories as owned by the owner of the mount + point and having permissions based on fileperms or + dirperms. With the acl mount option, files are presented + with ACLs obtained from the SMB server. Setting the acl + mount option is not advised unless the system is joined + to an Active Directory domain and using ldap(1) so it can + correctly present ACL identities from the SMB server. dirperms=octaltriplet + Specifies the permissions to be assigned to directories. + The value must be specified as an octal triplet, such as + `755'. The default value for the directory mode is taken + from the fileperms setting, with execute permission added + where fileperms has read permission. ! Note that these permissions have no relation to the ! rights granted by the SMB server. fileperms=octaltriplet + Specifies the permissions to be assigned to files. The + value must be specified as an octal triplet, such as + `644'. The default value is `700'. ! Note that these permissions have no relation to the ! rights granted by the SMB server. gid=groupid + Assigns the specified group ID to files. The default + value is the group ID of the directory where the volume + is mounted. intr|nointr + Enable (or disable) cancellation of smbfs(7FS) I/O + operations when the user interrupts the calling thread + (for example, by hitting Ctrl-C while an operation is + underway). The default is intr (interruption enabled), + so cancellation is normally allowed. noprompt + Suppresses the prompting for a password when mounting a + share. This property enables you to permit anonymous + access to a share. Anonymous access does not require a + password. The mount operation fails if a password is required, the ! noprompt property is set, and no password is stored by ! the smbutil login command. retry_count=number + Specifies the number of SMBFS retries to attempt before + the connection is marked as broken. By default, 4 + attempts are made. The retry_count property value set by the mount command ! overrides the global value set in SMF or the value set in ! your .nsmbrc file. timeout=seconds + Specifies the SMB request timeout. By default, the + timeout is 15 seconds. ! The timeout property value set by the mount command ! overrides the global value set in SMF or the value set in ! your .nsmbrc file. uid=userid + Assigns the specified user ID files. The default value + is the owner ID of the directory where the volume is + mounted. xattr|noxattr ! Enable (or disable) Extended Attributes in this mount point. This option defaults to xattr (enabled Extended ! Attributes), but note: if the SMB server does not support ! SMB "named streams", smbfs(7FS) forces this option to ! noxattr. When a mount has the noxattr option, attempts ! to use Extended attributes fail with EINVAL. + -O Overlays mount. Allow the file system to be mounted over an + existing mount point, making the underlying file system + inaccessible. If a mount is attempted on a pre-existing mount + point without setting this flag, the mount fails, producing the + error "device busy." + FILES + /etc/mnttab Table of mounted file systems. ! /etc/dfs/fstypes Default distributed file system type. ! /etc/vfstab Table of automatically mounted ! resources. + $HOME/.nsmbrc User-settable mount point configuration + file to store the description for each + connection. EXAMPLES Example 1 Mounting an SMBFS Share + The following example shows how to mount the /tmp share from the + nano server in the SALES workgroup on the local /mnt mount point. + You must supply the password for the root user to successfully + perform the mount operation. # mount -F smbfs "//SALES;root@nano.sfbay/tmp" /mnt Password: Example 2 Verifying That an SMBFS File System Is Mounted + The following example shows how to mount the /tmp share from the + nano server on the local /mnt mount point. You must supply the + password for the root user to successfully perform the mount + operation. # mount -F smbfs //root@nano.sfbay/tmp /mnt Password: You can verify that the share is mounted in the following ways: o View the file system entry in the /etc/mnttab file. # grep root /etc/mnttab //root@nano.sfbay/tmp /mnt smbfs dev=4900000 1177097833 + o View the output of the `mount' command. # mount | grep root /mnt on //root@nano.sfbay/tmp read/write/setuid/devices/dev=4900000 on Fri Apr 20 13:37:13 2007 + o View the output of the `df /mnt' command. # df /mnt /mnt (//root@nano.sfbay/tmp): 3635872 blocks -1 files + Obtain information about the mounted share by viewing the output + of the `df -k /mnt' command. # df -k /mnt Filesystem kbytes used avail capacity Mounted on //root@nano.sfbay/tmp 1882384 64448 1817936 4% /mnt + Example 3 Unmounting an SMB Share + This example assumes that an SMB share has been mounted on the + /mnt mount point. The following command line unmounts the share + from the mount point. # umount /mnt + INTERFACE STABILITY + Committed SEE ALSO ldap(1), smbutil(1), mount(1M), mountall(1M), svcadm(1M), acl(2), ! fcntl(2), link(2), mknod(2), mount(2), symlink(2), umount(2), mnttab(4), ! nsmbrc(4), vfstab(4), attributes(5), pcfs(7FS), smbfs(7FS) AUTHORS ! This manual page contains material originally authored by Boris Popov ! <bp@butya.kz>, <bp@FreeBSD.org>. NOTES ! The SMB client always attempts to use gethostbyname(3NSL) to resolve host ! names. If the host name cannot be resolved, the SMB client uses NetBIOS ! name resolution (NBNS). By default, the SMB client permits the use of ! NBNS to enable SMB clients in Windows environments to work without ! additional configuration. ! Since NBNS has been exploited in the past, you might want to disable it. ! To disable NBNS, set the nbns-enabled service management facility property to false. By default, nbns-enabled is set to true. If the directory on which a file system is to be mounted is a symbolic link, the file system is mounted on the directory to which the symbolic link refers, rather than being mounted on top of the symbolic link itself. ! NexentaStor March 4, 2018 NexentaStor