dpns-ls man page
DPNS-LS(1) DPNS User Commands DPNS-LS(1)
dpns-ls - list DPNS name server directory/file entries
[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...
[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
[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-
[1m-c [22muse time of last metadata modification instead of last file mod-
[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
[1m-i [22mprint the file uniqueid in front of each entry.
[1m-L [22mfor symbolic links, print target attributes instead of link
[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.
print the file class in front of each entry.
print the comment associated with the entry after the pathname.
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.
This program returns 0 if the operation was successful or >0 if the
[1mCastor_limits(4)[22m, [1mdpns_chmod(3)[22m, [1mdpns_getcomment(3)[22m,
[1mLCG Grid Deployment [22mTeam
DPNS $Date: 2011-03-15 08:02:08 +0100 (Tue, 15 Mar 2011) $ DPNS-LS(1)