jigdo-file - Online en la nube

PROGRAMA:

NOMBRE

jigdo-file: prepara archivos para descargar Jigsaw (distribución de archivos grandes, por ejemplo, CD
imágenes).

SINOPSIS

archivo jigdo COMANDO
[ --image =cdrom.iso ] [ --jigdo =cdrom.jigdo ] [ --template =cdrom.plantilla ] [ --fuerza ] [
MÁS CAMPUS ] [ ARCHIVOS ... | --files-from =f ]
Algunos COMANDOS: hacer-plantilla, hacer imagen, verificar

DESCRIPCIÓN

Descargar Jigsaw, o jigdo corto, es un esquema desarrollado principalmente para facilitar la
distribuir enormes imágenes del sistema de archivos (por ejemplo, CD (ISO9660) o imágenes de DVD (UDF))
Internet, pero también podría usarse para otros datos que son incómodos de manejar debido a su
tamaño, como archivos de audio / video o paquetes de software grandes.

jigdo intenta asegurarse de que el archivo grande (siempre llamado imagen a partir de ahora) se descarga
en pequeñas partes que se pueden almacenar en diferentes servidores. Personas que quieran descargar el
imagen hazlo diciendo a la jigdo(1) (NO IMPLEMENTADO AÚN) descargar herramienta para procesar uno
`.jigdo' Archivo; usándolo, jigdo descarga las piezas y vuelve a montar la imagen. archivo jigdo
se utiliza para preparar los archivos para su descarga.

Lo que hace especial a jigdo es que las partes que se utilizan para reconstruir la imagen pueden tener
cualquier tamaño y contenido, solo necesitan estar contenidos en una región contigua en cualquier lugar de
la imagen.

Por ejemplo, si desea distribuir una imagen ISO9660 que contiene una instantánea de una
Servidor FTP, puede instruir archivo jigdo para preparar los datos de descarga de tal manera que
cuando la gente usa jigdo para descargar la imagen, jigdo realmente recupera los archivos individuales
del servidor FTP y los ensambla en una copia exacta de su imagen, durante el
¡descargar! (Si la imagen no es un volcado del sistema de archivos, puede usar dividido(1) para crear el pequeño
partes de las que se volverá a ensamblar la imagen).

Tiene total libertad para elegir dónde se almacenan las partes individuales de la imagen:
pueden estar en directorios completamente diferentes en diferentes servidores (por ejemplo, debido a
restricciones de almacenamiento / ancho de banda), pero esto es invisible para las personas que descargan su
imagen. La información sobre los servidores disponibles solo necesita agregarse al archivo `.jigdo' archivo
por usted antes de distribuirlo.

La sección "DETALLES" a continuación contiene detalles técnicos sobre cómo funciona jigdo. Los 'EJEMPLOS'
La sección enumera una serie de escenarios comunes y puede ayudarlo a tener una idea de lo que jigdo
es útil para.

CAMPUS

Muchas opciones son específicas para un COMANDO; los siguientes son generales o utilizados por
varios comandos. A continuación se enumeran más opciones con los comandos individuales. Todo
las opciones se ignoran silenciosamente si no son aplicables al comando actual. Para cualquier
BYTES parámetros a las opciones, puede añadir una de las letras 'k', 'M' o 'G' al
cantidad que especifique, para indicar kilobytes, megabytes o gigabytes.

-h --ayuda
Salida breve resumen de comandos y opciones.

-H --ayudar a todo
Salida resumen completo de comandos y opciones.

-v --versión
Versión del programa de salida.

-i --image =cdrom.iso
Especifique la ubicación del archivo que contiene la imagen. La imagen es el archivo grande que
desea distribuir.

-j --jigdo =cdrom.jigdo
Especifique la ubicación del archivo de descripción de Descarga de Jigsaw. El archivo jigdo es un
archivo legible por humanos generado por archivo jigdo, a la que agrega información sobre todos
los servidores a los que va a cargar los archivos. jigdo descargará este archivo como
el primer paso para recuperar la imagen.

-t --template =cdrom.plantilla
Especifique la ubicación del archivo de 'plantilla' de imagen. El archivo de plantilla es un archivo binario
generado por archivo jigdo, contiene información sobre cómo volver a montar la imagen y
también (en forma comprimida) todos los datos de la imagen que no se encontraron en ninguno de
las partes

Dependiendo del comando, cada uno de estos tres archivos se usa a veces para ingresar,
a veces para la salida. Si el archivo se va a utilizar para la salida de un comando en particular
y el archivo de salida ya existe, archivo jigdo sale con un error, a menos que --fuerza
está presente.

En la mayoría de los casos, solo necesitará especificar uno de -i -j -t, porque cualquiera
Los nombres de archivo que falten se deducirán del que especifique. Esto se hace primero
eliminar cualquier extensión del nombre proporcionado y luego no agregar nada (si
deducir --imagen), `.jigdo'o'.plantilla'.

-r --report = default | noprogress | quiet | grep
Controle qué tan detallado es el programa y qué formato tiene la salida: sin progreso is
lo mismo que tu préstamo estudiantil excepto que no se imprimen mensajes de progreso "x% done". tranquilo
restringe la salida a lo que es absolutamente necesario, principalmente mensajes de error. grep
es solo diferente de tu préstamo estudiantil para hacer-plantilla comando: Habilita la salida en
un simple ' 'formato que es útil cuando se buscan archivos binarios
en otros archivos binarios.

-f --fuerza
Sobrescriba los archivos de salida existentes sin quejarse.

--no-fuerza
Este is las predeterminado. Rechace sobrescribir archivos de salida existentes.

-c --caché =jigdo-cache.db
archivo jigdo por lo general, necesita leer el contenido completo de todos los ARCHIVOS tu específicas.
Si lo usa repetidamente (por ejemplo, porque hace que una nueva imagen de CD esté disponible diariamente),
El almacenamiento en caché de la información del archivo aumentará significativamente la velocidad del programa. El
El archivo de caché se crea automáticamente si aún no está presente. Los datos suelen ser ambos
leer y escribir en él.

--sin caché
Este is las predeterminado. No utilice un caché.

--cache-expiry =SECONDS
Establezca la antigüedad máxima de las entradas de la caché. Cualquier entrada anterior a esta se eliminará de
el caché. El valor predeterminado es 30 días. Puede agregar una de las letras 'h', 'd', 'w',
'm', 'y' para denotar horas, días, semanas, meses o años, respectivamente. Un valor de
`0 'o` off' desactiva la caducidad, de modo que todas las entradas permanecerán en la caché para siempre.
Consulte la sección "ARCHIVOS CACHE" a continuación para obtener más información.

