1datalad export-archive-ora(1)General Commands Manuadlatalad export-archive-ora(1)
2
3
4

NAME

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

SYNOPSIS

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

DESCRIPTION

17       Keys in the local annex object store are reorganized in a temporary di‐
18       rectory  (using  links to avoid storage duplication) to use the the di‐
19       rectory-type special remote. This  alternative  object  store  is  then
20       moved  into  a  7zip  archive  that is suitable for use in a ORA remote
21       dataset store. Placing such an archive into::
22
23       <dataset location>/archives/archive.7z
24
25       Enables the ORA special remote to locate and  retrieve  all  keys  con‐
26       tained in the archive.
27

OPTIONS

29       TARGET if  an  existing  directory,  an 'archive.7z' is placed into it,
30              otherwise this is the path to the target  archive.  Constraints:
31              value must be a string or value must be NONE
32
33       list of options for 7z to replace the default '-mx0' to generate an un‐
34       compressed archive.
35
36
37       -h, --help, --help-np
38              show this help message. --help-np forcefully disables the use of
39              a pager for displaying the help message
40
41       -d DATASET, --dataset DATASET
42              specify  the  dataset to process. If no dataset is given, an at‐
43              tempt is made to identify the dataset based on the current work‐
44              ing  directory.  Constraints: Value must be a Dataset or a valid
45              identifier of a Dataset (e.g. a path) or value must be NONE
46
47       --for LABEL
48              name of the target sibling, wanted/preferred  settings  will  be
49              used  to  filter  the  files added to the archives. Constraints:
50              value must be a string or value must be NONE
51
52       --annex-wanted FILTERS
53              git-annex-preferred-content expression  for  git-annex  find  to
54              filter  files. Should start with 'or' or 'and' when used in com‐
55              bination with `--for`.
56
57       --from FROM [FROM ...]
58              one or multiple tree-ish from which to select files.
59
60       --missing-content {error|continue|ignore}
61              By default, any discovered file with missing content will result
62              in  an error and the export is aborted. Setting this to 'contin‐
63              ue' will issue warnings instead of failing on error.  The  value
64              'ignore'  will only inform about problem at the 'debug' log lev‐
65              el. The latter two can be helpful when generating a TAR  archive
66              from a dataset where some file content is not available locally.
67              Constraints: value must be one  of  ('error',  'continue',  'ig‐
68              nore') [Default: 'error']
69
70       --version
71              show the module and its version which provides the command
72

AUTHORS

74        datalad is developed by The DataLad Team and Contributors <team@datal‐
75       ad.org>.
76
77
78
79datalad export-archive-ora 0.19.3 2023-08-11     datalad export-archive-ora(1)
Impressum