NAME

       datalad export-archive-ora - export an archive of a local annex object store for the ORA remote.

SYNOPSIS

       datalad  export-archive-ora  [-h]  [-d DATASET] [--for LABEL] [--annex-wanted FILTERS] [--from FROM [FROM
              ...]] [--missing-content {error|continue|ignore}] [--version] TARGET ...

DESCRIPTION

       Keys in the local annex object store are reorganized in a temporary directory (using links to avoid stor‐
       age duplication) to use the 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::

       <dataset location>/archives/archive.7z

       Enables the ORA special remote to locate and retrieve all keys contained in the archive.

OPTIONS

       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

       list of options for 7z to replace the default '-mx0' to generate an uncompressed archive.

       -h, --help, --help-np
              show this help message. --help-np forcefully disables the use of a pager for displaying  the  help
              message

       -d DATASET, --dataset DATASET
              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

       --for 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

       --annex-wanted 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`.

       --from FROM [FROM ...]
              one or multiple tree-ish from which to select files.

       --missing-content {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']

       --version
              show the module and its version which provides the command

AUTHORS

        datalad is developed by The DataLad Team and Contributors <team@datalad.org>.

datalad export-archive-ora 1.1.0                   2024-06-14                      datalad export-archive-ora(1)