git-pack-objects

Записывает пары файлов (.pack и .idx), используя <base-name> для определения имени создаваемого файла. При использовании этого параметра два файла пары записываются в файлы <base-name>-<SHA-1>.{pack,idx}. <SHA-1> — это хеш, вычисленный на основе содержимого пакета; он выводится в стандартный поток вывода команды.

Записывает содержимое пакета (то, что было бы записано в файл .pack) в стандартный поток вывода.

Читает аргументы ревизий из стандартного ввода вместо отдельных имен объектов. Аргументы ревизий обрабатываются так же, как в git rev-list: флаг --objects использует аргументы commit для формирования списка выводимых объектов. Объекты из полученного списка упаковываются. Помимо ревизий, также принимаются строки --not или --shallow <SHA-1>.

Подразумевает --revs. При обработке списка аргументов ревизий, прочитанного из стандартного ввода, ограничивает набор упаковываемых объектов теми, которые еще не упакованы.

Подразумевает --revs. Помимо списка аргументов ревизий, прочитанного из стандартного ввода, рассматривает все ссылки в refs/ как включенные в список.

Включает не запрошенные аннотированные теги, если объект, на который они ссылаются, включен в результирующий файл пакета. Это может быть полезно для передачи новых тегов клиентам Git.

Читает из стандартного ввода базовые имена файлов пакетов (например, pack-1234abcd.pack) вместо имен объектов или аргументов ревизий. Результирующий пакет содержит все объекты, перечисленные во включенных пакетах (не начинающихся с ^), за исключением объектов, перечисленных в исключенных пакетах (начинающихся с ^).

Если mode имеет значение "follow", перед именами пакетов может дополнительно указываться !, обозначая, что эти пакеты исключены, но не обязательно замкнуты относительно достижимости. Помимо объектов из включенных пакетов, результирующий пакет может содержать дополнительные объекты в следующих случаях:

Этот режим полезен, например, для восстановления ранее недостижимых объектов из cruft-пакетов и создания пакетов, замкнутых относительно достижимости вплоть до границы, заданной исключенными пакетами.

Несовместим с --revs и параметрами, подразумевающими --revs (например, --all), за исключением совместимого параметра --unpacked.

Упаковывает недостижимые объекты в отдельный пакет "cruft", обозначаемый наличием файла .mtimes. Обычно используется командой git repack --cruft. Вызывающая команда передает список имен пакетов и указывает, какие пакеты останутся в репозитории, а какие будут удалены (такие пакеты отмечаются префиксом -). В cruft-пакет входят все объекты, отсутствующие в сохраняемых пакетах и не вышедшие за пределы льготного периода (см. ниже --cruft-expiration), а также объекты, вышедшие за пределы льготного периода, но достижимые из другого объекта, который еще не вышел за его пределы.

Если во входных данных указан пакет, содержащий все достижимые объекты, а все остальные пакеты помечены для удаления, соответствующий cruft-пакет будет содержать все недостижимые объекты (с mtime новее --cruft-expiration), а также недостижимые объекты с mtime старше --cruft-expiration, если они достижимы из недостижимого объекта с mtime новее --cruft-expiration).

Несовместим с --unpack-unreachable, --keep-unreachable, --pack-loose-unreachable, --stdin-packs, а также с любыми другими параметрами, подразумевающими --revs.

Если указан, объекты удаляются из cruft-пакета, если их mtime старше <approxidate>. Если параметр не указан (и задан --cruft), объекты не удаляются.

Эти два параметра влияют на способ хранения объектов в пакете с использованием дельта-сжатия. Сначала объекты сортируются внутри программы по типу, размеру и, при необходимости, именам; затем каждый объект сравнивается с другими объектами в пределах --window, чтобы определить, позволит ли дельта-сжатие сэкономить место. Параметр --depth ограничивает максимальную глубину дельты; слишком большая глубина снижает производительность распаковки, поскольку данные дельт приходится применять указанное количество раз, чтобы получить нужный объект.

Значение --window по умолчанию равно 10, а --depth — 50. Максимальная глубина — 4095.

Этот параметр задает дополнительное ограничение сверх --window; размер окна будет динамически уменьшаться, чтобы потребление памяти не превышало <n> байт. Это полезно в репозиториях, содержащих объекты разных размеров: большой размер окна не приведет к нехватке памяти, а для небольших объектов при этом можно будет использовать преимущества большого окна. К размеру можно добавить суффикс "k", "m" или "g". Значение --window-memory=0 снимает ограничение на потребление памяти. По умолчанию используется значение переменной конфигурации pack.windowMemory.

