6.37 List Snaps

list snaps [more|all]

Print a list of all NSS pool snapshots. For each, display its pool name and its mount state.

nlvm [-t] list snaps [more|all]

Command Options

-t , --terse

Use this NLVM option to format the output for parsing.

more

Prints more information than appears in the standard output. It can be used with or without the -t NLVM option.

Example

more
all

Prints detailed information about each of the snapshots. This is the same information that is printed for the nlvm list snapshot <snap_name> command. It can be used with or without the -t NLVM option.

Example

all

Command Example

nlvm list snaps more

Print a list of all snapshots and detailed information about each one.

Response Parameters

You can issue the commands with the --terse NLVM option to output the same information in a format that is more easily parsed.

Standard Output

The command returns the following information about the pool snapshots on the server:

Label

Description

Name

Name of the snapshot

Pool

Name of the pool being snapped

Mounted

Yes or No; whether the snapshot is mounted as a pool

Size

Size of the pool in MB, GB, or TB

Shared

Yes or No; whether the snapshot’s device is marked as Shareable for Clustering. Typically, No, because snapshots are not supported for clustered pools at this time.

More Output

The command returns the following additional information about the pool snapshots on the server:

Label

Description

PoolSize

Source pool in KB, MB, GB, or TB

Chunk

Snapshot chunk size in KB (ex: 128)

Full

Percent of space on the partition that is used for copy-on-write-data

PartSize

Partition size in MB, GB, or TB, and the number of whole sectors in that space

Partition

Name of the partition for the snapshot

All Output

If the all option is specified, the information returned for each pool snapshot is the same as for the nlvm list snap <snap_name> command.

Sample Command Response
Sample 1: nlvm list snaps
nlvm list snaps

  Name     Pool            Mounted Shared
 SNAP1     POOL1             Yes     No
 SNAPSHOT1 BIGLONGPOOLNAME    No     No
Sample 2: nlvm list snaps more
 nlvm list snaps more

 Name      Pool            Mounted Shared PoolSize Chunk Full  PartSize Partition
 SNAP1     POOL1               Yes     No    99.00MB  128   12%   75.00MB sdi6.1
 SNAPSHOT1 BIGLONGPOOLNAME    No     No    99.98MB  128    1%   50.00MB sde7.1
Sample 3: nlvm list snaps all
 nlvm list snaps all

  Name=SNAP1
  Pool=POOL1 Mounted=Yes Shared=No
  PoolSize=99.00MB Chunk=128 Full=12%
  PartSize=75.00MB(153600) Partition=sdi6.1
  M:M=253:19 Writeable=Yes

 Name=SNAPSHOT1
  Pool=BIGLONGPOOLNAME Mounted=No Shared=No
  PoolSize=99.98MB Chunk=128 Full=1%
  PartSize=50.00MB(102400) Partition=sde7.1
  M:M=253:8 Writeable=Yes
Sample 4: nlvm list snaps all --terse
 nlvm list snaps all --terse

 Name=SNAP1 Pool=POOL1 Mounted=Yes Shared=No PoolSize=99.00MB Chunk=128 Full=12% PartSize=75.00MB(153600) Partition=sdi6.1 M:M=253:19 Writeable=Yes

 Name=SNAPSHOT1 Pool=BIGLONGPOOLNAME Mounted=No Shared=No PoolSize=99.98MB Chunk=128 Full=1% PartSize=50.00MB(102400) Partition=sde7.1 M:M=253:8