apt-ftparchive: en línea en la nube

PROGRAMA:

NOMBRE

apt-ftparchive: utilidad para generar archivos de índice

SINOPSIS

archivo apt-ftp [-dsq] [--md5] [--desvincular] [--solo lectura] [--contenido] [--arco arquitectura]
[-o =cadena_config] [-c =archivo de configuración]
{paquetes camino... [anular-archivo [prefijo de ruta]] |
fuentes camino... [anular-archivo [prefijo de ruta]] | contenido camino |
, camino | generar archivo de configuración .... | limpio archivo de configuración |
{-v | --version} | {-h | --ayuda}}

DESCRIPCIÓN

archivo apt-ftp es la herramienta de línea de comando que genera los archivos de índice que APT usa para
acceder a una fuente de distribución. Los archivos de índice deben generarse en el sitio de origen según
sobre el contenido de ese sitio.

archivo apt-ftp es un superconjunto del paquetes de escaneo dpkg(1) programa, incorporando todo su
funcionalidad a través del comando de paquetes. También contiene un generador de archivos de contenido,
contenidos, y un medio elaborado para 'guión' el proceso de generación para una completa
archivo.

Internamente archivo apt-ftp puede hacer uso de bases de datos binarias para almacenar en caché el contenido de un .deb
archivo y no depende de ningún programa externo aparte de gzip(1). Al hacer un completo
generarlo realiza automáticamente comprobaciones de cambio de archivo y crea el archivo comprimido deseado
archivos de salida.

A menos que el -ho --ayuda Si se da la opción, uno de los comandos siguientes debe estar presente.

paquetes
El comando de paquetes genera un archivo de paquete a partir de un árbol de directorios. Se necesita el
dado y busca recursivamente archivos .deb, emitiendo un registro de paquete
a stdout para cada uno. Este comando es aproximadamente equivalente a paquetes de escaneo dpkg(1).

La opción --db se puede utilizar para especificar una base de datos de caché binaria.

fuentes
El comando sources genera un archivo de índice fuente a partir de un árbol de directorios. Se necesita el
dado el directorio y busca recursivamente archivos .dsc, emitiendo un registro de origen
a stdout para cada uno. Este comando es aproximadamente equivalente a dpkg-scansources(1).

Si se especifica un archivo de anulación, se buscará un archivo de anulación de origen con
una extensión de .src. La opción --source-override se puede usar para cambiar la fuente
anular el archivo que se utilizará.

contenido
El comando de contenido genera un archivo de contenido a partir de un árbol de directorio. Se necesita el
directorio dado y lo busca de forma recursiva para archivos .deb, y lee la lista de archivos
de cada archivo. Luego clasifica y escribe en stdout la lista de archivos que coinciden con
paquetes. Los directorios no se escriben en la salida. Si varios paquetes poseen lo mismo
file, luego cada paquete está separado por una coma en la salida.

La opción --db se puede utilizar para especificar una base de datos de caché binaria.

,
El comando de lanzamiento genera un archivo de lanzamiento a partir de un árbol de directorios. Recursivamente
busca en el directorio dado paquetes sin comprimir y archivos de origen y otros
comprimido con gzip, bzip2 or lzma así como los archivos Release y md5sum.txt por defecto
(APT :: FTPArchive :: Release :: Default-Patterns). Se pueden crear patrones de nombre de archivo adicionales.
agregado enumerándolos en APT :: FTPArchive :: Release :: Patterns. Luego escribe en stdout
un archivo de lanzamiento que contiene (por defecto) un resumen MD5, SHA1, SHA256 y SHA512 para cada
archivo.

Los valores de los campos de metadatos adicionales en el archivo de lanzamiento se toman del
variables correspondientes en APT :: FTPArchive :: Release, por ejemplo
APT :: FTPArchive :: Release :: Origin. Los campos admitidos son: Origen, Etiqueta, Suite,
Versión, Nombre en clave, Fecha, Válido hasta, Arquitecturas, Componentes, Descripción.

