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

NAME

6       lfc-ls - list LFC name server directory/file entries
7

SYNOPSIS

9       lfc-ls  [-cdhiLlRTu] [--class] [--comment] [--deleted] [--display_side]
10       [--ds] [--si] path...
11

DESCRIPTION

13       lfc-ls lists LFC name server directory/file  entries.   If  path  is  a
14       directory,  lfc-ls  list  the entries in the directory; they are sorted
15       alphabetically.
16
17       path   specifies the LFC pathname.  If path does not start with  /,  it
18              is prefixed by the content of the LFC_HOME environment variable.
19

OPTIONS

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

EXIT STATUS

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

SEE ALSO

99       Castor_limits(4), lfc_chmod(3),
100
101
102

AUTHOR

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