# gfal2

## Description

The Grid File Access Library 2 offers a POSIX interface to the distributed files system supported by WLCG.
Differents file systems are supported by a collections of GFAL 2 plugins, this is a non complete list:

- GRIDFTP with gsiftp://
- LFC (Logical File Catalog), with lfn://
- SRM (Storage Resource Manager) with srm://
- RFIO (Remote File I/O) with rfio://
- DCAP (Remote FTP for dCache ) with gsidcap://
- HTTP/Webdav with cluster, third party copy and client side credential support
- XRootD protocll with root://
- S3 and Google Cloud, with s3:// and gcloud://.

## Installation

GFAL2 itself abstracts the access to different underlying storage systems - including local -, but in order to get support for a given protocol, its corresponding plugin needs to be installed.

- gfal2-plugin-gridftp
- gfal2-plugin-lfc
- gfal2-plugin-srm
- gfal2-plugin-rfio
- gfal2-plugin-dcap
- gfal2-plugin-http
- gfal2-plugin-xrootd
- gfal2-plugin-file
- gfal2-plugin-mock

For convenience we provide a package called gfal2-all, which will trigger the installation of all these packages.
gfal2-devel is required only for development.
A typical installation can be done as easy as bellow:

    yum install gfal2-all gfal2-devel

## API Documentation

Doxygen documentation
You can also have a look at the examples folder to see some simple usage of the API.

## License

This software is licensed under the Apache 2 License. See LICENSE for details.

## Release Notes

See RELEASE-NOTES for a detailed changelog.

## Contact

You can notify bugs or ask for feature requests via

Tracker
  https://its.cern.ch/jira/projects/DMC/
Mailing list
  dmc-support@cern.ch