 |
Click this button to go to the index for this section. |
volnotify(8)
NAME
volnotify - Display Logical Storage Manager (LSM) configuration events
SYNOPSIS
/usr/sbin/volnotify -icfdD -w wait-time -g diskgroup -n number -t timeout
DESCRIPTION
The volnotify utility displays events related to disk and configuration
changes, as managed by the Logical Storage Manager configuration daemon,
vold. volnotify displays requested event types until killed by a signal,
until a given number of events have been received, or until a given number
of seconds have passed.
Each event is displayed as a single-line output record on the standard
output. Displayed events are:
connected
A connection was established with vold. This event type is displayed
immediately after successful startup and initialization of volnotify.
A connected event is also displayed if the connection to vold is lost,
and then regained. A connected event displayed after a reconnection
indicates that some events may have been lost.
disconnected
The connection to vold was lost. This normally results from vold being
stopped (such as by voldctl stop) or killed by a signal. In response
to a disconnection, volnotify displays a disconnected event and then
waits until a reconnection succeeds. A connected event is then
displayed.
A disconnected event is also printed if vold is not accessible at the
time volnotify is started. In this case the disconnected event
precedes the first connected event.
more events
Due to internal buffer overruns, or other possible problems, some
events may have been lost.
vold disabled
vold was changed to disabled mode. Most configuration information will
be unavailable until vold is changed back to enabled mode.
vold enabled
vold was changed to enabled mode. All configuration information should
now be retrievable. vold disabled and vold enabled events can be
retrieved only when using diagnostic-mode connections to the vold
diagnostic portal. Use -D to obtain a regular diagnostic mode
connection.
waiting ...
If the -w option is specified, a waiting event is displayed after a
defined period with no other events. Shell scripts can use waiting
messages to collect groups of related, or at least nearly simultaneous,
events. This can make shell scripts more efficient. This can also
provide some scripts with better input since sets of detach events, in
particular, often occur in groups that scripts can relate together.
This is particularly important given that a typical shell script will
block until volnotify produces output, thus requiring output to
indicate the end of a possible sequence of related events.
import dg groupname dgid groupid
The disk group named groupname was imported. The disk group ID of the
imported disk group is groupid.
deport dg groupname dgid groupid
The named disk group was deported. The disk group ID of the imported
disk group is groupid.
disable dg groupname dgid groupid
The named disk group was disabled. A disabled disk group cannot be
changed, and its records cannot be printed with volprint. However,
some volumes in a disabled disk group may still be usable, although it
is unlikely that the volumes will be usable after a system reboot. A
disk group will be disabled as a result of excessive failures. A disk
group will be disabled if the last disk in the disk group fails, or if
errors occur when writing to all configuration and log copies in the
disk group.
change dg groupname dgid groupid
A change was made to the configuration for the named disk group. The
transaction ID for the update was groupid.
detach plex plex volume volume
dg groupname dgid groupid
The named plex, in the named disk group, was detached as a result of an
I/O failure detected during normal volume I/O, or disabled as a result
of a detected disk failure.
detach volume volume dg groupname
dgid groupid
The named volume, in the named disk group, was detached as a result of
an I/O failure detected during normal volume I/O, or as a result of a
detected disk failure. Usually, only plexes are detached as a result
of volume I/O failure. However, if the last plex in a volume is
disabled by a total disk failure, then the volume will be detached.
detach disk accesname dm medianame
dg groupname dgid groupid
The named disk, with device access name accessname and disk media name
medianame was disconnected from the named disk group as a result of an
apparent total disk failure. Total disk failures are checked for when
plexes are detached by kernel failures, or, explicitly, by the voldisk
check operation (see voldisk(8)).
change disk accessname dm medianame
dg groupname dgid groupid
The disk header changed for the disk with a device access name of
accessname. The disk group name and ID of the disk are groupname and
groupid, respectively. The displayed groupname and groupid strings
will be ``-'' or blank if the disk is not currently in an imported disk
group.
OPTIONS
The following options are recognized:
-i Display disk group import, deport, and disable events.
-c Display disk group change events.
-f Display plex, volume, and disk detach events.
-d Display disk change events.
-D Use a diagnostic-mode connection to vold. This allows the receipt of
events when vold is running in disabled mode. Access to configuration
information is limited when vold is running in disabled mode. For most
applications, it is better to let volnotify print events only when vold
is running in enabled mode.
-w wait_time
Display waiting events after wait_time seconds with no other events.
-g diskgroup
Restrict displayed events to those in the indicated disk group. The
disk group can be specified either as a disk group name or a disk group
ID.
-n number
Display the indicated number of vold events, then exit. Events that
are not generated by vold (i.e., connect, disconnect and waiting
events) do not count towards the number of counted events and will not
cause an exit to occur.
-t timeout
Display events for up to timeout seconds, then exit. The -n and -t
options can be combined to specify a maximum number of events and a
maximum timeout to wait before exiting.
If none of the -i, -c, -f, or -d options are specified, then default to
printing all event types. If a disk group is specified with -g,
display only disk group-related events.
EXAMPLES
The following example shell script will send mail to root for all detected
plex, volume, and disk detaches:
checkdetach() {
d=`volprint -AQdF '%name %nodarec' |
awk '$2=="on" {print " " $1}'`
p=`volprint -AQpe 'pl_kdetach || pl_nodarec' -F ' %name'`
v=`volprint -AQvF ' %name' -e \
"((any aslist.pl_kdetach==true) ||
(any aslist.pl_nodarec)) &&
!(any aslist.pl_stale==false)"`
if [ ! -z "$d" ] || [ ! -z "$p" ] || [ ! -z "$v" ]
then
(
cat <<EOF
Failures have been detected by the Logical Storage Manager:
EOF
[ -z "$d" ] || echo "\\nfailed disks:\\n$d"
[ -z "$p" ] || echo "\\nfailed plexes:\\n$p"
[ -z "$v" ] || echo "\\nfailed volumes:\\n$v"
) | mailx -s "Logical Storage Manager failures" root
fi
}
volnotify -f -w 30 | while read code more
do
case $code in
waiting) checkdetach;;
esac
done
EXIT CODES
The volnotify utility exits with a nonzero status if an error is
encountered while communicating with vold. See volintro(8) for a list of
standard exit codes.
RELATED INFORMATION
volintro(8), vold(8), voltrace(8).