NAME
dpns-ls - list DPNS name server directory/file entries
SYNOPSIS
dpns-ls [-cdiLlRTu] [--class] [--comment] [--deleted] [--display_side]
[--ds] 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.
-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.
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