Because GARM was designed to be flexible and extensible with
regards data sources, interaction with the GARM tools is done
with references rather than filenames. This allows the same
commands to be used to manage a variety of data locations and
References have the format:
The current types and the types of their locations are given below.
|local-gar||file path||A GAR on a locally visible filesystem|
|remote-gar||descriptor path||A GAR in the repository|
|standalone||collection||A Globus standalone container installation|
A reference refers to a collection of files that GARM should be aware of.
GARM makes no real distinction between GAR files and containers, except that
GARs are read-only. This means you can in principle install the contents
of one container on another. In practice at present you don't get any
more functionality than a bulk copy would have provided, although this
may change in later versions.
The location argument for the standalone container needs more explanation.
This is infact another reference, although to a different kind of collection -
an untyped collection. There is only one reference of this type in the present