volume qtree show

Display a list of qtrees

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

Description

This command displays information about qtrees for online volumes. By default, the command displays the following information about all qtrees in the cluster:
  • Vserver name
  • Volume name
  • Qtree name
  • Security style (unix, ntfs, mixed or unified)
  • Whether oplocks is enabled
  • Status (normal or readonly)

The display will also include information about Qtree 0. When you create a volume, a special qtree referred to as "qtree0", also called the default qtree is automatically created for the volume. It represents all of the data stored in a volume that is not contained in a qtree. In the CLI output, qtree0 is denoted by empty quotation marks ("") and has the ID zero (0). The qtree called qtree0 cannot be manually created or deleted. This command is not supported on Infinite Volumes.

The qtree status indicates readonly for data protection and load sharing volumes.

To display detailed information about a single qtree, run the command with the -instance and -qtree parameters. The detailed view adds the following information:
  • UNIX permissions
  • Qtree ID
  • Export policy
  • Is Export Policy Inherited

Parameters

{ [-fields <fieldname>, ...]
If you specify the -fields <fieldname>, ... parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.
| [-exports ]
Displays the following information about qtree exports:
  • Vserver - The name of the Vserver the qtree belongs to
  • Volume - The name of the volume the qtree resides on
  • Qtree name - The name of the qtree
  • Policy Name - The name of the export policy assigned to the qtree
  • Is Export Policy Inherited - Whether the export policy assigned to the qtree is inherited
| [-id ]
Displays qtree IDs in addition to the default output.
| [-instance ]}
If you specify the -instance parameter, the command displays detailed information about all fields.
[-vserver <vserver name>] - Vserver Name
Selects information about the qtrees in the specified Vserver.
{ [-volume <volume name>] - Volume Name
Selects information about the qtrees in the specified volume.
[-qtree <qtree name>] - Qtree Name
Selects information about the qtrees that have the specified name.
| [-qtree-path <qtree path>]} - Actual (Non-Junction) Qtree Path
Selects information about the qtrees that have the specified path.
[-security-style <security style>] - Security Style
Selects information about the qtrees that have the specified security style. The unified security style, which applies only to Infinite Volumes, cannot be applied to a qtree.
[-oplock-mode {enable|disable}] - Oplock Mode
Selects information about the qtrees that have the specified oplock mode.
[-unix-permissions | -m <unix perm>] - Unix Permissions
Selects information about the qtrees that have the specified UNIX permissions.
[-qtree-id <integer>] - Qtree Id
Selects information about the qtrees that have the specified ID. A valid qtree ID is an integer from 0 to 4994. All qtree0 (automatically created) qtrees have an ID of zero (0).
[-status {normal|readonly}] - Qtree Status
Selects information about the qtrees that have the specified status.
[-export-policy <text>] - Export Policy
Selects information about the qtrees that use the specified export policy.
[-is-export-policy-inherited {true|false}] - Is Export Policy Inherited
Selects information about the qtrees that inherit (true) or not inherit (false) the export policy of containing volume.

Examples

The following example displays default information about all qtrees along with each qtree ID. Note that on vs0, no qtrees have been manually created, so only the automatically created qtrees referred to as qtree 0 are shown. On vs1, the volume named vs1_vol1 contains qtree 0 and two manually created qtrees, qtree1 and qtree2.
cluster1::> volume qtree show -id
Vserver    Volume        Qtree        Style        Oplocks    Status   Id
---------- ------------- ------------ ------------ ---------- -------- --
vs0        vs0_vol1      ""           unix         enable     readonly 0
vs0        vs0_vol2      ""           unix         enable     normal   0
vs0        vs0_vol3      ""           unix         enable     readonly 0
vs0        vs0_vol4      ""           unix         enable     readonly 0
vs0        root_vs_vs0   ""           unix         enable     normal   0
vs1        vs1_vol1      ""           unix         enable     normal   0
vs1        vs1_vol1      qtree1       unix         disable    normal   1
vs1        vsl_vol1      qtree2       unix         enable     normal   2
vs1        root_vs_vs1   ""           unix         enable     normal   0
9 entries were displayed.