Autogenerated man pages for 026351a03507dc3a2e89e068c01234dc55914df2
[git.git] / man1 / git-cat-file.1
1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
2 .de Sh \" Subsection
3 .br
4 .if t .Sp
5 .ne 5
6 .PP
7 \fB\\$1\fR
8 .PP
9 ..
10 .de Sp \" Vertical space (when we can't use .PP)
11 .if t .sp .5v
12 .if n .sp
13 ..
14 .de Ip \" List item
15 .br
16 .ie \\n(.$>=3 .ne \\$3
17 .el .ne 3
18 .IP "\\$1" \\$2
19 ..
20 .TH "GIT-CAT-FILE" 1 "" "" ""
21 .SH NAME
22 git-cat-file \- Provide content or type information for repository objects
23 .SH "SYNOPSIS"
24
25
26 git\-cat\-file [\-t | \-s | \-e | <type>] <object>
27
28 .SH "DESCRIPTION"
29
30
31 Provides content or type of objects in the repository\&. The type is required unless \-t is used to find the object type, or \-s is used to find the object size\&.
32
33 .SH "OPTIONS"
34
35 .TP
36 <object>
37 The sha1 identifier of the object\&.
38
39 .TP
40 \-t
41 Instead of the content, show the object type identified by <object>\&.
42
43 .TP
44 \-s
45 Instead of the content, show the object size identified by <object>\&.
46
47 .TP
48 \-e
49 Suppress all output; instead exit with zero status if <object> exists and is a valid object\&.
50
51 .TP
52 <type>
53 Typically this matches the real type of <object> but asking for a type that can trivially be dereferenced from the given <object> is also permitted\&. An example is to ask for a "tree" with <object> being a commit object that contains it, or to ask for a "blob" with <object> being a tag object that points at it\&.
54
55 .SH "OUTPUT"
56
57
58 If \-t is specified, one of the <type>\&.
59
60
61 If \-s is specified, the size of the <object> in bytes\&.
62
63
64 If \-e is specified, no output\&.
65
66
67 Otherwise the raw (though uncompressed) contents of the <object> will be returned\&.
68
69 .SH "AUTHOR"
70
71
72 Written by Linus Torvalds <torvalds@osdl\&.org>
73
74 .SH "DOCUMENTATION"
75
76
77 Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
78
79 .SH "GIT"
80
81
82 Part of the \fBgit\fR(7) suite
83