NAME
gfal-xattr - show or set attributes of a file
SYNOPSIS
gfal-xattr [ OPTION ]... FILE [ ATTRIBUTE [ = VALUE ]]
DESCRIPTION
gfal-xattr Display attributes of a file or set them to a new value. This command comes in three forms, making it possible, for a specified file, to list all attribute and corresponding values, display the value of a particular attribute or assign a new value to a particular attribute - see examples.
OPTIONS
- -h, --help
-
show help about the command.
- -V, --version
-
output version information and exit.
- -v, --verbose
-
verbose mode. Repeat up to 3 times for the most verbose mode.
- -D, --definition DEFINITION
-
define properties for gfal2. Definitions have the following syntax: "CONFIG_GROUP:KEY=VALUE"
- -t, --timeout TIMEOUT
-
global timeout for the execution of the command. Command is interrupted if time expires before it finishes. Note: A grace period of 30 seconds is given to the global timeout.
- -E, --cert CERT
-
user certificate. (This option takes effect only after X509_USER_PROXY environment variable and default /tmp/x509up_u`id -u` location cannot provide a certificate)
- --key KEY
-
user private key.
- -4
-
forces Gfal2 to use IPv4 addresses only. (Option valid only for GridFTP protocol)
- -6
-
forces Gfal2 to use IPv6 addresses only. (Option valid only for GridFTP protocol)
- -C, --client-info CLIENT_INFO
-
provide custom client-side information.
- --log-file LOG_FILE
-
write Gfal2 library logs to the given file location.
- FILE
-
file URI
- ATTRIBUTE
-
optional argument, specifying an attribute to get or set. If no attribute is given, all attributes and corresponding values are displayed.
- VALUE
-
if an attribute is given, a new value can optionally be assigned to it.
EXAMPLES
- Show all attributes and values of a file:
-
gfal-xattr srm://endpoint.cern.ch/path/file
- Show the value of a particular attribute:
-
gfal-xattr srm://endpoint.cern.ch/path/file user.status
- Set a new value to an attribute:
-
gfal-xattr srm://endpoint.cern.ch/path/file user.status=new_value
- Typically, you can get the transport urls (turls) with the "user.replicas" attribute:
-
srm://endpoint.cern.ch/path/file user.replicas
FILES
/etc/gfal2.d/*
All configuration files in this directory affect the behavior of the underlying gfal2.
AUTHORS
Duarte Meneses <[email protected]>
Adrien Devresse <[email protected]>
Alejandro Alvarez Ayllon <[email protected]>
Andrea Manzi <[email protected]>
Mihai Patrascoiu <[email protected]>
Joao Lopes <[email protected]>
SEE ALSO
gfal-cat(1), gfal-chmod(1), gfal-copy(1), gfal-ls(1), gfal-mkdir(1), gfal-rename(1), gfal-rm(1), gfal-save(1), gfal-stat(1), gfal-sum(1), gfal-token(1), gfal-xattr(1), gfal-evict(1), gfal-bringonline(1), gfal-archivepoll(1)