|
-a
|
Display all information about each selected record, one record per
line. The contents are similar to the -m option, with the
following exceptions: the -a option format appears on a single
line with one space character between each field, the list of associated
records is not displayed, and the -m option retains the sd
record type rather than sv . This format is useful for processing output
through filters such as sed and grep that operate exclusively on
one-line records, although the fields are not readily distinguishable.
It is not a practical format from the viewpoint of human readability.
|
-A
|
Print records from all active (imported) disk groups.
Each disk group represented in the output is separated
from other disk groups by blank lines.
A short header line introduces each disk group.
|
|
Note: This option overrides the -g option.
|
-b
|
Print the size of fields such as object length and offset in units of
512 bytes, regardless of platform.
If used with the -m option, the output values
are qualified by a suffix character.
|
-c
|
Display only DCO (dc), link object (ln)
and snap object (sp) records.
|
-C
|
Display only cache object records.
|
-d
|
Display only disk media records.
|
-D database
|
Get a configuration from the specified location. The database
option argument can be one of:
|
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.
|
|
|
-e pattern
|
Use a volume configuration search expression to select records to be
displayed. See vol_pattern(4) for a description of search
patterns.
|
|
Selecting RVG and RLINK records via search expressions is not
currently supported.
|
-f
|
Display information about each record as one-line output records
containing the following fields, from left to right.
A one-line header is written before any record information.
|
|
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.
|
|
|
|
|
|
|
-F [ type :]format_spec
|
|
Set a literal format string for displaying record information.
If the option argument begins with a comma-separated list of zero or
more record types (dg, dm, plex, sd, vol,
or vset)
followed by a colon, the
format_spec
after the colon is used when
printing the indicated record types.
If no record types are specified,
all record types are assumed.
In this case,
a colon can still be used to prevent parts of
format_spec
from being interpreted as a type.
|
|
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.
|
-g diskgroup
|
Display records from the specified disk group.
The diskgroup argument can be a name or ID of a disk group.
|
|
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.
|
-G
|
Display only disk group records.
|
|
|
-h
|
List hierarchies below selected records. For RVGs, this list includes
all associated RLINKs, volumes, and subdisks. For volumes, this
list includes all associated plexes and subdisks. For plexes, this
list includes all associated subdisks/subvolumes.
|
|
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.
|
-H
|
Print help information on usage.
|
-l
|
Display all information from each selected record.
This information is in a free format that is not
intended for use by scripts.
This format is more convenient than the
-m format for looking at records directly,
because the density of information is more
appropriate for human viewing.
|
-m
|
Display all information about each selected record in a format that is
useful as input to both the vxmake utility and to awk(1)
scripts. The format used is the vxmake description format (see
vxmake(4)). In addition to record information, the list of
plex or subdisk/subvolume records associated with selected volume or plex
records is displayed. Each field is output on a separate line,
indented by a single tab. Values for fields that contain
comment-style strings are always preceded by one double-quote
character and terminated by the end of the line.
|
|
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:
|
|
vset_devinfo=on:read-only
| |
Raw device nodes for the compnent volumes are visible in read-only mode.
|
vset_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.
|
-n
|
Display only the names of selected records.
|
-p
|
Display only plexes.
If a name operand refers to a volume or subdisk,
then a diagnostic is written to the standard error.
|
-P
|
Display only RLINKs.
|
-q
|
Suppress headers that would otherwise be printed for the default and
the -t and -f output formats.
|
-Q
|
Suppress the disk group header that separates each disk group. A
single blank line still separates each disk group.
|
-R
|
Rendezvous point. This is a reserved option to indicate the communications
point used with vxconfigd.
|
-r
|
Display related records of a volume containing subvolumes. Grouping
is done under the highest level volume.
|
-L
|
Useful when used with the -r parameter. Display related records of a
volume containing subvolumes, but grouping is done under any volume.
|
-s
|
Display only subdisks/subvolumes. If a name
operand refers to a volume or plex, then a diagnostic is written to the
standard error.
|
-S
|
Display configuration summary information. The output consists of a
header line followed by a line containing the total number of
subdisks/subvolumes, plexes, volumes, RVGs, and RLINKs; the number
of unassociated
subdisks/subvolumes; and the number of unassociated plexes.
|
-t
|
Print single-line output records that depend upon the configuration
record type.
|
|
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 disks private region.
|
PUBLEN
| |
Length of the disks 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.
|
LFAILED
|
The node does not have local access to the disk. The node is
sending private region I/Os through the network to a remote
node that has local access to the disk.
|
LMISSING
|
The disk was not discovered locally by DMP. The node does not
have a corresponding DMP device for the disk.
|
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 subdisks
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 records 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.
|
-u unit
|
Display sizes in human-friendly units. The sizes display with a suffix
that indicates the specified unit. Valid values for unit are:
|
|
h|H
|
The largest possible unit.
|
b|B
|
Bytes
|
k|K
|
Kilobytes
|
m|M
|
Megabytes
|
g|G
|
Gigabytes
|
t|T
|
Terabytes
|
p|P
|
Petabytes
|
e|E
|
Exabytes
|
z|Z
|
Zettabytes
|
|
|
|
|
|
The -u flag should not be used in scripts because the
output format may not be accepted as input to other commands.
|
-v
|
Display only volumes.
If a name operand refers to a plex or subdisk/subvolume,
a diagnostic is written to the standard error.
|
-V
|
Display only RVGs.
|
-x
|
Display only volume set objects.
|
-z
|
Displays the RECLAIM pending records for the subdisks.
When this option is used with the -l option, subdisks that have
pending reclaims display the reclaim_pnd flag in the flags field.
When used by itself, the -z option displays RECLAIM in the
STATE field.
|
|