6.38 List Volume

list volume <volume_name>

Print detailed information about a specified NSS volume.

nlvm [nlvm_options] list volume  <volume_name>

Command Option

volume_name

Mandatory. Specify the name of the NSS volume.

Example

MYVOL1

Command Example

nlvm list volume MYVOL1

Print detailed information about the volume MYVOL1.

Response Parameters

The command returns the following information about the specified NSS volume:

Label

Description

Name

Name of the volume

Pool

Name of the pool

State

Volume state (Active, Deactive)

Mounted

Yes or No; whether the volume is mounted for user access

Shared

Yes or No; whether the volume’s device is marked Shareable for Clustering

Mountpoint

Full Linux path where the volume is mounted; typically, /media/nss/<volume_name>

Used

Amount of used space in KB, MB, GB, or TB

Avail

Amount of available space (free space plus purgeable space) in KB, MB, GB, or TB

Quota

None, or amount of the volume quota in MB, GB, or TB

Purgeable

Amount of purgeable space in KB, MB, GB, or TB

Attributes

Volume attributes (such as Salvage, Compression, User Space Quotas, Directory Quotas)

ReadAheadBlocks

Setting for the Read Ahead Blocks parameter

PrimaryNameSpace

Primary lookup name space; the default is LONG

Objects

Number of objects

Files

Number of files

BlockSize

Block size; typically, 4096 bytes

ShredCount

Number of shredding cycles (1 to 7), where 0 is no shredding

AuthModelID

Authentication model ID (1, 0)

SupportedNameSpaces

Supported name spaces (DOS, MAC, UNIX, LONG)

CreateTime

Date created (Day Month dd hh:mm:ss yyyy)

ArchiveTime

Date last archived (Never , Day Month dd hh:mm:ss yyyy), or Never

Sample Command Response
Sample 1: NSS Volume, Mounted, Unshared
nlvm list volume NSS1

 Name=NSS1
  Pool=POOL1 State=Active Mounted=Yes Shared=No
  Mountpoint=/media/nss/NSS1
  Used=1.28MB Avail=87.27MB Quota=None Purgeable=12KB 
  Attributes=Salvage,Compression
  ReadAheadBlocks=16 PrimaryNameSpace=LONG
  Objects=28 Files=23 
  BlockSize=4096 ShredCount=1 AuthModelID=1
  SupportedNameSpaces=DOS,MAC,UNIX,LONG
  CreateTime:  Wed May 22 16:03:26 2013
  ArchiveTime: Never
Sample 2: NSS Volume, Not Mounted, Unshared
nlvm list volume NSS1

 Name=NSS1
  Pool=POOL1 State=Dective Mounted=No Shared=No
  Mountpoint=/media/nss/NSS1
  CreateTime:  Wed May 22 16:03:26 2013
  ArchiveTime: Never
Sample 3: NSS Snapshot Volume, Mounted, Unshared
nlvm list volume NSS1_SV

 Name=NSS1_SV
  Pool=SNAP1 State=Active Mounted=Yes Shared=No
  Mountpoint=/media/nss/NSS1_SV
  Used=572KB Avail=88.05MB Quota=None Purgeable=12KB
  Attributes=Salvage,Compression
  ReadAheadBlocks=16 PrimaryNameSpace=LONG
  Objects=15 Files=15 
  BlockSize=4096 ShredCount=1 AuthModelID=1
  SupportedNameSpaces=DOS,MAC,UNIX,LONG
  CreateTime:  Wed Jun  5 16:57:21 2013
  ArchiveTime: Never