jigdo-file - Online na nuvem

PROGRAMA:

NOME

jigdo-file - Prepare os arquivos para download do Jigsaw (distribuição de arquivos enormes, por exemplo, CD
imagens).

SINOPSE

arquivo jigdo COMANDO
[ --image =cdrom.iso ] [ --jigdo =cdrom.jigdo ] [ --template =cdrom.template ] [ --força ] [
MAIS OPÇÕES ] [ ARQUIVOS ... | --files-from =f ]
comum COMANDOS: fazer-modelo, fazer-imagem, verificar

DESCRIÇÃO

Jigsaw Download, ou short jigdo, é um esquema desenvolvido principalmente para tornar mais fácil
distribuir imagens enormes do sistema de arquivos (por exemplo, imagens de CD (ISO9660) ou DVD (UDF)) sobre o
Internet, mas também pode ser usado para outros dados que são difíceis de manusear devido ao seu
tamanho, como arquivos de áudio / vídeo ou grandes pacotes de software.

O jigdo tenta garantir que o arquivo grande (sempre chamado imagem de agora em diante) é baixado
em pequenas partes que podem ser armazenadas em diferentes servidores. Pessoas que desejam baixar o
imagem fazê-lo dizendo ao jigdo(1) (NÃO IMPLEMENTADO AINDA) baixar ferramenta para processar um
`.jigdo' Arquivo; usando isso, jigdo baixa as peças e remonta a imagem. arquivo jigdo
é usado para preparar os arquivos para download.

O que torna o jigdo especial é que as partes que são usadas para reconstruir a imagem podem ter
qualquer tamanho e conteúdo - eles só precisam estar contidos em uma região contígua em qualquer lugar em
a imagem.

Por exemplo, se você deseja distribuir uma imagem ISO9660 que contém um instantâneo de um
Servidor FTP, você pode instruir arquivo jigdo para preparar os dados de download de tal forma que
quando as pessoas usam jigdo para baixar a imagem, jigdo realmente busca os arquivos individuais
do servidor FTP e os monta em uma cópia exata de sua imagem - durante o
download! (Se a imagem não for um despejo do sistema de arquivos, você pode usar divisão(1) para criar o pequeno
partes das quais a imagem será remontada.)

Você é totalmente livre para escolher onde as partes individuais da imagem são armazenadas:
podem estar em diretórios totalmente diferentes em servidores diferentes (por exemplo, por causa de
restrições de armazenamento / largura de banda), mas isso é invisível para as pessoas que fazem o download do seu
imagem. As informações sobre os servidores disponíveis só precisam ser adicionadas ao `.jigdo' Arquivo
por você antes de distribuí-lo.

A seção `DETALHES 'abaixo contém detalhes técnicos sobre como o jigdo funciona. Os `EXEMPLOS '
seção lista uma série de cenários comuns e pode ajudá-lo a ter uma ideia de como o jigdo
é útil para.

OPÇÕES

Muitas opções são específicas para um determinado COMANDO; os abaixo são gerais ou usados ​​por
vários comandos. Outras opções estão listadas abaixo com os comandos individuais. Tudo
as opções são silenciosamente ignoradas se não forem aplicáveis ​​ao comando atual. Para qualquer
BYTES parâmetros às opções, você pode anexar uma das letras `k ',` M' ou `G 'ao
quantidade que você especifica, para indicar kilobytes, megabytes ou gigabytes.

-h --Socorro
Produza um breve resumo de comandos e opções.

-H --ajuda-tudo
Saída de resumo completo de comandos e opções.

-v --versão
Versão do programa de saída.

-i --image =cdrom.iso
Especifique a localização do arquivo que contém a imagem. A imagem é o arquivo grande que
você deseja distribuir.

-j --jigdo =cdrom.jigdo
Especifique a localização do arquivo de descrição de download do Jigsaw. O arquivo jigdo é um
arquivo legível gerado por arquivo jigdo, ao qual você adiciona informações sobre todos
os servidores para os quais você enviará os arquivos. jigdo irá baixar este arquivo como
a primeira etapa de recuperação da imagem.

-t --template =cdrom.template
Especifique a localização do arquivo de 'modelo' de imagem. O arquivo de modelo é um arquivo binário
gerado por arquivo jigdo, contém informações sobre como remontar a imagem e
também (na forma compactada) todos os dados da imagem que não foram encontrados em nenhum dos
as partes.

Dependendo do comando, cada um desses três arquivos é usado às vezes para entrada,
às vezes para saída. Se o arquivo deve ser usado para a saída de um comando específico
e o arquivo de saída já existe, arquivo jigdo sai com um erro, a menos que --força
é presente.

Na maioria dos casos, você só precisa especificar um de -i -j -t, porque qualquer
os nomes de arquivos ausentes serão deduzidos daquele que você especificar. Isso é feito primeiro
removendo qualquer extensão do nome fornecido e, em seguida, não acrescentando nada (se
deduzindo --imagem), `.jigdo'ou `.modelo'.

-r --report = default | noprogress | quiet | grep
Controle a extensão do programa e o formato da saída: sem progresso is
a mesma omissão exceto que nenhuma mensagem de progresso `x% concluído 'é impressa. calma
restringe a saída ao que é absolutamente necessário, principalmente mensagens de erro. grep
só é diferente de omissão para o fazer-modelo comando: habilita a saída em
um simples ` 'formato que é útil ao pesquisar por arquivos binários
em outros arquivos binários.

-f --força
Substitua os arquivos de saída existentes sem reclamar.

- sem força
Esta is que o padrão. Recuse-se a sobrescrever arquivos de saída existentes.

-c --cache =jigdo-cache.db
arquivo jigdo geralmente precisa ler todo o conteúdo de todos os ARQUIVOS você especifica.
Se você usá-lo repetidamente (por exemplo, porque você disponibiliza uma nova imagem de CD diariamente),
armazenar em cache as informações do arquivo aumentará significativamente a velocidade do programa. O
arquivo de cache é criado automaticamente se ainda não estiver presente. Dados geralmente são ambos
ler e escrever nele.

