Home > Veritas Storage Foundation™ Volume Manager Manual Pages
VXPRINT (1M) |
Maintenance Commands |
vxprint [-AqS] [-g diskgroup]
Selecting RVG and RLINK records via search expressions is not currently supported.
Additionally, record association hierarchies can be displayed in an orderly fashion so that the structure of records is more apparent.
Dashes (-) are displayed in the output wherever there is no applicable record value.
If no options are specified, the default output uses -f, -h, -r, and -A. Specifying other options can override the these defaults, making it necessary to explicitly specify the normal default options.
The default output format consists of single-line records, each of which includes a record type, name, usage type or object association, enabled state, length, and other fields. A one-line header is written before the record information.
When no disk group is specified, selected records are retrieved from the default disk group as determined using the rules given in the vxdg(1M) manual page.
Subdisks/Subvolumes are sorted primarily by their device/volume, subdisks may also include a device offset. Plex and volume records are sorted by name.
Note 1: The vxprint utility can display disk group, disk media, volume, plex, subdisk/subvolume, data change object (DCO), link object and snap object records. It cannot display disk access records. Use the vxdisk list operation to display disk access records, or physical disk information.
Note 2: The subvolume "record type" appears as sv as a convenience in displaying views of the configuration database. For manipulation purposes, these records are accessible as subdisk record types, that is, records tagged as type sd.
Note: This option overrides the -g option.
- vold
- Get a configuration from the volume configuration daemon.
- -
- Read a configuration from the standard input. The standard input is expected to be in standard vxmake input format.
Selecting RVG and RLINK records via search expressions is not currently supported.
- TY
- Record type.
- NAME
- Record name.
- ASSOC
- Usage-type, volume association, or plex association (or - for unassociated plexes and subdisks).
- KSTATE
- Kernel state (or - for subdisks, disks, or disk groups).
- LENGTH
- Length in sectors.
- PLOFFS
- Plex association offset (or - for volumes, plexes, disks, or disk groups). This field appears as LOG for log subdisks.
- STATE
- Usage-dependent state (or - for subdisks). If an exception condition is recognized (a plex I/O failure, removed or inaccessible disk, or an unrecovered stale data condition), then that condition is listed instead of any usage-type-dependent state.
- TUTIL0
- The tutil[0] field is set by usage-types as a lockout mechanism.
- PUTIL0
- The putil[0] field can be set to prevent associations of plex or subdisk records.
The order of -F options is significant, with specifications later in the option list overriding earlier specifications. Any use of -F overrides any other option letter specifying a type of format for the indicated record types. Thus, -F vol:format_spec can be used with the -t option to change the format used for volumes, while still using the -t format for plex and subdisk records.
The format-spec string consists of literal text with embedded configuration record variables. Configuration record variables are introduced with a percent sign (%). The percent sign is followed by a variable name or by a variable name and optional field width in braces. The following formats are allowed for a variable specification:
%field_name %{field_name} %{field_name : [[-] width ][ * ] } %{field_spec | field_spec [ |] }
The first format specifies the exact field name. The second format allows a field to be specified with immediately surrounding text that would otherwise be taken as part of the field name. The third format allows the specification of a justification and a field width. The fourth format allows alternate specifications to be used, either with or without justification and width specifications. For the fourth, the first specification is used if the specified field name is applicable to the record and is non-empty; otherwise, the next available specification is used. Any number of alternate specifications can be used.
If no field width is specified, then the number of output column positions used for the field is the smallest possible to contain the value; otherwise spaces are added in the output to make it width columns in length. A field is not truncated if the minimum number of column positions necessary for a value is greater than width.
If a field width is specified with a leading dash (-) character, then an output field is lengthened by adding spaces after the field value, yielding a left-justified field. Otherwise, spaces are added before the value, yielding a right-justified field.
If a field width is followed or replaced by an asterisk (*) character, then an unrecognized or inappropriate field yields either no output for the field or a field containing all blanks. Without the asterisk, the printed field contains the character -.
A percent sign (%) can be displayed by including two percent characters (%%) in format-spec.
See the Record Fields section for a description of the field names that can be specified. An invalid format string may yield unexpected output, but does not generate an error.
If neither the -g option nor the -A option is specified, vxprint displays information about the default disk group for the -F, -m and -n options, as determined using the rules given in the vxdg(1M) manual page. For other options, vxprint displays information about all disk groups.
Note: If the default disk group is the reserved disk group, nodg, some operations may fail.
Hierarchies are separated in the output by a blank line. Each object listed occupies its own line. The order of output is the volume name, followed by an associated plex and its subdisks/subvolumes, followed by the next associated plex and its subdisks/subvolumes, and so on.
If a DCO is associated with a volume, the order of output is the volume hierarchy (as described above) followed by the DCO and the DCO volume hierarchy (if a DCO volume is associated with the DCO), followed by any associated link objects and snap objects.
For an RVG, all RLINKs and volumes that are associated with it are displayed using a similar hierarchy.
The -V, -P, -v, -p, -s and -c options limit the selection only of the head of a hierarchy. They do not prevent the display of associated records through the -h option.
Unless objects are named explicitly with name operands, a record is never displayed in two separate hierarchies. Thus, a selected plex is not displayed as a separate hierarchy if the volume that is associated with the plex is also selected.
Note: The -A option is not suitable for use with the -m option. This is because the vxmake command cannot handle vxprint output for multiple disk groups.
One of the following values is displayed for a volume set if the makedev attribute is set to on:
- \f(CWvset_devinfo=on:read-only
- Raw device nodes for the compnent volumes are visible in read-only mode.
- \f(CWvset_devinfo=on:read-write
- Raw device nodes for the compnent volumes are visible in read-write mode.
This field is not displayed if makedev is set to off.
Note: If the output from the vxprint -m command is fed to the vxmake command to recreate a volume set, the vset_devinfo attribute must set to off. Use the vxvset set command to re-enable raw device access with the desired access mode as described in the vxvset(1M) manual page.
For cache objects, the output consists of the following fields, from left to right.
- CO
- Record type (co).
- NAME
- Record name.
- CACHEVOL
- Name of associated cache volume.
- KSTATE
- Cache object kernel state.
- STATE
- Cache object utility state.
For DCOs, the output consists of the following fields, from left to right.
- DC
- Record type (dc).
- NAME
- Record name.
- PARENTVOL
- Associated volume, or dash (-) if the DCO is dissociated.
- LOGVOL
- Name of the DCO volume, or dash (-) if no DCO volume is associated with the DCO object.
For disk group records, the output consists of the following fields, in order from left to right.
- DG
- Record type (dg).
- NAME
- Record name.
- NCONFIG
- Number of configuration database copies.
- NLOG
- Number of kernel log copies.
- MINORS
- The base minor number of the disk group.
- GROUP-ID
- The disk group ID.
For disk media records, the output consists of the following fields, in order from left to right:
- DM
- Record type (dm).
- NAME
- Record name.
- DEVICE
- Underlying disk access record.
- TYPE
- Disk access record type (auto, sliced, simple, or nopriv).
- PRIVLEN
- Length of the disk's private region.
- PUBLEN
- Length of the disk's public region.
- STATE
- A string representing the state of the disk media:
- ALLOC_RES
- Reserved for use with ISP.
- ALLOC_NOUSE
- Marked as not for use with ISP.
- FAILING
- Disk media is failing.
- LOCAL_FAILING
- Disk is fenced off.
- NODEVICE
- Disk is not valid.
- NOHOTUSE
- Disk cannot be used for Hot-Relocation.
- REMOVED
- Disk is being removed from disk group.
- RESERVED
- Disk is reserved.
- SPARE
- Disk is marked as a spare for disk group.
- ST_SPARE
- Disk is marked as spare for storage pool.
- VOLATILE
- Disk state is changing.
For subcaches and subdisks, the output consists of the following fields, from left to right.
- SC or SD
- Record type (sc or sd for subcache or subdisk).
- NAME
- Record name.
- PLEX
- Associated plex, or dash (-) if the subdisk is dissociated.
- CACHE or DISK
- For subcaches, the name of the cache.
For subdisks, the name of the disk media record used by the subdisk.
- DISKOFFS
- Device (cache or disk, as appropriate) offset in sectors.
- LENGTH
- Subcache or subdisk length in sectors.
- [COL/]OFF
- Plex association offset, optionally preceded by subdisk column number for subdisks associated with striped plexes.
LOG is displayed for log subdisks. If the subdisk is dissociated, the putil[0] field is displayed. The putil[0] field can be non-empty to reserve the subdisk's space for non-volume uses. If the putil[0] field is empty, - is displayed for dissociated subdisks.
- DEVICE
- Name of the disk access record used by the subcache or subdisk.
- MODE
- A string representing the I/O mode of the subcache or subdisk:
- DET
- The subdisk has been detached.
- DIS
- The subdisk is disabled.
- dS
- The subdisk in a RAID-5 plex has failed and the RAID-5 volume is in degraded mode (d indicates that the subdisk is detached, and S indicates that its contents are stale).
- ENA
- The subdisk is usable.
- FAIL
- The subdisk has been detached in the kernel due to an error.
- NDEV
- The media record on which the subdisk is defined has no associated access record.
- RCOV
- The subdisk is part of a RAID-5 plex and has stale content.
- RLOC
- The subdisk has failed and is waiting to be relocated.
- RMOV
- The media record on which the subdisk is defined has been removed from its disk access record by a utility.
For plexes, the output consists of the following fields, from left to right:
- PL
- Record type (pl).
- NAME
- Record name.
- VOLUME
- Associated volume, or - if the plex is dissociated.
- KSTATE
- Plex kernel state.
If an enabled plex is sparse (possibly because one or more subdisks have been dissociated), this is indicated by displaying the modifier (SPARSE) in the output.
- STATE
- Plex utility state. If an exception condition is recognized on the plex (an I/O failure, a removed or inaccessible disk, or an unrecovered stale data condition), then that condition is listed instead of the value of the plex record's state field.
- LENGTH
- Plex length in sectors.
- LAYOUT
- Plex layout type.
- NCOL/WID
- Number of columns and plex stripe width, or - if the plex is not striped.
- MODE
- Plex I/O mode: RW (read-write), WO (write-only) or RO (read-only).
For RLINKs, the output consists of the following fields, in order from left to right:
- RL
- Record type (rl).
- NAME
- Record name.
- RVG
- Associated RVG, or - if the RLINK is dissociated.
- KSTATE
- RLINK kernel state (derived from various flags).
- STATE
- RLINK utility state.
- REM_HOST
- The remote host.
- REM_DG
- The remote disk group.
- REM_RLNK
- The remote RLINK.
For RVGs, the output consists of the following fields, in order from left to right:
- RV
- Record type (rv).
- NAME
- Record name.
- RLINK_CNT
- Associated RLINK count.
- KSTATE
- RVG kernel state (derived from various flags).
- STATE
- RVG utility state.
- PRIMARY
- RVG primary flag (primary or secondary).
- DATAVOLS
- Associated data volume count.
- SRL
- The srl volume.
For snap objects, the output consists of the following fields, from left to right.
- SP
- Record type (sp).
- NAME
- Record name.
- SNAPVOL
- Name of the volume whose snapshot information this snap object records.
- DCO
- Name of the DCO with which this snap record is associated.
For storage pool records (used with the Intelligent Storage Provisioning (ISP) feature), the output consists of the following fields, in order from left to right.
- ST
- Record type (st).
- NAME
- Record name.
- DM_CNT
- Number of disks in the storage pool.
- SPARE_CNT
- Number of spare disks in the storage pool.
- APPVOL_CNT
- Number of application volumes in the storage pool.
For subvolumes, the output consists of the following fields, from left to right.
- SV
- Record type (sv).
- NAME
- Record name.
- PLEX
- Associated plex, or dash (-) if the subvolume is dissociated.
- VOLNAME
- Name of the underlying (layered) volume record used by the subvolume.
- NVOLLAYR
- Number of layers used in the subvolume.
- LENGTH
- Subvolume length in sectors.
- [COL/]OFF
- Plex association offset, optionally preceded by subvolume column number for subvolumes associated with striped plexes.
- AM/NM
- Number of active plexes, followed by the number of plexes in the underlying (layered) volume.
- MODE
- A string representing the I/O mode of the subvolume:
- ENA
- The subvolume is usable.
- DIS
- The subvolume is disabled.
- IOFAIL
- The subvolume has been detached in the kernel due to an error.
For volumes, the output consists of the following fields, from left to right:
- V
- Record type (v).
- NAME
- Record name.
- RVG/VSET/CO
- Associated replicated volume group (RVG), volume set (VSET) or cache object (CO), if applicable.
- KSTATE
- Volume kernel state.
- STATE
- Volume utility state.
- LENGTH
- Volume length in sectors.
- READPOL
- Volume read policy.
- PREFPLEX
- Referred plex, if used by the read-policy.
- UTYPE
- Associated usage type.
For volume sets, the output consists of the following fields, from left to right:
- VT
- Record type (vt).
- NAME
- Record name.
- RVG
- Replicated volume group to which the volume set is associated.
- KSTATE
- Volume set kernel state.
- STATE
- Volume set application state.
- NVOLUME
- Number of volumes in volume set.
A header line is printed before any record information, for each type of record that could be selected based on the -V, -P, -v, -p, -s, and -h options. These header lines are followed by a single blank line.
- NODEVICE
- An expected underlying disk could not be found
- REMOVED
- An underlying disk is in the removed state
- IOFAIL
- An unrecovered I/O failure caused the plex to be detached
- RECOVER
- A disk replacement left the plex in need of recovery, either from another plex or from a backup
- RELOCATE
- The plex has been moved by the Hot-Relocation feature
See vxintro(1M) for a list of standard exit codes.
vxprint -Ath
To avoid looking at the 5-line header and the extra disk group headers generated by this command, you can remove all the headers by adding a -q.
To display all subdisks and all disk groups, in sorted order by disk, enter:
vxprint -AGts
If all plexes are named based on volumes, this can be a convenient means of viewing large configurations. The association field for each of the subdisks names the plex, and the plex name will normally imply a volume association by the form of the plex name.
To display the names of all unassociated plexes, use the command
vxprint -n -p -e !assoc
To print all subdisks, including the subdisk name and either the subdisk plex association offset or the putil0 field for dissociated subdisks, enter:
vxprint -s -F "%{name:-14} %{pl_offset|putil0}"
The vxprint command can be used to back up objects from one disk group configuration with the use of the combined options -mvpsch or -mvpschr. The output should be saved into a file that is maintained outside of the system being backed up. Use the following command with the saved file to restore the configuration:
vxmake -d file
Note: Although it is possible to use vxmake to create new volumes from an appropriate description file, it is recommended that you use vxassist or the graphical user interface instead.
Note: The Configuration Backup and Restore utilities, vxcnfbk and vxcnfres, are the recommended method for backing up and restoring volume hierarchies.
Last updated: 31 Aug 2008
Copyright ©2009 Symantec Corporation
All rights reserved.