lssnap

Purpose

Use the lssnap command to list snapshots on NDMP hosts.

See Also:

"Snapshot Commands" for related commands

Prerequisites

You must have the right to query and display information about devices to use the lssnap command.

Syntax

lssnap::=

lssn•ap [ --short/-s | --long/-l ] [ --noheader/-H ] [ --reserve/-r ]
[ --host/-h hostname[,hostname]... ]
[ --fs/-f filesystem-name[,filesystem-name]... ]
[ --numberformat/-n numberformat ] [ snapshot-name ]...

Semantics

--short/-s: Displays snapshot data in short form. This option is the default.
--long/-l: Displays snapshot data in long form.
--noheader/-H: Suppresses columns headers when listing data.
--reserve/-r: Displays the reserved space.
--host/-h hostname ...: Specifies the NDMP host. If you do not specify a host name, then Oracle Secure Backup uses the value from the host variable.
--fs/-f filesystem-name: Specifies the file system of which the snapshot was taken.
--numberformat/-n numberformat: Specifies the format in which to display large numbers. Refer to "numberformat" for a description of the numberformat placeholder.
snapshot-name ...: Specifies the name of the snapshot to list.

Output

Table 2-18 describes the output of the lssnap command.

Table 2-18 lssnap Output

Label	Indicates
File system	File system captured in the snapshot
Max snapshots	Maximum number of snapshots permitted on this volume
Reserved space	Total reserved space for all snapshots
% reserved space	Percentage of reserved space currently used by all snapshots
Snapshot	Name of the snapshot
Of	Name of the file system
Taken at	Date and time of the snapshot
Used %	Space consumed by this snapshot as a percentage of reserved disk space being used on the volume. This value is calculated by: snapshot size x 100% / reserved space.
Total %	Space consumed by this snapshot as a percentage of total disk space on the volume. This value is calculated by: snapshot size x 100% / total disk space in this volume.
Busy	Whether the snapshot is busy; values are `yes` and `no`
Dependency	Whether the snapshot has a dependency on another processing entity (such as snapmirror); values are `yes` and `no`

Example

Example 2-74 displays snapshots on the NDMP-accessed host br_filer. In this example, the lucy.0 snapshot has used 3% of the space allocated to snapshots on /vol/vol0 (3% of 44.8 GB) and 1% of the total disk space for the volume /vol/vol0 (1% of 104 GB).

Example 2-74 Displaying Snapshots

ob> lssnap --long --host br_filer
File system /vol/vol0:
    Max snapshots:          255
    Reserved space:           44.8 GB
    % reserved space:       30
    Snapshot:               lucy.0
        Of:                 /vol/vol0
        Taken at:           2005/03/28.20:52
        Used %:               3
        Total %:              1
        Busy:               no
        Dependency:         no
    Snapshot:               myhost_snap1
        Of:                 /vol/vol0
        Taken at:           2004/08/21.11:30
        Used %:              12
        Total %:              7
        Busy:               no
        Dependency:         no