--sem cache
Esta is que o padrão. Não use um cache.

--cache-expiry =SEGUNDOS
Defina a idade máxima das entradas de cache. Quaisquer entradas anteriores a isso serão removidas de
o cache. O padrão é 30 dias. Você pode anexar uma das letras `h ',` d', `w ',
`m ',` y' para denotar horas, dias, semanas, meses ou anos, respectivamente. Um valor de
`0 'ou` off' desabilita a expiração, para que todas as entradas permaneçam no cache para sempre.
Consulte a seção `ARQUIVOS DE CACHE 'abaixo para obter mais informações.

--readbuffer =BYTES
Defina o tamanho dos buffers internos. O padrão é 128k - se você tiver um disco rápido,
aumentar este valor pode fazer arquivo jigdo mais rápido, mas em geral, mudá-lo é
não é necessário.

--md5-block-size =BYTES
Desinteressante interno parâmetro. Defina o tamanho dos blocos nos quais os arquivos são
subdividido. O padrão é 128k. Se você alterá-lo, qualquer arquivo de cache terá que ser
regenerado. Internamente, arquivo jigdo pode escolher usar um ligeiramente maior ou menor
valor.

-T --files-from =lima
Leia os nomes dos arquivos e diretórios do arquivo especificado. Se lima é `- ', lê os nomes
da entrada padrão. Cada linha do arquivo é considerada um nome, então os nomes podem
contêm espaços, mas não caracteres de nova linha. Uma linha vazia causa arquivo jigdo parar
lendo do arquivo.

find(1) é uma ferramenta poderosa para gerar listas de arquivos, mas certifique-se de usar `find
-Tipo f'se possível - caso contrário, se você instruir find para produzir um nome de arquivo
e um link simbólico para esse nome de arquivo, arquivo jigdo irá ler o conteúdo do arquivo duas vezes.

--hex. Soma de verificação de saída em hexadecimal em vez de formato semelhante a Base64. Isso não deveria ser
usado com o fazer-modelo comando, porque o resultado `.jigdo'arquivo viola
o `.jigdo' formato de arquivo. Seu uso pretendido é fazer arquivo jigdo mais interoperável
com outros utilitários de shell Unix como md5sum(1).

--sem hexadecimal
Esta is que o padrão. Use a própria codificação de somas de verificação semelhante a Base64 do jigdo.

--debug [= ajuda | = tudo | =UNIDADE, ~ UNIDADE ... ]
Ative ou desative a saída de depuração. Apenas `--debug 'é equivalente a` --debug = all'.
O argumento é uma lista separada por vírgulas de nomes de unidades para as quais a saída de depuração é
a ser habilitado ou desabilitado se o nome for precedido por `~ '. O nome especial `all '
significa todas as unidades. Por padrão, a saída de depuração é desligada, exceto para as unidades
`afirmar 'e` geral'. A lista exata de unidades disponíveis para as quais a depuração pode
ser ligado depende se o jigdo foi compilado com suporte para depuração - o
lista pode ser impressa com `--debug = help '.

ARQUIVOS Nomes de arquivos ou diretórios a serem usados ​​como entrada. Estas são as partes que são
contido na imagem. No caso de um dos nomes ser um diretório, o programa
verifica recursivamente o diretório e adiciona todos os arquivos contidos nele. Enquanto faz
isso, segue links simbólicos, mas evita loops de links simbólicos.

Se um dos nomes de arquivo começar com o caractere `- ', você deve preceder a lista de
arquivos com `- '. Um valor de `- 'tem não significado especial nesta lista, significa
um arquivo cujo nome é um único hífen.

COMANDOS

O nome do comando é o primeiro argumento não opcional passado para arquivo jigdo. A maioria dos comandos tem
abreviações curtas e nomes longos. A baixo comando nomes rede de apoio social não be usava in
Scripts - lá pode be incompatível alterar para eles in que o futuro!

FAZER MODELO, MT
Lê imagem e ARQUIVOS, cria `.jigdo'e'.modelo'. Esta é a principal funcionalidade do
arquivo jigdo.

É possível especificar ambos --image = - e --files-from = -. Neste caso, primeiro a lista
de arquivos é lido da entrada padrão até que uma linha vazia seja encontrada. Tudo
a seguir é assumido como sendo os dados da imagem. Isso pode ser útil se você usar mkisofs(1) ou
programas semelhantes que podem produzir a imagem completa em sua saída padrão, porque
não há necessidade de armazenar a imagem no disco temporariamente.

Se um ARQUIVOS argumento contém os caracteres `// '(Unix) ou` \. \' (Windows), este tem
significado especial. No arquivo jigdo final que os usuários irão baixar, cada uma das partes é
referenciado na seção `[Parts] 'com um URI no formato` Label: algum / nome do arquivo'. (Ver
`FORMATO DE ARQUIVOS .JIGDO 'abaixo para uma descrição detalhada.) A seção` [Servidores]' fornece
um mapeamento de rótulos para servidores na internet, com linhas como
`Label =http://myserver.org/jigdofiles/'. Usando essas informações, jigdo irá criar o
URI de download final para a parte, `http://myserver.org/jigdofiles/some/filename'.
Especificar `// '(ou` \. \') Em um nome de arquivo ou diretório serve para `cortar 'os nomes em
o nível de diretório correto. Por exemplo, se o caminho Unix de um de seus ARQUIVOS is
`/ caminho / algum / nome do arquivo ', você pode dizer arquivo jigdo para cortar após o `/ path 'passando-o
o argumento `/ caminho // algum / nome de arquivo ', ou` / caminho //' se você deseja que todo o diretório seja verificado.
Os nomes dos caminhos não precisam ser absolutos; `algumedirectory // 'também é possível.

--rótulo Rótulo = / caminho
Especifique um nome a ser usado como nome do rótulo para um caminho no disco. (Influencia a saída
arquivo jigdo.) Se você usou `// 'no ARQUIVOS argumentos conforme descrito acima, arquivo jigdo
irá por padrão escolher os nomes dos rótulos automaticamente (`A ',` B' etc.). Com esta opção,
você pode dar aos rótulos nomes mais significativos. Observe que o nome do rótulo será apenas
usado se um ou mais ARQUIVOS comece com `/ path // '.

Tente usar nomes de rótulos que começam com caracteres maiúsculos, para eliminá-los
claramente a partir de nomes de protocolo como `http ',` ftp'.

--uri Label =http://some.server.org/
Por padrão, usando --rótulo como descrito acima irá causar linhas do formulário
`Label = file: / path / 'a ser escrito na seção` [Servers]' do jigdo de saída
Arquivo. Se você deseja sobrescrever o URI `arquivo: 'para que a linha leia
`Label =http://some.server.org/', você pode fazer isso especificando --uri e o
--rótulo. Dando apenas --uri Rótulo = ... sem o correspondente --rótulo Rótulo = ...
não tem efeito, e mesmo se você especificar ambos, uma entrada só é adicionada ao
Seção `[Servidores] 'se o rótulo é referenciado por pelo menos uma entrada` [Partes]'.

O valor fornecido não é cotado pelo programa; se contiver caracteres como
espaço ou qualquer um dos caracteres # "'\ então você deve citá-lo. (No Unix, você pode
precisa citar o valor duas vezes para protegê-lo do shell, por exemplo, \\\\ ou '\\'
para obter uma única barra invertida no URI.)

