Solaris CIFS Utilities

These utilities must be run as superuser or with specific privileges to be fully effective, but requests for information can be made by all users:

• mount_smbfs Command

• sharectl Command

• sharemgr Command

• smbadm Command

• smbstat Command

• smbutil Command

• umount_smbfs Command

mount_smbfs Command

With this command, you can attach a named CIFS share to a specified mount point. The mount_smbfs command enables you to mount a CIFS share to a directory you own without having to become superuser.

For more information, see the following:

• How to Mount a CIFS Share on a Directory You Own

• How to Mount a Multiuser CIFS Share

• How to Add an Automounter Entry for a CIFS Share

Also, see the mount_smbfs(1M) man page.

sharectl Command

The sharectl utility is an administrative tool that enables you to configure and manage file-sharing protocols, such as CIFS and NFS, and network protocols such as NetBIOS. You can use this command to do the following:

• Set client and server operational properties

• Display property values for a specific protocol

• Obtain the status of a protocol

For procedures that use the sharectl utility, see the following:

• How to Configure WINS

• How to Customize the Global Solaris CIFS Environment

• How to View the Global Solaris CIFS Environment Property Settings

Also, see the sharectl(1M) man page.

sharemgr Command

The sharemgr utility is an administrative tool that provides an enhanced method of sharing files and performing related tasks. The sharemgr utility introduces the following concepts:

• Share. One or more files or directories in a share group.

• Share group. A container of one or more shared files or directories.

  Note the following:

  • Options for sharemgr are set to a share group, not to a specific file or directory. All options apply to each file and directory in the group.

  • A file or directory can only be assigned to one share group. However, you can move a file or directory from one group to another.

  • A share group can be used by multiple file system types. For example, the share group my_group could be used by the NFS and ZFS file systems and be assigned one set of options for NFS and another set of options for the ZFS file system.

    ---

    Note –

    When a share is managed by the ZFS file system, sharemgr identifies the share and lists it in a zfs share group.

    ---

The sharemgr utility provides a unique way of checking the validity of a desired configuration. The -n option allows you to test the validity of the options and properties you want to use with a specific subcommand. The test does not change your configuration. For example, if you use the -n option with the subcommand create, no share group is created.

You can also use the ZFS file system sharesmb property to configure SMB sharing. For more information, see How to Create a CIFS Share (zfs) and the zfs(1M) and zpool(1M) man pages.

For procedures that use the sharemgr utility, see the following:

• How to Create a CIFS Share (sharemgr)

• How to Modify CIFS Share Properties (sharemgr)

• How to Remove a CIFS Share (sharemgr)

Also, see the sharemgr(1M) man page.

smbadm Command

You can use the smbadm command to manage domain membership of the Solaris CIFS service. For instance, you can have the Solaris CIFS service use domain mode or workgroup mode. The smbadm command also enables you to configure CIFS local groups. CIFS local groups can be used when Windows accounts must be members of some local groups and when Windows-style privileges must be granted. Solaris local groups cannot provide these functionalities.

For procedures that use the smbadm utility, see the following:

• How to Configure the Solaris CIFS Service in Domain Mode

• How to Configure the Solaris CIFS Service in Workgroup Mode

• How to Create a CIFS Group

• How to Add a Member to a CIFS Group

• How to Remove a Member From a CIFS Group

• How to Modify CIFS Group Properties

Also, see the smbadm(1M) man page.

smbstat Command

You can use the smbstat command to show statistical information about the smbd server. By default, the smbstat command shows general information about the CIFS service as well as dispatched CIFS request counters. For more information, see the smbstat(1M) man page.

The kstat command can be used to report on kernel CIFS statistics on a periodic basis and also to specify information about individual CIFS statistics. For more information, see the kstat(1M) man page.

smbutil Command

Use the smbutil command to perform the following CIFS client tasks:

• View the shares available for mounting from a particular CIFS server

• Generate a hash of a password for storing in a file such as $HOME/.nsmbrc

• Create or remove persistent passwords used to authenticate to CIFS servers

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

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

For procedures that use the smbutil utility, see the following:

• How to Find Available CIFS Shares on a Known File Server

• How to Mount a CIFS Share on a Directory You Own

• How to Store a CIFS Persistent Password

• How to Configure the PAM Module to Store a CIFS Persistent Password

• How to Delete a CIFS Persistent Password

• How to Mount a Multiuser CIFS Share

• How to Delete All CIFS Persistent Passwords

Also, see the smbutil(1) man page.

umount_smbfs Command

With this command, you can remove a named CIFS share from a mount point.

For more information, see How to Unmount a CIFS Share From a Directory You Own, and the mount_smbfs(1M) man page.