zVolumeInfo_s

Syntax

typedef struct zVolumeInfo_s
{
   VolumeID_t   volumeID;
   NDSid_t      ndsObjectID;
   LONG         volumeState;
   LONG         nameSpaceMask;
   struct{
      QUAD   enabled;
      QUAD   enableModMask;
      QUAD   supported;
   }features;
   QUAD   maximumFileSize;
   QUAD   totalSpaceQuota;
   QUAD   numUsedBytes;
   QUAD   numObjects;
   QUAD   numFiles;
   LONG   authModelID;
   LONG   dataShreddingCount;
   struct{
      QUAD   purgeableBytes;
      QUAD   nonPurgeableBytes;
      QUAD   numDeletedFiles;
      QUAD   oldestDeletedTime;
      LONG   minKeepSeconds;
      LONG   maxKeepSeconds;
      LONG   lowWaterMark;
      LONG   highWaterMark;
   }salvage;
   struct{
      QUAD   numCompressedFiles;
      QUAD   numCompDelFiles;
      QUAD   numUncompressableFiles;
      QUAD   numPreCompressedBytes;
      QUAD   numCompressedBytes;
   }comp;
}zVolumeInfo_s;

Fields

volumeID

Specifies a 128-bit GUID that identifies the volume.

ndsObjectID

Specifies a 128-bit object ID that is assigned by eDirectory (zMOD_VOL_NDS_OBJECT_ID).

volumeState

Specifies the current state of the volume:

• DEACTIVE (2)

• MAINTENANCE (3)

• ACTIVE (6)

nameSpaceMask

Specifies the namespace that is supported on the volume.

enabled

Specifies the features that are currently enabled for the volume (zMOD_VOL_ATTRIBUTES).

enableModMask

Specifies the features that should be changed (zMOD_VOL_ATTRIBUTES).

supported

Specifies the features that can be supported on the volume.

maximumFileSize

Specifies the maximum file size that is supported on the volume.

totalSpaceQuota

Specifies the maximum size of the volume, which can still overbook the pool (zMOD_VOL_QUOTA).

numUsedBytes

Specifies the number of bytes that are in use by the volume.

numObjects

Specifies the number of file-like objects on the volume, including extended attributes and data streams.

numFiles

Specifies the number of files on the volume.

authModelID

Specifies the authorization:

• zFTYPE_ZAS_AUTH_MODEL is for traditional NetWare®

• zFTYPE_UNIX_AUTH_MODEL is for UNIX (rwxrwxrwx)

dataShreddingCount

Specifies how many writes are done to the disk to obscure the original date (zMOD_VOL_DATA_SHREDDING_COUNT). Up to seven passes can be specified.

purgeableBytes

Specifies the space that is used by deleted files that can be reclaimed.

nonPurgeableBytes

Specifies the space that is used by deleted files that cannot be reclaimed yet.

numDeletedFiles

Specifies the total number of deleted files that are in salvage.

oldestDeletedTime

Specifies the date of the oldest deleted file in salvage.

minKeepSeconds

Specifies the minimum number of seconds that a file can be kept in the salvage system (zMOD_VOL_MIN_KEEP_SECONDS). This is not supported on ZLSS.

maxKeepSeconds

Specifies the maximum amount of time to keep deleted files (zMOD_VOL_MAX_KEEP_SECONDS).

lowWaterMark

Specifies an amount of used space under which deleted files should be kept (zMOD_VOL_LOW_WATER_MARK). When the percent of used space reaches the highWaterMark, NSS begins purging deleted files until the amount of used space drops below the lowWaterMark.

highWaterMark

Specifies the maximum amount of used space that deleted files should occupy (zMOD_VOL_HIGH_WATER_MARK). When the percent of used space reaches the highWaterMark, NSS begins purging deleted files until the amount of used space drops below the lowWaterMark.

numCompressedFiles

Specifies the number of compressed files.

numCompDelFiles

Specifies the number of compressed deleted files.

numUncompressibleFiles

Specifies the number of files that cannot be compressed.

numPreCompressedBytes

Specifies the amount of space that would have been used if no files were compressed.

numCompressedBytes

Specifies the amount of space that is used with compressed files.

Remarks

The salvage system saves deleted files until the system needs their space. The salvage structure provides information about those deleted files (zGET_VOL_SALVAGE_INFO).