Provided by:
kernel-package_11.001_all 
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 modi‐
ficadas con opciones de make-kpkg.
En este momento, las variables modificables por el usuario son:
maintainer
Encargado del paquete local kernel-*. Establecido en la insta‐
lació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 modifi‐
cado mediante la variable de entorno PGP_SIGNATURE, o (de nuevo)
por la opción --pgpsign de make-kpkg. Por omisión es main‐
tainer. (Opcional)
debian La revisión de Debian del paquete con el núcleo. Puede ser modi‐
ficado 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 propor‐
cionará 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 predeter‐
minado /. 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 adi‐
cionales 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 mod‐
ificado mediante la variable de entorno REVERSE_SYMLINK Mutua‐
mente 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 col‐
gando. 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 con‐
strucción hace que se ejecute sobre /usr/src/ker‐
nel-patches/$(architecture)/apply y (afortunadamente) deshaga el
proceso durante la fase de limpieza ejecutando run-parts sobre
/usr/src/kernel-patches/$(architecture)/unpatch. La arquitec‐
tura especial all se usa para parches independientes de la
arquitectura.
config_target
Define el tipo de configuración a usar. Por omisión es oldcon‐
fig, 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 CON
FIG_TARGET modifica éste valor de configuración). Si el valor
de config_target es otro distinto de config, oldconfig, menucon‐
fig 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 supe‐
rusuario (por ejemplo, ‘sudo’ o que dpkg-buildpackages necesita
usando la opción -r. La variable de entorno ROOT_CMD lo modi‐
fica. 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 ejem‐
plo.
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 directo‐
rio 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 subdi‐
rectorios, los directorios originales con las fuentes deben per‐
manecer intactos. De esta forma se facilitan los pequeños reto‐
ques a la imagen del núcleo que ese esté empaquetando.
source_clean_hook
Si apunta a un ejecutable, éste será ejecutado desde el directo‐
rio principal de las fuentes (temporales) del núcleo antes de
que sean empaquetadas, ./debian/tmp-source/usr/src/ker‐
nel-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 mold‐
ear 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 directo‐
rio 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 mold‐
ear 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 directo‐
rio principal de la documentación del núcleo antes de que sea
empaquetada. No tiene efecto sobre otra cosa que no sea la docu‐
mentació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 mold‐
ear 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 com‐
primidos debe de comprimirlos y luego proporcionar la ruta al
fichero comprimido. La variable de entorno EXTRA_DOCS lo modi‐
fica, 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 multi‐
tud 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-arquitec‐
tura 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 predetermina‐
dos.
c) Las variables también se pueden establecer con su correspondi‐
ente 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.
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 <sri‐
vasta@debian.org>, para el sistema Debian GNU/Linux.
TRADUCTOR
Traducción de Rubén Porras Campo <debian-l10n-spanish@lists.debian.org>