--readbuffer =BYTES
Establecer el tamaño de los búferes internos. El valor predeterminado es 128k; si tiene un disco rápido,
aumentar este valor puede hacer archivo jigdo más rápido, pero en general, cambiarlo es
no es necesario.

--md5-block-size =BYTES
Poco interesante interno parámetro. Establecer el tamaño de los bloques en los que se almacenan los archivos.
subdividido. El valor predeterminado es 128k. Si lo cambia, cualquier archivo de caché tendrá que ser
regenerado. Internamente, archivo jigdo puede optar por utilizar un poco más grande o más pequeño
.

-T --files-from =presentar
Leer nombres de archivos y directorios del archivo especificado. Si presentar es `- ', leer nombres
desde la entrada estándar. Cada línea del archivo se toma como un nombre, por lo que los nombres pueden
contienen espacios, pero no caracteres de nueva línea. Una línea vacía provoca archivo jigdo para detener
leyendo del archivo.

encontrar(1) es una herramienta poderosa para generar listas de archivos, pero asegúrese de usar `encontrar
Tipo f'si es posible; de ​​lo contrario, si instruye encontrar para generar tanto un nombre de archivo
y un enlace simbólico a ese nombre de archivo, archivo jigdo leerá el contenido del archivo dos veces.

--maleficio Sumas de comprobación de salida en formato hexadecimal en lugar de en formato similar a Base64. Esto no debería ser
usado con el hacer-plantilla comando, porque el resultado `.jigdo'archivo viola
el '.jigdo' formato de archivo. Su uso previsto es hacer archivo jigdo más interoperable
con otras utilidades de shell de Unix como md5sum(1).

--no-hexadecimal
Este is las predeterminado. Utilice la codificación de sumas de comprobación similar a Base64 de jigdo.

--debug [= ayuda | = todo | =UNIDAD, ~ UNIDAD ... ]
Active o desactive la salida de depuración. Solo `--debug 'es equivalente a` --debug = all'.
El argumento es una lista separada por comas de nombres de unidades para los que se realiza la depuración.
para ser habilitado, o deshabilitado si el nombre está precedido por '~'. El nombre especial 'todos'
significa todas las unidades. De forma predeterminada, la salida de depuración está desactivada excepto para las unidades
'aseverar' y 'general'. La lista exacta de unidades disponibles para las que se puede depurar
ser activado depende de si jigdo se compiló con soporte de depuración - el
La lista se puede imprimir con `--debug = help '.

ARCHIVOS Nombres de archivos o directorios para usar como entrada. Estas son las partes que son
contenido en la imagen. En caso de que uno de los nombres sea un directorio, el programa
escanea de forma recursiva el directorio y agrega todos los archivos que contiene. Mientras se hace
esto, sigue enlaces simbólicos, pero evita bucles de enlace simbólico.

Si uno de los nombres de archivo comienza con el carácter '-', debe preceder la lista de
archivos con `- '. Un valor de '-' tiene no significado especial en esta lista, significa
un archivo cuyo nombre es un solo guion.

COMANDOS

El nombre del comando es el primer argumento que no es una opción que se pasa a archivo jigdo. La mayoría de los comandos tienen
abreviaturas cortas y nombres largos. El Corto comando nombres tienes no be usado in
guiones - existe podrían be incompatible cambios a ellos in las ¡futuro!

HACER PLANTILLA, MT
Lee imagen y ARCHIVOS, crea '.jigdo'y'.plantilla'. Esta es la principal funcionalidad de
archivo jigdo.

Es posible especificar ambos --image = - y --files-from = -. En este caso, primero la lista
de archivos se lee desde la entrada estándar hasta que se encuentra una línea vacía. Todo
siguiente se supone que son los datos de la imagen. Esto puede ser útil si usa mkisofs(1) o
programas similares que pueden generar la imagen completa en su salida estándar, porque
no es necesario almacenar la imagen en el disco temporalmente.

Si un ARCHIVOS argumento contiene los caracteres `// '(Unix) o` \. \' (Windows), esto tiene
significado especial. En el archivo jigdo final que los usuarios descargarán, cada una de las partes es
referenciado en la sección `[Partes] 'con un URI de la forma` Etiqueta: algunos / nombre de archivo'. (Ver
"FORMATO DE ARCHIVOS .JIGDO" a continuación para obtener una descripción detallada.) La sección "[Servidores]" proporciona
un mapeo de etiquetas a servidores en Internet, con líneas como
`Etiqueta =http://myserver.org/jigdofiles/'. Usando esta información, jigdo creará el
URI de descarga final para la pieza, `http://myserver.org/jigdofiles/some/filename'.
Especificar `// '(o` \. \') En un nombre de archivo o directorio sirve para `cortar 'los nombres en
el nivel de directorio correcto. Por ejemplo, si la ruta Unix de uno de sus ARCHIVOS is
`/ ruta / algún / nombre de archivo ', puedes decir archivo jigdo para cortar después del `/ path 'pasándolo
el argumento `/ ruta // algún / nombre de archivo ', o` / ruta //' si desea que se escanee todo el directorio.
Los nombres de las rutas no necesitan ser absolutos; `somedirectory // 'también es posible.

--etiqueta Etiqueta = / ruta
Especifique un nombre para usar como nombre de etiqueta para una ruta en el disco. (Influye en la salida
jigdo.) Si usó `// 'en el ARCHIVOS argumentos como se describe anteriormente, archivo jigdo
elegirá automáticamente los nombres de las etiquetas de forma predeterminada ("A", "B", etc.). Con esta opción,
puede dar a las etiquetas nombres más significativos. Tenga en cuenta que el nombre de la etiqueta solo será
utilizado si uno o más ARCHIVOS comience con `/ ruta // '.

Intente usar nombres de etiquetas que comiencen con caracteres en mayúscula para eliminar la ambigüedad
claramente a partir de nombres de protocolo como 'http', 'ftp'.

--uri Etiqueta =http://some.server.org/
Por defecto, usando --etiqueta como se describió anteriormente causará líneas de la forma
`Label = file: / path / 'se escribirá en la sección` [Servers]' del jigdo de salida
Archivo. Si desea anular el URI `file: 'para que la línea diga
`Etiqueta =http://some.server.org/', puede hacerlo especificando --uri para cada año fiscal junto con la
--etiqueta. Dando solo --uri Etiqueta = ... sin el correspondiente --etiqueta Etiqueta = ...
no tiene ningún efecto, e incluso si especifica ambos, una entrada solo se agrega al
Sección '[Servidores]' si la etiqueta es referenciada por al menos una entrada '[Partes]'.

