---
name: "gfal-archivepoll"
section: "1"
platform: "linux"
package: "gfal2-util-scripts"
version: "1.9.0-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/gfal-archivepoll"
---

# gfal-archivepoll(1)

Perform an archive polling operation on the given SURL

## NAME

gfal-archivepoll - Perform an archive polling operation on the given SURL

## SYNOPSIS

**gfal-archivepoll** \[ *OPTION* \]... *FILE*

## DESCRIPTION

**gfal-archivepoll** This command performs an archive polling operation on a given SURL. If a polling timeout greater than 0 is provided the command blocks for polling the status of the archiving request and only returns when the file is on tape 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.

- **--from-file** *FROM\_FILE*

  read sources 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 archiving request and only returns when the file is on tape or the timeout expires.

## EXAMPLES

- **gfal-archivepoll 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-cat/1.md), [**gfal-chmod**(1)](/gfal-chmod/1.md), [**gfal-copy**(1)](/gfal-copy/1.md), [**gfal-ls**(1)](/gfal-ls/1.md), [**gfal-mkdir**(1)](/gfal-mkdir/1.md), [**gfal-rename**(1)](/gfal-rename/1.md), [**gfal-rm**(1)](/gfal-rm/1.md), [**gfal-save**(1)](/gfal-save/1.md), [**gfal-stat**(1)](/gfal-stat/1.md), [**gfal-sum**(1)](/gfal-sum/1.md), [**gfal-token**(1)](/gfal-token/1.md), [**gfal-xattr**(1)](/gfal-xattr/1.md), [**gfal-evict**(1)](/gfal-evict/1.md), [**gfal-bringonline**(1)](/gfal-bringonline/1.md), [**gfal-archivepoll**(1)](/gfal-archivepoll/1.md)