1GFAL-LS(1) General Commands Manual GFAL-LS(1)
2
3
4
6 gfal-ls - list directory contents or file information
7
9 gfal-ls [ OPTION ]... FILE
10
11
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
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
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
99 /etc/gfal2.d/*
100 All configuration files in this directory affect the behavior of
101 the underlying gfal2.
102
103
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
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)