JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris SMB and Windows Interoperability Administration Guide     Oracle Solaris 11 Express 11/10
search filter icon
search icon

Document Information

Preface

1.  Windows Interoperability (Overview)

The Solaris SMB Server

Solaris SMB Server

Solaris SMB Client

Identity Mapping Service

Managing Solaris SMB Configuration Properties

Configuring the Solaris SMB Server - Process Overview

Utilities and Files Associated With the Solaris SMB Server and Client

Solaris SMB Utilities

mount_smbfs Command

sharectl Command

share Command

smbadm Command

smbstat Command

smbutil Command

umount_smbfs Command

unshare Command

zfs Command

Solaris SMB Service Daemon

Solaris SMB Files

/etc/auto_direct File

/etc/dfs/sharetab File

/etc/smbautohome File

$HOME/.nsmbrc File

Authentication, Directory, Naming, and Time Services

SMB Shares

Share Properties

Access Control to Shares

Host-Based Access Control to Shares

Access Control Lists on Shares

Autohome Shares

Autohome Entries

Autohome Map Entry Format

Autohome Map Key Substitution

Wildcard Rule

nsswitch Map

Local SMB Groups

Client-Side Caching for Offline Files

Share Execution Properties

Support for the Distributed File System

2.  Identity Mapping Administration (Tasks)

3.  Solaris SMB Server Administration (Tasks)

4.  Solaris SMB Client Administration (Tasks)

Glossary

Index

Client-Side Caching for Offline Files

The Solaris SMB server provides a per-share configuration property to support client-side caching for offline files. Although the Solaris SMB server enables you to configure this feature, only the client manages client-side caching and access to offline files. You can use the zfs command to configure this feature by setting the csc property for a share.

The following are valid values for the csc property:

Example 1-1 Configuring Client-Side Caching

The following example shows how to configure client-side caching on shares.

First, create and share a file system. When you are using SMB, it is best practice to create a mixed-mode ZFS file system. If you have both NFS and SMB clients using a mixture of different character sets on the same file system, you might also want to set utf8only and consider specifying the charset=access-list NFS share property.

The sharesmb property can only be set to on or off. Specifying sharesmb=on shares a dataset with the default share properties.

# zfs create -o casesensitivity=mixed -o utf8only=on tank/zvol
# zfs set sharesmb=on tank/zvol
# zfs get share tank/zvol

NAME PROPERTY VALUE SOURCE
tank/zvol share name=tank_zvol,path=/tank/zvol,prot=smb local

If you specify sharesmb=on without first creating a share, the share is automatically created as a default share. The name of the share is based on the share path, where slashs (/) are replaced by underscores (_).

To create a share with non-default values, use the zfs set share command, as shown in the following example:

First, create the dataset.

# zfs create -o casesensitivity=mixed -o utf8only=on tank/zvol

Next, create an SMB share with the name of zvol.

# zfs set share=name=zvol,path=/tank/zvol,prot=smb tank/zvol
name=zvol,path=/tank/zvol,prot=smb

# zfs get share tank/zvol
NAME PROPERTY VALUE SOURCE
tank/zvol share name=zvol,path=/tank/zvol,prot=smb local

Then, enable SMB sharing on the tank/zvol dataset, and view the active shares on the system.

# zfs set sharesmb=on tank/zvol
# cat /etc/dfs/sharetab
/tank/zvol zvol smb -

The following command creates a new share with the csc property set to auto:

# zfs set share=name=zvol,path=/tank/zvol,prot=smb,csc=auto tank/zvol
name=zvol,path=/tank/zvol,prot=smb,csc=auto

# zfs get share tank/zvol
NAME PROPERTY VALUE SOURCE
tank/zvol share name=zvol,path=/tank/zvol,prot=smb,csc=auto local

Using the zfs command enables you to add properties to a share without specifying all the other previously specified properties and their values.

In the following example, the first command creates a share with the name of zvol. The second command adds the csc property. In the second command, you do not need to specify the path property because it was already specified in the first command.

# zfs set share=name=zvol,path=/tank/zvol,prot=smb tank/zvol
name=zvol,path=/tank/zvol,prot=smb

# zfs set share=name=zvol,prot=smb,csc=auto tank/zvol
name=zvol,prot=smb,csc=auto

To add an SMB property with the zfs command, specify the share name (name=zvol), the protocol (prot=smb), and the new property (csc=auto).

You can also set the csc property on autohome shares in the smbautohome map. As with the ZFS share property, multiple property-value pairs can be specified in a comma-separated list. The following smbautohome map disables client-side caching by default, but sets csc=auto for /export/home/john:

*      /export/home/&   csc=disabled,description=&
john   /export/home/&   csc=auto,dn=sun,dn=com,ou=users