49 lines
1.5 KiB
Text
49 lines
1.5 KiB
Text
|
# NAME
|
||
|
|
|
||
|
|
git-annex filter-process - long running git filter process for git-annex
|
||
|
|
|
||
|
|
# SYNOPSIS
|
||
|
|
|
||
|
|
git annex filter-process
|
||
|
|
|
||
|
|
# DESCRIPTION
|
||
|
|
|
||
|
|
By default, `git-annex smudge` is used as the git filter driver.
|
||
|
|
This is an alternative way to accomplish the same thing, using git's
|
||
|
|
long-running filter process interface.
|
||
|
|
|
||
|
|
To enable using this, run:
|
||
|
|
|
||
|
|
git config filter.annex.process 'git-annex filter-process'
|
||
|
|
|
||
|
|
There will be no visible difference in behavior between enabling this and
|
||
|
|
not, besides changes in speed and memory use when using git.
|
||
|
|
|
||
|
|
When this is not enabled, each file that git wants to filter involves
|
||
|
|
starting up a new `git-annex smudge` process. Starting many such processes
|
||
|
|
for many files can be slow, and can make commands like `git checkout` and
|
||
|
|
`git add` slow when they are operating on a lot of files. (A lot of locked
|
||
|
|
annexed files do not make `git checkout` slow, but unlocked files and
|
||
|
|
non-annexed files do slow it down.)
|
||
|
|
|
||
|
|
On the other hand when this is enabled, `git add` of a large file does an
|
||
|
|
unncessary extra read of the file, and pipes its contents into git-annex.
|
||
|
|
So if you enable this, it will be faster to use `git-annex add` to add
|
||
|
|
large files to the annex, rather than `git add`. Other commands that
|
||
|
|
add files, like `git commit -a`, are also impacted by this.
|
||
|
|
|
||
|
|
# OPTIONS
|
||
|
|
|
||
|
|
* The [[git-annex-common-options]](1) can be used.
|
||
|
|
|
||
|
|
# SEE ALSO
|
||
|
|
|
||
|
|
[[git-annex]](1)
|
||
|
|
[[git-annex-smudge]](1)
|
||
|
|
|
||
|
|
# AUTHOR
|
||
|
|
|
||
|
|
Joey Hess <id@joeyh.name>
|
||
|
|
|
||
|
|
Warning: Automatically converted into a man page by mdwn2man. Edit with care.
|