generar
El comando generate está diseñado para ejecutarse desde un script cron y crea índices
de acuerdo con el archivo de configuración dado. El lenguaje de configuración proporciona un medio flexible de
especificar qué archivos de índice se crean a partir de qué directorios, así como proporcionar un
medios sencillos de mantener los ajustes necesarios.

limpia
El comando clean ordena las bases de datos utilizadas por el archivo de configuración dado por
eliminar cualquier registro que ya no sea necesario.

EL REINO UNIDO GENERAR CONFIGURACIÓN

El comando generate usa un archivo de configuración para describir los archivos que van a
ser generado. Sigue el formato de configuración típico de ISC como se ve en herramientas de ISC como
enlazar 8 y dhcpd. apt.conf(5) contiene una descripción de la sintaxis. Tenga en cuenta que el
generar configuración se analiza de manera seccional, pero apt.conf(5) se analiza en un árbol
manera. Esto solo afecta la forma en que se maneja la etiqueta de alcance.

La configuración de generación tiene cuatro secciones separadas, cada una de las cuales se describe a continuación.

Usted Sección
La sección Dir define los directorios estándar necesarios para ubicar los archivos requeridos
durante el proceso de generación. A estos directorios se les anteponen ciertas rutas relativas
definido en secciones posteriores para producir una ruta completa y absoluta.

ArchivoDir
Especifica la raíz del archivo FTP, en una configuración estándar de Debian esta es la
directorio que contiene los nodos ls-LR y dist.

AnularDir
Especifica la ubicación de los archivos de reemplazo.

CachéDir
Especifica la ubicación de los archivos de caché.

ArchivoListaDir
Especifica la ubicación de los archivos de la lista de archivos, si la configuración de FileList se usa a continuación.

Predeterminado Sección
La sección Predeterminado especifica valores predeterminados y configuraciones que controlan el funcionamiento de
el generador. Otras secciones pueden anular estos valores predeterminados con una configuración por sección.

Paquetes :: Comprimir
Establece los esquemas de compresión predeterminados que se utilizarán para los archivos de índice del paquete. Es un
cadena que contiene una lista separada por espacios de al menos uno de: '.' (sin compresión),
'gzip' y 'bzip2'. El valor predeterminado para todos los esquemas de compresión es '. gzip '.

Paquetes :: Extensiones
Establece la lista predeterminada de extensiones de archivo que son archivos de paquete. Esto por defecto es
'.debutante'.

Fuentes :: Comprimir
Esto es similar a Packages :: Compress, excepto que controla la compresión del
Archivos de fuentes.

Fuentes :: Extensiones
Establece la lista predeterminada de extensiones de archivo que son archivos de origen. Esto por defecto es
'.dsc'.

Contenido :: Comprimir
Esto es similar a Packages :: Compress, excepto que controla la compresión del
Archivos de contenido.

Traducción :: Comprimir
Esto es similar a Packages :: Compress, excepto que controla la compresión del
Archivo maestro de traducción.

Límite de enlace
Especifica el número de kilobytes para desvincular (y reemplazar con enlaces físicos) por ejecución.
Esto se usa junto con la configuración de Enlaces externos por sección.

Filemode
Especifica el modo de todos los archivos de índice creados. El valor predeterminado es 0644. Todos los archivos de índice
están configurados en este modo sin tener en cuenta la umask.

Descripción larga
Especifica si las descripciones largas deben incluirse en el archivo de paquetes o dividirse
en un archivo maestro Translation-en.

Árbol por defecto Sección
Establece valores predeterminados específicos para las secciones del árbol. Todas estas variables son variables de sustitución
y reemplazar las cadenas $ (DIST), $ (SECTION) y $ (ARCH) por sus respectivas
valores.

Contenido máximoCambiar
Establece el número de kilobytes de archivos de contenido que se generan cada día. El
Los archivos de contenido se distribuyen por turnos para que durante varios días se reconstruyan todos.