El valor proporcionado no es cotizado por el programa; si contiene caracteres como
espacio o cualquiera de los caracteres # "'\ entonces debe citarlo. (En Unix, puede
es necesario citar el valor dos veces para protegerlo también del shell, por ejemplo, \\\\ o '\\'
para obtener una sola barra invertida en el URI).

El mapeo especificado con un --uri La opción se ignora si ya está presente en
el archivo jigdo de salida.

Los usuarios de la versión de Windows pueden notar que los separadores de directorio `\ 'son
convertido a `/ 'en el` archivo:' URI que se generan de forma predeterminada. Esto esta hecho
para aumentar la compatibilidad multiplataforma de `file: '- el falta de impresión comando de
la versión de Windows volverá a convertir automáticamente los caracteres cuando imprima el
URI. En caso de que proporcione su propio 'archivo:' URI en Windows usando --uri, debes
también intercambie `/ 'y` \'.

-0 a -9
Establezca la cantidad de compresión en el archivo de plantilla de salida, desde -0 (sin compresión) a
-9 (máxima compresión). El valor predeterminado es -9, que puede hacer que la generación de la plantilla
bastante lento. Por defecto, el algoritmo de compresión utilizado es el mismo que para gzip(1).

--gzip y --bzip2
Elija entre los algoritmos de compresión gzip y bzip2. El predeterminado es gzip.
Bzip2 generalmente ofrece una mejor relación de compresión, pero la compresión es significativamente
más lento que con gzip.

--min-length =BYTES
Establecer la longitud mínima de una pieza para archivo jigdo buscarlo en la imagen. El
el valor predeterminado es 1k. Partes más pequeñas que esto nunca se encontrarán en la imagen, por lo que su
Los datos se incluirán en el archivo de plantilla. El algoritmo de búsqueda utilizado requiere tal
una longitud mínima, de lo contrario la generación de plantillas podría volverse extremadamente lenta. Si tu
sé seguro que todos tus ARCHIVOS son más grandes que una cierta cantidad, puede
incrementar archivo jigdovelocidad ligeramente especificando la cantidad con esta opción.
Hay un mínimo absoluto cableado de 256 bytes; cualquier valor inferior se activará silenciosamente
establecerse en 256.

--merge =ARCHIVO
Incluir el contenido de ARCHIVO en la salida '.jigdo' Archivo. El archivo puede contener datos
que desea agregar a la salida (por ejemplo, una sección "[Servidores]" con una lista
de sus servidores como entradas), o puede ser la salida del archivo jigdo por una ejecución anterior
of archivo jigdo.

Es posible especificar el mismo archivo para la entrada con --unir y para salida con
--jigdo. Sin embargo, también necesitará utilizar --fuerza para hacer que el programa se sobrescriba
la versión anterior del archivo jigdo con la nueva. ARCHIVO puede ser '-' para estándar
entrada.

Cuándo la adición de nueva información en el archivo suministrado, archivo jigdo no insertará nuevo
líneas en la sección '[Partes]' si una entrada para la misma suma de comprobación MD5 (pero no
¡necesariamente con el mismo URI!) ya existe, y no insertará nuevas líneas
en la sección '[Servidores]' si ya existe una entrada completamente idéntica.

Cuándo lectura in la existencia ARCHIVO, el comportamiento es ligeramente diferente: el programa
conservas entradas en la sección "[Partes]" con suma de comprobación idéntica, pero diferente
URI. Para entradas completamente idénticas (la misma suma de comprobación y URI), solo una entrada es
se conservan y los duplicados se eliminan. La sección "[Servidores]" está a la izquierda
intacto.

--sección de imágenes
Este is las predeterminado. Causas archivo jigdo para agregar una sección "[Imagen]" a la sección ".jigdo'
archivo.

Como excepción, se incluye una nueva sección "[Imagen]" no agregado si usa --unir y del
archivo para fusionar contiene una sección `[Imagen] 'con una línea que dice` Plantilla-
MD5Sum = '(final de la línea después del' = '). En este caso, los datos de la plantilla generados
El valor de suma de comprobación MD5 se acaba de agregar después del `= 'de la primera línea de este formulario en
el archivo - no se anexa una sección completamente nueva '[Imagen]'. Este comportamiento es útil
porque te permite pasar por --unir una sección "[Imagen]" con arbitrario
contenido y luego hacer que la suma de comprobación MD5 agregue automáticamente archivo jigdo.
La sección `FORMATO DE ARCHIVOS .JIGDO 'a continuación explica el contenido de la sección` [Imagen]' en
mayor detalle.

--no-sección-de-imagen
Do no incluir una sección "[Imagen]" en el ".jigdo' Archivo. Necesitas agregar uno
usted mismo si usa esta opción. Sin embargo, hacer eso no es fácil (también necesita
agregue una línea 'Template-MD5Sum' con la suma de verificación correcta, o jigdo se quejará), así que
Se desaconseja el uso de esta opción.

