gfal-xattr(1)

Usage

gfal-xattr [OPTION] ... FILE [ATTRIBUTE [= VALUE]]

Overview

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.

Releases

Unchanged in 2 releases since Debian 12 (Bookworm).

12–13

gfal-cat(1) concatenate a file and print on the standard output gfal-chmod(1) Change the permissions of a file gfal-copy(1) Copy files gfal-ls(1) list directory contents or file information gfal-mkdir(1) make directories gfal-rename(1) Renames files or directories gfal-rm(1) Remove files or directories gfal-save(1) read from standard input and write it to a file gfal-stat(1) display extended information about a file or directory gfal-sum(1) Calculate checksum of a file gfal-token(1) retrieve SE-issued token for a given path gfal-xattr(1) show or set attributes of a file gfal-evict(1) Evict file from a disk buffer gfal-bringonline(1) Perform a staging operation on the given SURL gfal-archivepoll(1) Perform an archive polling operation on the given SURL

Referred to by

gfal-ls(1) list directory contents or file information gfal-rm(1) Remove files or directories gfal-cat(1) concatenate a file and print on the standard output gfal-sum(1) Calculate checksum of a file gfal-copy(1) Copy files gfal-save(1) read from standard input and write it to a file gfal-stat(1) display extended information about a file or directory gfal-chmod(1) Change the permissions of a file gfal-evict(1) Evict file from a disk buffer gfal-mkdir(1) make directories gfal-token(1) retrieve SE-issued token for a given path gfal-rename(1) Renames files or directories gfal-archivepoll(1) Perform an archive polling operation on the given SURL gfal-bringonline(1) Perform a staging operation on the given SURL