Skip to main content

vserver cifs branchcache show

Display the CIFS BranchCache service status and settings

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

Description​

The vserver cifs branchcache show command displays information about the BranchCache configuration for the Vserver. The command output depends on the parameter or parameters specified with the command. If you do not specify any parameters, the command displays the following information:

  • Operating Mode

  • Allowed Versions

  • Maximum Size

  • Path

You can specify additional parameters to display only information that matches those parameters.

Parameters​

{ [-fields <fieldname>, ...]
If you specify the -fields <fieldname>, ... parameter, the command displays only the fields that you specify.
| [-instance ]}
If you specify the -instance parameter, the command displays detailed information about all entries.
[-vserver <vserver name>] - Vserver
If you specify this parameter, the command displays information for the specified Vserver.
[-versions {v1-enable|v2-enable|enable-all}, ...] - Supported BranchCache Versions
If you specify this parameter, the command displays information for the Vservers that support the specified BranchCache versions.
[-hash-store-path <text>] - Path to Hash Store
If you specify this parameter, the command displays information for Vservers that store their hashes at the specified location.
[-hash-store-max-size {<integer>[KB|MB|GB|TB|PB]}] - Maximum Size of the Hash Store
If you specify this parameter, the command displays information for Vservers that have a maximum hash store size that is set to the specified value.
[-server-key <text>] - Encryption Key Used to Secure the Hashes
If you specify this parameter, the command displays information for Vservers that have the specified server key.
[-operating-mode <BranchCache Mode>] - CIFS BranchCache Operating Modes
If you specify this parameter, the command displays information for Vservers whose BranchCache configuration operates in the specified mode.

Examples​

The following example displays a subset of the information about the BranchCache service in the cluster.

cluster1::> vserver cifs branchcache show
                Operating  Allowed     Max
 Vserver        Mode       Versions    Size   Path
 -------------- ---------- ----------- ------ ------------------------
 vs1            per_share  enable_all     1GB /hash_dir/

The following example displays all information about all the Vservers with BranchCache configurations.

cluster1::> vserver cifs show -instance

                                   Vserver: vs1
         Supported Versions of BranchCache: enable_all
                        Path to Hash Store: /hash_dir/ 
            Maximum Size of the Hash Store: 1GB
  Encryption Key Used to Secure the Hashes: asdad
          CIFS BranchCache Operating Modes: per_share
The following example displays information about BranchCache configurations that store the hash data at the location /branchcache_hash_store.
cluster1::> vserver cifs branchcache show -hash-store-path /branchcache_hash_store 
                Operating  Allowed     Max
 Vserver        Mode       Versions    Size   Path
 -------------- ---------- ----------- ------ ------------------------
 vs1            per_share  enable_all     1GB /branchcache_hash_store