Ubuntu Manpage: kernel-pkg.conf - fichero de configuración global del sistema para

NOMBRE

       kernel-pkg.conf  -  fichero  de  configuración  global del sistema para
       make-kpkg

SINOPSIS

       /etc/kernel-pkg.conf o ~/.kernel-pkg.conf

DESCRIPCIÓN

El fichero /etc/kernel-pkg.conf o ~/.kernel-pkg.conf actualmente es un
pequeño Makefile incluido durante el proceso de construcción del
núcleo, debido a esto puede poner cualquier cosa permitida en este tipo
de ficheros (simplemente esté muy seguro acerca de lo que hace). Si
existe la configuración de usuario ~/.kernel-pkg.conf , se usa en favor
del fichero de configuración global /etc/kernel-pkg.conf.

Todas las variables tienen valores razonables de forma predeterminada,
pueden ser modificadas para una ejecución o para un caso en concreto
usando variables de entorno. Algunas de las variables pueden ser
modificadas con opciones de make-kpkg.

En este momento, las variables modificables por el usuario son:

maintainer
Encargado del paquete local kernel-*. Establecido en la
instalación por postinst. Puede ser modificado mediante la
variable de entorno KPKG_MAINTAINER. Dese cuenta que cualquier
apostrofe "’" debe de ser entrecomillado del siguiente modo:
maintainer = John O’\’’Brien. Si, es feo pero funciona.

email La dirección de correo electrónico del encargado. Establecido en
la instalación por postinst. Puede ser modificado mediante la
variable de entorno KPKG_EMAIL.

pgp Nombre a buscar en la base de datos pgp si construimos módulos
separados (como pcmcia) en /usr/src/modules/. Puede ser
modificado mediante la variable de entorno PGP_SIGNATURE, o (de
nuevo) por la opción --pgpsign de make-kpkg. Por omisión es
maintainer. (Opcional)

debian La revisión de Debian del paquete con el núcleo. Puede ser
modificado mediante la variable de entorno DEBIAN_REVISION, o
(de nuevo) por la opción --revision de make-kpkg. Por omisión
es 10.0.0.Custom (Opcional)

debian_revision_mandatory
Normalmente sin definir. Si ésta o la variable de entorno
DEBIAN_REVISION_MANDATORY están establecidas, entonces, la falta
de una revisión de Debian causa un error (y make-kpkg no
proporcionará un valor por omisión de 10.0.0.Custom)

link_in_boot
Póngalo a True si quiere el enlace simbólico a la imagen del
núcleo, llamado vmlinuz en /boot en vez de en el sitio
predeterminado /. Puede ser modificado mediante la variable de
entorno LINK_IN_BOOT. Por omisión está indeterminado.
(Opcional)

kimage El tipo de imagen del núcleo (e.g. zImage o bzImage). Puede ser
modificado mediante la variable de entorno IMAGE_TYPE, o (de
nuevo) por las opciones --zimage o --bzimage de make-kpkg. Por
omisión es bzImage. (Opcional)

no_symlinks
Determina si se usan o no enlaces al fichero con la imagen.
Puede ser modificado mediante la variable de entorno NO_SYMLINK
Mutuamente excluyente con reverse_symlinks. Puede usarse con
link_in_boot. La imagen se coloca en vmlinuz (en vez de en
/boot/vmlinuz-X.X.XX). El vmlinuz anterior se mueve a
vmlinuz.old incondicionalmente. (Normalmente, sólo se hace si la
versión de la nueva imagen difiere de la anterior). Esto le
restringe a dos imágenes, a menos que usted tome medidas
adicionales y guarde copias de imágenes anteriores. Esto es para
aquellos que tienen /boot en un sistema que no usa los enlaces
simbólicos (y digamos, que usan loadlin como gestor de
arranque). Esto es una chapuza. Por omisión está indefinido
(opcional)

reverse_symlinks
Determina si se usan enlaces simbólicos invertidos (esto es, el
fichero real es el que no tiene número de versión, la versión
numerada es el enlace) al fichero con la imagen. Puede ser
modificado mediante la variable de entorno REVERSE_SYMLINK
Mutuamente excluyente con no_symlinks. Se puede usar junto con
link_in_boot. Igual que no_symlinks, excepto porque
/boot/vmlinuz-X.XX es enlazado con la nueva imagen real,
vmlinuz. Esto también le restringe a dos imágenes a menos que
tome alguna acción adicional. Los enlaces anteriores quedan
colgando. Esto es para aquellos con /boot en umsdos, y no pueden
ver el enlace en dos, pero quieren saber el número de la versión
cuando estén en Linux. Esto es una chapuza. Por omisión está
sin definir. (opcional)

