NAME

       dpns-ls - list DPNS name server directory/file entries

SYNOPSIS

       dpns-ls  [-cdhiLlRTu]  [--class]  [--comment]  [--deleted]  [--display_side] [--ds] [--si]
       path...

DESCRIPTION

       dpns-ls lists DPNS name server directory/file entries.  If path is  a  directory,  dpns-ls
       list the entries in the directory; they are sorted alphabetically.

       path   specifies  the DPNS pathname.  If path does not start with /, it is prefixed by the
              content of the DPNS_HOME environment variable.

OPTIONS

       -c     use time of last metadata modification instead of last file modification.

       -d     if path is a directory, list the directory entry itself,  not  the  files  in  that
              directory.

       -h     with  -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.

       -i     print the file uniqueid in front of each entry.

       -L     for symbolic links, print target attributes instead of link attributes.

       -l     long listing (see below).

       -R     list the contents of directories recursively.

       -T     list file segments migrated to tape.

       -u     use last access time instead of last modification.

       --class
              print the file class in front of each entry.

       --comment
              print the comment associated with the entry after the pathname.

       --deleted
              print also the logically deleted files.

       --display_side or --ds
              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.

       --si   use powers of 1000 not 1024 for sizes.

       The  long  list  gives the file mode, the number of entries in the directory, 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 d for a directory, D for a
       logically deleted file, l for a symbolic link, m for a migrated file and - for  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.

              r      the file is readable

              w      the file is writable

              x      the file is executable or the directory is searchable

              -      permission is not granted

              s      set-user-ID or set-group-ID bit is on and corresponding execute bit is on

              S      set-user-ID or set-group-ID bit is on but corresponding execute bit is off

              t      sticky 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
       - for an active segment or D for a logically deleted segment.

EXIT STATUS

       This program returns 0 if the operation was successful or >0 if the operation failed.

SEE ALSO

       Castor_limits(4), dpns_chmod(3), dpns_getcomment(3),

AUTHOR

       LCG Grid Deployment Team