NAME
gfal-bringonline - Perform a staging operation on the given SURL
SYNOPSIS
gfal-bringonline [ OPTION ]... FILE
DESCRIPTION
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.
EXAMPLES
- gfal-bringonline http://endpoint.cern.ch/path/file --polling-timeout=3600
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]>
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)