Contenido Edad
Controla el número de días que se permite comprobar un archivo de contenido sin cambiarlo.
Si se supera este límite, se actualiza el mtime del archivo de contenido. Este caso puede ocurrir
si el archivo del paquete se cambia de tal manera que no da como resultado un nuevo contenido
archivo [anular la edición, por ejemplo]. Se permite una espera con la esperanza de que nuevos .debs
ser instalado, requiriendo un nuevo archivo de todos modos. El valor predeterminado es 10, las unidades están en días.

Directorio
Establece la parte superior del árbol de directorios .deb. Predeterminado a
$ (DIST) / $ (SECCIÓN) / binario - $ (ARCH) /

DirectorioOrigen
Establece la parte superior del árbol del directorio del paquete fuente. Predeterminado a
$ (DIST) / $ (SECCIÓN) / fuente /

Buceo y Alojamiento
Establece el archivo de paquetes de salida. El valor predeterminado es $ (DIST) / $ (SECCIÓN) / binario - $ (ARCH) / Paquetes

Fuentes
Establece el archivo de fuentes de salida. El valor predeterminado es $ (DIST) / $ (SECTION) / source / Sources

Traducción
Establece el archivo maestro de Translation-en de salida con las descripciones largas si es necesario
no estar incluido en el archivo de paquetes. Predeterminado a
$ (DIST) / $ (SECCIÓN) / i18n / Translation-es

Prefijo interno
Establece el prefijo de la ruta que hace que un enlace simbólico se considere un enlace interno.
de un enlace externo. El valor predeterminado es $ (DIST) / $ (SECCIÓN) /

Contenido
Establece el archivo de contenido de salida. El valor predeterminado es $ (DIST) / $ (SECCIÓN) / Contenido - $ (ARCH). Si
esta configuración hace que varios archivos de paquetes se mapeen en un solo archivo de contenido (como es
el predeterminado) entonces archivo apt-ftp integrará esos archivos de paquete juntos
automáticamente.

Contenido :: Encabezado
Establece el archivo de encabezado para anteponerlo al contenido de salida.

BinCacheDB
Establece la base de datos de caché binaria que se utilizará para esta sección. Varias secciones pueden compartir
la misma base de datos.

Lista de archivos
Especifica que en lugar de caminar por el árbol de directorios, archivo apt-ftp debería leer el
lista de archivos del archivo dado. Los nombres de archivos relativos tienen el prefijo del archivo.
directorio.

Lista de archivos fuente
Especifica que en lugar de caminar por el árbol de directorios, archivo apt-ftp debería leer el
lista de archivos del archivo dado. Los nombres de archivos relativos tienen el prefijo del archivo.
directorio. Se utiliza al procesar índices de origen.

Árbol Sección
La sección Árbol define un árbol de archivos Debian estándar que consta de un directorio base,
luego múltiples secciones en ese directorio base y finalmente múltiples arquitecturas en cada
sección. La ruta exacta utilizada se define mediante la variable de sustitución de directorio.

La sección Árbol toma una etiqueta de alcance que establece la variable $ (DIST) y define la raíz de
el árbol (la ruta tiene el prefijo ArchiveDir). Normalmente, esta es una configuración como
dists / jessie.

Todas las configuraciones definidas en la sección TreeDefault se pueden usar en una sección Tree como
así como tres nuevas variables.

Al procesar una sección de árbol archivo apt-ftp realiza una operación similar a:

porque yo en las secciones hago
para j en arquitecturas no
Generar para DIST = alcance SECCIÓN = i ARCO = j

secciones
Esta es una lista de secciones separadas por espacios que aparecen debajo de la distribución;
normalmente esto es algo así como main contrib non-free