--sección de servidores
Este is las predeterminado. Causas archivo jigdo para agregar una sección "[Servidores]" a la sección ".jigdo'
Archivo. Esta sección predeterminada usa URIs `file: ', que permite el reensamblaje inmediato
de la imagen del sistema de archivos local, y también es útil si desea editar el
archivo manualmente y reemplace los URI `file: 'con otros URI.

--sección-sin-servidores
Do no agregue una sección "[Servidores]" al final de la sección ".jigdo' Archivo. Útil, por ejemplo, si
va a agregar la sección con un guión.

--match-exec =COMANDO SHELL
Siempre que se encuentre un archivo en la imagen, ejecute la cadena de comando proporcionada por
pasándolo a un caparazón. archivo jigdo configura una serie de variables de entorno con
información sobre la coincidencia del archivo. Por ejemplo, si el archivo `/ ruta // a / b / archivo' estaba
que se encuentra en la imagen y `Label: a / b / file 'se escribirá en el archivo`.jigdo'
archivo:

· LABEL= "Etiqueta": nombre de la etiqueta del archivo. El ejemplo asume que `--etiqueta
La etiqueta = / ruta 'fue especificada por usted. En ausencia de tal opción, LABEL seguirá
estar configurado pero vacío.

· RUTA DE ETIQUETA= "/ ruta /": la ruta correspondiente a la etiqueta o, en otras palabras, la
prefijo de la ruta del archivo coincidente que no aparecen en la salida `.jigdo'
Archivo. Se establece incluso sin ningún `--etiqueta'opción presente. Termina con una barra.

· RUTA DE PARTIDO= "a / b /": el resto de la ruta, sin el nombre de la hoja de la coincidencia
Archivo. Está vacío o termina con una barra.

· HOJA= "archivo": el nombre de la hoja del archivo coincidente.

· MD5SUM= "lNVdUSqbo2yqm33webrhnw": md5sum del archivo coincidente, en formato Base64
formato.

· ARCHIVO= "/ ruta // a / b / archivo" - Para mayor comodidad, la ruta completa del archivo. El
La variable siempre se establece en $ LABELPATH $ MATCHPATH $ LEAF.

Tenga cuidado de citar correctamente la cadena pasada a esta opción; de lo contrario, su
El comando proporcionado no funcionará con nombres de archivo que contengan espacios. Como ejemplo, para
cree una copia de seguridad de los enlaces físicos a los archivos coincidentes, use la siguiente opción: --match-
exec = 'mkdir -p "$ {LABEL: -.} / $ MATCHPATH" && ln -f "$ FILE" "$ {LABEL: -.} / $ MATCHPATH $ LEAF"'

De forma predeterminada, no se ejecuta ningún comando. Utilice --match-exec = "" para eliminar una cadena de comando que
se configuró con un uso anterior de esta opción.

- emparejamiento codicioso
Este is las predeterminado. Imagina que tu imagen contiene un .alquitrán archivo que a su vez
contiene otro archivo x, y que proporcione tanto .alquitrán y los archivos dentro de él
en la línea de comando. Cuándo archivo jigdo escanea la imagen, encuentra el principio
de las .alquitrán archivo, y luego el archivo x.

En este punto, se debe tomar una decisión: si el archivo más pequeño x ser registrado como
coincidente, o debería ignorarse a favor de la coincidencia más grande (y por lo tanto mejor) de
las .alquitrán ¿Archivo? Desafortunadamente, en este punto no está claro si habrá
en realidad ser un partido completo de la .alquitrán, por lo que, por defecto, el programa prefiere los pequeños
partido.

--no-codicioso-emparejamiento
En el caso de que haya una coincidencia parcial grande y se haya realizado una coincidencia más corta
confirmado, ignora el pequeño fósforo. (Vea la opción anterior).

HACER IMAGEN, MI
Lee '.plantilla'y ARCHIVOS, crea imagen (o `nombreimagen.tmp'). Proporciona un rudimentario
forma de reensamblar imágenes - jigdo suele ser más adecuado para esta tarea. Sin embargo, en
contraste con jigdo, no '.jigdo'archivo es obligatorio.

Si la imagen se va a escribir en un archivo (y no en una salida estándar), es posible
crear la imagen en varios pasos, con varias invocaciones de 'archivo jigdo hacer imagen', como
siguiente: Primero invocas archivo jigdo, especificando tantos archivos como estén disponibles en este
hora. El programa escanea los archivos y los que están contenidos en la imagen se copian en
un archivo temporal, cuyo nombre se forma agregando '.tmp'al nombre del archivo de imagen.

Para todos los archivos adicionales que podrían ser parte de la imagen, repita este proceso. Tan pronto
como todas las partes están presentes, el archivo temporal se truncará ligeramente (para eliminar algunas
datos administrativos que archivo jigdo se agrega al final) y se le cambia el nombre a la imagen final
nombre. La posibilidad de reensamblar la imagen en varios pasos es especialmente útil para
recopilar archivos de medios extraíbles, por ejemplo, varios CD más antiguos.

Scripts usando hacer imagen puede detectar si la creación de la imagen está completa marcando el
Estado de salida: 0 indica una creación exitosa, mientras que 1 significa que se necesitan más archivos
suministrado. Otros errores dan como resultado un estado de salida de 2 ('recuperable', por ejemplo, archivo no encontrado)
o 3 (no recuperable, por ejemplo, error de escritura).

--verificar archivos
Este is las predeterminado. Siempre que se copie cualquier parte a la imagen, vuelva a comprobar su
suma de comprobación contra la suma de comprobación almacenada en la plantilla. Se recomienda que
déjelo encendido, incluso si ralentiza un poco la creación de imágenes.

--no-verificar-archivos
No compruebe las sumas de comprobación de los archivos al copiarlos en la imagen. Esto puede ser seguro
se utiliza cuando no se utiliza ningún archivo de caché (lo que significa que los archivos se escribirán en el
imagen inmediatamente después de ser escaneada) o la imagen completa se verifica más tarde con el
verificar mando.

