Man page - gfal-bringonline(1)

Packages contains this manual

Package: gfal2-util-scripts
apt-get install gfal2-util-scripts

Manuals in package:

Documentations in package:

gfal2-util-scripts

Manual

GFAL-BRINGONLINE

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
FILES
AUTHORS
SEE ALSO

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 <duarte.meneses@cern.ch>
Adrien Devresse <adrien.devresse@cern.ch>
Alejandro Alvarez Ayllon <alejandro.alvarez.ayllon@cern.ch>
Mihai Patrascoiu <mihai.patrascoiu@cern.ch>
Joao Lopes <joao.pedro.batista.lopes@cern.ch>