.\" Hey, Emacs! This is an -*- nroff -*- source file.
.\" Copyright (c) 2000 Manoj Srivastava <srivasta@debian.org>
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, write to the Free
.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
.\" USA.
.\"
.\" $Id: kernel-img.conf.es.5,v 1.3 2003/08/08 19:13:57 srivasta Exp $
.\"

.\" (c) 2003 Software in the Public Interest
.\" Esta traduccin ha sido realizada por Rubn Porras <nahoo@inicia.es>
.\" Est basada en la pgina de manual original:
.\" versin 1.10 del CVS de
.\" /cvs/debian-doc/manpages/english/kernel-package/kernel-img.conf.5 
.\" Revisada por Rudy Godoy <rudy@kernel-panik.org>

.TH KERNEL\-IMG.CONF 5 "21 de marzo de 2000" "Debian" "manual Debian GNU/Linux" 
.\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
.\" other parms are allowed: see man(7), man(1)
.SH NOMBRE
kernel\-img.conf \- fichero de configuracin global para paquetes con
imgenes del ncleo
.SH SINOPSIS
.I /etc/kernel\-img.conf
.SH "DESCRIPCIN"
El fichero 
.I /etc/kernel\-img.conf
es un simple fichero que se consulta durante el proceso de post\-instalacin de
la imagen del ncleo y que permite personalizar localmente algunos aspectos de
la instalacin, modificando las opciones predeterminadas de la propia imagen.
.PP
El formato de los valores es una simple pareja
.B VAR = VALOR. 
Los valores booleanos han de especificarse como
.I Yes, True, 1,
y
.I No, False, 0,
teniendo en cuenta las maysculas.
Este fichero se crea automticamente por el script de instalacin si no existe,
al contrario que con el enlace simblico
.I /vmlinuz.
El script pregunta al usuario si se debe de crear el enlace simblico y guarda
la respuesta en
.I /etc/kernel\-img.conf
.PP
En este momento, las variables modificables por el usuario son:
.TP
.B link_in_boot 
Si es Yes en enlace simblico con la imagen llamado
.I vmlinuz 
se crear en 
.I /boot 
en vez de en
.I /.  
El nombre antiguo y confuso image_in_boot es desaconsejado, ya que lo que
se reubica normalmente es el enlace simblico.
Por omisin es No.
.TP
.B do_symlinks
Por omisin, el script de post\-instalacin de la imagen del ncleo crea o
actualiza los enlaces simblicos
.I /vmlinuz
y 
.I /vmlinuz.old.
Esto es cierto si ya existe un enlace
.I /vmlinuz
, sin embargo, en ausencia de ste, el script busca el fichero de configuracin.
Si no existe, el script de configuracin pregunta al usuario si desea crear el
enlace simblico, y guarda la respuesta en el fichero
.I /etc/kernel\-img.conf
recin creado.
Si el fichero de configuracin ya existe, y esta opcin est puesta a NO, nunca
se crea ningn enlace. Esto es para aquellos que no quieran tener enlaces
simblicos molestando en su directorio / . Por omisin es Yes.
.TP
.B minimal_swap
Por omisin, si el enlace simblico /vmlinuz no apunta a una imagen que es la
misma que la imagen instalada, el postinst mueve /vmlinuz a /vmlinuz.old, y crea
un enlace simblico a la imagen del ncleo en /vmlinuz (la excepcin es para
prevenir que /vmlinuz y /vmlinuz.old apunten a la misma imagen del ncleo --
potencialmente desastroso si la imagen actual es defectuosa o le falta
algo). Sin embargo, si la opcin est habilitada, no se realiza ninguna accin si
/vmlinuz.old apunta a la imagen actualmente instalada (por omisin los enlaces
simblicos son intercambiados). Por omisin tiene el valor de No.
.TP
.B no_symlinks
Determina si se usan los enlaces al fichero con la
.I imagen.
Mutuamente excluyente con
.I reverse_symlinks. 
Puede usarse con
.I link_in_boot (image_in_boot).
Si es Yes, la imagen real es colocada en vmlinuz (en vez de en
/boot/vmlinuz\-X.X.XX). Si usa link_in_boot junto con esto, se mueve
/boot/vmlinuz\-X.X.XX a /boot/vmlinuz. El vmlinuz previo se mueve
incondicionalmente a vmlinuz.old. (Normalmente, esto slo se hace si la versin
de la nueva imagen es diferente de la anterior). Esto le restringe a dos
imgenes, a menos que tome acciones adicionales y guarde copias de imgenes
anteriores.
Esto es para aquellos que tienen
.I /boot
en un sistema que no usa los enlaces simblicos (digamos, que usan loadlin
como gestor de arranque). Esto es una chapuza.
Por omisin tiene el valor de No. 
.TP
.B reverse_symlinks
Determina si se usan enlaces simblico invertidos (esto es, el fichero real es
el que no tiene nmero de versin, la versin numerada es el enlace) al fichero
con la 
.I imagen.
Puede ser modificado mediante la variable de entorno
.B REVERSE_SYMLINK
Mutuamente excluyente con
.I no_symlinks.
Se puede usar junto con
.I link_in_boot (image_in_boot).
Igual que
.I no_symlinks, 
excepto porque /boot/vmlinuz\-X.XX es enlazado con la nueva imagen real,
vmlinuz. Esto tambin le restringe a dos imgenes a menos que tome alguna accin
adicional. Los enlaces anteriores quedan colgando. Esto es para aquellos con
.I /boot
en umsdos, y no pueden ver el enlace en dos, pero quieren saber el nmero de la
versin cuando estn en Linux. Esto es una chapuza.
Por omisin tiene el valor de No.
.TP
.B image_dest 
Si quiere que el enlace simblico (o imagen, si 
.B move_image 
est establecida) se guarde en algn sitio distinto de
.I /
establezca esta variable al directorio donde quiera poner el enlace. Dese cuenta
que no es una variable booleana. Puede ser de ayuda para usuarios de
.B loadlin
, que pueden establecer sta y
.B move_image. 
Por omisin es
.I /.
Se puede usar con todas la opciones anteriores excepto con
.B link_in_boot (image_in_boot),
porque no tendra sentido. (Si ambas
.B image_dest 
y 
.B link_in_boot (image_in_boot)
estn establecidas, predomina
.B link_in_boot (image_in_boot)).
.TP
.B postinst_hook 
Establezca esta variable apuntando a un script que debe ser ejecutado durante la
instalacin despus de que se hayan creado todos los enlaces simblicos, pero
antes de invocar el gestor de arranque u ofrecer crear un disquete de
arranque. Este script debe invocarse con dos argumentos, el primero es la
.I versin
de la imagen del ncleo, el segundo es la
.I localizacin
de la imagen del ncleo. Los errores en el script slo producirn un mensaje de
aviso. Un script de ejemplo para usuarios de grub se puede encontrar
en /usr/share/doc/kernel\-package/.
.TP
.B postrm_hook 
Establezca esta variable apuntando a un script que debe ser ejecutado despus de
que se haya eliminado la imagen y despus de que se hayan realizado todas las
acciones. Este script debe invocarse con dos argumentos, el primero es la
.I versin
de la imagen del ncleo, el segundo es la
.I localizacin
de la imagen del ncleo. Los errores en el script slo producirn un mensaje de
aviso.
.TP
.B preinst_hook 
Establezca esta variable apuntando a un script que debe ser ejecutado despus de
desempaquetar el paquete, puede usarse para comprobaciones adicionales. Este
script debe invocarse con dos argumentos, el primero es la
.I versin
de la imagen del ncleo, el segundo es la
.I localizacin
de la imagen del ncleo.
.TP
.B prerm_hook 
Establezca esta variable apuntando a un script que debe de ser ejecutado despus
que los ficheros del paquete hayan sido eliminados (de este modo se
puede eliminar cualquier fichero aadido). Este script debe invocarse con dos
argumentos, el primero es la
.I versin
de la imagen del ncleo, el segundo es la
.I localizacin
de la imagen del ncleo. Los errores en el script slo producirn un mensaje de
aviso.
.TP
.B src_postinst_hook
A diferencia de las otras variables hook, ste es para un script que se ejecuta
durante el postinst de un paquete de documentacin, de cabeceras, o fuente. El
uso de esta variable en paquetes con cabeceras ahora est desaconsejado, en algn
momento el script de postinst del paquete con las cabeceras slo deber ejecutar
header_postinst_hook.
Este script necesita dos argumentos, el primero es el
.I nombre
del paquete que se esta instalando (kernel\-headers\-X.X.XX), y el segundo
argumento es la
.I versin
del paquete que esta siendo instalado. Los errores en el script slo producirn
un mensaje de aviso.
.TP
.B headers_postinst_hook
A diferencia de las otras variables hook, sta es slo para un script que se
ejecuta durante el postinst de un paquete de cabeceras. Este script necesita dos
argumentos, el primero es el
.I nombre
del paquete que se esta instalando (podra ser kernel\-source\-X.X.XX o
kernel\-headers\-X.X.XX), y el segundo argumento es la
.I versin
del paquete que esta siendo instalado. Los errores en el script slo producirn
un mensaje de aviso.
.TP
.B move_image 
En vez de crear el enlace simblico a (o, si 
.B reverse_symlinks 
est establecida, desde)
.B image_dest,
La imagen se mueve desde
.I /boot
a
.B image_dest.
Si 
.B reverse_symlinks 
est establecida
.I /boot
contendr un enlace simblico a la imagen real. 
Esta opcin puede ser til para aquellos que usen loadlin, y que quiz necesiten
mover la imagen a una particin diferente, de dos.
Por omisin esta variable est sin establecer.
.TP
.B clobber_modules
Si est establecida, el preinst tratar de eliminar /lib/modules/version sin
comunicarlo si es la misma versin que la de la imagen siendo instalada. Uselo
bajo su responsabilidad. Por omisin esta variable est sin establecer.
.TP
.B do_boot_enable
Si es NO, deshabilita cualquier intento de crear disquetes de arranque, ejecutar
lilo, etc. Tiene el efecto adicional de que el postinst sea silencioso.
Estableciendo  
.B do_bootfloppy
y 
.B do_bootloader
a NO implica establecer
.B do_boot_enable 
a NO. Por omisin es Yes.
.TP
.B do_bootfloppy
Si es NO, hace que el postinst no cree un disquete de arranque y tampoco
pregunte acerca de ello. El gestor de arranque todava ser ejecutado. Esto
reducir la interaccin de postinst. (Todava pregunta antes de dar formato a
.I /dev/fd0) 
Por omisin es Yes.
.TP
.B do_bootloader
Si es NO, hace que el postinst no ejecute el gestor de arranque. Todava se
preguntar al usuario si desea crear un disquete de arranque a menos que
.B do_bootfloppy
tambin est a NO. Por omisin es Yes.
.TP
.B relative_links
Si es Yes, el script de postinst de la imagen del ncleo tomar medidas
adicionales para que el enlace simblico sea relativo. Normalmente el enlace es
relativo slo si es relativamente fcil saber que el enlace relativo
funcionar. Por omisin es No.
.TP
.B do_initrd
Si es YES el script de postinst de
.I kernel\-image
no avisar de que est instalando un ncleo que usa initrd. Esto asume que ha
configurado correctamente su gestor de arranque para que arranque la imagen
initrd. Por omisin es No. Esta opcin est desaconsejada en favor de la opcin
ms descriptiva
.B warn_initrd
(dese cuenta que el sentido de la opcin es el contrario).
.TP
.B warn_initrd
Si es NO el script de postinst de
.I kernel\-image
no avisar de que est instalando un ncleo que usa initrd. Esto asume que ha
configurado correctamente su gestor de arranque para que arranque la imagen
initrd. Esta opcin se prefiere respecto a
.B do_initrd,
ya que lo que se previene son los
.I avisos.
Por omisin es Yes.
.TP
.B use_hard_links
Esta opcin es para aquellos que no puedan usar enlaces simblicos (por ejemplo,
si el gestor de arranque no los soporta). Si es YES, esto har que el postinst
de la imagen del ncleo use enlaces duros en vez de los enlaces simblicos para
los ficheros /vmlinuz y /vmlinuz.old, manejados automticamente. He tratado de
que sea compatible con
.B move_image
y
.B reverse_symlinks
Precaucin: Es trabajo del usuario final asegurarse de que el directorio
.B image_dest
y el lugar de la imagen (normalmente /boot) se encuentran en el mismo sistema de
ficheros (ya que no se pueden crear enlaces duros entre sistemas de ficheros).
.B Est avisado.
.TP
.B relink_build_link
Esta opcin manipula el enlace de construccin creado por los ncleos
recientes. Si el enlace es un enlace colgante, y si parece que el
correspondiente kernel\-headers est instalado en el sistema, se crear un nuevo
enlace apuntndolo. Por omisin se reenlazar el directorio de construccin
(SI).
.TP
.B force_build_link
Esta opcin manipula el enlace de construccin creado por los ncleos
recientes. Si el enlace es un enlace colgante se crear un nuevo
enlace a /usr/src/kernel\-headers\-X.Y.ZZ, sin importar que estn o no
instalados. Por omisin est sin establecer, ya que no creamos enlaces colgantes
de forma predeterminada.
.TP
.B relink_source_link
Esta opcin manipula el enlace al cdigo fuente creado por los ltimos ncleos.
Si el enlace es un enlace colgante se elimina durante la instalacin.
Por omisin re-enlaza (elimina) el enlace source (YES).
.TP
.B mkimage
Debe ser una orden que produzca una imagen initrd dado un directorio. Se pasa a
la opcin
.I \-m
del programa
.I mkinitrd.
Por ejemplo, puede ser
 mkimage="genromfs -d %s -f %s"
