The afs command performs some basic actions on a AFS drive:

  • list the content of an AFS folder
  • archive/restore an AFS content from/to a directory for backup purposes

Read this tutorial to learn how to configure an AFS drive.


$> itools afs --help
usage: itools [OPTIONS] afs [--archive <FILE_SYSTEM_NAME>] [--dir <DIR>]
       [--help] [--ls <PATH>] [--unarchive <FILE_SYSTEM_NAME>]

Available options are:
    --config-name <CONFIG_NAME>   Override configuration file name

Available arguments are:
    --archive <FILE_SYSTEM_NAME>     archive file system
    --dir <DIR>                      directory
    --help                           display the help and quit
    --ls <PATH>                      list files
    --unarchive <FILE_SYSTEM_NAME>   unarchive file system



Use the --archive command to archive an AFS root node and all its children to a directory.


Use the --ls command to list the content of the specified AFS node.


Use the --unarchive command to restore an AFS root node from a backup directory.

Required parameters


Use the --dir parameter to specify the directory. This parameter is required by the archive and unarchive commands.


This example shows how to list the content of an AFS root folder:

$> itools afs --ls "my-first-fs"

This example shows how to list the content of a specific folder:

$> itools afs --ls "my-first-fs:/my-first-folder"

This example shows how to backup an AFS node to a directory:

$> itools afs --archive my-first-fs --dir /tmp

This example shows how to restore an AFS node from a backup directory:

$> itools afs --unarchive my-first-fs --dir /tmp

Maven configuration

To use the afs command, add the following dependencies to the pom.xml file:


Read the documentation page to learn more about the AFS implementations.