FALTA IMPRESIÓN, PM
Lee '.jigdo', `.plantilla'y (si está presente)'nombreimagen.tmp', genera una lista de URI todavía
necesario para volver a montar completamente la imagen.

Junto con el hacer imagen comando, esto proporciona la mayor parte de la funcionalidad de jigdo on
la línea de comando.

Para cada parte que aún no está presente en el archivo de imagen temporal, la suma de verificación del archivo es
buscó en la sección '[Partes]' del archivo jigdo. Cualquier etiqueta en la entrada correspondiente
luego se expande de acuerdo con las definiciones de etiqueta en la sección "[Servidores]" y se imprime
en salida estándar. jigdo le permite especificar varias ubicaciones alternativas para cada
etiqueta en esta sección, pero falta de impresión solo generará el primero por cada falta
parte.

Si la suma de comprobación no se puede encontrar en la sección "[Partes]" (esto no debería suceder a menos que
eliminó esa sección), se realiza una búsqueda para `MD5Sum:', al igual que
jigdo. (Por lo tanto, si desea deshacerse de la sección '[Partes]', puede hacerlo si
cambie el nombre de cada parte a su propia suma de comprobación).

--uri Etiqueta =http://some.server.org/
Anule las entradas en el `.jigdo'para cualquier etiqueta con un URI de su elección.
Con el ejemplo anterior, una entrada '[Partes]' de 'Etiqueta: algún / nombre de archivo' hará que
línea 'http://some.server.org/some/filename'para ser impreso.

El valor proporcionado no es cotizado por el programa; si contiene caracteres como
espacio o cualquiera de los caracteres # "'\ entonces debe citarlo. (En Unix, puede
es necesario citar el valor dos veces para protegerlo también del shell, por ejemplo, \\\\ o '\\'
para obtener una sola barra invertida en el URI).

IMPRESIÓN-FALTA-TODO, PMA
Al igual que falta de impresión, este comando genera una lista de URI que aún se necesitan para completar
vuelva a montar la imagen. Sin embargo, todos Se imprimen ubicaciones de descarga alternativas en lugar de
solo uno. En la salida, los URI de un archivo están separados de los URI de otros archivos con
líneas en blanco. El --uri La opción tiene el mismo efecto que para falta de impresión.

VERIFICAR, VER
Lee imagen (presumiblemente generado con hacer imagen) y '.plantilla', comprueba la correcta
suma de comprobación de la imagen.

Los datos de la plantilla no solo contienen sumas de comprobación de las partes individuales, sino también de las
imagen en su conjunto. hacer imagen ya realiza una serie de comprobaciones internas, pero si
como, también puede verificar la imagen con este comando.

ESCANEAR, SC
Lee todo el ARCHIVOS y los ingresa en la caché, a menos que ya estén almacenados en caché. El
--cache La opción debe estar presente para este comando.

--no-escanear-archivo-completo
Este is las predeterminado. Esto solo causa la primera --md5-tamaño de bloque bytes de cada archivo
ser leído. Si la caché se usa más tarde por archivo jigdo hacer imagen, el resto de
El archivo se leerá una vez que se reconozcan estos primeros bytes en la imagen de entrada.

--escanear-archivo-completo
Lea inmediatamente todo el contenido del archivo y guárdelo en la caché.

MD5SUMA, MD5
Lee todo el ARCHIVOS e imprime sumas de comprobación MD5 de su contenido. Este comando es bastante
similar a md5sum(1), excepto que la suma de comprobación se emite en la codificación similar a Base64 que
también se usa en otros lugares por archivo jigdo.

El ARCHIVOS Los argumentos se procesan de la misma manera que con los otros comandos, lo que significa
que la recursividad tiene lugar automáticamente para cualquier argumento que sea un directorio, y que
Los enlaces simbólicos no se enumeran excepto cuando los archivos a los que apuntan no son accesibles
.

En la lista de suma de comprobación impresa en la salida estándar, solo la parte del nombre de archivo que sigue
se imprime cualquier `// '(o` \. \' en Windows). Ningún --cache se utilizará para consultar archivos '
Sumas de comprobación MD5 y / o escribir las sumas de comprobación de los archivos escaneados.

LISTA-PLANTILLA, LS
Lee un '.plantilla'archivo y genera información de bajo nivel sobre la imagen y todas las partes
contenido en él, incluido el desplazamiento, la longitud y la suma de comprobación.

También puede usar este comando con archivos de imagen temporales (especificando algo como
--template = imagename.tmp) - en ese caso, la salida también distingue entre partes que
se han escrito en la imagen y en partes que no.

El formato de salida exacto puede cambiar de manera incompatible entre diferentes versiones de jigdo. El
Se pueden generar los siguientes tipos de líneas. `have-file 'solo ocurre para`.tmp'
archivos, indicando un archivo que ya se ha escrito correctamente en el archivo temporal:

en plantilla desplazamiento en imagen de largo
archivo de necesidad desplazamiento en imagen de largo archivo-md5sum archivostart-rsyncsum
tener archivo desplazamiento en imagen de largo archivo-md5sum archivostart-rsyncsum
imagen-info longitud de la imagen imagen-md5sum rsyncsum-tamaño

DETALLES

Jigsaw Download se creó con el formato de imágenes de CD ISO9660 en mente; sin embargo, el
lo siguiente también se aplica a muchos otros formatos del sistema de archivos, así como a los archivos `tar 'y
archivos zip sin comprimir. Una imagen de CD contiene información para organizar el
sistema de archivos (encabezado con nombre de disco, etc., datos de directorio ISO9660, datos de extensiones como
Joliet o RockRidge, zero padding) y los archivos contenidos en el CD. Un importante
La propiedad en la que se basa jigdo es que cada archivo se almacena en una sección contigua del
imagen; no se divide en dos o más partes.

Cuándo archivo jigdo recibe una cantidad de archivos que pueden estar contenidos en una imagen, detecta
si alguno de los archivos está presente utilizando una "suma de comprobación continua" inspirada en la utilizada
by rsync(1). Los datos resultantes se escriben en el archivo `.plantilla'archivo: Si una sección del
la imagen no pudo coincidir (por ejemplo, era información de directorio), los datos están comprimidos y
escrito directamente en la plantilla. Sin embargo, si se encuentra un archivo coincidente, sus datos se
omitido de la plantilla. En su lugar, solo se incluye una referencia (una suma de comprobación MD5 del archivo).
insertado en la plantilla.