В исключительных случаях файловая система может не поддерживать создание файлов больше определенного размера. Этот параметр позволяет указать команде разбить результирующий файл пакета на несколько независимых файлов, каждый из которых не превышает заданный размер. К размеру можно добавить суффикс "k", "m" или "g". Минимально допустимый размер — 1 МиБ. По умолчанию ограничение отсутствует, если только не задана переменная конфигурации pack.packSizeLimit. Обратите внимание: этот параметр может привести к увеличению размера репозитория и снижению его производительности; см. обсуждение в pack.packSizeLimit.

Этот флаг приводит к тому, что объект, уже находящийся в локальном пакете с файлом .keep, игнорируется, даже если в противном случае он был бы упакован.

Этот флаг приводит к тому, что объект, уже находящийся в указанном пакете, игнорируется, даже если в противном случае он был бы упакован. <pack-name> — это имя файла пакета без начального каталога (например, pack-123.pack). Этот параметр можно указать несколько раз, чтобы сохранить несколько пакетов.

Этот флаг приводит к тому, что объект, уже находящийся в пакете, игнорируется, даже если в противном случае он был бы упакован.

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

Создает упакованный архив, только если в нем будет хотя бы один объект.

По умолчанию ход выполнения отображается в стандартном потоке ошибок, если он подключен к терминалу, кроме случаев, когда указан -q. Этот флаг принудительно включает отображение хода выполнения, даже если стандартный поток ошибок не направлен в терминал.

Если указан --stdout, отчет о ходе выполнения отображается во время подсчета и сжатия объектов, но не во время записи. Это сделано потому, что в некоторых случаях поток вывода напрямую связан с другой командой, которая может захотеть отображать собственный ход обработки поступающих данных пакета. Этот флаг действует как --progress, но также принудительно включает отчет о ходе выполнения на этапе записи, даже если используется --stdout.

Этот параметр подразумевает --all-progress при включении отображения хода выполнения. В отличие от --all-progress, сам по себе этот флаг не включает отображение хода выполнения.

Этот флаг запрещает команде отображать ход выполнения в стандартном потоке ошибок.

При создании упакованного архива в репозитории с уже существующими пакетами команда повторно использует существующие дельты. Иногда это приводит к созданию немного неоптимального пакета. Этот флаг запрещает повторное использование существующих дельт и предписывает вычислять их заново.

Этот флаг запрещает повторное использование любых существующих данных объектов, в том числе объектов без дельта-сжатия, и принудительно сжимает все заново. Подразумевает --no-reuse-delta. Полезен только в редком случае, когда требуется применить другой уровень сжатия ко всем упакованным данным.

Задает уровень сжатия для новых сжимаемых данных в создаваемом пакете. Если параметр не указан, уровень сжатия пакета определяется сначала значением pack.compression, затем core.compression, а если ни одно из них не задано, используется значение по умолчанию -1 (значение по умолчанию для zlib). Добавьте --no-reuse-object, если хотите задать единый уровень сжатия для всех данных независимо от их источника.

Включает или выключает алгоритм "sparse", определяющий, какие объекты включать в пакет, при использовании вместе с параметром "--revs". Этот алгоритм обходит только деревья, присутствующие в путях, добавляющих новые объекты. Это может значительно повысить производительность при вычислении пакета для передачи небольшого изменения. Однако если включенные коммиты содержат некоторые типы прямых переименований, в файл пакета могут попасть лишние объекты. Если этот параметр не указан, используется значение pack.useSparse, равное true, если не задано иное.

Создает "тонкий" пакет, исключая общие для отправителя и получателя объекты, чтобы уменьшить объем передаваемых по сети данных. Этот параметр имеет смысл только вместе с --stdout.

Примечание: тонкий пакет нарушает формат упакованного архива, поскольку в нем отсутствуют обязательные объекты, и поэтому Git не может использовать его, пока он не станет автономным. Используйте git index-pack --fix-thin (см. git-index-pack[1]), чтобы восстановить автономность.

Оптимизирует пакет, предназначенный для клиента с неглубоким репозиторием. Этот параметр в сочетании с --thin позволяет уменьшить размер пакета за счет скорости.

Упакованный архив может указывать базовый объект дельты либо его 20-байтовым именем, либо смещением в потоке, но старые версии Git не понимают второй вариант. По умолчанию git pack-objects использует только первый формат для лучшей совместимости. Этот параметр позволяет команде использовать второй формат для компактности. В зависимости от средней длины цепочки дельт этот параметр обычно уменьшает размер результирующего файла пакета на 3–5 процентов.

Примечание: команды верхнего уровня, такие как git gc (см. git-gc[1]) и git repack (см. git-repack[1]), по умолчанию передают этот параметр в современных версиях Git при упаковке объектов репозитория. То же относится к команде git bundle (см. git-bundle[1]) при создании связки.