Arquitecturas
Esta es una lista separada por espacios de todas las arquitecturas que aparecen en la búsqueda.
sección. La arquitectura especial 'fuente' se utiliza para indicar que este árbol tiene un
archivo de origen. La arquitectura 'todo' indica que archivos específicos de la arquitectura como
Los paquetes no deben incluir información sobre la arquitectura de todos los paquetes en todos los archivos
ya que estarán disponibles en un archivo dedicado.

Descripción larga
Especifica si las descripciones largas deben incluirse en el archivo de paquetes o dividirse
en un archivo maestro Translation-en.

Anulación de contenedor
Establece el archivo de reemplazo binario. El archivo de anulación contiene sección, prioridad y
información de la dirección del mantenedor.

Anulación de Src
Establece el archivo de reemplazo de origen. El archivo de anulación contiene información de la sección.

Anulación adicional
Establece el archivo de anulación adicional binario.

SrcExtraOverride
Establece el archivo de anulación adicional de origen.

DirectorioBin Sección
La sección bindirectory define un árbol de directorio binario sin una estructura especial. El
La etiqueta de alcance especifica la ubicación del directorio binario y la configuración es similar a
la sección Árbol sin variables de sustitución o configuración de Arquitectura de sección.

Buceo y Alojamiento
Establece la salida del archivo de paquetes.

Fuentes
Establece la salida del archivo de fuentes. Se requiere al menos uno de los paquetes o fuentes.

Contenido
Establece la salida del archivo de contenido (opcional).

Anulación de contenedor
Establece el archivo de reemplazo binario.

Anulación de Src
Establece el archivo de reemplazo de origen.

Anulación adicional
Establece el archivo de anulación adicional binario.

SrcExtraOverride
Establece el archivo de anulación adicional de origen.

BinCacheDB
Establece la base de datos de la caché.

Prefijo de ruta
Agrega una ruta a todas las rutas de salida.

Lista de archivos, Lista de archivos fuente
Especifica el archivo de lista de archivos.

EL REINO UNIDO BINARIO ANULACIÓN ARCHIVO

El archivo de anulación binaria es totalmente compatible con paquetes de escaneo dpkg(1). Contiene cuatro
campos separados por espacios. El primer campo es el nombre del paquete, el segundo es el
prioridad para forzar ese paquete, la tercera es la sección para forzar ese paquete y
el campo final es el campo de permutación del mantenedor.

La forma general del campo mantenedor es:

