diff options
Diffstat (limited to 'glacier')
-rwxr-xr-x | glacier | 50 |
1 files changed, 43 insertions, 7 deletions
@@ -7,7 +7,7 @@ use Pod::Man; use App::Glacier::Command; use File::Basename; -our $VERSION = '0.60'; +our $VERSION = '1.00'; my %comtab = ( @@ -87,14 +87,38 @@ I<COMMAND> [I<OPTIONS>] I<ARG>... =head1 DESCRIPTION -Command line tool for accessing Amazon Glacier storage. The I<COMMAND> +Command line tool for working with the Amazon Glacier storage. The I<COMMAND> instructs it what kind of manipulation is required. Its action can be modified by I<OPTIONS> supplied after the command name. Options occurring before it, affect the behavior of the program as a whole and are common for all commands. The following is a short summary of existing commands. For a detailed -description about any of them, please run B<glacier I<COMMAND> --help>. +description about any particular I<command>, please refer to the +corresponding manual page (B<glacier-I<command>>), or run +B<glacier I<command> --help>. + +=head2 On file versioning + +In the discussion below, I<FILE> stands for the name of the file to which +the command in question applies. In contrast to the UNIX filesystem, where +each file name is unique within the directory, B<Glacier> vaults can keep +multiple copies of the same file. To discern between them, the I<version +number> is used. When a file B<FILE> is first stored in a vault, it is +assigned version number B<1>. The version numbed of this copy is incremented +each time a new copy of the same file is added to the vault. The most recently +stored copy always has the version number of B<1>. + +Each command by default operates on the most recent copy of the file, i.e. +the one with the version number B<1>. To address a particular version of the +file, append the version number to its name with a semicolon in between. For +example, to list B<FILE>, version B<3>, do: + + glacier ls vault 'FILE;3' + +Notice the use of quotes to prevent C<;> from being interpreted by the shell. + +=head1 COMMANDS =head2 glacier get I<VAULT> I<FILE> [I<LOCALNAME>] @@ -153,7 +177,7 @@ Sets account ID to use. See B<Multiple accounts>, below. Sets the name of the configuration file to use. In the absense of this option, the environment variable B<GLACIER_CONF> is consulted. If it -is not set neither, the default file F</etc/glacier.conf> is read. See +is not set, the default file F</etc/glacier.conf> is read. See the section B<CONFIGURATION> for its description. =item B<-d>, B<--debug> @@ -278,7 +302,7 @@ Sets the number of retries for failed transfers. Defaults to 10. =item B<[database job]> Configures the I<job database>. Job database is a local GDBM file, which -B<glacier> uses to keep track of initiated Amazon Glacier jobs. +B<glacier> uses to keep track of the initiated Amazon Glacier jobs. =over 8 @@ -342,9 +366,21 @@ Default job database name, Inventory database for the I<VAULT>. =back + +=head1 SEE ALSO + +B<glacier-get>(1), +B<glacier-jobs>(1), +B<glacier-ls>(1), +B<glacier-mkvault>(1), +B<glacier-purge>(1), +B<glacier-put>(1), +B<glacier-rm>(1), +B<glacier-rmvault>(1), +B<glacier-sync>. -=head1 AUTHOR - +=head1 AUTHOR + Sergey Poznyakoff <gray@gnu.org> =cut |