O mapeamento especificado com um --uri opção é ignorada se já estiver presente em
o arquivo jigdo de saída.

Os usuários da versão Windows podem notar que os separadores de diretório `\ 'são
convertidos em `/ 'nos URIs` file:' que são gerados por padrão. Isso está feito
para aumentar a compatibilidade de plataforma cruzada de `arquivo: '- o impressão faltando comando de
a versão do Windows reconverterá automaticamente os caracteres quando imprimir o
URIs. No caso de você fornecer seus próprios URIs `file: 'no Windows usando --uri, Você deve
também troque `/ 'e` \'.

-0 para -9
Defina a quantidade de compactação no arquivo de modelo de saída, de -0 (sem compressão) para
-9 (compressão máxima). O padrão é -9, o que pode tornar a geração do modelo
Bastante lento. Por padrão, o algoritmo de compressão usado é o mesmo que para gzip(1).

--gzip e --bzip2
Escolha entre os algoritmos de compressão gzip e bzip2. O padrão é gzip.
Bzip2 geralmente oferece uma taxa de compressão melhor, mas a compressão é significativamente
mais lento do que com gzip.

--min-length =BYTES
Defina o comprimento mínimo de uma peça para arquivo jigdo procurá-lo na imagem. O
o padrão é 1k. Partes menores do que isso nunca serão encontradas na imagem, então seus
os dados serão incluídos no arquivo de modelo. O algoritmo de pesquisa usado requer tal
um comprimento mínimo, caso contrário, a geração do modelo pode se tornar extremamente lenta. Se vocês
saiba com certeza que todos os seus ARQUIVOS são maiores do que uma certa quantidade, você pode
aumentar arquivo jigdoligeiramente a velocidade de, especificando a quantidade com esta opção.
Há um mínimo absoluto conectado de 256 bytes - qualquer coisa menor será silenciosa
ser definido para 256.

--merge =ARQUIVO
Inclui o conteúdo de ARQUIVO na saída `.jigdo' Arquivo. O arquivo pode conter dados
que você deseja adicionar à saída (por exemplo, uma seção `[Servidores] 'com uma lista
de seus servidores como entradas), ou pode ser a saída do arquivo jigdo por uma execução anterior
of arquivo jigdo.

É possível especificar o mesmo arquivo para entrada com --mesclar e para saída com
--jigdo. No entanto, você também precisará usar --força para fazer o programa sobrescrever
a versão antiga do arquivo jigdo com a nova. ARQUIVO pode ser `- 'para padrão
entrada.

Quando acrescentando novas informações para o arquivo fornecido, arquivo jigdo não vai inserir novo
linhas na seção `[Parts] 'se uma entrada para a mesma soma de verificação MD5 (mas não
necessariamente com o mesmo URI!) já existe, e não irá inserir novas linhas
na seção `[Servidores] 'se uma entrada completamente idêntica já existir.

Quando leitura in o existente ARQUIVO, o comportamento é um pouco diferente: o programa
conserva entradas na seção `[Parts] 'com checksum idêntico, mas diferente
URIs. Para entradas completamente idênticas (mesma soma de verificação e URI), apenas uma entrada é
preservados e as duplicatas são removidas. A seção `[Servers] 'é deixada
intocado.

--imagem-seção
Esta is que o padrão. destaque arquivo jigdo para adicionar uma seção `[Image] 'ao`.jigdo'
arquivo.

Como exceção, uma nova seção `[Imagem] 'é não adicionado se você usar --mesclar e os votos de
arquivo a ser mesclado contém uma seção `[Image] 'com uma linha que diz` Template-
MD5Sum = '(fim da linha após o `='). Neste caso, os dados do modelo gerados
O valor da soma de verificação MD5 é apenas adicionado após o `= 'da primeira linha deste formulário no
o arquivo - nenhuma seção `[Image] 'totalmente nova é anexada. Este comportamento é útil
porque permite que você passe por --mesclar uma seção `[Image] 'com
conteúdo e, em seguida, ter a soma de verificação MD5 adicionada automaticamente por arquivo jigdo. O
a seção `FORMATO DE ARQUIVOS .JIGDO 'abaixo explica o conteúdo da seção` [Imagem]' em
maiores detalhes.

