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>

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)