[thirdparty/git.git] / Documentation / git-get-tar-commit-id.txt

git-get-tar-commit-id(1)
========================

NAME
----
git-get-tar-commit-id - Extract commit ID from an archive created using git-archive


SYNOPSIS
--------
[verse]
'git get-tar-commit-id' < <tarfile>


DESCRIPTION
-----------
Acts as a filter, extracting the commit ID stored in archives created by
'git archive'.  It reads only the first 1024 bytes of input, thus its
runtime is not influenced by the size of <tarfile> very much.

If no commit ID is found, 'git get-tar-commit-id' quietly exists with a
return code of 1.  This can happen if <tarfile> had not been created
using 'git archive' or if the first parameter of 'git archive' had been
a tree ID instead of a commit ID or tag.

GIT
---
Part of the linkgit:git[1] suite
Commit	Line	Data
7fc9d69f JH	1	git-get-tar-commit-id(1)
	2	========================
	3
	4	NAME
	5	----
c251005c	6	git-get-tar-commit-id - Extract commit ID from an archive created using git-archive
7fc9d69f JH	7
	8
	9	SYNOPSIS
	10	--------
7791a1d9	11	[verse]
b1889c36	12	'git get-tar-commit-id' < <tarfile>
760b6634	13
7fc9d69f JH	14
	15	DESCRIPTION
	16	-----------
760b6634	17	Acts as a filter, extracting the commit ID stored in archives created by
0b444cdb	18	'git archive'. It reads only the first 1024 bytes of input, thus its
760b6634 RS	19	runtime is not influenced by the size of <tarfile> very much.
760b6634 RS	20
0b444cdb	21	If no commit ID is found, 'git get-tar-commit-id' quietly exists with a
760b6634	22	return code of 1. This can happen if <tarfile> had not been created
0b444cdb	23	using 'git archive' or if the first parameter of 'git archive' had been
760b6634	24	a tree ID instead of a commit ID or tag.
7fc9d69f	25
7fc9d69f JH	26	GIT
7fc9d69f JH	27	---
9e1f0a85	28	Part of the linkgit:git[1] suite