Tenga en cuenta que los datos de la plantilla solo contienen datos binarios, no contienen ningún nombre de archivo
o URI, ya que no se puede editar fácilmente en caso de que sea necesario cambiar alguno de estos valores.
Toda esa información se almacena en el archivo `.jigdo'archivo, un archivo de texto al que puede agregar URL
para su (s) servidor (es). El archivo jigdo proporciona una asignación para cada suma de comprobación MD5 a uno o más
ubicaciones de descarga alternativas para la pieza correspondiente.

Además de la asignación de sumas MD5 a URI, el archivo jigdo también contiene un URI que apunta
a una ubicación de descarga para el archivo de plantilla. De esta manera, el jigdo la herramienta de descarga solo necesita
para recibir un URI (el del `.jigdo') para poder descargar y volver a montar el
imagen completa.

FORMATO OF .JIGDO ARCHIVOS

El formato general de '.jigdo'archivos sigue al de'. Inicial'archivos, como también lo utiliza el
Proyectos de Gnome y KDE para algunos datos. El archivo está organizado en secciones, cada una de las cuales
está precedido por una línea que dice '[nombre de la sección]'. Dentro de cada sección, las líneas tienen la forma
'Etiqueta = Valor'. Estas líneas también se denominan "entradas" a continuación. Todo.jigdo'archivos usan UTF-8 como
su codificación de caracteres.

