voltrace(8)voltrace(8)NAMEvoltrace - Trace operations on volumes
SYNOPSIS
/usr/sbin/voltrace [-eEla] [-d outputfile] [-f inputfile] [-t timeout]
[-c eventcount] [-w waitinterval] [-b buffersize] [-g diskgroup] [-o
objtype[,objtype]...] [name | device]...
OPTIONS
The following options are recognized by voltrace: Selects new error
trace data. The default is to select I/O trace data. Selects pre-
existing error trace data. This can be combined with -e to get both
preexisting trace data and new trace data. Specifies long format.
Prints all available fields for all tracing records, rather than a sub‐
set of the available fields. The default is to use the short format.
Writes (dumps) binary trace data to the specified output file. Appends
to the outputfile rather than truncating it. By default, the output
file is truncated. Reads binary trace data from the specified input
file, rather than from the kernel. Accumulates trace data for at most
timeout seconds and then exits. Accumulates at most eventcount events
and then exits. The timeout and eventcount options can be used
together. If voltrace waits for waitinterval seconds without receiving
any new events, prints the message waiting... to allow scripts to wake
up and process previously accumulated events. This is mostly of use
for processing errors. The waiting... message does not count as an
event for the purposes of the -c option. Sets the kernel I/O trace
buffer size or sets the read buffer size when used with the -f option.
The Logical Storage Manager kernel allocates a private kernel space to
buffer the I/O trace records for each voltrace command. The default
buffer size is 8K bytes. Some trace records may be discarded if the
trace buffer is too small. This option can be used to set a larger or
a smaller kernel trace buffer size. The buffer size is specified as a
standard Logical Storage Manager length (see volintro(8)). Depending on
the Logical Storage Manager kernel configuration, usually only a maxi‐
mum of 64K bytes buffer size will be granted. Selects objects from the
specified disk group. The disk group can be specified either by disk
group ID or by disk group name. With no name or device operands, all
appropriate objects in the disk group are selected. With name oper‐
ands, diskgroup names the disk group that is expected to contain the
named configuration record. Selects object based on the objtype option
arguments. Multiple types of objects can be specified with one or sev‐
eral -o options. The possible object selection types are: Selects mir‐
rored or RAID-5 volume kernel objects. Selects striped or concatenated
plex kernel objects. Selects mirrored volume kernel objects. Selects
subdisk kernel objects. Selects LSM physical disks. Selects virtual
disk devices. Selects DRL or RAID-5 log volumes. Selects RAID-5 log
plexes. Selects DRL or RAID-5 log subdisks. Selects all log objects.
Selects all possible virtual disk devices, kernel objects and physical
disks.
If name or device operands are provided, kernel objects of the
requested types are selected if they are associated with the configura‐
tion records or virtual disk devices indicated by those operands.
DESCRIPTION
The voltrace utility prints kernel error or I/O trace event records on
the standard output or writes them to a file in binary format. Binary
trace records written to a file can be read back and formatted by
voltrace as well.
If no operands are given, either all error trace data or all I/O trace
data on all virtual disk devices are reported. With error trace data,
it is possible to select all accumulated error trace data, to wait for
new error trace data, or both (the default). Selection can be limited
to a specific disk group, to specific kernel I/O object types, or to
particular named objects or devices.
OPERANDS
Operands specify configuration record names, or physical or virtual
disk device nodes (by device path). If no object types were selected
with the -o option, only trace records corresponding to the indicated
configuration records or devices are selected; otherwise, objects of
the requested types are selected if they are associated in any way with
the named configuration record or device.
If a name argument does not match a regular configuration record but
does match a disk access record, the indicated physical disk is
selected. Physical disks can also be selected by the device path of the
public region partition, or by the disk media record name.
By default name arguments are searched for in all disk groups or in the
disk group specified using the -g option. Without the -g option, a
record that is found in more than one disk group will cause an error
unless the record is in the rootdg disk group (in which case, the
record in the rootdg disk group is selected). The disk group for any
individual name operand can be overridden using the form:
diskgroup/recordname
Note
When reading trace data from a file with the -f option, association
information is not available.
EXAMPLES
To trace all physical disk I/Os, use the command: # voltrace-o disk To
trace virtual disk device I/Os to the device associated with volume
testvol, use either of the commands: # voltrace-o dev testvol #
voltrace /dev/vol/testvol To trace all log subdisks associated with
volume testvol, use the command: # voltrace-o logsd testvol To trace
all log objects, use the command: # voltrace-o log To accumulate 10
seconds worth of trace data for disk04 and then format that data, use
the command: # voltrace-t 10 -d /tmp/tracedata disk04 # voltrace-l -f
/tmp/tracedata To read error trace data into a script for processing,
using 10 second pauses to generate mail messages, use the command: #
voltrace-leE -w 10 | while read...
FILES
Default device to which events are logged.
SEE ALSOvolintro(8), volnotify(8), volstat(8)voltrace(8)