o
 mkimage="mkcramfs %s %s"
.TP
.B silent_modules
Est opcin es para aquellos que se sienten molestos cuando se les avisa de
mdulos existentes en el directorio
.I /lib/modules/$version.
Este directorio probablemente pertenezca a un paquete 
.I kernel\-image\-$version
viejo o que ya no existe, en cuyo caso pueden aparecer problemas con mdulos
que hayan quedado en ese directorio, o puede que el directorio exista
legtimamente porque se haya instalado un paquete independiente con mdulos
para la misma versin del ncleo. En este ltimo caso la existencia del
directorio es totalmente benigna. Si establece esta variable, nunca ms podr
cancelar la instalacin si se detecta previamente un directorio
.I /lib/modules/$version
existente. Por omisin no est establecido.
.TP
.B silent_loader
Si est establecida, est opcin har que se omita la pregunta realizada antes
de ejecutar el gestor de arranque durante el proceso de instalacin. Esta opcin
no afecta a que el gestor de arranque sea o no ejecutado (lea
.B do_bootloader
para entender como controlarlo, la ausencia de un fichero de configuracin har
el proceso de instalacin ameno e interactivo).
.TP
.B ignore_depmod_error
Si est establecida, no pide confirmacin para continuar despus de un problema
con depmod en el script de post\-instalacin. Esto facilita las instalaciones
automatizadas, aunque puede enmascarar algn problema con la imagen del
ncleo. De todas formas todava se muestra un diagnstico. 
.SH FICHEROS
El fichero descrito en este documento es
.I /etc/kernel\-img.conf.
.SH "VASE TAMBIN"
.BR make\-kpkg (1),
.BR kernel\-pkg.conf (5),
.BR make (1),
.B El manual de GNU Make.
.SH FALLOS
No tiene fallos. Cualquier cosa que se lo parezca es un delirio, de verdad.
.SH AUTOR
Esta pgina del manual fue escrita por Manoj Srivastava <srivasta@debian.org>,
para el sistema Debian GNU/Linux.
.SH TRADUCTOR
Traduccin de Rubn Porras Campo <debian\-l10n\-spanish@lists.debian.org>