1GFAL-LS(1)                  General Commands Manual                 GFAL-LS(1)
2
3
4

NAME

6       gfal-ls - list directory contents or file information
7

SYNOPSIS

9       gfal-ls [ OPTION ]...  FILE
10
11

DESCRIPTION

13       gfal-ls  List  information about the file. Depending on the implementa‐
14       tion, some information from the long listing, such as  group  and  user
15       ids,  might  not  be available and will be displayed as 0. When listing
16       several files or directories, if one returns an error, the execution is
17       canceled.
18
19

OPTIONS

21       -h, --help
22              show help about the command.
23
24       -V, --version
25              output version information and exit.
26
27       -v, --verbose
28              verbose mode. Repeat up to 3 times for the most verbose mode.
29
30       -D, --definition DEFINITION
31              define properties for gfal2. Definitions have the following syn‐
32              tax: "CONFIG_GROUP:KEY=VALUE"
33
34       -t, --timeout TIMEOUT
35              global timeout for the execution of the command. Command is  in‐
36              terrupted  if time expires before it finishes. Note: A grace pe‐
37              riod of 30 seconds is given to the global timeout.
38
39       -E, --cert CERT
40              user  certificate.  (This  option  takes   effect   only   after
41              X509_USER_PROXY     environment     variable     and     default
42              /tmp/x509up_u`id -u` location cannot provide a certificate)
43
44       --key KEY
45              user private key.
46
47       -4     forces Gfal2 to use IPv4 addresses only. (Option valid only  for
48              GridFTP protocol)
49
50       -6     forces  Gfal2 to use IPv6 addresses only. (Option valid only for
51              GridFTP protocol)
52
53       -C, --client-info CLIENT_INFO
54              provide custom client-side information.
55
56       --log-file LOG_FILE
57              write Gfal2 library logs to the given file location.
58
59       -a, --all
60              don't hide files with name starting in '.'.
61
62       -l, --long
63              long listing format. Following columns are  displayed  for  each
64              entry:  mode, number of links, group id, user id, last modifica‐
65              tion time, size and name.
66
67       -d, --directory
68              list directory entries instead of its contents.
69
70       -H, --human-readable
71              with -l, print sizes in human readable format (e.g.:  1K,  234M,
72              2G).
73
74       --xattr XATTR
75              with  -l, query additional attributes. Can be specified multiple
76              times.
77
78       --time-style STYLE
79              specify the time style. Supports the following  values:  locale,
80              iso, long-iso or full-iso (partially).
81
82       --full-time
83              equivalent to --time-style=full-iso.
84
85       --color MODE
86              with  -l, enable or disable color output. Supports the following
87              values: always, never, auto.
88
89

EXAMPLES

91       Long listing of all files:
92              gfal-ls -laH srm://endpoint.cern.ch/path/file
93
94       List a directory instead of its contents:
95              gfal-ls -d file:///tmp
96
97

FILES

99       /etc/gfal2.d/*
100              All configuration files in this directory affect the behavior of
101              the underlying gfal2.
102
103

AUTHORS

105       Duarte Meneses <duarte.meneses@cern.ch>
106       Adrien Devresse <adrien.devresse@cern.ch>
107       Alejandro Alvarez Ayllon <alejandro.alvarez.ayllon@cern.ch>
108       Andrea Manzi <andrea.manzi@cern.ch>
109       Mihai Patrascoiu <mihai.patrascoiu@cern.ch>
110       Joao Lopes <joao.pedro.batista.lopes@cern.ch>
111
112

SEE ALSO

114       gfal-cat(1),  gfal-chmod(1),  gfal-copy(1),  gfal-ls(1), gfal-mkdir(1),
115       gfal-rename(1), gfal-rm(1),  gfal-save(1),  gfal-stat(1),  gfal-sum(1),
116       gfal-token(1), gfal-xattr(1), gfal-evict(1), gfal-bringonline(1), gfal-
117       archivepoll(1)
118
119
120
121v1.7.1                            March 2022                        GFAL-LS(1)
Impressum