dpns-ls man page

DPNS-LS(1)                    DPNS User Commands                    DPNS-LS(1)

[1mNAME[0m
      dpns-ls - list DPNS name server directory/file entries

[1mSYNOPSIS[0m
      [1mdpns-ls [22m[[1m-cdhiLlRTu[22m] [[1m--class[22m] [[1m--comment[22m] [[1m--deleted[22m] [[1m--display_side[22m]
      [[1m--ds[22m] [[1m--si[22m] [4mpath[24m...

[1mDESCRIPTION[0m
      [1mdpns-ls [22mlists DPNS name server directory/file entries.  If  [4mpath[24m  is  a
      directory,  [1mdpns-ls  [22mlist the entries in the directory; they are sorted
      alphabetically.

      [4mpath[24m   specifies the DPNS pathname.  If [4mpath[24m does not start with [1m/[22m,  it
             is  prefixed  by  the content of the [1mDPNS_HOME [22menvironment vari-
             able.

[1mOPTIONS[0m
      [1m-c     [22muse time of last metadata modification instead of last file mod-
             ification.

      [1m-d     [22mif [4mpath[24m is a directory, list the directory entry itself, not the
             files in that directory.

      [1m-h     [22mwith -l, print sizes in human readable format, using few  digits
             and  a  suffix  k, M, G, T or P to indicate kB, MB, GB, TB or PB
             respectively.

      [1m-i     [22mprint the file uniqueid in front of each entry.

      [1m-L     [22mfor symbolic links, print  target  attributes  instead  of  link
             attributes.

      [1m-l     [22mlong listing (see below).

      [1m-R     [22mlist the contents of directories recursively.

      [1m-T     [22mlist file segments migrated to tape.

      [1m-u     [22muse last access time instead of last modification.

      [1m--class[0m
             print the file class in front of each entry.

      [1m--comment[0m
             print the comment associated with the entry after the pathname.

      [1m--deleted[0m
             print also the logically deleted files.

      [1m--display_side [22mor [1m--ds[0m
             print  the  vid  followed  by a slash followed by the media side
             number.  This option is valid only if -T  is  specified  and  is
             useful for multi-sided media like DVD.

      [1m--si   [22muse powers of 1000 not 1024 for sizes.

      The  long list gives the file mode, the number of entries in the direc-
      tory, the owner in alphabetic form or as a valid numeric ID, the  group
      in  alphabetic  form  or as a valid numerci ID, the file size, the last
      modification date and the file name.

      The mode is printed as 10 characters, the first one is [1md [22mfor  a  direc-
      tory,  [1mD  [22mfor  a logically deleted file, [1ml [22mfor a symbolic link, [1mm [22mfor a
      migrated file and [1m- [22mfor a regular file.   The  next  9  characters  are
      three  triplets: the first triplet gives read, write and execute/search
      permission for the owner, the second triplet for the group and the last
      one for the others.

             [1mr      [22mthe file is readable

             [1mw      [22mthe file is writable

             [1mx      [22mthe file is executable or the directory is searchable

             [1m-      [22mpermission is not granted

             [1ms      [22mset-user-ID  or  set-group-ID bit is on and corresponding
                    execute bit is on

             [1mS      [22mset-user-ID or set-group-ID bit is on  but  corresponding
                    execute bit is off

             [1mt      [22msticky bit is on

      The  file segments list gives the file segment status, the copy number,
      the file segment number, the tape visual identifier, the file  sequence
      number  on  tape, the blockid, the segment size, the compression factor
      and the file name.  The segment status can be either [1m-  [22mfor  an  active
      segment or [1mD [22mfor a logically deleted segment.

[1mEXIT STATUS[0m
      This  program  returns  0  if the operation was successful or >0 if the
      operation failed.

[1mSEE ALSO[0m
      [1mCastor_limits(4)[22m, [1mdpns_chmod(3)[22m, [1mdpns_getcomment(3)[22m,

[1mAUTHOR[0m
      [1mLCG Grid Deployment [22mTeam

DPNS         $Date: 2011-03-15 08:02:08 +0100 (Tue, 15 Mar 2011) $  DPNS-LS(1)