Задает число потоков, создаваемых при поиске наилучших совпадений дельт. Для работы этого параметра pack-objects должен быть собран с поддержкой pthreads; в противном случае параметр игнорируется с предупреждением. Он предназначен для сокращения времени упаковки на многопроцессорных компьютерах. Однако объем памяти, необходимый для окна поиска дельт, умножается на число потоков. Значение 0 заставляет Git автоматически определить число процессоров и соответственно задать количество потоков.

Предназначен только для использования тестовым набором. Позволяет принудительно задать версию создаваемого индекса пакета, а также использовать 64-битные записи индекса для объектов, расположенных выше заданного смещения.

При использовании этого параметра родители, скрытые с помощью grafts, все равно упаковываются.

Исключает некоторые объекты (обычно блобы) из результирующего файла пакета. Допустимые формы <filter-spec> см. в git-rev-list[1].

Отключает все ранее заданные аргументы --filter=.

Отладочный параметр, предназначенный для помощи в дальнейшей разработке "частичного клонирования". Определяет, как обрабатывать отсутствующие объекты.

Форма --missing=error требует остановить pack-objects с ошибкой при обнаружении отсутствующего объекта. Если репозиторий является частичным клоном, перед тем как объявить объект отсутствующим, будет предпринята попытка загрузить его. Это действие используется по умолчанию.

Форма --missing=allow-any позволяет продолжить обход объектов при обнаружении отсутствующего объекта. Загрузка отсутствующего объекта не выполняется. Отсутствующие объекты молча исключаются из результатов.

Форма --missing=allow-promisor действует как allow-any, но позволяет продолжить обход объектов только для ОЖИДАЕМЫХ отсутствующих объектов promisor. Загрузка отсутствующего объекта не выполняется. При обнаружении неожиданно отсутствующего объекта возникает ошибка.

Исключает объекты, которые, как известно, находятся на удаленном сервере promisor. (Этот параметр предназначен для обработки только объектов, созданных локально, чтобы при повторной упаковке сохранялось различие между локально созданными объектами [без .promisor] и объектами с удаленного сервера promisor [с .promisor].) Используется при частичном клонировании.

Недостижимые объекты из пакетов, указанных с помощью параметра --unpacked=, добавляются в результирующий пакет вместе с достижимыми объектами, отсутствующими в пакетах, помеченных файлами *.keep. Подразумевает --revs.

Упаковывает недостижимые отдельные объекты (а их отдельные копии удаляет). Подразумевает --revs.

Оставляет недостижимые объекты в отдельном виде. Подразумевает --revs.

Ограничивает сопоставление дельт на основе «островов». См. раздел «ДЕЛЬТА-ОСТРОВА» ниже.

При дельта-сжатии Git группирует потенциально похожие объекты, используя эвристики, основанные на пути к объекту. Группировка объектов по точному совпадению пути подходит для путей с множеством версий, однако поиск пар дельт по разным полным путям также имеет свои преимущества. Git собирает объекты сначала по типу, затем по «хешу имени» пути и после этого по размеру, стремясь сгруппировать объекты, которые хорошо сжимаются вместе.

По умолчанию используется версия хеша имени 1, которая обеспечивает локальность хеша, придавая наибольший вес последним байтам пути. Эта версия хорошо различает короткие пути и находит переименования между каталогами. Однако функция хеширования в основном зависит от последних 16 байт пути. Если в репозитории много путей с одинаковыми последними 16 байтами, различающихся только родительским каталогом, хеш имени может привести к слишком большому числу коллизий и ухудшить результаты. В настоящее время эта версия обязательна при записи файлов битовых карт достижимости с помощью --write-bitmap-index.

Версия хеша имени 2 обладает свойствами локальности, схожими со свойствами версии 1, но рассматривает каждый компонент пути отдельно и накладывает хеши друг на друга со сдвигом. При этом приоритет по-прежнему отдается последним байтам пути, но младшие биты хеша также «подмешивают» имена родительских каталогов. Этот метод сохраняет некоторые преимущества локальности версии 1, устраняя при этом большинство коллизий, возникающих, когда файлы с одинаковыми именами находятся в разных каталогах. В настоящее время эта версия не допускается при записи файлов битовых карт достижимости с помощью --write-bitmap-index; она будет автоматически заменена на версию 1.

Выполняет сжатие в два прохода: сначала упорядочивает объекты по путям, затем сжимает их между путями обычным способом. Это может улучшить дельта-сжатие, особенно если имена файлов приводят к коллизиям в используемом Git по умолчанию алгоритме хеширования имен.

Несовместим с --delta-islands. При наличии --path-walk параметр --use-bitmap-index игнорируется. Параметр --path-walk поддерживает формы --filter=<spec>: blob:none, blob:limit=<n>, tree:0, object:type=<type> и sparse:<oid>. Эти поддерживаемые типы фильтров можно комбинировать, используя форму combine:<spec>+<spec>.