MMINFO(8) Legato NetWorker 4.0 MMINFO(8)
NAME
mminfo - NetWorker media reporting command
SYNOPSIS
mminfo [ -amvBVX ] [ -c client ] [ -N name ] [ -o order ] [ -s server
] [ -t time ] [ volname... ]
DESCRIPTION
The mminfo command provides information about NetWorker's media and
save sets. Mminfo can produce several different reports depending on
the options specified. The default report, along with the reports
printed by the use of the -v, -V, -m, and -B options, are described
below. Other options are described in the OPTIONS section.
Without any options, mminfo displays information about the save sets
that completed properly during the last twenty four hours, and are
still contained in an on-line file index. The following information
is printed for each save set: the containing volume name, the
client's name, the creation date, the size saved, the save set level,
and the save set name. The size field is displayed in Bytes (B),
KiloBytes (KB) or MegaBytes (MB). The save set level will display
`full', `incr', or 1 through 9, for full, incremental, level 1
through 9, respectively. The level is only kept for scheduled saves;
save sets generated by explicitly running the save(8) command (called
ad hoc saves) do not have an associated level.
Specifying the -v flag causes three additional fields to be dis
played: the creation time, the internal save set identifier (ssid),
and two flags. One character is used per flag. The first flag indi
cates which part of the save set is on the volume. When the save is
completely contained on the volume, a c is displayed. An h is dis
played when the save set spans volumes and the head is contained on
this volume. The remaining sections will be on other volumes. An m
is displayed when the save set spans volumes and middle section is
contained on this volume. The head and tail sections will be on dif
ferent volumes. There may be more than one middle section. A t is
displayed when the tail section of a spanning save set is contained
on this volume. Again, the other sections will be on other volumes.
The second flag indicates the status of the save set. A b indicates
that the save set is in the on-line index and is browsable via the
recover(8) command. An r indicates that the save set is not in the
on-line index and is recoverable via the scanner(8) command. An R
indicates that the save set has been marked eligible for recycling
and may be over-written at any time. An a indicates that the save
was aborted before completion. Aborted save sets are removed from
the on-line file index by nsrck(8). An i indicates that the save is
still in progress. The -v flag also prints aborted, purged, and
incomplete save sets.
The -V flag displays more details, and is generally used for debug
ging. This format also displays information (i.e. media file number
and record number) that can be used to speed the operation of the
scanner(8) command. Rather than displaying one line per save set per
volume, two lines are displayed each time a section of a save set
Licensed material--property of copyright holder(s) 1
MMINFO(8) Legato NetWorker 4.0 MMINFO(8)
occurs within a file on a volume. A single save set will have multi
ple index entries if it starts in one file on a volume and ends in
another. The first line will contain the same fields described
above, although the size field will now list the number of bytes that
are contained in the section, rather than the total save set size.
The second line contains the following fields: the save time in sec
onds since 00:00:00 GMT, Jan 1, 1970, the internal save set identi
fier (ssid), the offset of the first and last bytes of the save set
contained within section, the media file number, the first record
within the media file containing data for this save set, the internal
volume identifier (volid), the total size of the save set, and the
flags, described in the -v paragraph above, indicating which part of
the save set is contained in this media file (c, h, m, or t) and the
save set's status (b, r, a, or i).
The -m flag causes mminfo to display the name of each volume in the
media database, the number of bytes written to it, the percent of
space used (or the word `full' indicating if the volume is filled to
capacity), the number of bytes read, the expiration date, the number
of times the volume has been mounted, the number of `file skip' oper
ations completed, and the volume's capacity. Volumes that are recy
clable (see nsrim(8)) are flagged by an R in the 1st column. Archive
volumes are flagged by an A, also in the 1st column. If the volume
has not been specified as an archive, and is not recyclable, no flag
appears. Specifying the -v flag with the -m flag causes three addi
tional fields to be displayed: the internal volume identifier
(volid), the number of the next file to be written, and the type of
media. The -V flag adds a flags column to the output. There is cur
rently one possible flag, d, which is set if the volume is currently
being written (dirty). If the volume is not dirty, the flags column
will be empty.
The -B flag displays another alternate format suitable for use by
saveindex(8) to print out bootstrap information. In this format,
there is one line of output for each matched save set. Each line
contains the save date and time, save level, save set identifier
(ssid), starting file number, starting record number, and the vol
ume(s). The -v option has no effect on the bootstrap display. The
-V option overrides the -B option.
OPTIONS
-a List all browsable save sets, not just those in the last 24
hours. This option is implied by the -c, -N, and -o options,
described below. Note that this option tends to use a large
amount of machine resources, especially memory, on both the
machine on which mminfo is run, and on the NetWorker server
machine, and can cause the query to run for a long time.
Unless all save sets are needed, consider using the -t option
instead.
-c client
Only display save sets generated by client.
-m Display media information.
Licensed material--property of copyright holder(s) 2
MMINFO(8) Legato NetWorker 4.0 MMINFO(8)
-N name
Only display save sets named name.
-o order
Sort the output in the specified order. Before displaying the
save sets, they are sorted by various fields. Numeric fields
are sorted least to greatest, other fields are sorted alpha
betically. order may be any combination of the letters mfrc
ntlR, representing media, file, record, client, name, time,
length, and reverse, respectively. The default sorting order
is mfrcntl. The file and record fields are only considered
when the -V option has been selected.
-s server
Display volume and save set information from the NetWorker
system on server. See nsr(8) for a description of server
selection.
-t time
Display save sets created after time. See getdate(3) for a
description of the recognized time formats.
-v Turn on the verbose display format.
-B Use the bootstrap display format. This format is used by
saveindex(8) when saving the server's index and bootstrap.
-V Display the save set section map.
-X Perform checking on the media database to detect gaps and
overlaps in save sets. This option displays a summary statis
tics report instead of one line per save set. The summary
lists the total number of save sets, and breaks the total down
into several overlapping categories. These categories are the
number of fulls, the number of incrementals, The number of
other non-full, non-incremental saves, the number of ad hoc,
empty and purged save sets, the number of index save sets, and
finally, the number of incomplete save sets. For each line,
the number of files (saved in the time interval specified),
number of save sets, total size, and average size per save
set, and average size per file, are listed.
EXAMPLES
Display information about all of the volumes:
mminfo -m
Display save set information from volumes mars.001 and mars.002:
mminfo -m mars.001 mars.002
Display all save sets named /usr:
mminfo -N /usr
Display save sets named /usr, generated by client venus, in the past
week:
Licensed material--property of copyright holder(s) 3
MMINFO(8) Legato NetWorker 4.0 MMINFO(8)
mminfo -N /usr -c venus -t 'last week'
Display save sets named /usr, generated by client venus, on volume
mars.001:
mminfo -N /usr -c venus mars.001
FILES
/nsr/mm/mmvolume The save set and volume databases (actually
accessed by nsrmmdbd(8)).
SEE ALSO
getdate(3), nsrlayout(5), nsradmin(8), nsrmmdbd(8), recover(8),
saveindex(8), scanner(8).
DIAGNOSTICS
`c' is not a valid order selector, choose from mfrcntlR
Only letters from mfrcntlR may be used with the -o option.
using server server
Server server is being used rather than the default server.
volume volname not found
The specified volume volname was not found in the database.
no volumes found
Either the data base contains no volumes or the media database
daemon, nsrmmdbd(8), is not running or not responding.
no save sets found
After querying the media database, no save sets were found
matching all the command-line parameters.
no save sets on type family volname
There are no save sets on the given volume volname. This mes
sage is only printed if the -V flag has been specified.
Licensed material--property of copyright holder(s) 4