gfal-bringonline(1)

Usage

gfal-bringonline [OPTION] ... FILE

Overview

gfal-bringonline This command performs a staging operation on the given SURL. A bringonline token is returned if the staging request is successful. In addition, if the polling timeout is greater than 0 the command blocks for polling the status of the staging request and only returns when the file is online or the timeout expires.

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.

--pin-lifetime: Desired pin lifetime

--desired-request-time: Desired total request time

--staging-metadata: Metadata for the bringonline operation --from-file FROM_FILE read list of surls from a file.

--polling-timeout: The timeout for the polling operation. If a polling timeout greater than 0 is provided the command blocks for polling the status of the staging request and only returns when the file is on disk or the timeout expires.