antiguo [// antiguo] * => nuevo

o simplemente,

nueva

El primer formulario permite crear una lista separada por dos barras de direcciones de correo electrónico antiguas.
especificado. Si se encuentra alguno de ellos, se sustituye por nuevo por el campo mantenedor. El
la segunda forma sustituye incondicionalmente al campo mantenedor.

EL REINO UNIDO FUENTE ANULACIÓN ARCHIVO

El archivo de anulación de origen es totalmente compatible con dpkg-scansources(1). Contiene dos
campos separados por espacios. El primer campo es el nombre del paquete fuente, el segundo es el
sección para asignarlo.

EL REINO UNIDO EXTRA ANULACIÓN ARCHIVO

El archivo de anulación adicional permite agregar o reemplazar cualquier etiqueta arbitraria en la salida. Eso
tiene tres columnas, la primera es el paquete, la segunda es la etiqueta y el resto de
la línea es el nuevo valor.

CAMPUS

Todas las opciones de la línea de comando se pueden configurar usando el archivo de configuración, las descripciones
Indique la opción de configuración a establecer. Para opciones booleanas, puede anular la configuración
archivo usando algo como -F-,--no-f, -f = no o varias otras variaciones.

--md5, --sha1, --sha256, --sha512
Genere la suma de comprobación dada. Estas opciones se activan de forma predeterminada cuando se apaga el
los archivos de índice generados no tendrán los campos de suma de comprobación cuando sea posible. Configuración
Elementos: APT :: FTPArchive ::Checksums y APT :: FTPArchive ::Home::Checksums donde Home podemos
ser Paquetes, Fuentes o Lanzamiento y Checksums puede ser MD5, SHA1, SHA256 o SHA512.

-d, --db
Utilice una base de datos de almacenamiento en caché binaria. Esto no tiene ningún efecto sobre el comando generate. Configuración
Elemento: APT :: FTPArchive :: DB.

-q, --tranquilo
Tranquilo; produce una salida adecuada para el registro, omitiendo los indicadores de progreso. Más q's
producirá más silencio hasta un máximo de 2. También puede utilizar -q = # para poner el silencio
nivel, anulando el archivo de configuración. Elemento de configuración: silencioso.

--desvincular
Realizar desvinculación. Si se utiliza la configuración de Enlaces externos, esta opción en realidad
permite desvincular los archivos. Está activado de forma predeterminada y se puede apagar con
--no desvincular. Elemento de configuración: APT :: FTPArchive :: DeLinkAct.

--contenido
Realizar generación de contenidos. Cuando esta opción está configurada y los índices de paquetes se están
generado con una base de datos de caché, la lista de archivos también se extraerá y almacenará en
la base de datos para su uso posterior. Cuando se usa el comando generate, esta opción también permite
creación de cualquier archivo de contenido. El valor predeterminado está activado. Elemento de configuración:
APT :: FTPArchive :: Contenido.

-s, --fuente-anular
Seleccione el archivo de reemplazo de fuente para usar con el comando de fuentes. Elemento de configuración:
APT :: FTPArchive :: SourceOverride.

--solo lectura
Haga que las bases de datos de almacenamiento en caché sean de solo lectura. Elemento de configuración: APT :: FTPArchive :: ReadOnlyDB.

-a, --arco
Acepte en los comandos de paquetes y contenido solo los archivos de paquete que coincidan con * _arch.deb o
* _all.deb en lugar de todos los archivos de paquete en la ruta dada. Elemento de configuración:
APT :: FTPArchive :: Arquitectura.

APT :: FTPArchive :: AlwaysStat
archivo apt-ftp(1) almacena en caché la mayor cantidad posible de metadatos en un caché b. Si los paquetes son
recompilado y / o republicado con la misma versión nuevamente, esto dará lugar a problemas
ya que se utilizarán los metadatos almacenados en caché ahora obsoletos, como el tamaño y las sumas de comprobación. Con este
opción habilitada, esto ya no sucederá ya que se verificará si el archivo fue
cambió. Tenga en cuenta que esta opción está configurada como "falsa" de forma predeterminada, ya que no se recomienda
cargar múltiples versiones / compilaciones de un paquete con el mismo número de versión, por lo que en teoría
nadie tendrá estos problemas y, por lo tanto, todos estos controles adicionales son inútiles.

APT :: FTPArchive :: LongDescription
Esta opción de configuración tiene el valor predeterminado "verdadero" y solo debe establecerse en "falso" si el
Archivo generado con archivo apt-ftp(1) también proporciona archivos de traducción. Tenga en cuenta que
el archivo maestro Translation-en solo se puede crear en el comando generate.

-h, --ayuda
Muestre un breve resumen de uso.

-v, --versión
Muestra la versión del programa.

-c, --archivo de configuración
Archivo de configuración; Especifique un archivo de configuración para usar. El programa leerá el
archivo de configuración predeterminado y luego este archivo de configuración. Si los ajustes de configuración
deben configurarse antes de analizar los archivos de configuración predeterminados especificar un archivo con
las APT_CONFIG Variable ambiental. Ver apt.conf(5) para obtener información sobre la sintaxis.

-o, --opción
Establecer una opción de configuración; Esto establecerá una opción de configuración arbitraria. los
la sintaxis es -o Foo :: Bar = bar. -o y --opción se puede utilizar varias veces para configurar
Diferentes opciones.

EJEMPLOS

Para crear un archivo de paquetes comprimido para un directorio que contiene paquetes binarios (.deb):

archivo apt-ftp paquetes directorio | gzip > Paquetes.gz

Use apt-ftparchive en línea usando los servicios de onworks.net