Skip to main content

vserver cifs share properties show

Contributors
Suggest changes
PDFs

Display share properties

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The vserver cifs share properties show command displays the CIFS share properties.

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ] }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-vserver <vserver name>] - Vserver

This optional parameter specifies the name of the Vserver containing the CIFS share for which you want to display share properties.

[-share-name <Share>] - Share

If you specify this parameter, the command displays share properties only for the CIFS share that you specify.

[-share-properties <share properties>,…​] - Share Properties

If you specify this parameter, the command displays share properties only for CIFS shares using the properties you specify. The share properties can be one or more of the following:

  • homedirectory - This property specifies that the share and path names are dynamic. Specify this value for a home directory share. In a home directory share, the share's name and path can be generated by substituting %w and %d variables with the corresponding user's name and domain, respectively, specified as the value of the -share-name and -path parameters. For instance, if a dynamic share is defined with a name of %d%w_ , a user logged on as barbara from a domain named FIN sees the share as FIN_barbara . Using the homedirectory value specifies that the share and path names are dynamically expanded.

  • oplocks - This property specifies that the share uses opportunistic locks, also known as client-side caching.

  • browsable - This property allows Windows clients to browse the share.

  • showsnapshot - This property specifies that snapshots can be viewed and traversed by clients.

  • changenotify - This property specifies that the share supports Change Notify requests.

  • attributecache - This property enables the file attribute caching on the CIFS share in order to provide faster access of attributes over SMB 1.0.

    Note For certain workloads, stale file attribute data could be delivered to a client.

  • continuously-available - This property permits SMB clients that support it to open files in a persistent manner. Files opened this way are protected from disruptive events, such as failover and giveback. This attribute is not supported for FlexGroup volumes and workgroup CIFS servers.

  • branchcache - This property specifies that the share allows clients to request BranchCache hashes on the files within this share. This option is useful only if you specify "per-share" as the operating mode in the CIFS BranchCache configuration, and also specify the "oplocks" share property.

  • shadowcopy - This property specifies that the share is pointing to a shadow copy. This attribute cannot be added nor removed from a share.

  • access-based-enumeration - This property specifies that Access Based Enumeration is enabled on this share. ABE-filtered shared folders are visible to a user based on that individual user's access rights, preventing the display of folders or other shared resources that the user does not have rights to access.

  • namespace-caching - This property specifies that the SMB clients connecting to this share can cache the directory enumeration results returned by the CIFS servers.

  • encrypt-data - This property specifies that SMB encryption must be used when accessing this share. Clients that do not support encryption will not be able to access this share.

  • show-previous-versions - This property specifies that the previous version can be viewed and restored from the client. This property is enabled by default.

Examples

The following example displays share properties for shares in Vserver vs1.

cluster1::> vserver cifs share properties show
Vserver          Share            Properties
---------------- ---------------- -----------------
vs1              abc              oplocks
                                  browsable
                                  changenotify
                                  show-previous-versions
vs1              admin$           browsable
vs1              ipc$             browsable
vs1              sh1              oplocks
                                  browsable
                                  changenotify
                                  show-previous-versions
4 entries were displayed.