--sem-imagem-seção
Do não incluir uma seção `[Image] 'na seção`.jigdo' Arquivo. Você precisa adicionar um
você mesmo se usar esta opção. No entanto, fazer isso não é fácil (você também precisa
adicione uma linha `Template-MD5Sum 'com a soma de verificação correta, ou jigdo vai reclamar), então
o uso desta opção é desencorajado.

--servidores-seção
Esta is que o padrão. destaque arquivo jigdo para adicionar uma seção `[Servidores] 'ao`.jigdo'
Arquivo. Esta seção padrão usa URIs `file: ', que permite a remontagem imediata
da imagem do sistema de arquivos local, e também é útil se você deseja editar o
arquivo manualmente e substitua os URIs `file: 'por outros URIs.

--nenhum-server-section
Do não adicione uma seção `[Servidores] 'no final do`.jigdo' Arquivo. Útil, por exemplo, se
você irá anexar a seção com um script.

--match-exec =SHELLCOMMAND
Sempre que um arquivo for encontrado na imagem, execute a string de comando fornecida por
passando para uma concha. arquivo jigdo configura uma série de variáveis ​​de ambiente com
informações sobre a correspondência de arquivo. Por exemplo, se o arquivo `/ caminho // a / b / arquivo' foi
encontrado na imagem e `Label: a / b / file 'será gravado no arquivo`.jigdo'
arquivo:

· LABEL= "Rótulo" - Nome do rótulo do arquivo. O exemplo assume que `--rótulo
Label = / path 'foi especificado por você. Na ausência de tal opção, LABEL precisarão
ser definido, mas vazio.

· LABELPATH= "/ path /" - O caminho correspondente ao rótulo, ou em outras palavras, o
prefixo do caminho do arquivo correspondente que irá não aparecem na saída `.jigdo'
Arquivo. Está definido mesmo sem qualquer `--rótulo'opção presente. Termina com uma barra.

· CAMINHO DE PARTIDA= "a / b /" - O resto do caminho, sem o nome da folha do correspondente
Arquivo. Está vazio ou termina com uma barra.

· FOLHA= "arquivo" - O nome da folha do arquivo correspondido.

· Md5sum= "lNVdUSqbo2yqm33webrhnw" - O md5sum do arquivo correspondente, no tipo Base64
formato.

· ARQUIVO= "/ caminho // a / b / arquivo" - Para sua conveniência, o caminho completo do arquivo. O
variável é sempre definida como $ LABELPATH $ MATCHPATH $ LEAF.

Tenha o cuidado de citar corretamente a string passada para esta opção, caso contrário, seu
O comando fornecido não funcionará com nomes de arquivos que contenham espaços. Por exemplo, para
crie um backup dos links físicos para os arquivos correspondentes, use a seguinte opção: --match-
exec = 'mkdir -p "$ {LABEL: -.} / $ MATCHPATH" && ln -f "$ FILE" "$ {LABEL: -.} / $ MATCHPATH $ LEAF"'

Por padrão, nenhum comando é executado. Use --match-exec = "" para remover uma string de comando que
foi definido com um uso anterior desta opção.

--correspondência gananciosa
Esta is que o padrão. Imagine que sua imagem contém um .alcatrão arquivo que por sua vez
contém outro arquivo x, e que você fornece tanto o .alcatrão e os arquivos dentro dele
na linha de comando. Quando arquivo jigdo escaneia a imagem, encontra o começo
da .alcatrão arquivo, e então o arquivo x.

Neste ponto, uma decisão deve ser tomada: O arquivo menor deve ser x ser registrado como
correspondido, ou deve ser ignorado em favor da correspondência maior (e, portanto, melhor) de
que o .alcatrão Arquivo? Infelizmente, neste ponto não está claro se haverá
na verdade, ser uma combinação completa do .alcatrão, então, por padrão, o programa prefere o pequeno
partida.

--no-greedy-correspondência
No caso em que uma grande correspondência parcial está presente e uma correspondência mais curta foi
confirmado, ignore o pequeno jogo. (Veja a opção acima.)

FAÇA IMAGEM, MI
Lê `.modelo'e ARQUIVOS, cria imagem (ou `nomedaimagem.tmp'). Fornece um rudimentar
maneira de remontar imagens - jigdo geralmente é mais adequado para essa tarefa. No entanto, em
contrasta com jigdo, não `.jigdo'é necessário.

Se a imagem for gravada em um arquivo (e não na saída padrão), é possível
criar a imagem em várias etapas, com várias invocações de `arquivo jigdo fazer imagem', Como
segue: Você primeiro invoca arquivo jigdo, especificando quantos arquivos estão disponíveis neste
Tempo. O programa verifica os arquivos, e aqueles que estão contidos na imagem são copiados para
um arquivo temporário, cujo nome é formado anexando `.tmp'ao nome do arquivo da imagem.

Para todos os outros arquivos que podem fazer parte da imagem, você repete este processo. Tão logo
como todas as partes estão presentes, o arquivo temporário será ligeiramente truncado (para excluir alguns
dados administrativos que arquivo jigdo acrescenta no final) e renomeado para a imagem final
nome. A possibilidade de remontar a imagem em várias etapas é especialmente útil para
coleta de arquivos de mídia removível, por exemplo, vários CDs mais antigos.

Scripts usando fazer imagem pode detectar se a criação da imagem está completa verificando o
status de saída: 0 indica criação bem-sucedida, enquanto 1 significa que mais arquivos precisam ser
fornecido. Outros erros resultam em um status de saída de 2 (`recuperável ', por exemplo, arquivo não encontrado)
ou 3 (não recuperável, por exemplo, erro de gravação).

--checar arquivos
Esta is que o padrão. Sempre que qualquer parte é copiada para a imagem, verifique novamente seu
checksum em relação ao checksum armazenado no modelo. É recomendado que você
deixe-o ligado, mesmo que retarde um pouco a criação da imagem.

--no-check-files
Não verifique as somas de verificação dos arquivos ao copiá-los para a imagem. Isso pode ser seguro
usado quando nenhum arquivo de cache é usado (o que significa que os arquivos serão gravados no
imagem imediatamente após ser digitalizada) ou toda a imagem é verificada posteriormente com o
verificar comando.

