vserver cifs session show

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

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.