.TH "datalad export-archive-ora" "1" "2023\-07\-03" "datalad export-archive-ora 0.19.2"
.SH NAME
\fBdatalad export-archive-ora\fR \- export an archive of a local annex object store for the ORA remote.
.SH SYNOPSIS
.nh
.HP
\fBdatalad export\-archive\-ora\fR [-h] [-d\~DATASET] [--for\~LABEL] [--annex-wanted\~FILTERS] [--from FROM [FROM ...]] [--missing-content\~{error|continue|ignore}] [--version] TARGET ...


.hy
.SH DESCRIPTION

Keys in the local annex object store are reorganized in a temporary
directory (using links to avoid storage duplication) to use the
'hashdirlower' setup used by git\-annex for bare repositories and
the directory\-type special remote. This alternative object store is
then moved into a 7zip archive that is suitable for use in a
ORA remote dataset store. Placing such an archive into::
.PP
<dataset location>/archives/archive.7z
.PP
Enables the ORA special remote to locate and retrieve all keys contained
in the archive.
.SH OPTIONS
.TP
TARGET
if an existing directory, an 'archive.7z' is placed into it, otherwise this is the path to the target archive. Constraints: value must be a string or value must be NONE
.TP
...
list of options for 7z to replace the default '-mx0' to generate an uncompressed archive.

.TP
\fB-h\fR, \fB--help\fR, \fB--help-np\fR
show this help message. --help-np forcefully disables the use of a pager for displaying the help message
.TP
\fB-d\fR \fI\s-1DATASET\s0\fR, \fB--dataset\fR \fI\s-1DATASET\s0\fR
specify the dataset to process. If no dataset is given, an attempt is made to identify the dataset based on the current working directory. Constraints: Value must be a Dataset or a valid identifier of a Dataset (e.g. a path) or value must be NONE
.TP
\fB--for\fR LABEL
name of the target sibling, wanted/preferred settings will be used to filter the files added to the archives. Constraints: value must be a string or value must be NONE
.TP
\fB--annex-wanted\fR FILTERS
git-annex-preferred-content expression for git-annex find to filter files. Should start with 'or' or 'and' when used in combination with `--for`.
.TP
\fB--from\fR FROM [FROM ...]
one or multiple tree-ish from which to select files.
.TP
\fB--missing-content\fR {error|continue|ignore}
By default, any discovered file with missing content will result in an error and the export is aborted. Setting this to 'continue' will issue warnings instead of failing on error. The value 'ignore' will only inform about problem at the 'debug' log level. The latter two can be helpful when generating a TAR archive from a dataset where some file content is not available locally. Constraints: value must be one of ('error', 'continue', 'ignore') [Default: 'error']
.TP
\fB--version\fR
show the module and its version which provides the command
.SH AUTHORS
 datalad is developed by The DataLad Team and Contributors <team@datalad.org>.