FALTA DE IMPRESSÃO, PM
Lê `.jigdo', `.modelo'e (se presente) `nomedaimagem.tmp', gera uma lista de URIs ainda
necessário para remontar completamente a imagem.

Juntamente com o fazer imagem comando, isso fornece a maior parte da funcionalidade de jigdo on
a linha de comando.

Para cada parte que ainda não está presente no arquivo de imagem temporário, a soma de verificação do arquivo é
consultado na seção `[Parts] 'do arquivo jigdo. Qualquer etiqueta na entrada correspondente
é então expandido de acordo com as definições de rótulo na seção `[Servidores] 'e impresso
na saída padrão. jigdo permite que você especifique vários locais alternativos para cada
rótulo nesta seção, mas impressão faltando irá apenas imprimir o primeiro para cada falta
parte.

Se a soma de verificação não puder ser encontrada na seção `[Partes] '(isso não deve acontecer a menos que
você excluiu essa seção), em vez disso, uma pesquisa é feita para `MD5Sum:', Assim como
com jigdo. (Assim, se você quiser se livrar da seção `[Partes] ', você pode fazer isso se você
renomeie cada parte com sua própria soma de verificação.)

--uri Label =http://some.server.org/
Substitua as entradas no `.jigdo'para qualquer etiqueta com um URI de sua escolha.
Com o exemplo acima, uma entrada `[Parts] 'de` Label: algum / nome do arquivo' fará com que o
linha `http://some.server.org/some/filename'para ser impresso.

O valor fornecido não é cotado pelo programa; se contiver caracteres como
espaço ou qualquer um dos caracteres # "'\ então você deve citá-lo. (No Unix, você pode
precisa citar o valor duas vezes para protegê-lo do shell, por exemplo, \\\\ ou '\\'
para obter uma única barra invertida no URI.)

IMPRIMIR-FALTANDO-TUDO, PMA
Assim como impressão faltando, este comando gera uma lista de URIs ainda necessários para completamente
remonte a imagem. Contudo, todos os locais de download alternativos são impressos em vez de
apenas um. Na saída, os URIs de um arquivo são separados dos URIs de outros arquivos com
linhas em branco. O --uri opção tem o mesmo efeito que para impressão faltando.

VERIFICAR, VER
Lê imagem (presumivelmente gerado com fazer imagem) e `.modelo', verifica se está correto
checksum da imagem.

Os dados do modelo não contêm apenas somas de verificação das partes individuais, mas também do
imagem como um todo. fazer imagem já realiza uma série de verificações internas, mas se você
como, você também pode verificar a imagem com este comando.

VARREDURA, SC
Lê todos os ARQUIVOS e os insere no cache, a menos que já estejam armazenados em cache. O
--cache opção deve estar presente para este comando.

--no-scan-arquivo inteiro
Esta is que o padrão. Isso só causa o primeiro - tamanho do bloco md5 bytes de cada arquivo
para ser lido. Se o cache for usado posteriormente por arquivo jigdo fazer imagem, o resto do
o arquivo será lido assim que esses primeiros bytes forem reconhecidos na imagem de entrada.

--scan-arquivo inteiro
Leia imediatamente todo o conteúdo do arquivo e armazene-o no cache.

MD5SUM, MD5
Lê todos os ARQUIVOS e imprime checksums MD5 de seu conteúdo. Este comando é bastante
semelhante ao md5sum(1), exceto que a soma de verificação é emitida na codificação do tipo Base64 que
também é usado em outro lugar por arquivo jigdo.

A ARQUIVOS os argumentos são processados ​​da mesma forma que os outros comandos, o que significa
essa recursão ocorre automaticamente para quaisquer argumentos que sejam diretórios, e que
links simbólicos não são listados, exceto quando os arquivos para os quais eles apontam não estão acessíveis
diretamente.

Na lista de checksum impressa na saída padrão, apenas a parte do nome do arquivo após
qualquer `// '(ou` \. \' no Windows) é impresso. Qualquer --cache será usado para consultar arquivos '
Soma de verificação MD5 e / ou gravação das somas de verificação de arquivos digitalizados.

LISTA-MODELO, LS
Lê um `.modelo'arquivo e fornece informações de baixo nível sobre a imagem e todas as partes
contido nele, incluindo deslocamento, comprimento e soma de verificação.

Você também pode usar este comando com arquivos de imagem temporários (especificando algo como
--template = imagename.tmp) - nesse caso, a saída também distingue entre as partes que
foram gravados na imagem e partes que não foram.

O formato de saída exato pode mudar de forma incompatível entre as diferentes versões do jigdo. O
os seguintes tipos diferentes de linhas podem ser produzidos. `have-file 'ocorre apenas para`.tmp'
arquivos, indicando um arquivo que já foi gravado com sucesso no arquivo temporário:

no modelo deslocamento na imagem comprimento
precisa de arquivo deslocamento na imagem comprimento arquivo-md5sum filestart-rsyncsum
ter arquivo deslocamento na imagem comprimento arquivo-md5sum filestart-rsyncsum
informação da imagem comprimento da imagem imagem-md5sum tamanho do rsyncsum

DETALHES

O download do Jigsaw foi criado com o formato de imagens de CD ISO9660 em mente - no entanto, o
a seguir também se aplica a muitos outros formatos de sistema de arquivos, bem como a arquivos `tar 'e
arquivos `zip 'descompactados. Uma imagem de CD contém ambas as informações para organizar o
sistema de arquivos (cabeçalho com nome do disco, etc., dados de diretório ISO9660, dados de extensões como
Joliet ou RockRidge, preenchimento zero) e os arquivos contidos no CD. Um importante
propriedade que jigdo depende é que cada arquivo é armazenado em uma seção contígua do
imagem; não está dividido em duas ou mais partes.

Quando arquivo jigdo recebe vários arquivos que podem estar contidos em uma imagem, ele detecta
se algum dos arquivos está presente usando um `rolling checksum 'inspirado no usado
by rsync(1). Os dados resultantes são gravados no `.modelo'arquivo: Se uma seção do
a imagem não pode ser correspondida (por exemplo, eram informações de diretório), os dados estão compactados e
escrito diretamente no modelo. No entanto, se um arquivo correspondente foi encontrado, seus dados são
omitido do modelo. Em vez disso, apenas uma referência (uma soma de verificação MD5 do arquivo) é
inserido no modelo.

Observe que os dados do modelo contêm apenas dados binários, não contém nenhum nome de arquivo
ou URIs, uma vez que não pode ser editado facilmente caso algum desses valores precise ser alterado.
Todas essas informações são armazenadas no `.jigdo', um arquivo de texto ao qual você pode adicionar URLs
para o (s) seu (s) servidor (es). O arquivo jigdo fornece um mapeamento para cada checksum MD5 para um ou mais
locais de download alternativos para a parte correspondente.

Além do mapeamento de somas MD5 para URIs, o arquivo jigdo também contém um URI que aponta
para um local de download para o arquivo de modelo. Assim, o jigdo ferramenta de download só precisa
para receber um URI (o do `.jigdo') para poder baixar e remontar o
imagem completa.

FORMATO OF .JIGDO ARQUIVOS

O formato geral de `.jigdo'arquivos segue o de `. Inicial', como também usado pelo
Projetos Gnome e KDE para alguns dados. O arquivo é organizado em seções, cada uma das quais
é precedido por uma linha onde se lê `[nome da seção] '. Dentro de cada seção, as linhas têm a forma
`Etiqueta = valor '. Essas linhas também são chamadas de `entradas 'abaixo. Tudo `.jigdo'arquivos usam UTF-8 como
sua codificação de caracteres.

Os comentários são introduzidos com o caractere `# 'e se estendem até o final da linha.
Os espaços em branco são ignorados no início e no final da linha, bem como à esquerda e à direita da seção
nomes e `= 'nas entradas. Além disso, os utilitários jigdo dividem o texto do
valor de entrada (ou seja, a parte após o `= ') em palavras separadas por espaços em branco, bem como o
Shell do Unix. Aspas simples '' e duplas "" podem ser usadas para evitar que, por exemplo, URIs
contendo espaços em branco são separados. Da mesma forma, caracteres com significado especial (o
caracteres '"# \ e espaço / tabulação) devem ser colocados entre aspas com \ para aparecer no valor.
shell, há uma diferença entre '' e "": dentro de '', os caracteres "# \ e
os espaços em branco perdem seu significado especial e se tornam caracteres comuns, enquanto dentro de "",
apenas os caracteres '# e espaço em branco perdem seu significado especial - em outras palavras,
escapes de barra invertida ainda funcionam dentro de "", mas não em ''.

`.jigdo'arquivos podem ser opcionalmente compactados com gzip(1). arquivo jigdo sempre produz
arquivos descompactados, que você mesmo pode compactar. jigdo-lite suporta único
arquivos descompactados e compactados.

(Comportamento que pode mudar no futuro e que não deve ser considerado: jigdo
além disso, suporta qualquer número de texto simples concatenado e partes compactadas nos arquivos
- por exemplo, você pode compactar um `.jigdo'e, em seguida, adicione algumas linhas de
dados descompactados até o fim.)

Em todos os casos, o `.gz'extensão deve ser removida do nome do arquivo - as ferramentas irão
determine automaticamente a partir do conteúdo do arquivo se um arquivo está compactado ou não.

Abaixo está uma descrição dos nomes de seção individuais usados ​​pelo jigdo.

JIGDO SECÇÃO
[Jigdo]
Versão = 1.1
Generator = arquivo-jigdo / 1.0.0

Informações sobre a versão do formato de arquivo jigdo usado e o programa que
gerou. Deve haver uma tal seção por `.jigdo' Arquivo.

IMAGEM SECÇÃO
[Imagem]
Nome do arquivo ="nome do arquivo para poupança on usuário disco"
Template ="URI onde para buscar modelo Arquivo"
Template-MD5Sum=OQ8riqT1BuyzsrT9964A7g
ShortInfo =única linha descrição of que o imagem (200 caracteres máx.)
Info =longo descrição (5000 caracteres máx.)

O valor da entrada `Template 'pode ser um URL (absoluto ou relativo ao URL
do arquivo jigdo) ou uma string no formato `O rótulo:pathname'(SEM IMPLEMENTAÇÃO), conforme descrito
abaixo.

A entrada `Template-MD5Sum 'é adicionada por arquivo jigdo e especifica a soma de verificação MD5 do
gerado `.modelo' Arquivo. É usado por jigdo para detectar casos em que o download
os dados do modelo estão corrompidos ou pertencem a uma imagem diferente.

Ao contrário de outros valores de entrada, os valores das entradas `ShortInfo 'e` Info' são não divisão
em palavras, em vez disso, todas as citações são preservadas.

O valor da entrada `Info 'é especial porque jigdo(1) pode, opcionalmente, analisar a marcação XML
contém. Se a marcação tiver erros, como tags não balanceadas / não suportadas, a string é
exibido literalmente, sem análise XML. As tags suportadas são (negrito),
(itálico), (fonte de máquina de escrever), (sublinhado), (fonte maior),
(fonte menor) e (quebra de linha). As entidades com suporte incluem <
(`<'),> (`>') e & (`& '). Observe que toda a entrada `Info 'deve estar em uma linha no
o arquivo jigdo.

Esta seção pode ocorrer várias vezes, mas todas, exceto a primeira, serão ignoradas. Isto
é útil, por exemplo, ao criar um `.jigdo'para uma imagem de DVD quando você já tiver
`.jigdo'arquivos para CDs com o mesmo conteúdo: Você pode simplesmente `[Incluir]' (veja abaixo) o
Arquivos jigdo dos CDs no final do arquivo jigdo do DVD, após sua seção `[Imagem] '.

PARTES SECÇÃO
[Partes]
xJNkjrq8NYMraeGavUpllw = LabelA: part0
GoTResP2EC6Lb_2wTsqOoQ = LabelA: part1
kyfebwu6clbYqqWUdFIyaw = LabelB: algum / caminho / parte2
-J9UAimo0Bqg9c0oOXI1mQ=http://some.where.com/part3

Todas as linhas na seção, que fornece o mapeamento de somas de verificação MD5 para URIs, têm o
mesmo formato: No lado esquerdo de `= 'a soma de verificação (codificado com um Base64-like
codificação) é fornecido, e à direita uma string correspondente à parte com este
checksum; um URI completo ou uma string no formato `O rótulo:pathname', qual é
expandido em um ou mais URIs, procurando a (s) definição (ões) para o O rótulo no
Seção `[Servidores] '.

