git-check-attr(1)

NAME#

git-check-attr - Display gitattributes information

SYNOPSIS#

git check-attr\n [--source <tree-ish>] [-a | --all | <attr>...] [--] <pathname>...
\ngit check-attr\n --stdin [-z] [--source <tree-ish>] [-a | --all | <attr>...]

DESCRIPTION#

For every pathname, this command will list if each attribute is unspecified, set, or unset as a gitattribute on that pathname.

OPTIONS#

-a, --all

--cached

--stdin

-z

--source=<tree-ish>

--

If none of --stdin, --all, or -- is used, the first argument will be treated as an attribute and the rest of the arguments as pathnames.

OUTPUT#

The output is of the form: <path> COLON SP <attribute> COLON SP <info> LF

unless -z is in effect, in which case NUL is used as delimiter: <path> NUL <attribute> NUL <info> NUL

<path> is the path of a file being queried, <attribute> is an attribute being queried, and <info> can be either:

unspecified

unset

set

<value>

Buffering happens as documented under the GIT_FLUSH option in git(1). The caller is responsible for avoiding deadlocks caused by overfilling an input buffer or reading from an empty output buffer.

EXAMPLES#

In the examples, the following .gitattributes file is used:

*.java diff=java -crlf myAttr
NoMyAttr.java !myAttr
README caveat=unspecified

$ git check-attr diff org/example/MyClass.java
org/example/MyClass.java: diff: java

$ git check-attr crlf diff myAttr -- org/example/MyClass.java
org/example/MyClass.java: crlf: unset
org/example/MyClass.java: diff: java
org/example/MyClass.java: myAttr: set

$ git check-attr --all -- org/example/MyClass.java
org/example/MyClass.java: diff: java
org/example/MyClass.java: myAttr: set

$ git check-attr myAttr -- org/example/MyClass.java org/example/NoMyAttr.java
org/example/MyClass.java: myAttr: set
org/example/NoMyAttr.java: myAttr: unspecified

$ git check-attr caveat README
README: caveat: unspecified

SEE ALSO#

gitattributes(5).

GIT#

Part of the git(1) suite