Los comentarios se introducen con el carácter '#' y se extienden hasta el final de la línea.
Los espacios en blanco se ignoran al principio y al final de la línea, así como a la izquierda y a la derecha de la sección.
nombres y el '=' en las entradas. Además, las utilidades jigdo dividen el texto del
valor de entrada (es decir, la parte después del `= ') en palabras separadas por espacios en blanco, al igual que el
Shell de Unix. Se pueden usar comillas simples "" y dobles para evitar que, por ejemplo, URI
que contienen espacios en blanco se dividen. Del mismo modo, los caracteres con un significado especial (el
caracteres '"# \ y espacio / tabulador) deben estar entrecomillados con \ para aparecer en el valor. Al igual que con el
shell, hay una diferencia entre '' y "": Dentro de '', los caracteres "# \ y
los espacios en blanco pierden su significado especial y se convierten en caracteres ordinarios, mientras que dentro de "",
solo los caracteres # y los espacios en blanco pierden su significado especial; en otras palabras,
Los escapes de barra invertida aún funcionan dentro de "", pero no en ''.

`.jigdo'los archivos se pueden comprimir opcionalmente con gzip(1). archivo jigdo siempre salidas
archivos sin comprimir, que puede comprimir usted mismo. jigdo-lite admite soltero
archivos comprimidos y sin comprimir.

(Comportamiento que puede cambiar en el futuro y en el que no se debe confiar: jigdo
Además, admite cualquier número de texto sin formato concatenado y partes comprimidas con gzip en los archivos.
- por ejemplo, puede comprimir un `.jigdo'y luego agregue un par de líneas de
datos sin comprimir hasta el final.)

En todos los casos, el '.gz'debe eliminarse del nombre del archivo; las herramientas
determinar automáticamente a partir del contenido del archivo si un archivo está comprimido o no.

A continuación se muestra una descripción de los nombres de las secciones individuales que utiliza jigdo.

JIGDO SECCIÓN
[Jigdo]
Versión = 1.1
Generador = jigdo-file / 1.0.0

Información sobre la versión del formato de archivo jigdo utilizado y el programa que
lo generó. Debería haber una de esas secciones por '.jigdo' expediente.

IMAGEN SECCIÓN
[Imagen]
Nombre de archivo ="nombre del archivo para ahorro on usuario Dto"
Plantilla ="URI donde a ha podido recuperar plantilla expediente"
Template-MD5Sum=OQ8riqT1BuyzsrT9964A7g
ShortInfo =linea sola descripción of las imagen (200 personajes máx.)
Info =Corto descripción (5000 personajes máx.)

El valor de la entrada "Plantilla" puede ser una URL (absoluta o relativa a la URL
del archivo jigdo) o una cadena de la forma `Label:ruta'(SIN IMPLEMENTAR), tal como se describe
abajo.

La entrada 'Template-MD5Sum' es agregada por archivo jigdo y especifica la suma de comprobación MD5 del
generado '.plantilla' Archivo. Es utilizado por jigdo para detectar casos donde el descargado
los datos de la plantilla están dañados o pertenecen a una imagen diferente.

A diferencia de otros valores de entrada, los valores de las entradas 'ShortInfo' e 'Info' son no dividido
en palabras, en cambio, se conservan todas las citas.

El valor de la entrada 'Info' es especial porque jigdo(1) opcionalmente puede analizar el marcado XML
contiene. Si el marcado tiene errores como etiquetas no balanceadas / no admitidas, la cadena es
se muestra literalmente, sin análisis XML. Las etiquetas admitidas son (audaz),
(itálico), (fuente de máquina de escribir), (subrayar), (fuente más grande),
(fuente más pequeña) y (salto de línea). Las entidades admitidas incluyen <
(`<'),> (`>') y & (`& '). Tenga en cuenta que toda la entrada de "Información" debe estar en una línea en
el archivo jigdo.

Esta sección puede ocurrir varias veces, pero todas excepto la primera serán ignoradas. Esta
es útil, por ejemplo, al crear un `.jigdo'para una imagen de DVD cuando ya tiene
`.jigdo'archivos para CD con el mismo contenido: simplemente puede' [Incluir] '(ver más abajo) el
Archivos jigdo de CD al final del archivo jigdo de DVD, después de su sección `[Imagen] '.

PARTES SECCIÓN
[Partes]
xJNkjrq8NYMraeGavUpllw = LabelA: part0
GoTResP2EC6Lb_2wTsqOoQ = LabelA: part1
kyfebwu6clbYqqWUdFIyaw = LabelB: alguna / ruta / part2
-J9UAimo0Bqg9c0oOXI1mQ=http://some.where.com/part3

Todas las líneas de la sección, que proporciona la asignación de sumas de comprobación MD5 a URI, tienen la
mismo formato: en el lado izquierdo de '=' la suma de comprobación (codificada con un
codificación), y a la derecha una cadena correspondiente a la parte con este
suma de control; ya sea un URI completo o una cadena de la forma `Label:ruta', cual es
expandido en uno o más URI al buscar la (s) definición (es) para el Label existentes
Sección '[Servidores]'.

En caso de que no se pueda encontrar una suma de comprobación MD5 en ninguna sección de '[Partes]' por jigdo, la
El programa realizará una búsqueda de `MD5Sum:', por ejemplo, para
`MD5Sum: xJNkjrq8NYMraeGavUpllw 'si eliminó la línea para` part0' anterior.

Una suma de comprobación que aparece varias veces en esta sección indica una descarga alternativa
ubicaciones de la pieza.

Puede haber cualquier número de secciones '[Partes]' en el archivo; todos son considerados cuando
buscando sumas de comprobación MD5.

archivo jigdo siempre pone la sección "[Partes]" al final del archivo, e incluso
reorganiza cualquier archivo especificado con --unir tener solo una de esas secciones al final. Esta
está hecho para permitir jigdo para mostrar la información de la sección `[Imagen] 'mientras
el resto de ese archivo aún se está descargando.

SERVIDORES SECCIÓN
[Servidores]
LabelA =http://myserver.org/
LabelA =ftp://mirror.myserver.org/
LabelB = LabelC: subdirectorio /
LabelC =http://some.where.com/jigdo/

Todas las líneas de la sección, que proporciona el mapeo de las etiquetas del servidor al servidor
ubicaciones, tienen el mismo formato: en el lado izquierdo de '=' se da el nombre de la etiqueta, y
a la derecha, el valor para expandir el nombre de la etiqueta.

Un nombre de etiqueta que aparece varias veces en esta sección indica una descarga alternativa
ubicaciones de las piezas que utilizan la etiqueta en la sección "[Piezas]". Esta notación hace
es muy fácil agregar espejos al archivo jigdo.

Como se muestra en el ejemplo anterior, los valores de las etiquetas pueden hacer referencia a otras etiquetas. En
En este caso, la entrada `LabelB: some / path / part2 'en la sección` [Parts]' se expandirá a
`http://some.where.com/jigdo/subdirectory/some/path/part2'. Bucles en la etiqueta
las definiciones dan como resultado un comportamiento indefinido y deben evitarse.

Puede haber cualquier número de secciones '[Servidores]' en el archivo; todos son considerados cuando
buscando etiquetas. Cualquiera de '[Partes]' o '[Servidores]', pero no ambos, se pueden omitir de
el archivo jigdo.

COMENTARIO SECCIÓN
[Comentario]
Cualquier texto, excepto que las líneas no deben comenzar con '['.

Todo el texto que sigue a una línea `[Comentario] 'o` [comentario]' se ignora, hasta la siguiente línea con
una etiqueta de sección.

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

Las líneas de este formulario hacen que el contenido del archivo jigdo especificado se descargue y
analizado como el archivo jigdo principal. El efecto será el mismo que copiar el contenido incluido.
el contenido del archivo en el archivo que contiene la directiva de inclusión. (Excepción: Cualquiera
las URL relativas siempre se resuelven utilizando la URL del `.jigdo'archivo que contiene ese
URL relativa.)

El argumento de la URL puede ser una URL absoluta o relativa. Se supone que las URL relativas son
relativo a la URL del archivo jigdo que contiene la directiva include. Incluye lata
anidarse, pero es un error crear un ciclo de directivas de inclusión. Está no posible
para utilizar URL de la forma `Label:ruta'.

La URL no se puede citar con "". Cualquier carácter ']' en el argumento debe escaparse como
'% 5D', y cualquier espacio como '% 20'.

Las directivas de inclusión solo son compatibles con jigdo, son ignorados por jigdo-lite.

Una directiva de inclusión termina cualquier sección anterior, pero no inicia una nueva. En
En otras palabras, siempre se debe iniciar una nueva sección después de la línea de inclusión, jigdo no
permitir que las entradas normales aparezcan debajo de '[Incluir]'.

CACHE ARCHIVOS

Cualquier archivo especificado con el --cache La opción se utiliza para almacenar información sobre el ARCHIVOS
presentado a archivo jigdo. Al consultar la caché, un archivo se considera sin cambios (y el
se utilizan datos almacenados en caché) solo si el nombre del archivo, el tamaño del archivo y la hora de la última modificación (mtime) coinciden
exactamente. Para la coincidencia de nombre de archivo, no se utiliza el nombre de archivo completo, sino solo la parte
después de cualquier `// ', de modo que cualquier cambio en la parte anterior al` //' no invalidará
el caché.

Las entradas de caché antiguas se eliminan de la caché si no se han leído o escrito en
durante el tiempo especificado con --cache-caducidad. Las entradas son no inmediatamente eliminado
de la caché si el archivo al que hacen referencia ya no existe; esto hace posible
caché de información sobre archivos en medios extraíbles.

La caducidad de la caché solo tiene lugar después de archivo jigdo ha hecho su trabajo principal - si alguna entrada antigua
se accede antes de que se produzca la caducidad, se conservarán. Por ejemplo, si el programa es
ejecutar usando el tiempo de vencimiento predeterminado de 30 días, pero accede a un archivo de caché con entradas
generado hace 2 meses, luego entradas en ese caché seguirá ser considerados, y solo aquellos
caducarán las entradas de caché que no fueron necesarias durante la ejecución del programa.

Debido a una peculiaridad de la biblioteca de base de datos subyacente (libdb3), los archivos de caché nunca
encogen, solo crecen. Si una gran cantidad de entradas caducó de su archivo de caché y
desea que se reduzca, puede simplemente eliminarlo (por supuesto, entonces todo tendrá
para ser regenerado) o use las utilidades que acompañan a libdb3 para volcar y restaurar el
base de datos, con un comando como `db3_volcado viejo-cache.db | carga_db3 nuevo-cache.db'. Para Debian,
estos programas se suministran en el paquete `libdb3-util '.

Si es diferente --md5-tamaño de bloque se especifica, es necesario volver a leer todo el archivo para
actualice su entrada de caché. Si es diferente --longitud mínima se especifica, solo el primero
Los bytes 'md5-block-size' del archivo necesitan ser releídos.

EJEMPLOS

PREPARANDO TU CD IMAGEN PARA DISTRIBUCIÓN
Ha creado una imagen de CD `imagen.iso'de algunos de los archivos almacenados en el directorio
`/ inicio / ftp'en su disco duro, que también está disponible en línea como `ftp://misitio.org'. Como
no desea desperdiciar espacio alojando efectivamente los mismos datos dos veces (una vez como archivos en
el servidor FTP, una vez dentro de la imagen), y estás harto de que las descargas de los usuarios cancelen
después de 200 MB y reiniciar la descarga decenas de veces, decides usar jigdo.
¿Cómo se prepara la imagen para descargar?

De hecho, solo es necesario un comando:

archivo jigdo hacer-plantilla --image = image.iso --jigdo = / inicio / ftp / image.jigdo
--template = / home / ftp / image.template / inicio / ftp // --etiqueta Mysite = / inicio / ftp --uri
Mysite =ftp://misitio.org/

La gente ahora puede señalar jigdo en 'ftp://misitio.org/imagen.jigdo'para descargar tu imagen. El
El archivo de plantilla debe ser accesible como `ftp://misitio.org/imagen.plantilla'.

Tenga en cuenta que nada le impide hacer lo mismo con un servidor FTP que no
administrado por usted; en ese caso, solo necesita alojar el archivo `.jigdo'y'.plantilla'
archivos en su propio servidor / página de inicio.

PREPARANDO AN ARBITRARIO GRANDE ARCHIVO PARA DISTRIBUCIÓN
Suponemos que tiene un archivo grande que no es un sistema de archivos, por ejemplo, `película.mpeg'. Porque
de problemas de espacio, desea distribuir los datos en dos servidores.

En este caso, las partes de la imagen deben generarse artificialmente con el dividido
mando. Por ejemplo, para crear fragmentos de 4 MB cada uno, utilice `dividido -b 4m película.mpeg parte'.
Copie los archivos resultantes `parteXX'en dos directorios'1'y'2'que tu creas,
según cómo desee distribuir los archivos entre los servidores. A continuación, cree el
jigdo y archivos de plantilla con `archivo jigdo hacer-plantilla --image = movie.mpeg 1 // 2 //'. usted
necesitará editar el `.jigdo'y proporcione los URI correctos para los dos servidores que
vas a subir el `parteXX'archivos a.

PERSONALIZADO VERSIONES OF IMÁGENES
Debido a que es posible asignar un URI diferente para cada parte de una imagen si es necesario,
jigdo es muy flexible. Solo un ejemplo es la posibilidad de versiones personalizadas de
imágenes: suponga que alguien está distribuyendo una imagen de CD y que desea hacer algunas
pequeños cambios y redistribuir su propia versión. Usted descarga el 'oficial.iso' CD
imagen con jigdo (pasándole la URL de `oficial.jigdo'), escríbalo en un CD-R, haga su
cambios (por ejemplo, agregar archivos desde el `mis archivos'directorio en su disco duro) y producir su
propia versión,miversion.iso'. A continuación, instruyes archivo jigdo para crear el jigdo y
archivos de plantilla para su imagen modificada, usando el comando

archivo jigdo hacer-plantilla --image = myversion.iso / mnt / cdrom / mis archivos// --etiqueta
My = myfiles / --uri Mi =http://my.homepage.net/ --merge = official.jigdo
mientras queoficial.iso'está montado debajo de'/ mnt / cdrom'. Mediante el uso --unir, has dicho jigdo-
presentar tomar el contenido de 'oficial.jigdo', agréguele una nueva sección' [Imagen] 'para
`miversion.iso'y escriba el archivo jigdo resultante en `miversion.jigdo' - y ahora
`miversion.jigdo'ofrece dos imágenes para descargar, la versión original y la modificada
versión. (Si no desea que ofrezca la versión oficial, edítela y elimine la
Sección `[Imagen] 'que enumera`oficial.iso'.)

Ahora puede cargar el archivo `.jigdo'archivo, el `.plantilla'archivo y también los archivos en `mis archivos'
a 'http://my.homepage.net/'. Por lo tanto, para que la gente descargue su imagen modificada, debe
no necesita cargar el contenido completo de la imagen en su espacio web, pero solo los cambios que
¡hecho!

(En caso de que haya realizado muy pocos cambios, también puede omitir el parámetro 'myfiles' en
el comando anterior, todos los cambios terminan en el nuevo archivo de plantilla).

COMBINATORIO MUCHOS GESTIONADO POR JIGDO IMÁGENES EN ONE
Tampoco es un problema combinar datos de varias fuentes que usan jigdo. Por ejemplo, si
de cinco servidores diferentes y no relacionados, cada uno distribuye una imagen de CD diferente a través de
jigdo, puede crear una imagen de DVD personalizada que contenga los datos de todos estos CD.
Cuando la gente usa jigdo para descargar su imagen, se obtienen los archivos individuales del DVD
de las mismas fuentes que los CD originales.

En consecuencia, aunque distribuya un archivo de 3.2 GB a través de su espacio web, el
La cantidad real de datos que se almacenan en su servidor solo será del orden de varios
MB.

Use jigdo-file en línea usando los servicios de onworks.net