git-pack-objects - Online na nuvem

PROGRAMA:

NOME

git-pack-objects - Crie um arquivo compactado de objetos

SINOPSE

git objetos de pacote [-q | --progresso | --all-progress] [--all-progress-implícito]
[--no-reuse-delta] [--delta-base-offset] [--non-vazio]
[--local] [--incremental] [--window = ] [- profundidade = ]
[--revs [--unpacked | --all]] [--stdout | nome-base]
[--shallow] [--keep-true-Parents] <lista de objetos

DESCRIÇÃO

Lê a lista de objetos da entrada padrão e grava um arquivo compactado com
nome-base ou para a saída padrão.

Um arquivo compactado é uma maneira eficiente de transferir um conjunto de objetos entre dois repositórios
bem como um formato de arquivo de acesso eficiente. Em um arquivo compactado, um objeto é
armazenado como um todo compactado ou como uma diferença de algum outro objeto. O último é
frequentemente chamado de delta.

O formato de arquivo compactado (.pack) é projetado para ser independente para que possa ser
descompactado sem qualquer informação adicional. Portanto, cada objeto do qual um delta depende
deve estar presente dentro da embalagem.

Um arquivo de índice de pacote (.idx) é gerado para acesso rápido e aleatório aos objetos no pacote.
Colocando o arquivo de índice (.idx) e o arquivo compactado (.pack) no pacote /
subdiretório de $ GIT_OBJECT_DIRECTORY (ou qualquer um dos diretórios em
$ GIT_ALTERNATE_OBJECT_DIRECTORIES) permite que o Git leia do arquivo do pacote.

A git descompactar objetos comando pode ler o arquivo compactado e expandir os objetos
contido no pacote no formato "um arquivo um objeto"; isso normalmente é feito pelo
comandos smart-pull quando um pacote é criado em tempo real para transporte de rede eficiente por
seus pares.

OPÇÕES

nome-base
Grave em um par de arquivos (.pack e .idx), usando para determinar o nome
do arquivo criado. Quando esta opção é usada, os dois arquivos são gravados em
- Arquivos. {pack, idx}. é um hash baseado no conteúdo do pacote e
é gravado na saída padrão do comando.

--stdout
Grave o conteúdo do pacote (o que teria sido gravado no arquivo .pack) para o
saída padrão.

--revs
Leia os argumentos de revisão da entrada padrão, em vez de objeto individual
nomes. Os argumentos de revisão são processados ​​da mesma forma que git lista de rev com o
O sinalizador --objects usa seus argumentos de confirmação para construir a lista de objetos que produz. o
os objetos na lista resultante são compactados. Além das revisões, --not ou --shallow
linhas também são aceitas.

- desempacotado
Isso implica --revs. Ao processar a lista de argumentos de revisão lidos do
entrada padrão, limite os objetos embalados para aqueles que ainda não estão embalados.

--tudo
Isso implica --revs. Além da lista de argumentos de revisão lidos do
entrada padrão, finja que todas as refs sob refs / são especificadas para serem incluídas.

--incluir-tag
Incluir tags anotadas não solicitadas se o objeto ao qual fazem referência foi incluído no
packfile resultante. Isso pode ser útil para enviar novas tags para clientes Git nativos.

--window = , --depth =
Essas duas opções afetam como os objetos contidos no pacote são armazenados usando delta
compressão. Os objetos são primeiro classificados internamente por tipo, tamanho e, opcionalmente,
nomes e comparados com outros objetos dentro de --window para ver se está usando delta
a compressão economiza espaço. --depth limita a profundidade delta máxima; tornando-o muito profundo
afeta o desempenho do lado do desempacotador, porque os dados delta precisam ser aplicados
tantas vezes para chegar ao objeto necessário. O valor padrão para --window é 10
e --depth é 50.

--window-memory =
Esta opção fornece um limite adicional no topo de --window; o tamanho da janela irá
diminuir dinamicamente para não ocupar mais do que bytes na memória. Isto é
útil em repositórios com uma mistura de objetos grandes e pequenos para não ficar sem memória
com uma grande janela, mas ainda pode aproveitar a grande janela para o
objetos menores. O tamanho pode ser sufixado com "k", "m" ou "g". --window-memory = 0
torna o uso de memória ilimitado, que é o padrão.

--max-pack-size =
Tamanho máximo de cada arquivo de pacote de saída. O tamanho pode ser sufixado com "k", "m" ou "g".
O tamanho mínimo permitido é limitado a 1 MiB. Se especificado, vários packfiles podem ser
criada. O padrão é ilimitado, a menos que a variável de configuração pack.packSizeLimit seja
definido.

--honor-pack-keep
Este sinalizador faz com que um objeto já em um pacote local que tem um arquivo .keep seja
ignorado, mesmo que de outra forma fosse embalado.

