.\" 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 de 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 el 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 definida a No, en ningn
caso se crea el 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 programa 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 --
que podra ser 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 se coloca 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.
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. Tenga en 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 se establece ambas
.B image_dest 
y 
.B link_in_boot (image_in_boot)
, 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. La ruta puede ser relativa si el
programa se encuentra en una ruta segura (es decir, si se localiza en /bin, /sbin,
/usr/bin, o /usr/sbin), o en caso contrario debe ser una ruta absoluta. Antes
de invocar a este programa, debe definir la variable
.B STEM
con el valor del argumento
.I \-\-stem
(o el valor predeterminado, linux). 
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 causarn el fallo de
postinst. Debido a que se est usando debconf antes de que se invoque
al script, ste no debe mostrar mensajes de diagnstico a stdout 
(mientras postinst invoca
.B db_stop
, debconf no restaura stdout, por lo tanto los mensajes a stdout desaparecern).
Puede encontrar un script de ejemplo para usuarios de grub en el directorio
/usr/share/doc/kernel\-package/.
.TP
.B postrm_hook 
Establezca esta variable apuntando a un script que debe ser ejecutado en el postrm 
(es decir, despus de que se haya eliminado la imagen) despus de que se hayan realizado 
todas las acciones. La ruta puede ser relativa si el programa se encuentra en 
una ruta segura (es decir, si se localiza en /bin, /sbin,
/usr/bin, o /usr/sbin), o en caso contrario debe ser una ruta absoluta. 
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, pero deben ser ignorados. Debido a que debconf est en uso antes de
que se invoque el script, ste no debe mostrar mensajes de diagnstico a
stdout (mientras postinst invoca
.B db_stop
, debconf no restaura stdout, por lo tanto los mensajes a stdout desaparecern).
.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. 
 La ruta puede ser relativa si el programa se encuentra en
una ruta segura (es decir, si se localiza en /bin, /sbin,
/usr/bin, o /usr/sbin), o en caso contrario debe ser una ruta absoluta.
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). La ruta puede ser relativa si el 
programa se encuentra en una ruta segura (es decir, si se localiza en /bin, /sbin,
/usr/bin, o /usr/sbin), o en caso contrario debe ser una ruta absoluta.
Este script debe invocarse con dos argumentos, el primero es la
.I versin
de la imagen del ncleo, y el segundo es la
.I localizacin
de la imagen del ncleo. Los errores en el script causarn el fallo de prerm.
Debido a que debconf est en uso antes de que se invoque al script, ste
no deber mostrar mensajes a stdout (mientras postinst invoca
.B db_stop
, debconf no restaura stdout, por lo tanto los mensajes a stdout desaparecern).
.TP
.B ramdisk
Establezca esta variable a una lista de ejecutables separada por espacios que
crean un disco RAM de inicio. Esto tiene efecto nicamente si se instala un
kernel-image (imgen de ncleo) que usa un disco RAM de inicio. Las rdenes
definidas deben ser compatibles con
.I mkinitrd.
Al usar las opciones de lnea de rdenes
.I --supported-host-version
y
.I --supported-target-version,
estos ejecutables se consultan al momento de instalacin para comprobar
si la combinacin del actual ncleo en ejecucin como ncleo anfitrin,
y la versin del ncleo a instalarse como al ncleo destino, y elminados
de la lista si no. La primera herramienta viable se usa para crear el
disco RAM de inicio. La instalacin fallar si no se encuentra una
herramienta utilizable.
Por omisin es definido al conjunto de
.I "mkinitrd mkinitrd.yaird mkinitramfs"
.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. La ruta puede ser relativa si el
programa se encuentra en una ruta segura (es decir, si se localiza en /bin, /sbin,
/usr/bin, o /usr/sbin), o en caso contrario debe ser una ruta absoluta.
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 causarn
el fallo de postinst.
.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. La ruta puede ser 
relativa si el programa se encuentra en una ruta segura (es decir, si se 
localiza en /bin, /sbin, /usr/bin, o /usr/sbin), o en caso contrario debe 
ser una ruta absoluta. 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 warn_reboot
Esta variable se puede utilizar para deshabilitar el aviso cuando se instala
un ncleo de la misma versin que el que est en ejecucin actualmente. Si
se cambia la lista de mdulos, las dependencias de mdulos habrn cambiado,
y los mdulos del nuevo ncleo podran no ejecutarse correctamente en el ncleo
actual si el ABI del ncleo ha cambiado en el intermedio. Es una buena idea
reiniciar, y esto es una nota para recordarle. Si sabe lo que hace puede 
definir esta variable a No. Esta variable est definida por omisin.
.TP
.B do_bootloader
Si es NO, hace que el postinst no ejecute el gestor de arranque.
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
(YES).
.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_src_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 a quienes les molesta 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 (vase 
.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>
Revisin y actualizacin de Rudy Godoy <rudy@kernel\-panik.org>