git-cat-file

Имя объекта, сведения о котором нужно показать. Полный список способов записи имён объектов см. в разделе «SPECIFYING REVISIONS» справки gitrevisions[7].

Вместо содержимого показывает тип объекта, заданного параметром <object>.

Вместо содержимого показывает размер объекта, заданного параметром <object>. При использовании с параметром --use-mailmap будет показан размер обновлённого объекта после замены ident с помощью механизма mailmap.

Завершает работу с нулевым кодом возврата, если <object> существует и является допустимым объектом. Если <object> имеет недопустимый формат, завершает работу с ненулевым кодом возврата и выводит сообщение об ошибке в stderr.

Выводит содержимое <object> в удобочитаемом формате в зависимости от его типа.

Обычно это соответствует фактическому типу <object>, но также разрешено запросить тип, который можно без труда разыменовать из указанного <object>. Например, можно запросить «tree», указав в <object> объект-коммит, содержащий это дерево, или запросить «blob», указав объект-тег, ссылающийся на него.

Использует файл mailmap для сопоставления имён и адресов электронной почты автора, коммитера и создателя тега с каноническими настоящими именами и адресами электронной почты. См. git-shortlog[1].

Показывает содержимое после преобразования фильтром textconv. В этом случае параметр <object> должен иметь вид <tree-ish>:<path> или :<path>, чтобы применить фильтр к содержимому, записанному в индексе по пути <path>.

Показывает содержимое после преобразования фильтрами, настроенными в текущем рабочем дереве для указанного пути <path> (например, фильтрами smudge, преобразованием конца строки и т. д.). В этом случае параметр <object> должен иметь вид <tree-ish>:<path> или :<path>.

Исключает объекты из списка выводимых объектов. Этот параметр можно использовать только вместе с одним из пакетных режимов. Исключённые объекты, явно запрошенные с помощью любого пакетного режима, считывающего объекты из стандартного ввода (--batch, --batch-check), будут помечены как «отфильтрованные». Исключённые объекты в режиме --batch-all-objects вообще не будут выведены. Значение <filter-spec> может быть одним из следующих:

Форма --filter=blob:none исключает все блобы.

Форма --filter=blob:limit=<n>[kmg] исключает блобы размером не менее n байт или единиц измерения. Значение n может быть равно нулю. Суффиксы k, m и g обозначают единицы измерения KiB, MiB и GiB. Например, blob:limit=1k эквивалентно blob:limit=1024.

Форма --filter=object:type=(tag|commit|tree|blob) исключает все объекты, тип которых не совпадает с запрошенным.

Используется с --textconv или --filters, чтобы задать имя объекта и путь отдельно, например, если трудно определить ревизию, из которой был получен blob.

Выводит сведения об объекте и его содержимое для каждого объекта, переданного через stdin. Нельзя использовать вместе с другими параметрами или аргументами, кроме --textconv, --filters или --use-mailmap.

Выводит сведения об объекте для каждого объекта, переданного через stdin. Нельзя использовать вместе с другими параметрами или аргументами, кроме --textconv, --filters или --use-mailmap.

Переходит в командный режим, в котором команды и аргументы считываются из stdin. Можно использовать только вместе с --buffer, --textconv, --use-mailmap или --filters.

--batch-command распознаёт следующие команды:

Вместо считывания списка объектов из stdin выполняет запрошенную пакетную операцию над всеми объектами репозитория и всеми альтернативными хранилищами объектов (а не только над достижимыми объектами). Требует указания --batch или --batch-check. По умолчанию объекты обходятся в порядке сортировки по хешам; см. также раздел --unordered ниже. Объекты предоставляются как есть, без учёта механизма «replace» команды git-replace[1].

Обычно пакетный вывод сбрасывается после вывода каждого объекта, чтобы процесс мог интерактивно считывать данные из cat-file и записывать их туда. С этим параметром вывод использует обычную буферизацию stdio; это значительно эффективнее при вызове --batch-check или --batch-command для большого числа объектов.

Если используется --batch-all-objects, объекты обходятся в порядке, который может быть более эффективным для доступа к их содержимому, чем порядок по хешам. Точный порядок не определён, но если конкретный порядок не важен, это обычно ускоряет вывод, особенно с --batch. Обратите внимание: cat-file по-прежнему выводит каждый объект только один раз, даже если он хранится в репозитории несколько раз.

При использовании с --batch или --batch-check следует по символическим ссылкам внутри репозитория при запросе объектов с расширенными выражениями SHA-1 вида tree-ish:path-in-tree. Вместо вывода сведений о самой ссылке выводит сведения об объекте, на который она указывает. Если символическая ссылка указывает за пределы tree-ish (например, на /foo или корневая ссылка указывает на ../foo), будет выведена часть пути ссылки, находящаяся за пределами дерева.

В настоящее время этот параметр работает некорректно, если указан объект в индексе (например, :link вместо HEAD:link), а не объект в дереве.

В настоящее время этот параметр можно использовать только вместе с --batch или --batch-check.

Например, рассмотрим репозиторий Git, содержащий:

f: a file containing "hello\n"
link: a symlink to f
dir/link: a symlink to ../f
plink: a symlink to ../f
alink: a symlink to /etc/passwd

Для обычного файла f команда echo HEAD:f | git cat-file --batch выведет

ce013625030ba8dba906f756967f9e9ca394464a blob 6

Команда echo HEAD:link | git cat-file --batch --follow-symlinks выведет то же самое, как и HEAD:dir/link, поскольку обе указывают на HEAD:f.

Без --follow-symlinks эти команды выводили бы данные о самой символической ссылке. В случае HEAD:link вы увидите

4d1ae35ba2c8ec712fa2a379db44ad639ca277bd blob 1

Обе ссылки — plink и alink — указывают за пределы дерева, поэтому они выведут соответственно:

symlink 4
../f

symlink 11
/etc/passwd

Имеет смысл только с --batch, --batch-check или --batch-command; входные и выходные данные разделяются нулевыми байтами, а не символами новой строки.

Имеет смысл только с --batch, --batch-check или --batch-command; входные данные разделяются нулевыми байтами, а не символами новой строки. Этот параметр устарел; вместо него следует использовать -Z, поскольку в противном случае вывод может быть неоднозначным.

Полное шестнадцатеричное представление имени объекта.

Тип объекта (совпадает со значением, выводимым командой cat-file -t).

Если для указанного объекта доступны сведения о режиме (например, для дерева или записи индекса), режим в виде восьмеричного целого числа. В противном случае — пустая строка.

Размер объекта в байтах (совпадает со значением, выводимым командой cat-file -s).

Размер объекта на диске в байтах. См. примечание о размерах на диске в разделе CAVEATS ниже.

Если объект хранится на диске в виде дельты, подставляется полное шестнадцатеричное представление имени базового объекта этой дельты. В противном случае подставляется нулевой OID (состоящий из одних нулей). См. CAVEATS ниже.

Если этот атом используется в строке вывода, входные строки разделяются по первому пробельному символу. Все символы до этого пробела считаются именем объекта; символы после первой последовательности пробелов (то есть «остаток» строки) выводятся вместо атома %(rest).