Skip to main content

vserver cifs share show

Contributors
Suggest changes
PDFs

Display CIFS shares

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

Description

The vserver cifs share show command displays information about CIFS shares. 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 about all CIFS shares:

  • Vserver name

  • CIFS share name

  • Path

  • Share properties

  • Comment

    You can specify additional parameters to display only information that matches those parameters. For example, to display information only about CIFS shares that use dynamic shares, run the command with the `-share-properties dynamicshare` parameter.

Parameters

{ [-fields <fieldname>,…​]

If you specify this parameter, the command only displays the fields that you specify.

| [-shadowcopy ]

If you specify this parameter, the command displays information only about CIFS shadow copy shares.

| [-umask ]

If you specify this parameter, the command displays file and directory masks for CIFS shares.

| [-instance ] }

If you specify this parameter, the command displays detailed information about all CIFS shares.

[-vserver <vserver name>] - Vserver

If you specify this parameter, the command displays information only about CIFS shares on the specified CIFS-enabled Vserver.

[-share-name <Share>] - Share

If you specify this parameter, the command displays information only about the CIFS share or shares that match the specified name.

[-cifs-server <NetBIOS>] - CIFS Server NetBIOS Name

If you specify this parameter, the command displays information only about the CIFS share or shares that use the CIFS-enabled Vserver with the specified CIFS server name.

[-path <text>] - Path

If you specify this parameter, the command displays information only about the CIFS share or shares that have the specified path.

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

If you specify this parameter, the command displays information only about the CIFS share or shares that have the specified share properties.

[-symlink-properties {enable|hide|read-only|symlinks|symlinks-and-widelinks|disable|no-strict-security}] - Symlink Properties

If you specify this parameter, the command displays information only about the CIFS share or shares that have the specified symbolic link properties.

[-file-umask <Octal Integer>] - File Mode Creation Mask

If you specify this parameter, the command displays information only about the CIFS share or shares that use the specified file mask.

[-dir-umask <Octal Integer>] - Directory Mode Creation Mask

If you specify this parameter, the command displays information only about the CIFS share or shares that use the specified directory mask.

[-comment <text>] - Share Comment

If you specify this parameter, the command displays information only about the CIFS share or shares that have the specified comment.

[-acl <text>,…​] - Share ACL

If you specify this parameter, the command displays information only about the CIFS share or shares that have the specified ACL.

[-attribute-cache-ttl <[<integer>d][<integer>h][<integer>m][<integer>s]>] - File Attribute Cache Lifetime

If you specify this parameter, the command displays information only about the CIFS share or shares that have the specified attribute-cache-ttl for attribute cache.

[-volume <volume name>] - Volume Name

If you specify this parameter, the command displays information only about the CIFS shares that are present in this volume.

[-offline-files {none|manual|documents|programs}] - Offline Files

If you specify this parameter, the command displays information only about the CIFS shares that have the specified Offline Files properties.

[-vscan-fileop-profile {no-scan|standard|strict|writes-only}] - Vscan File-Operations Profile

If you specify this parameter, the command displays information only about the CIFS shares that have the specified Vscan fileop profile.

[-max-connections-per-share <integer>] - Maximum Tree Connections on Share

If you specify this parameter, the command displays information only about the CIFS shares that have the specified maximum connections per share configured.

[-force-group-for-create <text>] - UNIX Group for File Create

This optional parameter displays information about the CIFS shares that have the specified "force-group" parameter configured.

Examples

The following example displays information about all CIFS shares:

cluster1::> vserver cifs share show
Vserver        Share         Path              Properties Comment  ACL
-------------- ------------- ----------------- ---------- -------- -----------
vs1            ROOTSHARE     /                 oplocks    Share    CNC \
                                               browsable  mapped   Everyone /
                                               changenoti to top   Full
                                               fy         of       Control
                                                          Vserver
                                                          global
                                                          namespac
                                                          e
vs1            admin$        /                 browsable  -        -
vs1            c$            /                 oplocks    -        BUILTIN\Admi
                                               browsable           nistrators /
                                               changenoti          Full
                                               fy                  Control
vs1            ipc$          /                 browsable  -        -
4 entries were displayed.

The following example displays information about a CIFS share named SALES_SHARE on a Vserver named vs1.

cluster1::> vserver cifs share show -vserver vs1 -share-name SALES_SHARE
                            Vserver: vs1
                              Share: SALES_SHARE
           CIFS Server NetBIOS Name: WINDATA
                               Path: /sales
                   Share Properties: oplocks
                                     browsable
                 Symlink Properties: enable
            File Mode Creation Mask: -
       Directory Mode Creation Mask: -
                      Share Comment: -
                          Share ACL: Everyone / Full Control
      File Attribute Cache Lifetime: -
                      Offline Files: manual
      Vscan File-Operations Profile: standard