patch_the_kernel
Esta variable es sólo para expertos. Si es YES (la variable de
entorno PATCH_THE_KERNEL lo modifica), el proceso de
construcción hace que se ejecute sobre
/usr/src/kernel-patches/$(architecture)/apply y
(afortunadamente) deshaga el proceso durante la fase de limpieza
ejecutando run-parts sobre
/usr/src/kernel-patches/$(architecture)/unpatch. La
arquitectura especial all se usa para parches independientes de
la arquitectura.

config_target
Define el tipo de configuración a usar. Por omisión es
oldconfig, lo que está bien para configuraciones no interactivas
(o mínimamente interactivas). Si está poniendo patch_the_kernel
a YES y algunos de los parches cambian la configuración
disponible, entonces es posible que desee poner esto a otro
valor (como menuconfig o xconfig). (La variable de entorno
CONFIG_TARGET modifica éste valor de configuración). Si el
valor de config_target es otro distinto de config, oldconfig,
menuconfig o xconfig se vuelve a poner a oldconfig.

use_saved_config
Ésta variable es sólo para expertos. Si es NO (la variable de
entorno USE_SAVED_CONFIG lo modifica), el fichero .config.save
en el directorio principal es ignorado.

root_cmd
Esta variable que se pasa a dpkg-buildpackage en el objetivo
buildpackage. Establece el modo de ganar permisos de
superusuario (por ejemplo, ���sudo��� o que dpkg-buildpackages�’
necesita usando la opción -r. La variable de entorno ROOT_CMD lo
modifica. Use la variable de entorno UNSIGN_SOURCE para pasar
una opción a dpkg-buildpackage para que éste no firme las
fuentes, del mismo modo, use la variable de entorno
UNSIGN_CHANGELOG para pasar una opción a dpkg-buildpackage para
que no firme el fichero de cambios. De nuevo, esta variable sólo
es útil para el objetivo buildpackage. Establezca la variable
de entorno ROOT_CMD si sólo desea construir la imagen del
núcleo, por ejemplo.

delete_build_link
Si es YES, el enlace simbólico a /lib/modules/$VERSION/build
será eliminado del paquete .deb resultante. La variable de
entorno DELETE_BUILD_LINK lo modifica.

do_clean
Si es cualquier cosa menos YES, evita que se haga un make clean
en el árbol de fuentes del núcleo después de construir el
paquete con la imagen. La variable de entorno CLEAN_SOURCE lo
modifica.

install_vmlinux
Si es YES instalará la imagen ELF del núcleo descomprimida junto
con la imagen arrancable y comprimida (vmlinuz). Esta imagen es
necesaria para medir el rendimiento del núcleo y usar userspace
con oprofile (oprofile.sourceforge.net, sólo i386).

image_clean_hook
Si apunta a un ejecutable, éste será ejecutado desde el
directorio principal con la imagen (temporal) del núcleo antes
de que sea empaquetada. Sólo tiene efecto sobre la imagen que se
esté empaquetando -- si el opera en el directorio actual y sus
subdirectorios, los directorios originales con las fuentes deben
permanecer intactos. De esta forma se facilitan los pequeños
retoques a la imagen del núcleo que ese esté empaquetando.

source_clean_hook
Si apunta a un ejecutable, éste será ejecutado desde el
directorio principal de las fuentes (temporales) del núcleo
antes de que sean empaquetadas,
./debian/tmp-source/usr/src/kernel-source-X.X.XX. No tiene
efecto sobre otra cosa que no sean las fuentes empaquetadas --
si el script opera en el directorio actual y sus descendientes,
el árbol de directorios con el código fuente original no se verá
modificado. Esto ayuda a moldear las fuentes empaquetadas (por
ejemplo, eliminar directorios de control de versiones, o
eliminar arquitecturas).

header_clean_hook
Si apunta a un ejecutable, este será ejecutado desde el
directorio principal de las cabeceras del núcleo antes de que
sean empaquetadas. No tiene efecto sobre otra cosa que no sean
las fuentes empaquetadas -- si el script opera en el directorio
actual y sus descendientes, el árbol de directorios con el
código fuente original no se verá modificado. Esto ayuda a
moldear las fuentes empaquetadas (por ejemplo, eliminar
directorios de control de versiones, o eliminar arquitecturas).

doc_clean_hook
Si apunta a un ejecutable, este será ejecutado desde el
directorio principal de la documentación del núcleo antes de que
sea empaquetada. No tiene efecto sobre otra cosa que no sea la
documentación empaquetada -- si el script opera en el directorio
actual y sus descendientes, el árbol de directorios con el
código fuente original no se verá modificado. Esto ayuda a
moldear las fuentes empaquetadas (por ejemplo, eliminar
directorios de control de versiones, o eliminar arquitecturas).

extra_docs
Esta variable debe de apuntar a la ruta donde se encuentra toda
la documentación extra que debe instalarse en el directorio
/usr/share/doc/kernel-image-X.X.XX/ . No hay ninguna
comprobación de conflictos entre nombres, y los ficheros no son
comprimidos. Debido a esto, si desea que los ficheros sean
comprimidos debe de comprimirlos y luego proporcionar la ruta al
fichero comprimido. La variable de entorno EXTRA_DOCS lo
modifica, es la forma más habitual de empaquetar documentación
extra.

kpkg_follow_symlinks_in_src
Esta opción es especialmente útil para aquellos que usan
multitud de enlaces simbólicos para compilar los núcleos. Con
esta opción, los paquetes kernel-source y kernel-header no
estarán llenos de enlaces rotos, en su lugar, se seguirán los
enlaces simbólicos. Dese cuenta de que cualquier enlace
simbólico en las fuentes del núcleo se sustituirá por el fichero
enlazado. La variable de entorno KPKG_FOLLOW_SYMLINKS_IN_SRC
modifica este comportamiento.

make_libc_headers
Esta opción es para el encargado de libc6 , cuando compila
libc6, para además empaquetar las cabeceras correspondientes.
NO LO USE a menos que sepa lo que hace, una pequeña equivocación
entre el paquete de cabeceras y libc6 puede hacer que todo el
código compilado en su máquina sea inestable. Ha sido avisado.
La variable de entorno MAKE_LIBC_HEADERS lo modifica.

CONCURRENCY_LEVEL
Si se define, esta variable establece el nivel de concurrencia
usado para compilar el núcleo y los módulos usando la opción -j
en el subproceso make del objetivo build de make-kpkg. Si se
usa, debería ser un entero (pequeño).

ARCH_IN_NAME
Si se define, esta variable hace que make-kpkg use un nombre
extendido para la imagen del núcleo empotrando la
sub-arquitectura en el nombre de la imagen, de este modo uno
puede escribir un script que cree múltiples sub-arquitecturas,
una detrás de la otra. Note que solamente afecta al nombre del
paquete, no afecta a la localización de los módulos y demás.

CONFDIR
Esta variable debe apuntar a un directorio que contenga ficheros
.config específicos de una arquitectura (consulte
/usr/share/kernel-package/Config para ejemplos). Útil para los
que necesiten compilar para varias arquitecturas. Por omisión
apunta a /usr/share/kernel-package/Config

IMAGEDIR
Si quiere que la imagen se guarde en algún otro sitio distinto
de /boot establezca esta variable al directorio deseado. Puede
ser de ayuda para los usuarios de loadlin. Por omisión es
/boot.

MODULE_LOC
Establezca esta variables, bien en el entorno o bien en el
fichero de configuración al lugar donde se encuentren módulos
adicionales. Por omisión /usr/src/modules

CONFDIR
Establezca esta variable, bien en el entorno o bien en el
fichero de configuración al lugar donde se encuentren los
ficheros de configuración del núcleo. Por omisión
/usr/share/kernel-package/Config

PATCH_DIR
Establezca esta variable, bien en el entorno o bien en el
fichero de configuración al lugar donde se encuentren parches
adicionales. Por omisión /usr/src/kernel-patches/ARCHITECTURE

ALL_PATCH_DIR
Establezca esta variable, bien en el entorno o bien en el
fichero de configuración al lugar donde se encuentren parches
independientes de la arquitectura adicionales. Por omisión
/usr/src/kernel-patches/all

El valor una variable puede establecerse de forma que:

a) Los valores predeterminados están en el fichero rules. Se usan
siempre que no haya ninguna otra preferencia establecida.

b) Las variables pueden establecerse en el fichero de configuración
/etc/kernel-pkg.conf. Estos valores modifican los
predeterminados.

c) Las variables también se pueden establecer con su
correspondiente variable de entorno. Estos valores predominan
sobre el fichero de configuración y los valores predeterminados.

d) Usando las opciones de make-kpkg , o, si se usa directamente el
fichero rules, en la línea de órdenes
# xxx/rules DEBIAN_REVISION=2.0a kernel_image
Esto predomina sobre todos los métodos descritos anteriormente.

FICHEROS

       El fichero descrito  en  este  documento  es  /etc/kernel-pkg.conf.   o
       ~/.kernel-pkg.conf.

VÉASE TAMBIÉN

       make-kpkg(1), kernel-img.conf(5), make(1), El manual de GNU Make.

FALLOS

       No  tiene  fallos.  Cualquier  cosa que se lo parezca es un delirio, de
       verdad.

AUTOR

       Esta   página   del   manual   fue   escrita   por   Manoj   Srivastava
       <srivasta@debian.org>, para el sistema Debian GNU/Linux.

TRADUCTOR

       Traducción de Rubén Porras Campo <debian-l10n-spanish@lists.debian.org>

Ubuntu manuals