1DPNS‐LS(1) DPNS User Commands
2DPNS‐LS(1)
3[1mNAME[0m
7 dpns‐ls ‐ list DPNS name server directory/file entries
8[1mSYNOPSIS[0m
10 [1mdpns‐ls [22m[[1m‐cdhiLlRTu[22m] [[1m‐‐class[22m]
11[[1m‐‐comment[22m] [[1m‐‐deleted[22m] [[1m‐‐display_side[22m]
12 [[1m‐‐ds[22m] [[1m‐‐si[22m] [4mpath[24m...
13[1mDESCRIPTION[0m
15 [1mdpns‐ls [22mlists DPNS name server directory/file en‐
16tries. If [4mpath[24m is a
17 directory, [1mdpns‐ls [22mlist the entries in the direc‐
18tory; they are sorted
19 alphabetically.
20 [4mpath[24m specifies the DPNS pathname. If [4mpath[24m
22does not start with [1m/[22m, it
23 is prefixed by the content of the [1mDPNS_HOME
24[22menvironment vari‐
25 able.
26[1mOPTIONS[0m
28 [1m‐c [22muse time of last metadata modification in‐
29stead of last file mod‐
30 ification.
31 [1m‐d [22mif [4mpath[24m is a directory, list the di‐
33rectory entry itself, not the
34 files in that directory.
35 [1m‐h [22mwith ‐l, print sizes in human readable for‐
37mat, using few digits
38 and a suffix k, M, G, T or P to indicate kB, MB,
39GB, TB or PB
40 respectively.
41 [1m‐i [22mprint the file uniqueid in front of each en‐
43try.
44 [1m‐L [22mfor symbolic links, print target at‐
46tributes instead of link
47 attributes.
48 [1m‐l [22mlong listing (see below).
50 [1m‐R [22mlist the contents of directories recursive‐
52ly.
53 [1m‐T [22mlist file segments migrated to tape.
55 [1m‐u [22muse last access time instead of last modifi‐
57cation.
58 [1m‐‐class[0m
60 print the file class in front of each entry.
61 [1m‐‐comment[0m
63 print the comment associated with the entry after
64the pathname.
65 [1m‐‐deleted[0m
67 print also the logically deleted files.
68 [1m‐‐display_side [22mor [1m‐‐ds[0m
70 print the vid followed by a slash followed by
71the media side
72 number. This option is valid only if ‐T is spec‐
73ified and is
74 useful for multi‐sided media like DVD.
75 [1m‐‐si [22muse powers of 1000 not 1024 for sizes.
77 The long list gives the file mode, the number of entries
79in the direc‐
80 tory, the owner in alphabetic form or as a valid numeric
81ID, the group
82 in alphabetic form or as a valid numerci ID, the file
83size, the last
84 modification date and the file name.
85 The mode is printed as 10 characters, the first one is
87[1md [22mfor a direc‐
88 tory, [1mD [22mfor a logically deleted file, [1ml
89[22mfor a symbolic link, [1mm [22mfor a
90 migrated file and [1m‐ [22mfor a regular file. The next
919 characters are
92 three triplets: the first triplet gives read, write and
93execute/search
94 permission for the owner, the second triplet for the group
95and the last
96 one for the others.
97 [1mr [22mthe file is readable
99 [1mw [22mthe file is writable
101 [1mx [22mthe file is executable or the direc‐
103tory is searchable
104 [1m‐ [22mpermission is not granted
106 [1ms [22mset‐user‐ID or set‐group‐ID bit is
108on and corresponding
109 execute bit is on
110 [1mS [22mset‐user‐ID or set‐group‐ID bit is on
112but corresponding
113 execute bit is off
114 [1mt [22msticky bit is on
116 The file segments list gives the file segment status, the
118copy number,
119 the file segment number, the tape visual identifier, the
120file sequence
121 number on tape, the blockid, the segment size, the com‐
122pression factor
123 and the file name. The segment status can be either [1m‐
124[22mfor an active
125 segment or [1mD [22mfor a logically deleted segment.
126[1mEXIT STATUS[0m
128 This program returns 0 if the operation was successful
129or >0 if the
130 operation failed.
131[1mSEE ALSO[0m
133 [1mCastor_limits(4)[22m, [1mdpns_chmod(3)[22m, [1mdp‐
134ns_getcomment(3)[22m,
135[1mAUTHOR[0m
138 [1mLCG Grid Deployment [22mTeam
139DPNS $Date$
143DPNS‐LS(1)
144