git-annex-import - Online in the Cloud

PROGRAM:

NAME

git-annex-import - move and add files from outside git working copy

SYNOPSIS

git annex import [path ...]

DESCRIPTION

Moves files from somewhere outside the git working copy, and adds them to the annex.
Individual files to import can be specified. If a directory is specified, the entire
directory is imported.

git annex import /media/camera/DCIM/*

When importing files, there's a possibility of importing a duplicate of a file that is
already known to git-annex -- its content is either present in the local repository
already, or git-annex knows of another repository that contains it, or it was present in
the annex before but has been removed now.

By default, importing a duplicate of a known file will result in a new filename being
added to the repository, so the duplicate file is present in the repository twice. (With
all checksumming backends, including the default SHA256E, only one copy of the data will
be stored.)

Several options can be used to adjust handling of duplicate files.

OPTIONS

--duplicate

Do not delete files from the import location.

This could allow importing the same files repeatedly to different locations in a
repository. More likely, it could be used to import the same files to a number of
different branches or separate git repositories.

--deduplicate
Only import files that are not duplicates; duplicate files will be deleted from the
import location.

--skip-duplicates
Only import files that are not duplicates; and avoid deleting duplicate files from
the import location.

--clean-duplicates
Does not import any files, but any files found in the import location that are
duplicates are deleted.

--force
Allow existing files to be overwritten by newly imported files.

Also, causes .gitignore to not take effect when adding files.

file matching options
Many of the git-annex-matching-options(1) can be used to specify files to import.

git annex import /dir --include='*.png'

--jobs=N -JN
Imports multiple files in parallel. This may be faster. For example: -J4

CAVEATS

Note that using --deduplicate or --clean-duplicates with the WORM backend does not look at
file content, but filename and mtime.

Use git-annex-import online using onworks.net services