1DPNS-LS(1)                    DPNS User Commands                    DPNS-LS(1)
2
3
4

NAME

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

SYNOPSIS

9       dpns-ls  [-cdiLlRTu] [--class] [--comment] [--deleted] [--display_side]
10       [--ds] path...
11

DESCRIPTION

13       dpns-ls lists DPNS name server directory/file entries.  If  path  is  a
14       directory,  dpns-ls  list the entries in the directory; they are sorted
15       alphabetically.
16
17       path   specifies the DPNS pathname.  If path does not start with /,  it
18              is  prefixed  by  the content of the DPNS_HOME environment vari‐
19              able.
20

OPTIONS

22       -c     use time of last metadata modification instead of last file mod‐
23              ification.
24
25       -d     if path is a directory, list the directory entry itself, not the
26              files in that directory.
27
28       -i     print the file uniqueid in front of each entry.
29
30       -L     for symbolic links, print  target  attributes  instead  of  link
31              attributes.
32
33       -l     long listing (see below).
34
35       -R     list the contents of directories recursively.
36
37       -T     list file segments migrated to tape.
38
39       -u     use last access time instead of last modification.
40
41       --class
42              print the file class in front of each entry.
43
44       --comment
45              print the comment associated with the entry after the pathname.
46
47       --deleted
48              print also the logically deleted files.
49
50       --display_side or --ds
51              print  the  vid  followed  by a slash followed by the media side
52              number.  This option is valid only if -T  is  specified  and  is
53              useful for multi-sided media like DVD.
54
55       The  long list gives the file mode, the number of entries in the direc‐
56       tory, the owner in alphabetic form or as a valid numeric ID, the  group
57       in  alphabetic  form  or as a valid numerci ID, the file size, the last
58       modification date and the file name.
59
60       The mode is printed as 10 characters, the first one is d for  a  direc‐
61       tory,  D  for  a logically deleted file, l for a symbolic link, m for a
62       migrated file and - for a regular file.   The  next  9  characters  are
63       three  triplets: the first triplet gives read, write and execute/search
64       permission for the owner, the second triplet for the group and the last
65       one for the others.
66
67              r      the file is readable
68
69              w      the file is writable
70
71              x      the file is executable or the directory is searchable
72
73              -      permission is not granted
74
75              s      set-user-ID  or  set-group-ID bit is on and corresponding
76                     execute bit is on
77
78              S      set-user-ID or set-group-ID bit is on  but  corresponding
79                     execute bit is off
80
81              t      sticky bit is on
82
83       The  file segments list gives the file segment status, the copy number,
84       the file segment number, the tape visual identifier, the file  sequence
85       number  on  tape, the blockid, the segment size, the compression factor
86       and the file name.  The segment status can be either -  for  an  active
87       segment or D for a logically deleted segment.
88

EXIT STATUS

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

SEE ALSO

94       Castor_limits(4), dpns_chmod(3), dpns_getcomment(3),
95
96

AUTHOR

98       LCG Grid Deployment Team
99
100
101
102DPNS                     $Date: 2008/01/29 11:14:55 $               DPNS-LS(1)