No caso de uma soma de verificação MD5 particular não puder ser encontrada em qualquer seção `[Parts] 'por jigdo,
programa irá realizar uma busca por `MD5Sum:', por exemplo, para
`MD5Sum: xJNkjrq8NYMraeGavUpllw 'se você deletou a linha para` part0' acima.

Uma soma de verificação aparecendo várias vezes nesta seção indica download alternativo
localizações para a peça.

Pode haver qualquer número de seções `[Parts] 'no arquivo; todos são considerados quando
procurando somas de verificação MD5.

arquivo jigdo sempre coloca a seção `[Parts] 'no final do arquivo, e até mesmo
reorganiza qualquer arquivo especificado com --mesclar ter apenas uma seção no final. Isto
é feito para permitir jigdo para exibir as informações da seção `[Imagem] 'enquanto o
o resto desse arquivo ainda está sendo baixado.

SERVIDORES SECÇÃO
[Servidores]
LabelA =http://myserver.org/
LabelA =ftp://mirror.myserver.org/
LabelB = LabelC: subdiretório /
LabelC =http://some.where.com/jigdo/

Todas as linhas na seção, que fornece o mapeamento de rótulos de servidor para servidor
locais, têm o mesmo formato: No lado esquerdo de `= 'o nome do rótulo é fornecido, e
à direita, o valor para o qual expandir o nome do rótulo.

