mirrors/git-annex
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
git-annex/doc/git-annex-oldkeys.mdwn

55 lines
1.3 KiB
Text
Raw Normal View History

oldkeys: New command that lists the keys used by old versions of a file The tricky thing about this turned out to be handling renames and reverts. For that, it has to make two passes over the git log, and to avoid buffering a possibly huge amount of logs in memory (ie the whole git log of an entire repository!), runs git log twice. (It might be possible to speed this up by asking git log to show a diff, and so avoid needing to use catKey.) Sponsored-By: Brock Spratlen on Patreon
2023-08-22 18:51:06 +00:00
# NAME
git-annex oldkeys - list keys used for old versions of files
# SYNOPSIS
git annex oldkeys `[path ...]`
# DESCRIPTION
Lists keys used for old versions of the specified files or directories.
The output from this command can be piped into a command like
`git-annex drop --batch-keys`
The keys are listed in order from newest to oldest.
oldkeys: check associated files by default and add --unchecked Removed the prior code that checked for keys used by current versions of the files being acted on. It is redundant with the associated files check (so long as the associated files database is always up-to-date, which reconcileStaged should accomplish). Sponsored-by: Luke T. Shumaker on Patreon
2023-08-23 17:31:31 +00:00
When listing old keys for a directory, it will include keys used by deleted
files that were in that directory in past commits.
oldkeys: New command that lists the keys used by old versions of a file The tricky thing about this turned out to be handling renames and reverts. For that, it has to make two passes over the git log, and to avoid buffering a possibly huge amount of logs in memory (ie the whole git log of an entire repository!), runs git log twice. (It might be possible to speed this up by asking git log to show a diff, and so avoid needing to use catKey.) Sponsored-By: Brock Spratlen on Patreon
2023-08-22 18:51:06 +00:00
# OPTIONS
oldkeys: check associated files by default and add --unchecked Removed the prior code that checked for keys used by current versions of the files being acted on. It is redundant with the associated files check (so long as the associated files database is always up-to-date, which reconcileStaged should accomplish). Sponsored-by: Luke T. Shumaker on Patreon
2023-08-23 17:31:31 +00:00
* --unchecked
By default this command does not list a key that is also used by any
file in the currently checked out branch. This option makes it also
list such keys.
The default behavior avoids surprises when dropping listed keys.
This option can be useful when eg copying all old versions of a file to a
remote.
oldkeys --revision-range Sponsored-by: Brett Eisenberg on Patreon
2023-08-22 19:00:29 +00:00
* --revision-range=value
Only list old keys used in the specified range of revisions.
This works the same as the revision range option of `git log`.
See gitrevisions(7) for documentation about the format of this option.
For example, to list only keys used since the tag v1.0, use
`--revision-range=v1.0..HEAD`
oldkeys: New command that lists the keys used by old versions of a file The tricky thing about this turned out to be handling renames and reverts. For that, it has to make two passes over the git log, and to avoid buffering a possibly huge amount of logs in memory (ie the whole git log of an entire repository!), runs git log twice. (It might be possible to speed this up by asking git log to show a diff, and so avoid needing to use catKey.) Sponsored-By: Brock Spratlen on Patreon
2023-08-22 18:51:06 +00:00
* Also the [[git-annex-common-options]](1) can be used.
# SEE ALSO
[[git-annex]](1)
[[git-annex-unused]](1)
# AUTHOR
Joey Hess <id@joeyh.name>
Warning: Automatically converted into a man page by mdwn2man. Edit with care.
Reference in a new issue Copy permalink