Go to main content

Managing SMB File Sharing and Windows Interoperability in Oracle® Solaris 11.3

Exit Print View

Updated: December 2017
 
 

Utilities and Files Associated With the SMB Server and Client

Managing SMB Servers and Clients by Using SMB Utilities (Task Map)

SMB utilities must be run as superuser or with specific privileges to be fully effective, but requests for some information can be made by all users. The following table lists the tasks performed to manage SMB servers and clients.

Task
Description
For Instructions
Attach a remote SMB share to a specified mount point.
Use the mount command to mount an SMB share to a directory you own.
mount_smbfs(1M) man page
Configure and manage file-sharing protocols such as SMB and NFS and network protocols such as NetBIOS.

    Use the sharectl command to do the following:

  • Set client and server operational properties

  • Display property values for a specific protocol

  • Obtain the status of a protocol

sharectl(1M) man page
Manage SMB shares on various file system types.
Use the zfs command to configure SMB sharing on Oracle Solaris ZFS file systems.
Use the share command to manage SMB shares on various file system types.
The share(1M) and zfs(1M) man pages
For information about SMB share properties, see the share_smb(1M) man page.
Manage domain membership of the SMB server.
The SMB server can use domain mode or workgroup mode. You can also use the smbadm command to configure SMB local groups.
smbadm(1M) man page
Managing the Oracle Solaris SMB client.

    Use the smbadm command to perform the following SMB client tasks:

  • View the shares available for mounting from a particular SMB server.

  • Create or remove persistent passwords used to authenticate to SMB servers.

  • Resolve a name to an IP address for a server that uses SMB over NetBIOS, not TCP.

  • Resolve the server name to the NetBIOS workgroup and system name.

Display statistical information about the smbd server.
Use the smbstat command to show statistical information about the SMB server. By default, the smbstat command shows general information about the SMB server as well as dispatched SMB request counters.
smbstat(1M) man page
Remove a named SMB share from a mount point.
Use the umount command to unmount a named SMB share.
Create, modify, and remove SMB shares on ZFS file systems.
Use the zfs set command to set the SMB sharing property for the ZFS file system.
Use the zfs share command to share a ZFS file system.
Use the zfs destroy command to remove SMB shares from a ZFS file system.
zfs(1M) man page
Create, modify, and remove SMB shares on Non-ZFS file systems.
Use the share command to create an SMB share on non-ZFS file system types.
Set the property values with the share command to modify an SMB share on non-ZFS file system types.
Use the unshare command to remove SMB shares from non-ZFS file system types.
unshare(1M) man page

SMB Service

The svc:/network/smb/server service provides the SMB service. The svc:/network/smb/server service depends on the following services:

  • svc:/network/smb/client:default

  • svc:/system/idmap:default

The svc:/network/smb/client service depends on the following services:

  • svc:/network/smb:default

  • svc:/system/idmap:default


Note -  The SMB service can be run only in the global zone and the kernel zone.

SMB Files

    The following files support SMB activities on Oracle Solaris systems:

  • /etc/auto_direct

  • /etc/dfs/sharetab

  • /etc/smbautohome

  • /var/smb/smbpasswd

/etc/auto_direct File

Use the /etc/auto_direct file to automatically mount an SMB share when a user accesses the mount point. To use the automount feature, you must store a persistent password for authentication to mount the share. See Storing SMB Persistent Passwords.

For instructions and examples, see How to Add an Automounter Entry for an SMB Share.

/etc/dfs/sharetab File

The /etc/dfs/sharetab file contains a record of all the active shares in the system. Each entry in the file describes a share, which includes the mount point, share name, protocol, and share properties. See the sharetab(4) and share_smb(1M) man pages.

/etc/smbautohome File

The /etc/smbautohome file is used to define the automatic sharing rules to be applied when a user connects to the SMB server. For more information, see SMB Autohome Shares and the smbautohome(4) man page.

/var/smb/smbpasswd File

The /var/smb/smbpasswd file stores the SMB passwords of Oracle Solaris users. The Oracle Solaris SMB server uses the SMB passwords to authenticate the connected Oracle Solaris users. For more information, see the pam_smb_passwd(5) man page.