Skip to main content

Displaying information about open SMB files

You can display information about open SMB files, including the SMB connection and session ID, the hosting volume, the share name, and the share path. You can display information about a file's continuously available protection level, which is helpful in determining whether an open file is in a state that supports nondisruptive operations.

About this task

You can display information about open files on an established SMB session. The displayed information is useful when you need to determine SMB session information for particular files within an SMB session.

For example, if you have an SMB session where some of the open files are open with continuously available protection and some are not open with continuously available protection (the value for the -continuously-available field in vserver cifs session show command output is Partial ), you can determine which files are not continuously available by using this command.

You can display information for all open files on established SMB sessions on storage virtual machines (SVMs) in summary form by using the vserver cifs session file show command without any optional parameters.

However, in many cases, the amount of output returned is large. You can customize what information is displayed in the output by specifying optional parameters. This can be helpful when you want to view information for only a small subset of open files.

  • You can use the optional

    -fields parameter to display output on the fields you choose.

    You can use this parameter either alone or in combination with other optional parameters.

  • You can use the

    -instance parameter to display detailed information about open SMB files.

    You can use this parameter either alone or in combination with other optional parameters.

Perform one of the following actions:
If you want to display open SMB files...Enter the following command...
On the SVM in summary formvserver cifs session file show -vserver vserver_name
On a specified nodevserver cifs session file show -vserver vserver_name -node {node_name|local}
On a specified file IDvserver cifs session file show -vserver vserver_name -file-id integer
On a specified SMB connection IDvserver cifs session file show -vserver vserver_name -connection-id integer
On a specified SMB session IDvserver cifs session file show -vserver vserver_name -session-id integer
On the specified hosting aggregatevserver cifs session file show -vserver vserver_name -hosting-aggregate aggregate_name
On the specified volumevserver cifs session file show -vserver vserver_name -hosting-volume volume_name
On the specified SMB sharevserver cifs session file show -vserver vserver_name -share share_name
On the specified SMB pathvserver cifs session file show -vserver vserver_name -path path
With the specified level of continuously available protectionvserver cifs session file show -vserver vserver_name -continuously-available {No|Yes}
Note
If the continuously available status is No , this means that these open files are not capable of nondisruptively recovering from takeover and giveback. They also cannot recover from general aggregate relocation between partners in a high-availability relationship.
With the specified reconnected statevserver cifs session file show -vserver vserver_name -reconnected {No|Yes}
Note
If the reconnected state is No , the open file is not reconnected after a disconnection event. This can mean that the file was never disconnected, or that the file was disconnected and is not successfully reconnected. If the reconnected state is Yes , this means that the open file is successfully reconnected after a disconnection event.

There are additional optional parameters that you can use to refine the output results. See the man page for more information.

Examples​

The following example displays information about open files on SVM vs1:

cluster1::> vserver cifs session file show -vserver vs1
Node:       node1
Vserver:    vs1
Connection: 3151274158
Session:    1
File    File      Open Hosting               Continuously
ID      Type      Mode Volume    Share       Available
------- --------- ---- --------- ----------- ------------
41      Regular   r    data      data        Yes
Path: \mytest.rtf

The following example displays detailed information about open SMB files with file ID 82 on SVM vs1:

cluster1::> vserver cifs session file show -vserver vs1 -file-id 82 -instance

                  Node: node1
               Vserver: vs1
               File ID: 82
         Connection ID: 104617
            Session ID: 1
             File Type: Regular
             Open Mode: rw
Aggregate Hosting File: aggr1
   Volume Hosting File: data1
            CIFS Share: data1
  Path from CIFS Share: windows\win8\test\test.txt
            Share Mode: rw
           Range Locks: 1
Continuously Available: Yes
           Reconnected: No