Provided by: apt-utils_0.8.16~exp5ubuntu13_i386 bug

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
           The release command generates a Release file from a directory tree.
           It recursively searches the given directory for uncompressed
           Packages and Sources files and the ones compressed with gzip, bzip2
           or lzma as well as Release and md5sum.txt files by default
           (APT::FTPArchive::Release::Default-Patterns). Additional filename
           patterns can be added by listing them in
           APT::FTPArchive::Release::Patterns. It then writes to stdout a
           Release file containing a MD5, SHA1 and SHA256 digest for each
           file.

           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/squeeze.

       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, --sha1, --sha256
           Generate the given checksum. These options default to on, when
           turned off the generated index files will not have the checksum
           fields where possible. Configuration Items:
           APT::FTPArchive::Checksum and APT::FTPArchive::Index::Checksum
           where Index can be Packages, Sources or Release and Checksum can be
           MD5, SHA1 or SHA256.

       -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