vserver cifs session show

Contributors

Display established CIFS sessions

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

Description

The vserver cifs session show command displays information about established CIFS sessions. 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 sessions:

  • Node name

  • Vserver name

  • CIFS connection ID

  • CIFS session ID

  • Workstation IP address

  • CIFS user name

  • CIFS open files

  • Session idle time

    You can specify additional parameters to display only information that matches those parameters. For example, to display information only about CIFS sessions established on connection ID 2012, run the command with the `-connection-id parameter set to ` 2012.

Parameters

{ [-fields <fieldname>,…​]

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

| [-show-win-unix-creds ]

If you specify this parameter along with a valid session-id, the command displays Windows and UNIX credentials along with the detailed information about matching CIFS sessions.

| [-instance ] }

If you specify this parameter, the command displays detailed information about matching CIFS sessions.

[-node {<nodename>|local}] - Node

If you specify this parameter, the command displays information about the CIFS sessions on the specified node.

[-vserver <vserver name>] - Vserver

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

[-session-id <integer>] - Session ID

If you specify this parameter, the command displays information about the CIFS session that match the specified session ID.

[-connection-id <integer>] - Connection ID

If you specify this parameter, the command displays information about CIFS sessions that match the specified connection ID.

[-lif-address <IP Address>] - Incoming Data LIF IP Address

If you specify this parameter, the command displays information about CIFS sessions that are established through the specified data LIF IP address.

[-address <IP Address>] - Workstation IP address

If you specify this parameter, the command displays information about CIFS sessions that are opened from the specified IP address.

[-auth-mechanism <Authentication Mechanism>] - Authentication Mechanism

If you specify this parameter, the command displays information about CIFS sessions that used the specified authentication mechanism. The authentication mechanism can include one of the following:

  • None - Could not authenticate

  • NTLMv1 - NTLMv1 authentication mechanism

  • NTLMv2 - NTLMv2 authentication mechanism

  • Kerberos - Kerberos authentication mechanism

  • Anonymous - Anonymous authentication mechanism

[-windows-user <TextNoCase>] - Windows User

If you specify this parameter, the command displays information about CIFS sessions that are established for the specified CIFS user. The acceptable format for CIFS user is [domain]\user.

[-unix-user <text>] - UNIX User

If you specify this parameter, the command displays information about CIFS sessions that are established for the specified UNIX user.

[-shares <integer>] - Open Shares

If you specify this parameter, the command displays information about CIFS sessions that have the specified number of CIFS shares opened.

[-files <integer>] - Open Files

If you specify this parameter, the command displays information about CIFS sessions that have the specified number of regular CIFS files opened.

[-other <integer>] - Open Other

If you specify this parameter, the command displays information about CIFS sessions that have the specified number of special CIFS files opened such as streams or directories.

[-connected-time <[<integer>d][<integer>h][<integer>m][<integer>s]>] - Connected Time

If you specify this parameter, the command displays information about CIFS sessions that are established for the specified time duration.

[-idle-time <[<integer>d][<integer>h][<integer>m][<integer>s]>] - Idle Time

If you specify this parameter, the command displays information about CIFS sessions on which there is no activity for the specified time duration.

[-protocol-version <CIFS Dialects>] - Protocol Version

If you specify this parameter, the command displays information about CIFS sessions that are established over the specified version of CIFS protocol. The protocol version can include one of the following:

  • SMB1 - SMB 1.0

  • SMB2 - SMB 2.0

  • SMB2_1 - SMB 2.1

  • SMB3 - SMB 3.0

  • SMB3_1 - SMB 3.1

[-continuously-available <CIFS Open File Protection>] - Continuously Available

If you specify this parameter, the command displays information about CIFS sessions with open files that have the specified level of continuously available protection. The open files are "continuously available" if they are opened from an SMB 3 client through a share with the "continuously_available" property set. These open files are capable of non-disruptively recovering from takeover and giveback as well as general aggregate relocation between partners in a high-availability relationship. This is in addition to the traditional SMB 2 capability allowing clients to recover from LIF migration and other brief network interruptions.

Note The CA protection levels depict the continuous availability at the connection level so it might not be accurate for a session if the connection has multiple sessions. Streams opened through a continuously available share are permitted, but are not currently made continuously available. Directories may be opened through a continuously available share, but, by design, will not appear continuously available as clients do not open them that way. These protection levels are applicable to the sessions on read/write volumes residing on storage failover aggregates.

The continuously available status can be one of the following:

  • No - The session contains one or more open file but none of them are continuously available.

  • Yes - The session contains one or more open files and all of them are continuously available.

  • Partial - The session contains at least one continuously available open file but other open files that are not.

[-is-session-signed {true|false}] - Is Session Signed

If you specify this parameter, the command displays information about CIFS sessions that are established with the specified SMB signing option.

[-user-type {local-user|domain-user|guest-user|anonymous-user}] - User Authenticated as

If you specify this parameter, the command displays information about CIFS sessions that are established for the specified user type. The user type can include one of the following:

  • local-user - Authenticated as a local CIFS user

  • domain-user - Authenticated as a domain user

  • guest-user - Authenticated as a guest user

  • anonymous-user - Authenticated as an anonymous or null user

[-netbios-name <text>] - NetBIOS Name

If you specify this parameter, the command displays information about CIFS sessions that are established with the specified NetBIOS Name.

[-smb-encryption-status {unencrypted|encrypted|partially-encrypted}] - SMB Encryption Status

If you specify this parameter, the command displays information about CIFS sessions that are established with the specified SMB encryption status.

The SMB encryption status can be one of the following:

  • unencrypted - The CIFS session is not encrypted.

  • encrypted - The CIFS session is fully encrypted. Vserver level encryption is enabled and encryption happens for the entire session.

  • partially-encrypted - The CIFS session is partially encrypted. Share level encryption is enabled and encryption is initiated when the tree-connect occurs.

[-connection-count <integer>] - Connection Count

If you specify this parameter, the command displays information about CIFS sessions that have the specified number of CIFS connections.

[-is-large-mtu-enabled {true|false}] - Is Large MTU Enabled

If you specify this parameter, the command displays information about CIFS sessions that are established with the specified Large MTU option.

Examples

The following example displays information about all CIFS sessions:

cluster1::> vserver cifs session show
Node:    node1
Vserver: vs1
Connection Session                                        Open            Idle        Connection
ID         ID      Workstation      Windows User         Files            Time             Count
---------- ------- ---------------- ---------------- --------- --------------- -----------------
127834     1       172.17.193.172   CIFSQA\                  2             22s                 4
                                    Administrator

The following example displays information about a CIFS session with session-id 1.

cluster1::> vserver cifs session show -session-id 1 -instance
Node: node1
                     Vserver: vs1
                  Session ID: 1
               Connection ID: 127834
Incoming Data LIF IP Address: 10.53.13.224
                 Workstation: 172.17.193.172
    Authentication Mechanism: NTLMv2
                Windows User: CIFSQA\Administrator
                   UNIX User: root
                 Open Shares: 2
                  Open Files: 2
                  Open Other: 0
              Connected Time: 2d 17h 58m 5s
                   Idle Time: 22s
            Protocol Version: SMB3
      Continuously Available: No
           Is Session Signed: true
       User Authenticated as: domain-user
                NetBIOS Name: ALIAS1
       SMB Encryption Status: encrypted
            Connection Count: 4
    Windows Unix Credentials: -