6.39 List Snaps

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