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

EXIT STATUS

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

SEE ALSO

93       Castor_limits(4), lfc_chmod(3),
94
95
96

AUTHOR

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