1GFAL-BRINGONLINE(1)         General Commands Manual        GFAL-BRINGONLINE(1)
2
3
4

NAME

6       gfal-bringonline - Perform a staging operation on the given SURL
7

SYNOPSIS

9       gfal-bringonline [ OPTION ]...  FILE
10
11

DESCRIPTION

13       gfal-bringonline This command performs a staging operation on the given
14       SURL. A bringonline token is returned if the staging  request  is  suc‐
15       cessful. In addition, if the polling timeout is greater than 0 the com‐
16       mand blocks for polling the status of the staging request and only  re‐
17       turns when the file is online or the timeout expires.
18

OPTIONS

20       -h, --help
21              show help about the command.
22
23       -V, --version
24              output version information and exit.
25
26       -v, --verbose
27              verbose mode. Repeat up to 3 times for the most verbose mode.
28
29       -D, --definition DEFINITION
30              define properties for gfal2. Definitions have the following syn‐
31              tax: "CONFIG_GROUP:KEY=VALUE"
32
33       -t, --timeout TIMEOUT
34              global timeout for the execution of the command. Command is  in‐
35              terrupted  if time expires before it finishes. Note: A grace pe‐
36              riod of 30 seconds is given to the global timeout.
37
38       -E, --cert CERT
39              user  certificate.  (This  option  takes   effect   only   after
40              X509_USER_PROXY     environment     variable     and     default
41              /tmp/x509up_u`id -u` location cannot provide a certificate)
42
43       --key KEY
44              user private key.
45
46       -4     forces Gfal2 to use IPv4 addresses only. (Option valid only  for
47              GridFTP protocol)
48
49       -6     forces  Gfal2 to use IPv6 addresses only. (Option valid only for
50              GridFTP protocol)
51
52       -C, --client-info CLIENT_INFO
53              provide custom client-side information.
54
55       --log-file LOG_FILE
56              write Gfal2 library logs to the given file location.
57
58
59       --pin-lifetime
60              Desired pin lifetime
61
62       --desired-request-time
63              Desired total request time
64
65       --staging-metadata
66              Metadata for the  bringonline  operation  --from-file  FROM_FILE
67              read list of surls from a file.
68
69       --polling-timeout
70              The  timeout  for  the  polling  operation. If a polling timeout
71              greater than 0 is provided the command blocks  for  polling  the
72              status  of the staging request and only returns when the file is
73              on disk or the timeout expires.
74
75

EXAMPLES

77       gfal-bringonline   http://endpoint.cern.ch/path/file    --polling-time‐
78       out=3600
79
80

FILES

82       /etc/gfal2.d/*
83              All configuration files in this directory affect the behavior of
84              the underlying gfal2.
85
86

AUTHORS

88       Duarte Meneses <duarte.meneses@cern.ch>
89       Adrien Devresse <adrien.devresse@cern.ch>
90       Alejandro Alvarez Ayllon <alejandro.alvarez.ayllon@cern.ch>
91       Mihai Patrascoiu <mihai.patrascoiu@cern.ch>
92       Joao Lopes <joao.pedro.batista.lopes@cern.ch>
93
94

SEE ALSO

96       gfal-cat(1), gfal-chmod(1),  gfal-copy(1),  gfal-ls(1),  gfal-mkdir(1),
97       gfal-rename(1),  gfal-rm(1),  gfal-save(1),  gfal-stat(1), gfal-sum(1),
98       gfal-token(1), gfal-xattr(1), gfal-evict(1), gfal-bringonline(1), gfal-
99       archivepoll(1)
100
101
102
103v1.8.0                             May 2022                GFAL-BRINGONLINE(1)