Provided by:
apt-utils_0.8.3ubuntu7_i386 
NAME
apt-ftparchive - Herramienta para generar ficheros de indice
SYNOPSIS
apt-ftparchive [-hvdsq] [--md5] [--delink] [--readonly] [--contents]
[--arch arquitectura] [-o configuraci'on=cadena]
[-c=fichero]
{[packages ruta... [fichero-alternativo [prefijo-ruta]]]
| [sources ruta... [fichero-alternativo [prefijo-ruta]]]
| [contents ruta] | [release ruta] |
[generate fichero-configuraci'on secci'on...] |
[clean fichero-configuraci'on]}
DESCRIPCI'oN
apt-ftparchive es la herramienta de la linea de ordenes que genera los
ficheros de indice que APT utiliza para acceder a la fuente de la
distribucion. Los ficheros de indice se deberian generar en el sitio de
origen basado en el contenido de ese sitio.
apt-ftparchive es un superconjunto del programa dpkg-scanpackages(1), e
incorpora su funcionalidad al completo mediante la orden packages.
Tambien contiene un generador de contenidos de fichero, contents, y un
modo elaborado para realizar un <<script>> para el proceso de
generacion de un archivo completo.
Internamente, apt-ftparchive puede hacer uso de bases de datos binarias
para almacenar los contenidos de un fichero <<.deb>> y no depender de
ningun programa externo como gzip(1). Cuando se realiza una generacion
completa, automaticamente realiza comprobaciones de cambios en los
ficheros y genera los ficheros de salida comprimidos deseados.
Se debe proporcionar alguna de las siguientes ordenes, a menos que se
proporcione una de las opciones -h o --help.
packages
La orden <<packages>> genera un fichero de paquete a partir de un
directorio. Busca recursivamente ficheros <<.deb>> en el directorio
proporcionado, generando un registro de paquete en la salida
estandar para cada uno. Esta orden es casi un equivalente de dpkg-
scanpackages(1).
La opcion --db se puede usar para especificar una base de datos
binaria para la cache (registro de paquetes).
sources
La orden sources genera un fichero de indice de fuentes a partir de
un directorio. Toma el directorio proporcionado y busca en el
recursivamente ficheros <<.dsc>>, generando un registro de fuente
en la salida estandar para cada uno. Esta orden es casi un
equivalente de dpkg-scansources(1).
Si se define un fichero alternativo, se buscara un fichero de
fuentes alternativo con la extension <<.src>>. Puede usar la opcion
--source-override para cambiar el fichero de fuentes alternativo
que se usara.
contents
La orden contents genera un fichero de contenidos a partir de un
directorio. Toma el directorio proporcionado y busca en el
recursivamente ficheros <<.deb>>, lee la lista de ficheros para
cada uno, los ordena y muestra en la salida estandar la lista de
ficheros que coinciden con los paquetes. Los directorios no se
muestran por la salida estandar. Si varios paquetes tienen el mismo
fichero, entonces cada paquete se separara por una coma en la
salida.
La opcion --db se puede usar para especificar una base de datos
binaria para la cache (registro de paquetes).
release
La orden release genera un fichero <<Release>> a partir de un
directorio. Toma el directorio proporcionado y busca en el
recursivamente los ficheros <<Packages>>, <<Packages.gz>>,
<<Packages.bz2>>, <<Sources>>, <<Sources.gz>>, <<Sources.bz2>>,
<<Release>> y <<md5sum.txt>>. Muestra en la salida estandar un
fichero <<Release>> que contiene un resumen MD5 y SHA1 para cada
fichero.
Los valores para los campos de metadatos adicionales en el fichero
<<Release>> se toman de las variables correspondientes en
APT::FTPArchive::Release, por ejemplo
APT::FTPArchive::Release::Origin. Los campos permitidos son:
Origin, Label, Suite, Version, Codename, Date, Valid-Until,
Architectures, Components y Description.
generate
La orden generate se diseno para ejecutarse desde un script de cron
y genera los indices de acuerdo a lo proporcionado en el fichero de
configuracion. El lenguaje de configuracion proporciona una forma
flexible de definir que ficheros de indice se generaran a partir de
que directorios, asi como proporcionar una forma sencilla de
mantener la configuracion necesaria.
clean
La orden clean ordena las bases de datos que usa el fichero de
configuracion proporcionado, eliminando los registros que no son
necesarios.
LA CONFIGURACI'oN DE <<GENERATE>>
La orden generate usa un fichero de configuracion para describir los
ficheros que se generaran. Sigue el tipico formato de configuracion de
ISC visto en las herramientas de ISC como bind 8 y dhcpd. apt.conf(5)
contiene una descripcion de la sintaxis. Tenga en cuenta que la
configuracion de <<generate>> se analiza por seccion, pero apt.conf(5)
se analiza por arbol. Esto solo afecta a como se maneja el ambito de la
etiqueta.
La configuracion de <<generate>> tiene cuatro secciones diferentes, que
se describen a continuacion.
Secci'on Dir
La seccion Dir define los directorios estandar necesarios para ubicar
los ficheros necesarios durante el proceso de generacion. A estos
directorios se les anaden ciertas rutas relativas definidas en
secciones posteriores para producir una ruta absoluta.
Seccion ArchiveDir
Define la raiz del archivo FTP; en una configuracion estandar de
Debian este es el directorio que contiene el ls-LR y los nodos
<<dist>>.
Seccion OverrideDir
Define la ubicacion de los ficheros alternativos.
Seccion CacheDir
Define la ubicacion de los ficheros de la cache.
Seccion FileListDir
Define la ubicacion de los ficheros del listado de ficheros, si se
usa posteriormente el valor FileList.
Secci'on Default
La seccion Default define los valores predeterminados, y los ajustes
que controlan la operacion del generador. Otras secciones pueden
sobrescribir estos valores predeterminados con un valor de la seccion.
Packages::Compress
Define los esquemas de compresion predeterminados para usar en los
ficheros de indice de <<Package>>. Es una cadena que contiene una
lista separada por espacios de al menos uno de los siguientes
valores: <<.>> (sin compresion), <<gzip>> y <<bzip2>>. El valor
predeterminado para todos los esquemas de compresion es <<. gzip>>.
Packages::Extensions
Define la lista predeterminada de extensiones de fichero que son
ficheros de paquete. El valor predeterminado es <<.deb>>.
Sources::Compress
Esta opcion es similar a Packages::Compress excepto que controla la
compresion para los ficheros <<Sources>>.
Sources::Extensions
Define la lista predeterminada de las extensiones de fichero que
son ficheros de fuentes. El valor predeterminado es <<.dsc>>.
Contents::Compress
Esta opcion es similar a Packages::Compress excepto que controla la
compresion para los ficheros <<Contents>>.
Translation::Compress
Esta opcion es similar a Packages::Compress excepto que controla la
compresion para el fichero maestro Translation-en.
DeLinkLimit
Define el numero de kilobytes a desenlazar (y reemplazar con
enlaces duros) por ejecucion. Se usa junto al valor External-Links
de cada seccion.
FileMode
Define el modo de todos los ficheros de indice creados. El valor
predeterminado es 0644. Todos los ficheros de indice se ajustan a
este modo sin tener en cuenta la mascara de usuario (<<umask>>).
LongDescription
Define si se deben incluir las descripciones largas en el fichero
<<Packages>>, o si se deben separar, guardandolo en el fichero
<<Translation-en>>.
Secci'on TreeDefault
Define los valores predeterminados de las secciones Tree. Todas estas
variables son variables de sustitucion y reemplazan las cadenas
$(DIST), $(SECTION) y $(ARCH) con sus valores respectivos.
MaxContentsChange
Define el numero de kilobytes de los ficheros de contenido que se
generan cada dia. Los ficheros de contenido estan en una cola
<<round-robin>>, de modo que durante varios dias todos se
regeneraran.
ContentsAge
Controla el numero de dias en los que se permite comprobar un
fichero de contenido sin cambios. Si este limite caduca, el tiempo
de modificacion (mtime) del fichero de contenido se actualiza. Este
caso puede aparecer si un fichero de paquete cambia de forma que no
resulte en un fichero de contenido nuevo (por ejemplo, una edicion
alternativa). Se permite la retencion con la esperanza de que se
instalen nuevos <<.deb>>, lo cual precisa un fichero nuevo de todos
modos. El valor predeterminado es diez, las unidades usadas son
dias.
Directory
Define la raiz del directorio <<.deb>>. El valor predeterminado es
$(DIST)/$(SECTION)/binary-$(ARCH)/
SrcDirectory
Define la raiz del directorio de los paquetes de fuentes. El valor
predeterminado es $(DIST)/$(SECTION)/source/
Packages
Define el fichero <<Packages>> de salida. El valor predeterminado
es $(DIST)/$(SECTION)/binary-$(ARCH)/Packages
Sources
Define el fichero <<Sources>> de salida. El valor predeterminado es
$(DIST)/$(SECTION)/source/Sources
Translation
Define el fichero maestro <<Translation-en>> que contiene las
descripciones maestras en el caso de que no se deban incluir en el
fichero <<Packages>>. El valor predeterminado es
$(DIST)/$(SECTION)/i18n/Translation-en
InternalPrefix
Define el prefijo de la ruta que hace que un enlace simbolico se
considere un enlace interno en lugar de un enlace externo. El valor
predeterminado es $(DIST)/$(SECTION)/
Contents
Define el fichero <<Contents>> de salida. El valor predeterminado
es $(DIST)/Contents-$(ARCH). Si este valor causa que varios
ficheros <<Packages>> se relacionen en un unico fichero
<<Contents>> (el comportamiento predeterminado), apt-ftparchive
integrara automaticamente esos ficheros de paquete juntos.
Contents::Header
Define el fichero de cabecera a anadir al fichero <<Contents>> de
salida.
BinCacheDB
Define la base de datos binaria de la cache para usar en esta
seccion. Varias secciones pueden compartir la misma base de datos.
FileList
Define que apt-ftparchive deberia leer la lista de ficheros del
fichero proporcionado en lugar de explorar recursivamente el arbol
de directorios. A los nombres de los ficheros relativos se les
anade como prefijo el directorio del archivo.
SourceFileList
Define que apt-ftparchive deberia leer la lista de ficheros del
fichero proporcionado en lugar de explorar recursivamente el arbol
de directorio. A los nombres de los ficheros relativos se les anade
como prefijo el directorio del archivo. Solo se usa cuando se
procesan indices de fuentes.
Secci'on Tree
La seccion Tree define un arbol de un archivo de paquetes Debian
estandar que consiste en un directorio base, varias secciones en ese
directorio base y finalmente varias arquitecturas en cada seccion. La
ruta exacta usada se define en la variable de sustitucion Directory.
La seccion Tree toma un ambito de una etiqueta que define la variable
$(DIST) y la raiz del arbol (a la ruta se le anade el prefijo
ArchiveDir). Normalmente esto es un valor como dists/lenny.
Todos los valores definidos en la seccion TreeDefault se pueden usar en
la seccion Tree, asi como tres nuevas variables.
Cuando se procesa una seccion Tree apt-ftparchive realiza una operacion
similar a la siguiente:
for i in Sections do
for j in Architectures do
Generar con DIST=scope SECTION=i ARCH=j
Secciones
Es una lista de secciones separadas por espacios que aparecen bajo
la distribucion, generalmente es similar a main contrib non-free.
Arquitecturas
Es una lista de todas las arquitecturas separadas por espacios que
aparecen bajo la seccion de busqueda. La arquitectura especial
<<source>> se usa para indicar que este arbol tiene un fichero de
fuentes.
LongDescription
Define si se deben incluir las descripciones largas en el fichero
<<Packages>>, o si se deben separar, guardandolo en el fichero
<<Translation-en>>.
BinOverride
Define el fichero binario alternativo. Este contiene la informacion
sobre la seccion, la prioridad y la direccion del mantenedor.
SrcOverride
Define el fichero de fuentes alternativo. Este contiene la
informacion sobre la seccion.
ExtraOverride
Define el fichero binario alternativo adicional.
SrcExtraOverride
Define el fichero de fuentes alternativo adicional.
Secci'on BinDirectory
La seccion bindirectory define un directorio binario sin ningun tipo de
estructura especial. El ambito de la etiqueta define la ubicacion del
directorio binario, la configuracion es similar a la seccion Tree sin
sustituir las variables o la configuracion de SectionArchitecture.
Packages
Define el fichero <<Packages>> de salida.
Sources
Define el fichero <<Sources>> de salida. Es necesario al menos un
fichero Packages o Sources.
Contents
Define el fichero <<Contents>> de salida. (Opcional)
BinOverride
Define el fichero binario alternativo.
SrcOverride
Define el fichero de fuentes alternativo.
ExtraOverride
Define el fichero binario alternativo adicional.
SrcExtraOverride
Define el fichero de fuentes alternativo adicional.
BinCacheDB
Define la base de datos de la cache.
PathPrefix
Anade una ruta a todas las rutas de salida.
FileList, SourceFileList
Define el fichero de la lista de ficheros.
EL FICHERO BINARIO ALTERNATIVO
El fichero binario alternativo es totalmente compatible con dpkg-
scanpackages(1). Contiene cuatro campos separados por espacios. El
primero es el nombre del paquete, el segundo la prioridad asignada el
paquete, el tercero es la seccion a la que se fuerza el paquete y el
ultimo es el campo de permutacion del mantenedor.
La forma general del campo del mantenedor es:
antigua [// antigua-n]* => nueva
o simplemente
nueva
La primera forma permite una lista separada por barras dobles de las
direcciones de correo electronico antiguas a definir. Si se encuentra
cualquier de ellas <<nueva>> se sustituye por el campo del mantenedor.
La segunda forma sustituye de forma incondicional el campo del
mantenedor.
EL FICHERO DE FUENTES ALTERNATIVO
El fichero de fuentes alternativo es totalmente compatible con dpkg-
scansources(1). Contiene dos campos separados por espacios. El primero
es el nombre del paquete fuente, el segundo es la seccion a la que se
asignara.
EL FICHERO ALTERNATIVO ADICIONAL
El fichero alternativo adicional permite anadir o reemplazar en la
salida cualquier etiqueta arbitraria. Tiene tres columnas, la primera
es el paquete, la segunda es la etiqueta y el resto de la linea es el
nuevo valor.
OPCIONES
Todas las opciones de la linea de ordenes se pueden definir mediante el
fichero de configuracion, las descripciones indican la opcion de la
configuracion a definir. Para opciones de tipo <<boolean>> puede
invalidar el fichero de configuracion utilizando algo como -f-,--no-f,
-f=no u otras muchas variaciones.
--md5
Genera una suma de control MD5. Esta activado de forma
predeterminada, cuando se desactiva los ficheros de indices
generados no tendran los campos MD5Sum cuando sea posible. Opcion
de configuracion: APT::FTPArchive::MD5
-d, --db
Usa una base de datos binaria para la cache. Esto no afecta a la
orden <<generate>>. Opcion de configuracion: APT::FTPArchive::DB.
-q, --quiet
Silencioso, produce una salida adecuada para su almacenamiento,
omitiendo los indicadores de progreso. Mas letras <<q>> producen
una salida mas silenciosa, hasta un maximo de dos letras. Ademas,
es posible usar -q=# para ajustar el nivel de silencio, ignorando
el fichero de configuracion. Opcion de configuracion: quiet.
--delink
Realiza el desenlazado. Esta opcion activa el desenlazado de los
ficheros si se usa la opcion External-Links. Esta activa de forma
predeterminada y se puede desactivar mediante --no-delink. Opcion
de configuracion: APT::FTPArchive::DeLinkAct.
--contents
Realiza la generacion de <<contents>>. Cuando se usa esta opcion y
los indices de los paquetes se estan generando con una base de
datos de la cache, el listado de los ficheros se extraera tambien y
se almacenara en la base de datos para su uso posterior. Cuando se
usa la orden <<generate>> esta opcion tambien permite la creacion
de cualquier fichero <<Contents>>. Esta activa de forma
predeterminada. Opcion de configuracion: APT::FTPArchive::Contents.
-s, --source-override
Selecciona el fichero de fuentes alternativo a usar con la orden
sources. Opcion de configuracion: APT::FTPArchive::SourceOverride.
--readonly
Define los permisos de las bases de datos de la cache como solo
lectura. Opcion de configuracion: APT::FTPArchive::ReadOnlyDB.
-a, --arch
Hace que las ordenes packages y contents solo acepten aquellos
paquetes que coinciden con *_arch.deb o *_all.deb, en lugar de
todos los ficheros de paquete en la ruta dada. Elemento de
configuracion: APT::FTPArchive::Architecture.
APT::FTPArchive::AlwaysStat
apt-ftparchive(1) almacena tantos metadatos como sea posible en una
base de datos de almacenamiento. Si los paquetes se recompilan o
publican otra vez con la misma version apareceran problemas ya que
se usaran los metadatos almacenados y ahora obsoletos tales como el
tamano o la suma de control. Esta situacion se evitara si se activa
esta opcion ya que se comprobara si el fichero ha cambiado. Tenga
en cuenta que esta opcion esta definida como <<false>> por omision,
ya que no se recomienda subir varias versiones o compilaciones de
un paquete con el mismo numero de version, asi que en teoria nadie
deberia tener problemas y por ello todas estas comprobaciones
adicionales son innecesarias.
APT::FTPArchive::LongDescription
De forma predeterminada esta opcion de configuracion se define como
<<true>> y solo se deberia definir como <<false>> si el archivo de
paquetes generado con apt-ftparchive(1) tambien proporciona
ficheros Translation. Tenga en cuenta que el fichero maestro
Translation-en solo se puede crear con la orden <<generate>>.
-h, --help
Muestra un mensaje corto sobre el uso.
-v, --version
Muestra la version del programa.
-c, --config-file
Fichero de configuracion: Especifica el fichero de configuracion a
usar. El programa leera el fichero de configuracion predeterminado
y, despues, este fichero de configuracion. Si necesita que ciertas
opciones de configuracion se definan antes que el analisis de los
de los ficheros de configuracion predeterminados, defina un fichero
con la variable de entorno APT_CONFIG. Consulte apt.conf(5) para
informacion sobre la sintaxis.
-o, --option
Define una opcion de configuracion: Esto definira una opcion
arbitraria de configuracion. La sintaxis es -o Algo::Cosa=cosa. -o
y --option se pueden usar varias veces para definir diferentes
opciones.
EJEMPLOS
Para crear un fichero <<Packages>> comprimido para un directorio que
contenga paquetes binarios (<<.deb>>):
apt-ftparchive packages directorio | gzip > Packages.gz
V'eASE TAMBI'eN
apt.conf(5)
DIAGN'oSTICOS
apt-ftparchive devuelve cero si no hay ningun error, y el valor 100 en
caso de error.
BUGS
P'agina de errores de APT[1]. Si quiere informar de un error en APT,
consulte /usr/share/doc/debian/bug-reporting.txt o use la orden
reportbug(1).
TRADUCCI'ON
La traduccion al espanol la realizaron Ismael Fanlo, Carlos Mestre,
Rudy Godoy, Gustavo Saldumbide, Javier Fernandez-Sanguino y Ruben
Porras Campo entre los anos 2003 y 2004. La traduccion fue actualizada
por Francisco Javier Cuadrado y Omar Campagne Polaino entre los anos
2009 y 2010.
Tenga en cuenta que este documento puede contener secciones sin
traducir. Esto es intencionado para evitar perder contenido cuando la
traduccion no esta actualizada con respecto al documento original.
AUTHORS
Jason Gunthorpe
Equipo de APT
NOTES
1. Pagina de errores de APT
http://bugs.debian.org/src:apt