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 anther repository that contains it.

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.

  • 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'
    

CAVEATS

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

SEE ALSO

git-annex(1)

AUTHOR

Joey Hess id@joeyh.name

Warning: Automatically converted into a man page by mdwn2man. Edit with care.

Comments on this page are closed.