Um nome de rótulo que aparece várias vezes nesta seção indica download alternativo
localizações para as peças que usam o rótulo na seção `[Peças] '. Esta notação faz
é muito fácil adicionar mirrors ao arquivo jigdo.

Conforme mostrado pelo exemplo acima, os próprios valores de rótulo podem fazer referência a outros rótulos. Dentro
neste caso, a entrada `LabelB: some / path / part2 'na seção` [Parts]' será expandida para
`http://some.where.com/jigdo/subdirectory/some/path/part2'. Loops na etiqueta
definições resultam em comportamento indefinido e devem ser evitadas.

Pode haver qualquer número de seções `[Servidores] 'no arquivo; todos são considerados quando
procurando rótulos. Qualquer de `[Parts] 'ou` [Servers]', mas não ambos, pode ser omitido de
o arquivo jigdo.

COMO SECÇÃO
[Comente]
Qualquer texto, exceto que as linhas não devem começar com `['.

Todo o texto após uma linha `[Comentário] 'ou` [comentário]' é ignorado, até a próxima linha com
um rótulo de seção.

INCLUIR DIRETIVA
[Incluir http://some.url/file.jigdo]

As linhas desta forma fazem com que o conteúdo do arquivo jigdo especificado seja baixado e
analisado exatamente como o arquivo jigdo principal. O efeito será o mesmo que copiar o incluído
o conteúdo do arquivo no arquivo que contém a diretiva de inclusão. (Exceção: Qualquer
URLs relativos são sempre resolvidos usando o URL do `.jigdo'arquivo que contém aquele
URL relativo.)

O argumento do URL pode ser um URL absoluto ou relativo. URLs relativos são considerados
relativo à URL do arquivo jigdo que contém a diretiva de inclusão. Inclui pode
ser aninhado, mas é um erro criar um loop de diretivas de inclusão. Isto é não possível
para usar URLs da forma `O rótulo:pathname'.

O URL não pode ser citado com "". Quaisquer caracteres `] 'no argumento devem ser escapados como
`% 5D 'e quaisquer espaços como`% 20'.

As diretivas de inclusão são suportadas apenas por jigdo, eles são ignorados por jigdo-lite.

Uma diretiva de inclusão termina qualquer seção anterior, mas não inicia uma nova. Dentro
outras palavras, uma nova seção deve sempre ser iniciada após a linha de inclusão, jigdo não
permitir que entradas normais apareçam abaixo de `[Incluir] '.

CACHE ARQUIVOS

Qualquer arquivo especificado com o --cache opção é usada para armazenar informações sobre o ARQUIVOS
apresentada a arquivo jigdo. Ao consultar o cache, um arquivo é considerado inalterado (e o
os dados em cache são usados) apenas se o nome do arquivo, o tamanho do arquivo e a hora da última modificação (mtime) corresponderem
exatamente. Para a correspondência do nome do arquivo, não é usado todo o nome do arquivo, mas apenas a parte
seguindo qualquer `// ', de modo que qualquer mudança na parte antes de` //' não invalidará
o cache.

As entradas de cache antigas são removidas do cache se não tiverem sido lidas ou gravadas
pela quantidade de tempo especificada com --cache-expiração. As inscrições são não imediatamente removido
do cache se o arquivo ao qual eles se referem não existir mais - isso torna possível
informações de cache sobre arquivos em mídia removível.

A expiração do cache ocorre apenas depois de arquivo jigdo fez seu trabalho principal - se houver entradas antigas
são acessados ​​antes da expiração, eles serão mantidos. Por exemplo, se o programa é
executado usando o tempo de expiração padrão de 30 dias, mas acessa um arquivo de cache com entradas
gerado 2 meses atrás, então as entradas nesse cache precisarão ser considerado, e apenas aqueles
as entradas de cache que não foram necessárias durante a execução do programa expirarão.

Devido a uma peculiaridade da biblioteca de banco de dados subjacente (libdb3), os arquivos de cache nunca
encolher, eles só crescem. Se um grande número de entradas expirou de seu arquivo de cache e
você quer encolher, você pode simplesmente excluí-lo (é claro, então tudo terá
a ser regenerado) ou use os utilitários que acompanham libdb3 para despejar e restaurar o
banco de dados, com um comando como `db3_dump cache antigo.db | db3_load novo-cache.db'. Para Debian,
esses programas são fornecidos no pacote `libdb3-util '.

Se um diferente - tamanho do bloco md5 for especificado, todo o arquivo precisa ser relido para
atualize sua entrada de cache. Se um diferente --min-comprimento é especificado, apenas o primeiro
Os bytes `md5-block-size 'do arquivo precisam ser lidos novamente.

EXEMPLOS

PREPARANDO SUA CD IMAGEM PARA DISTRIBUIÇÃO
Você criou uma imagem de CD `imagem.iso'de alguns dos arquivos armazenados no diretório
`/ home / ftp'no seu disco rígido, que também está disponível online como `ftp://meusite.org'. Como
você não quer desperdiçar espaço hospedando efetivamente os mesmos dados duas vezes (uma vez como arquivos em
o servidor FTP, uma vez dentro da imagem), e você está farto de abortar os downloads dos usuários
após 200 MB e reiniciando o download dezenas de vezes, você decide usar o jigdo.
Como você prepara a imagem para download?

Na verdade, apenas um comando é necessário:

arquivo jigdo fazer-modelo --image = image.iso --jigdo = / home / ftp / image.jigdo
--template = / home / ftp / image.template / home / ftp // --rótulo Mysite = / home / ftp --uri
Mysite =ftp://meusite.org/

As pessoas agora podem apontar jigdo em `ftp://mysite.org/image.jigdo'para baixar sua imagem. O
o arquivo de modelo precisa estar acessível como `ftp://mysite.org/image.template'.

Observe que nada o impede de fazer o mesmo para um servidor FTP que não seja
administrado por você - nesse caso, você só precisa hospedar o arquivo `.jigdo'e'.modelo'
arquivos em seu próprio servidor / página inicial.

PREPARANDO AN ARBITRÁRIO GRANDE ARQUIVO PARA DISTRIBUIÇÃO
Assumimos que você tem um arquivo grande que não é um sistema de arquivos, por exemplo, `filme.mpeg'. Porque
de problemas de espaço, você deseja distribuir os dados em dois servidores.

Nesse caso, as partes da imagem precisam ser geradas artificialmente com o divisão
comando. Por exemplo, para criar blocos de 4 MB cada, use `divisão -b 4m filme.mpeg parte'.
Copie os arquivos resultantes `parte XX'em dois diretórios `1'e'2'que você cria,
de acordo com como você deseja que os arquivos sejam distribuídos entre os servidores. Em seguida, crie o
jigdo e arquivos de modelo com `arquivo jigdo fazer-modelo --image = movie.mpeg 1 // 2 //'. Vocês
precisará editar o `.jigdo'e fornecer os URIs corretos para os dois servidores que
você vai fazer o upload do arquivo `parte XX'arquivos para.

PERSONALIZADO VERSÕES OF IMAGENS
Porque é possível atribuir um URI diferente para cada parte de uma imagem, se necessário,
o jigdo é muito flexível. Apenas um exemplo é a possibilidade de versões personalizadas de
imagens: suponha que alguém esteja distribuindo uma imagem de CD e que você queira fazer algumas
pequenas mudanças nele e redistribua sua própria versão. Você faz o download do `oficial.iso' CD
imagem com jigdo (passando a URL de `oficial.jigdo'), grave-o no CD-R, faça o seu
mudanças (digamos, adicionando arquivos do `meus arquivos'em seu disco rígido) e produza seu
própria versão, `minhaversão.iso'. Em seguida, você instrui arquivo jigdo para criar o jigdo e
arquivos de modelo para sua imagem modificada, usando o comando

arquivo jigdo fazer-modelo --image = myversion.iso / mnt / cdrom / meus arquivos// --rótulo
My = myfiles / --uri Meu =http://my.homepage.net/ --merge = official.jigdo
enquanto `oficial.iso'é montado em `/ mnt / cdrom'. Usando --mesclar, você disse Jigdo-
lima para pegar o conteúdo de `oficial.jigdo', adicione a ele uma nova seção `[Imagem]' para
`minhaversão.iso'e escrever o arquivo jigdo resultante em `minhaversão.jigdo' - então agora
`minhaversão.jigdo'oferece duas imagens para download, a versão original e sua modificada
versão. (Se você não quiser que ele ofereça a versão oficial, edite-o e remova o
Seção `[Image] 'que lista`oficial.iso'.)

Agora você pode fazer o upload do `.jigdo'arquivo, o `.modelo'arquivo e também os arquivos em `meus arquivos'
para `http://my.homepage.net/'. Assim, para as pessoas baixarem sua imagem modificada, você faz
não precisa fazer o upload do conteúdo completo da imagem para o seu espaço web, mas apenas as alterações que você
feito!

(No caso de você ter feito apenas algumas mudanças, você também pode omitir o parâmetro `myfiles 'em
o comando acima, então todas as suas alterações acabarão no novo arquivo de modelo.)

COMBINANDO MUITOS GERENCIADO POR JIGDO IMAGENS EM ONE
Também não é problema combinar dados de várias fontes que usam o jigdo. Por exemplo, se
de cinco servidores diferentes e não relacionados, cada um distribui uma imagem de CD diferente via
jigdo, você pode criar uma imagem de DVD personalizada que contém os dados de todos esses CDs.
Quando as pessoas usam jigdo para baixar sua imagem, os arquivos individuais no DVD são buscados
das mesmas fontes dos CDs originais.

Consequentemente, mesmo que você vá distribuir um arquivo de 3.2 GB por meio de seu espaço na web, o
a quantidade real de dados armazenados em seu servidor será apenas da ordem de vários
MB.

Use jigdo-file online usando serviços onworks.net