- incremental
Este sinalizador faz com que um objeto já em um pacote seja ignorado, mesmo se tivesse
caso contrário, foi embalado.

--local
Este sinalizador faz com que um objeto que é emprestado de um armazenamento de objeto alternativo seja
ignorado mesmo que de outra forma tivesse sido embalado.

--não vazio
Crie um arquivo compactado apenas se ele contiver pelo menos um objeto.

--progresso
O status do progresso é relatado no fluxo de erro padrão por padrão quando é
conectado a um terminal, a menos que -q seja especificado. Este sinalizador força o status de progresso mesmo
se o fluxo de erro padrão não for direcionado a um terminal.

--todo o progresso
Quando --stdout é especificado, o relatório de progresso é exibido durante a contagem de objetos
e fases de compressão, mas inibidas durante a fase de write-out. A razão é que em
alguns casos, o fluxo de saída está diretamente vinculado a outro comando que pode desejar
exibe o status de progresso próprio à medida que processa os dados do pacote de entrada. Esta bandeira é
como --progress, exceto que força o relatório de progresso para a fase de write-out também
mesmo se --stdout for usado.

- todo o progresso implícito
Isso é usado para indicar --all-progress sempre que a exibição de progresso for ativada. diferente
--all-progress este sinalizador não força nenhuma exibição de progresso por si só.

-q
Este sinalizador faz com que o comando não relate seu progresso no fluxo de erro padrão.

--no-reuse-delta
Ao criar um arquivo compactado em um repositório que possui pacotes existentes, o comando
reutiliza deltas existentes. Isso às vezes resulta em um pacote ligeiramente abaixo do ideal. Esse
sinalizador diz ao comando para não reutilizar deltas existentes, mas calculá-los do zero.

--objeto sem reutilização
Este sinalizador diz ao comando para não reutilizar dados de objetos existentes, incluindo não
objeto deltificado, forçando a recompressão de tudo. Isso implica em --no-reuse-delta.
Útil apenas no caso obscuro onde a aplicação geral de uma compressão diferente
nível nos dados compactados é desejado.

--compression =
Especifica o nível de compactação para dados recém-compactados no pacote gerado. Se não
especificado, o nível de compactação do pacote é determinado primeiro por pack.compression e, em seguida, por
core.compression, e o padrão é -1, o padrão zlib, se nenhum estiver definido. Adicionar
--no-reuse-object se você quiser forçar um nível de compressão uniforme em todos os dados não
importa a fonte.

--afinar
Crie um pacote "fino", omitindo os objetos comuns entre um remetente e um receptor em
a fim de reduzir a transferência de rede. Esta opção só faz sentido em conjunto com
--stdout.

Nota: Um pacote fino viola o formato de arquivo compactado ao omitir os objetos necessários e
é, portanto, inutilizável pelo Git sem torná-lo independente. Use git index-pack
--fix-thin (veja pacote de índice git(1)) para restaurar a propriedade independente.

--raso
Otimize um pacote que será fornecido a um cliente com um repositório raso. Esse
a opção, combinada com --thin, pode resultar em um pacote menor ao custo da velocidade.

--delta-base-offset
Um arquivo compactado pode expressar o objeto base de um delta como um objeto de 20 bytes
nome ou como um deslocamento no fluxo, mas as versões antigas do Git não entendem o
último. Por padrão, git objetos de pacote usa apenas o formato anterior para melhor
compatibilidade. Esta opção permite que o comando use o último formato para
compacidade. Dependendo do comprimento médio da cadeia delta, esta opção normalmente
reduz o packfile resultante em 3-5 por cento.

Nota: Comandos de porcelana como git gc (veja git-gc(1)), git repack (ver git-
Reembalar(1)) passar esta opção por padrão no Git moderno quando eles colocam objetos em seu
repositório em arquivos de pacote. O mesmo acontece com o pacote git (veja pacote git(1)) quando cria um
agrupar.

--threads =
Especifica o número de threads a serem gerados ao pesquisar as melhores correspondências delta. Esse
requer que os objetos do pacote sejam compilados com pthreads caso contrário esta opção será ignorada
com um aviso. Isso visa reduzir o tempo de empacotamento em máquinas com multiprocessadores. o
quantidade necessária de memória para a janela de pesquisa delta é, no entanto, multiplicada pelo
número de processos. Especificar 0 fará com que o Git detecte automaticamente o número de CPUs e
defina o número de threads de acordo.

--index-version = [, ]
Isso deve ser usado apenas pelo conjunto de testes. Permite forçar a versão para
o índice de pacote gerado e para forçar entradas de índice de 64 bits em objetos localizados acima
o deslocamento fornecido.

--manter-verdadeiros-pais
Com esta opção, os pais que estão escondidos por enxertos são embalados mesmo assim.

Use git-pack-objects online usando serviços onworks.net