LS Command

HSI Version: All
Purpose: List HPSS nodes
Aliases: LIST, DIR
Command Format: {ls | l[ist] | dir} [options] [path ...]
-a list all entries, including "hidden" files whose names begin with
-c -use time of last modification for sorting (deferred)
-d -if file is a dir, list its name instead of its contents
-l (letter "ell") ong list format
-p put a slash after each name if the file is a directory (deferred)
-r reverse alpha or age sort order, as appropriate (deferred)
-s display size as well as name if -1 (numeral 1) option used
-u use time of last access for sorting instead of last modification
-x multicolumn output format, with entries sorted across page
-A print annotation info
-C multicolumn output format, with entries sorted down the
-D displays the full date/time stamp
-F puts a / after directory filenames, or * if executable (deferred)
-H print headings on long listings
-O print unordered "-l" or "-1" format listings
-P prints one line per node with volume/position/VSN list/COS/file family/subsystem info.
The fields on the line are tab-separated, as follows:
  • object name

For FILE and HARDLINK objects

  • File size (in bytes)
  • Amount of data at first tape storage class (in bytes),
    or 0 if no tape level with data found.
  • Position and relative offset of file on first tape level, first VV (1 = first file on tape).
    0 if no tape levels with data were found in the hierarchy.
    The value is displayed as position+relative offset
  • Comma-separated list of VSNs for first (or only) tape level, or empty string if none found
  • Class of Service (COS) ID
  • File Family ID
  • Subsystem ID
  • File Creation Date in the form mm/dd/yyyy
  • File Creation Time in the form hh:mm:ss
  • File Last Modification Date in the form mm/dd/yyyy
  • File Last Modification Time in the form hh:mm:ss
-R recursively list directories
-S (display sizes in the form XX.Y sfx, where sfx is
"B","KB","MB","GB","TB","PB" or "XB". For these suffix values, 1K = 1000. If specified, this option also enables the "-l" option.
-T "type" where type is one of w,r,c or m.
This allows the user to specify which HPSS time value is
displayed when one of the "long list" options (e.g. "ls -l") is used.
The meaning of the letters are: w - last write time r - last read time c - file creation time m - time of last modification (default)
-U print HPSS-specific information
-V print volume info for 1st tape level. Enables "-l" option
-X print extended volume info (for all levels). Enables "-l" option.
-1 (numeral 1) forces one name-per-line list
Keywords: DIRn
Usage Notes: List options are available to cause the output to be formatted in a variety of ways. They may be specified individually (e.g., "-C") or as a string (e.g., "-1R"). See the examples below for descriptions of the fields for the -P, -V, and -X options.
1. Simple long listing "ls -l" command. This produces normal
Un*x-style output
ls -l test.tar.bz2 -rw-r--r-- 1 gleicher 14 437276618 May 28 2003 test.tar.bz2
2. List the information for the first tape level in the hierarchy in which the file resides:
ls -V somefile produces output similar to this:
ls -V test.tar.bz2
-rw-r--r-- 1 gleicher 14 6002 legacy TAPE 437276618 May 28 2003 test.tar.bz2
Storage VV Stripe Level Count Width Bytes at Level
---------------------------------------------------------------------------- 1 (tape) 1 1 437276618
VV[ 0]: Object ID: b730e850-a89f-11e0-98d6-10005afa75bf ServerDep: 6a61f9a2-fd36-11d0-93cb-10005afa75bf
Pos: 7323 PV List: X3086300
3. List file tape/position information on a single line.
ls -P test.tar.bz2 FILE /home/gleicher/test.tar.bz2
437276618 437276618 7323+0 X3086300 6002 0 1 05/28/2003 21:03:13 07/12/2011 09:53:21

This is sometimes used for sorting files by tape/position.
Fields in the listing are separated by tabs. The fields are as follows:
  • object name
  • size
  • bytes at 1st tape level
  • tape position+offset (offset=0:not in aggregate or first file in aggregate)
  • first or only tape VV cartridge(s) for file
  • class of service
  • file family ID
  • subsystem ID
  • create time
  • modification time
Related Command(s):