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

EXIT STATUS

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

SEE ALSO

100       Castor_limits(4), dpns_chmod(3), dpns_getcomment(3),
101
102

AUTHOR

104       LCG Grid Deployment Team
105
106
107
108DPNS         $Date: 2011-03-15 08:02:08 +0100 (Tue, 15 Mar 2011) $  DPNS-LS(1)