git-archive

Формат получаемого архива. Возможные значения: tar, zip, tar.gz, tgz, а также любой формат, определённый с помощью параметра конфигурации tar.<format>.command. Если параметр --format не указан, а выходной файл задан, формат по возможности определяется по имени файла (например, запись в foo.zip приводит к тому, что вывод будет в формате zip). В противном случае используется формат вывода tar.

Показать все доступные форматы.

Выводить сведения о ходе выполнения в stderr.

Добавить <prefix>/ перед путями в архиве. Параметр можно указывать несколько раз; для всех отслеживаемых файлов используется его последнее значение. Ниже описано, какое значение используется командой --add-file.

Значение <prefix> используется как задано и не нормализуется. Оно может включать начальные косые черты или компоненты родительских каталогов (например, ../). Некоторые программы для работы с архивами могут считать такие пути потенциально небезопасными и изменять их или выдавать предупреждение при распаковке.

Записать архив в <file> вместо stdout.

Добавить в архив неотслеживаемый файл. Параметр можно указывать несколько раз, чтобы добавить несколько файлов. Путь файла в архиве формируется объединением значения последнего параметра --prefix (если он есть), указанного перед этим параметром --add-file, и базового имени <file>.

Добавить указанное содержимое в архив. Параметр можно указывать несколько раз, чтобы добавить несколько файлов.

Аргумент <path> может начинаться и заканчиваться символом двойной кавычки; содержащиеся в нём имя файла интерпретируется как строка в стиле C, то есть обратная косая черта интерпретируется как символ экранирования. Путь необходимо заключить в кавычки, если он содержит двоеточие, чтобы двоеточие не было ошибочно принято за разделитель между путём и содержимым, или если путь начинается либо заканчивается символом двойной кавычки.

Режим файла ограничен обычным файлом; кроме того, на параметр могут распространяться ограничения командной строки, зависящие от платформы. В нетривиальных случаях создайте неотслеживаемый файл и вместо этого используйте --add-file.

Обратите внимание: в отличие от --add-file, путь, создаваемый в архиве, не зависит от параметра --prefix, поскольку в качестве значения параметра можно указать полный путь <path>.

Также искать атрибуты в файлах .gitattributes рабочего дерева (см. раздел АТРИБУТЫ).

Задать время изменения записей архива. Без этого параметра используется время коммиттера, если <tree-ish> является коммитом или тегом, и текущее время, если это дерево.

Любые дополнительные параметры, поддерживаемые серверной частью архиватора. См. следующий раздел.

Вместо создания tar-архива из локального репозитория получить tar-архив из удалённого репозитория. Обратите внимание, что удалённый репозиторий может ограничивать допустимые выражения sha1 для <tree-ish>. Подробности см. в git-upload-archive[1].

Используется вместе с --remote, чтобы указать путь к git-upload-archive на удалённой стороне.

Дерево или коммит, для которого нужно создать архив.

Если необязательный параметр path не указан, в архив включаются все файлы и подкаталоги текущего рабочего каталога. Если указан один или несколько путей, включаются только они.

Эта переменная позволяет ограничить биты прав доступа записей tar-архива. По умолчанию используется 0002, который отключает право записи для всех пользователей. Специальное значение "user" указывает, что вместо него будет использоваться umask пользователя, создающего архив. Подробности см. в umask(2). Если используется --remote, действует только конфигурация удалённого репозитория.

Эта переменная задаёт команду оболочки, через которую следует передавать вывод tar, созданный командой git archive. Команда выполняется оболочкой; сгенерированный файл tar передаётся ей через стандартный ввод, а окончательный результат она должна вывести в стандартный вывод. Команде передаются все параметры уровня сжатия (например, -9).

Форматы tar.gz и tgz определяются автоматически и по умолчанию используют специальную команду git archive gzip, которая вызывает встроенную реализацию gzip.

Если значение равно true, включает формат для использования удалёнными клиентами через git-upload-archive[1]. Для форматов, определённых пользователем, по умолчанию имеет значение false, а для форматов tar.gz и tgz — true.

Файлы и каталоги с атрибутом export-ignore не добавляются в архивы. Подробности см. в gitattributes[5].

Если для файла установлен атрибут export-subst, Git подставляет значения вместо нескольких заполнителей при добавлении этого файла в архив. Подробности см. в gitattributes[5].

Создать tar-архив, содержащий содержимое последнего коммита текущей ветки, и распаковать его в каталог /var/tmp/junk.

Создать сжатый tar-архив для выпуска v1.4.0.

То же, что и выше, но с использованием встроенной обработки tar.gz.

То же, что и выше, но формат определяется по выходному файлу.

Создать сжатый tar-архив для выпуска v1.4.0, но без глобального расширенного заголовка pax.

Поместить всё содержимое каталога Documentation/ из текущего HEAD в git-1.4.0-docs.zip с префиксом git-docs/.

Создать ZIP-архив, содержащий содержимое последнего коммита текущей ветки. Обратите внимание: формат вывода определяется по расширению выходного файла.

Создаёт tar-архив, содержащий содержимое последнего коммита текущей ветки без префикса, а также неотслеживаемый файл configure с префиксом build/.

Настроить формат "tar.xz" для создания tar-файлов, сжатых с помощью LZMA. Его можно использовать, указав --format=tar.xz, или создав выходной файл, например -o foo.tar.xz.