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

NAME

6       gfal-xattr - show or set attributes of a file
7

SYNOPSIS

9       gfal-xattr [ OPTION ]...  FILE [ ATTRIBUTE [ = VALUE ]]
10
11

DESCRIPTION

13       gfal-xattr  Display  attributes  of  a file or set them to a new value.
14       This command comes in three forms, making it possible, for a  specified
15       file,   to  list  all  attribute  and corresponding values, display the
16       value of a particular attribute or assign a new value to  a  particular
17       attribute - see examples.
18

OPTIONS

20       -h, --help
21              show help about the command.
22
23       -V, --version
24              output version information and exit.
25
26       -v, --verbose
27              verbose mode. Repeat up to 3 times for the most verbose mode.
28
29       -D, --definition DEFINITION
30              define properties for gfal2. Definitions have the following syn‐
31              tax: "CONFIG_GROUP:KEY=VALUE"
32
33       -t, --timeout TIMEOUT
34              global timeout for the execution of the command. Command is  in‐
35              terrupted  if time expires before it finishes. Note: A grace pe‐
36              riod of 30 seconds is given to the global timeout.
37
38       -E, --cert CERT
39              user  certificate.  (This  option  takes   effect   only   after
40              X509_USER_PROXY     environment     variable     and     default
41              /tmp/x509up_u`id -u` location cannot provide a certificate)
42
43       --key KEY
44              user private key.
45
46       -4     forces Gfal2 to use IPv4 addresses only. (Option valid only  for
47              GridFTP protocol)
48
49       -6     forces  Gfal2 to use IPv6 addresses only. (Option valid only for
50              GridFTP protocol)
51
52       -C, --client-info CLIENT_INFO
53              provide custom client-side information.
54
55       --log-file LOG_FILE
56              write Gfal2 library logs to the given file location.
57
58       FILE   file URI
59
60       ATTRIBUTE
61              optional argument, specifying an attribute to get or set. If  no
62              attribute  is given, all attributes and corresponding values are
63              displayed.
64
65       VALUE  if an attribute is given, a new value can optionally be assigned
66              to it.
67
68

EXAMPLES

70       Show all attributes and values of a file:
71              gfal-xattr srm://endpoint.cern.ch/path/file
72
73       Show the value of a particular attribute:
74              gfal-xattr srm://endpoint.cern.ch/path/file user.status
75
76       Set a new value to an attribute:
77              gfal-xattr       srm://endpoint.cern.ch/path/file      user.sta‐
78              tus=new_value
79
80       Typically, you can get the transport urls (turls) with the "user.repli‐
81       cas" attribute:
82              srm://endpoint.cern.ch/path/file user.replicas
83
84

FILES

86       /etc/gfal2.d/*
87              All configuration files in this directory affect the behavior of
88              the underlying gfal2.
89
90

AUTHORS

92       Duarte Meneses <duarte.meneses@cern.ch>
93       Adrien Devresse <adrien.devresse@cern.ch>
94       Alejandro Alvarez Ayllon <alejandro.alvarez.ayllon@cern.ch>
95       Andrea Manzi <andrea.manzi@cern.ch>
96       Mihai Patrascoiu <mihai.patrascoiu@cern.ch>
97       Joao Lopes <joao.pedro.batista.lopes@cern.ch>
98
99

SEE ALSO

101       gfal-cat(1), gfal-chmod(1),  gfal-copy(1),  gfal-ls(1),  gfal-mkdir(1),
102       gfal-rename(1),  gfal-rm(1),  gfal-save(1),  gfal-stat(1), gfal-sum(1),
103       gfal-token(1), gfal-xattr(1)
104
105
106
107v1.7.1                            March 2022                     GFAL-XATTR(1)
Impressum