Package: kernel-package
Version: 8.134
Severity: wishlist
Tags: patch l10n

Freeze time ;)

please, update this translation.

-- System Information:
Debian Release: 3.1
  APT prefers unstable
  APT policy: (500, 'unstable'), (101, 'experimental')
Architecture: i386 (i686)
Kernel: Linux 2.6.11-1-686
Locale: [EMAIL PROTECTED], [EMAIL PROTECTED] (charmap=UTF-8)

Versions of packages kernel-package depends on:
ii  dpkg                         1.10.27     Package maintenance system for Deb
ii  dpkg-dev                     1.10.27     Package building tools for Debian
ii  gcc [c-compiler]             4:3.3.5-3   The GNU C compiler
ii  gcc-2.95 [c-compiler]        1:2.95.4-22 The GNU C compiler
ii  gcc-3.3 [c-compiler]         1:3.3.5-12  The GNU C compiler
ii  make                         3.80-9      The GNU version of the "make" util
ii  perl                         5.8.4-8     Larry Wall's Practical Extraction 

-- no debconf information
.\" Hey, Emacs! This is an -*- nroff -*- source file.
.\" Copyright (c) 1997 Manoj Srivastava <[EMAIL PROTECTED]>
.\"
.\" 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: make-kpkg.es.8,v 1.3 2003/08/08 19:13:57 srivasta Exp $
.\"

.\" (c) 2003 Software in the Public Interest
.\" Esta traducci�n ha sido realizada por Rub�n Porras Campo <[EMAIL PROTECTED]>
.\" Est� basada en la p�gina de manual original:
.\" versi�n 1.22 del CVS de
.\" /cvs/debian-doc/manpages/english/kernel-package/make-kpkg.8
.\" Revisada por Rudy Godoy <[EMAIL PROTECTED]>

.TH MAKE\-KPKG 1 "14 noviembre de 2002" "Debian" "manual Debian GNU/Linux"
.SH NOMBRE
make\-kpkg \- construye paquetes Debian con n�cleos a partir de las fuentes
.SH SINOPSIS
.B make\-kpkg
.I [opciones]
\&[objetivo [objetivo ...]]
.SH DESCRIPCI�N
Esta p�gina del manual explica la utilidad
.B "make\-kpkg"
, usada para crear paquetes Debian relacionados con el n�cleo. La utilidad debe
ejecutarse desde el directorio superior de las fuentes del n�cleo, el cual ya
debe de haber sido configurado previamente (a menos que se use el objetivo
configure). Normalmente, el programa se ejecuta como superusuario o bajo
.B fakeroot,
sino hay que indicar a
.B make\-kpkg
como convertirse en superusuario, por ejemplo:
.sp 1
.ti +5
make\-kpkg \-\-rootcmd fakeroot kernel_image
.sp 1
El paquete Debian se crea en el directorio padre al directorio donde se ejecute
esta orden.
.PP
Tambi�n, tenga en cuenta que algunas versiones de gcc no interaccionan bien con
las fuentes del n�cleo (gcc 2.95 tiene problemas compilando el n�cleo sin la
opci�n
.I '\-fno\-strict\-aliasing' ).
Este asunto ha sido cuidado en los n�cleos recientes (las series 2.2 y 2.4
est�n bien) (Creo que puede necesitar editar el Makefile para n�cleos
anteriores, o alguna otra cosa). Puede controlar que versi�n se usa para
compilar el n�cleo estableciendo las variables CC y HOSTCC en el Makefile
principal del n�cleo. Puede hacer esto simplemente con
.PP
  % MAKEFLAGS="CC=gcc\-2.95" make\-kpkg ...
.PP
(por favor, lea el Makefile principal para saber que variables pueden establecerse).
.SH OPCIONES
.B \-\-help
Muestra el modo de uso.
.TP
.BR \-\-revision " n�mero"
Cambia el n�mero de revisi�n de los paquetes a
.BR n�mero.
Esto tiene algunas restricciones: la opci�n \-\-revision s�lo tiene efecto en la
fase de configuraci�n (en otras palabras, si existe un fichero llamado
.I stamp\-configure
, esta opci�n no tiene efecto \-\- ejecute 
.B make\-kpkg clean 
o elimine manualmente los ficheros
.I stamp\-configure 
y
.I stamp\-debian
para que tenga efecto \-\- Recomiendo encarecidamente
.B make\-kpkg clean 
a menos que sepa lo que est� haciendo).
Adicionalmente, los paquetes oficiales con las fuentes proporcionan su propio
n�mero de versi�n, por eso,
.B make\-kpkg.
no modifica algunas cosas, incluyendo el n�mero de revisi�n de
.B Debian.
Si quiere cambiar el n�mero de revisi�n de unas fuentes oficiales (esto implica
que existe
.I debian/official
y no est� vac�o), aseg�rese de eliminar
.I debian/official
antes de ejecutar
.B make\-kpkg clean 
para que esta opci�n tenga efecto.
Por eso, si desea volver a ejecutar
.B make\-kpkg 
con un n�mero de versi�n diferente, tiene que asegurarse de hacer borr�n y
cuenta nueva. La versi�n s�lo puede contener caracteres alfanum�ricos y los
caracteres + y . (punto y signo m�s) y debe de contener un d�gito. Consulte las
Normas de Debian (Debian Policy) para m�s detalles.
.I Realmente, esto es mentira: los responsables de los n�cleos y m�dulos
oficiales tienen permiso para usar guiones, pero est� altamente desaconsejado
para la mayor�a de la gente, ya que no hay ning�n tipo de comprobaci�n del n�mero
de versi�n, y dpkg y otros pueden atascar al final de la compilaci�n a menos que
uno sepa lo que est� haciendo. Opcionalmente, puede anteponer a la revisi�n un
d�gito seguido de dos puntos (:). Por omisi�n es
.B 10.00.Custom
a menos que est� establecida la variable de entorno
.B DEBIAN_REVISION_MANDATORY
, en cuyo caso se genera un error si no se especifica un n�mero de versi�n, bien
en la l�nea de �rdenes o bien en el fichero de configuraci�n.
.TP
.BR \-\-append\-to\-version " tal"
.TP
.BR \-\-append_to_version " tal"
Este argumento (
.B tal
) se a�ade al valor de la variable EXTRAVERSION presente en el Makefile del
n�cleo. Dado que EXTRAVERSION es un componente de la versi�n del n�cleo, tambi�n
se a�ade al nombre del paquete, y, como tal, debe de cumplir las normas a las
que est�n sujetos los nombres de los paquetes Debian. Esto quiere decir que s�lo
puede contener caracteres alfanum�ricos en
.B  min�sculas
y los caracteres \- + . (gui�n, signo m�s y punto). Las Normas no permiten
letras may�sculas en los paquetes nuevos. Si la variable de entorno
.B IGNORE_UPPERCASE_VERSION
est� establecida, make-kpkg pasar� a min�sculas los n�meros de versi�n en el
Makefile o en el fichero
.I localversion.
Esto predomina sobre la variable de entorno
.B APPEND_TO_VERSION.
Por favor, dese cuenta que \fB\s\-1debe\s0\fR ejecutar
.B make\-kpkg 
.I clean
despu�s de configurar el n�cleo usando
.I make (x|menu)?config, 
ya que esto crea el fichero
.I include/linux/version.h
.B sin
el contenido de
.I append_to_version
(tal). Este fichero no ser� actualizado por make\-kpkg (make\-kpkg
crea version.h si �ste no existe, pero no lo toca si ya existe),
y el n�cleo final _no_ tendr� el contenido de append_to_version en su n�mero de
versi�n, esto har� que busque los m�dulos y s�mbolos en sitios incorrectos. La
soluci�n mas sencilla es borrar include/linux/version.h despu�s de configurar y
antes de compilar, o ejecutar
.B make\-kpkg clean
despu�s de configurar y antes de compilar.
.B Dese cuenta
de que una vez que use
.BR \-\-append_to_version " tal"
para configurar o construir la imagen del n�cleo, necesita usar la misma opci�n
en ejecuciones posteriores de make\-kpkg (por ejemplo, para construir m�dulos
independientes, o cualquier cosa).
.B make\-kpkg
no recuerda el argumento tal entre ejecuciones (esto es diferente con el
argumento \-\-revision, que si se recuerda). Si le molesta que make\-kpkg se queje
acerca del uso de
.BR \-\-append_to_version 
cuando ya existe un fichero
.T version.h
anterior, puede establecer la variable de entorno
.B VERSION_H_OK
que deber�a parar estos avisos.
.TP
.BR \-\-flavour\ tal
Esta opci�n est� deprecada en favor de
.BR \-\-append_to_version.
Establece el sabor del n�cleo seg�n el argumento \fBtal\fR. El sabor tambi�n es
a�adido al nombre del paquete. Necesita un Makefile parcheado para que esto
funcione apropiadamente (lea /usr/share/doc/kernel\-package/\s\-1Flavours\s0.gz).
S�lo debe de contener caracteres alfanum�ricos en
.B min�sculas
y los caracteres \- + . (gui�n, signo m�s y punto). Las letras en may�sculas no
est�n permitidas. \fB\s\-1NOTA\s0\fR: se desaconsejan los guiones. (Lea el
cap�tulo 4 de las Normas de Debian para m�s detalles). Dese cuenta de que
necesita ejecutar
.B make\-kpkg 
.I clean
.B PRIMERO
si desea recompilar una imagen del n�cleo usando sabores.
.TP
.BR \-\-added\-modules\ tal
.TP
.BR \-\-added_modules\ tal
El argumento debe ser una lista de m�dulos a�adidos separada por comas (que no
est�n en el �rbol principal del n�cleo) que desea construir cuando invoque el
objetivo modules_blah. Debe proporcionar la ruta completa del directorio donde
residen los m�dulos, o s�lo el nombre del m�dulo si se puede encontrar en
.B MODULE_LOC,
que por omisi�n apunta a
.I /usr/src/modules.
Por omisi�n se compilan todos los m�dulos en
.B MODULE_LOC,
cuando se invocan los objetivos modules_blah.
.TP
.BR \-\-added\-patches\ tal
.TP
.BR \-\-added_patches\ tal
El argumento debe de ser una lista separada por comas de parches adicionales
para el n�cleo. Establece autom�ticamente la opci�n de configuraci�n del n�cleo
.I patch_the_kernel
a YES. 
.IP
A diferencia de con los m�dulos, s�lo debe proporcionar la base del nombre (n.t.
del ingl�s basename) (no el nombre completo del fichero con el parche). Por cada
fichero <nombre_parche> en la lista se sigue el siguiente proceso: Si el fichero
se puede encontrar en los directorios
.B ALL_PATCH_DIR/{apply,unpatch}/,
entonces el fichero
.B ALL_PATCH_DIR/apply/<nombre_parche>
se ejecutar� durante la fase de configuraci�n (y presumiblemente esto aplicar�
el parche). Correspondientemente, el fichero
.B ALL_PATCH_DIR/unpatch/<nombre_parche> 
debe de ejecutarse en la fase de borrado. Por omisi�n todos los parches se
aplican invocando los ficheros ejecutables en
.B ALL_PATCH_DIR/apply/
si es requerido (Bien estableciendo la opci�n de configuraci�n
.B patch_the_kernel
o la variable de entorno
.B PATCH_THE_KERNEL
a YES). Dese cuenta de que los parches son DES\-instalados de las fuentes del
n�cleo cuando se ejecuta el objetivo clean. Esto se puede prevenir estableciendo
la variable de entorno
.B NO_UNPATCH_BY_DEFAULT
.IP
Arriba, 
.B ALL_PATCH_DIR
es por omisi�n un subdirectorio de
.I /usr/src/kernel\-patches/.
.IP
Algunas veces puede ser conveniente aplicar los parches cuando uno pide un
parche espec�fico usando esta opci�n, sin necesidad de tener que establecer
expl�citamente la variable de entorno. Puesto que establecer la variable de
entorno
.B PATCH_THE_KERNEL
a YES puede ser peligroso, (puede darse el caso de que apliquen todos los
parches cuando no quer�a aplicar ninguno, y no especific� la opci�n
added_patches), tambi�n puede establecer la variable PATCH_THE_KERNEL a
.I AUTO,
en cuyo caso PATCH_THE_KERNEL ser� establecida a YES por usted cuando invoque
.BR \-\-added\-patches\ tal, 
pero no en otra situaci�n.
Adem�s, dese cuenta que si alg�n parche instala un script en el directorio
.I ./debian/image.d/
, debe de llamarse a 
.B run\-parts
sobre ese directorio nada m�s se construya la imagen del n�cleo. El lugar de
la ra�z del paquete con la imagen siendo construida debe pasarse en la variable
de entorno
.B IMAGE_TOP,
y la versi�n del n�cleo se pasa mediante la variable de entorno
.B version.
De esta forma es posible que un parche inserte ficheros adicionales en la
imagen, por ejemplo.
.IP
Algunos de los paquetes con parches tambi�n tienen en cuenta otras variables de
entorno, esto se documenta en el directorio doc apropiador (por ejemplo, deber�a
mirar en
.I /usr/share/doc/kernel-patch-tal/README-kernelpatch.Debian
si quiere informaci�n adicional para sobre el parche tal).
.TP
.BR \-\-arch\ tal
�til para establecer la arquitectura cuando se est� realizando compilaci�n
cruzada. La arquitectura se detecta autom�ticamente si no est� realizando
compilaci�n cruzada. El mismo efecto se puede conseguir estableciendo la
variable de entorno
.B KPKG_ARCH
.TP
.BR \-\-cross\-compile\ tal
.TP
.BR \-\-cross_compile\ tal
Es �til para definir la cadena de caracteres del objetivo cuando se est�
realizando compilaci�n cruzada. El mismo efecto se puede conseguir estableciendo
la variable de entorno
.B CROSS_COMPILE
.TP
.BR \-\-subarch\ tal
Algunas arquitecturas (Alpha, y m68k) requieren un n�cleo diferente para cada
sub\-arquitectura. Esta opci�n proporciona un modo de especificarlo como
argumento de \fBmake\-kpkg\fR. \fBDese cuenta\fR que se necesita soporte
adicional para sub\-arquitecturas en las fuentes del n�cleo para que esto haga
algo. El mismo efecto se puede conseguir estableciendo la variable de entorno
.B KPKG_SUBARCH
.TP
.BR \-\-arch\-in\-name
.TP
.BR \-\-arch_in_name
Esta opci�n usa un nombre extendido para la imagen del n�cleo empaquetada,
introduciendo la sub\-arquitectura en el nombre de �sta, de este modo se pueden
crear scripts que creen m�ltiples sub\-aquitecturas, una despu�s de otra. El
mismo efecto se puede conseguir estableciendo la variable de entorno
.B ARCH_IN_NAME. 
\fBDese cuenta\fR que s�lo afecta al
.I nombre
del paquete, no a la localizaci�n de los m�dulos y dem�s.
.TP
.BR \-\-pgpsign " nombre"
Establece la cadena a usar para firmar el fichero de
.B cambios
de cada m�dulo externo en
.IR /usr/src/modules/
usando PGP. Esta opci�n no tendr� en cuenta el comportamiento predeterminado ni
la configuraci�n del sistema guardada en
.IR /etc/kernel\-pkg.conf
o
.IR ~/.kernel\-pkg.conf.
.TP
.BR \-\-config " objetivo"
Cambia el tipo de configuraci�n hecha desde el \f(CWoldconfig\fR por omisi�n.
\fIobjetivo\fR debe ser uno de \f(CWoldconfig\fR, \f(CWconfig\fR, \f(CWmenuconfig\fR,
\f(CWgconfig\fR, \f(CWxconfig\fR; o \f(CWold\fR, \f(CWmenu\fR, \f(CWg\fR o \f(CWx\fR.
.Sp
Esta opci�n es particularmente �til cuando se usa \s\-1PATCH_THE_KERNEL\s0 por si
alguno de los parches cambia las opciones de configuraci�n disponibles.
.B Nota
Sin embargo
.BR make\-kpkg
busca al arrancar algunas opciones en el fichero de configuraci�n, notablemente
el hecho de que los m�dulos est�n o no habilitados, de manera que cambiar el
estado durante esta configuraci�n retrasada resulta en un error. Si es
necesario, cree el fichero de configuraci�n lo m�s pr�ximo a lo deseado antes de
llamar a make\-kpkg con esta opci�n.
.TP
.B \-\-targets
Muestra una lista de objetivos conocidos. Lea la secci�n
.B Objetivos
m�s abajo.
.TP
.B \-\-noexec
Pasa la opci�n 
.B \-n
a
.I make
de forma que las �rdenes se muestran en pantalla pero no se ejecutan. �til para
depuraci�n.
.TP 
.B \-\-initrd
Si 
.B make\-kpkg 
est� generando un paquete del tipo
.I kernel\-image 
, realizar� cualquier acci�n necesaria para que el n�cleo se pueda cargar usando
.B initrd.  
.B NOTA:
en los n�cleos antiguos, esto requiere un parche (que no es est�ndar) cramfs de
initrd a las fuentes del n�cleo, (a menos que la configuraci�n del mkinitrd se
haya modificado para no usar cramfs) o se generar� una imagen del n�cleo
imposible de arrancar. El parche normalmente se encontraba en las fuentes del
n�cleo proporcionadas por Debian. Algunas arquitecturas todav�a necesitan
parches para arreglar problemas con cramfs. Esta opci�n puede implicar
dependencias extra y modificaciones en los scripts del encargado del paquete. No
tiene efecto cuando 
.B make\-kpkg no est� generando un paquete 
.I kernel\-image.
El mismo efecto se puede conseguir estableciendo la
variable de entorno
.B INITRD
a cualquier valor no nulo. Esta opci�n provoca un aviso, para evitar el aviso
establezca la variable de entorno
.B INITRD_OK
a cualquier valor no nulo.
Para evitar el aviso en tiempo de instalaci�n, lea kernel\-img.conf(5), y a�ada
una directiva
.I warn_initrd 
en ese fichero. Para configurar initrd consulte
.I mkinitrd (8).
.TP
.B \-\-zimage
Crea una imagen del n�cleo del tipo zImage en vez de bzImage (predeterminada).
�til para gente con problemas con los n�cleos bzImage. 
.TP
.B \-\-bzimage
Crea un n�cleo bzImage. �til para gente que quiera un n�cleo bzImage donde el
n�cleo predeterminado es un zImage. 
.TP
 .B \-\-mkimage
Debe ser una orden que produzca una imagen initrd dado un directorio. Se pasa a
la opci�n
.I \-m
del programa
.I mkinitrd.
Por ejemplo, puede ser
 "genromfs \-d %s \-f %s"
o
 "mkcramfs %s %s"
.TP
.B \-\-rootcmd tal
La orden que proporciona acceso de superusuario (por ejemplo, `sudo' o
`fakeroot'), necesitado por la opci�n \-r de dpkg\-buildpackage.
.TP
.B \-\-us
Esta opci�n se pasa a dpkg\-buildpackage, indica que el paquete no debe firmar
las fuentes. S�lo es relevante para el objetivo buildpackage.
.TP
.B \-\-uc
Esta opci�n se pasa a dpkg\-buildpackage, indica que el paquete no debe firmar el
fichero de cambios (changelog). S�lo es relevante para el objetivo buildpackage.
.PP
Las opciones pueden acortarse a una �nica cadena m�s corta, pudiendo
introducirse adem�s con el prefijo \- o \-\-, entre una opci�n y su valor se
puede usar tanto un espacio como un s�mbolo '='. Tambi�n puede usar la forma
opci�n=valor; para m�s detalles sobre �sta y otras variantes soportadas, lea la
p�gina del manual Getopt::Long (3perl).
.TP
.B CONCURRENCY_LEVEL
Si est� definida, esta variable de entorno establece el nivel de concurrencia
usado por make para compilar el n�cleo y el conjunto de m�dulos, usando la
opci�n
.I \-j
para el make del objetivo
.B build
de
.B make\-kpkg.
Si se usa debe ser un entero (peque�o). Puede obtener el n�mero actual de
procesadores usando la orden:
 "grep -c '^processor' /proc/cpuinfo"
.SH OBJETIVOS
.TP
.B clean
Elimina del directorio con las fuentes del n�cleo todos los ficheros generados
por el objetivo
.B build,
y ejecuta make distclean. (V�a en el Makefile del n�cleo de Linux para m�s
detalles).
Dese cuenta que aunque se preserva la lista de configuraci�n del n�cleo actual
del fichero
.I .config,
no se preserva el fichero
.I include/linux/autoconf.h.
Este objetivo no debe combinarse con otros, ya que
.B make\-kpkg
lee todos los datos
.I antes
de ejecutar cualquier objetivo, lo que hace que los objetivos siguientes se
ejecuten con los datos viejos, algo que probablemente no es lo que desea.
.TP
.B buildpackage
Este objetivo ejecuta los objetivos
.B clean, 
y
.B binary,
para producir el paquete completo usando
.B dpkg\-buildpackage
.TP
.B binary
Este objetivo produce los cuatro paquetes del n�cleo de Debian ejecutando los objetivos
.B kernel_source, kernel_headers, kernel_doc
y
.B kernel_image.
.TP
.B kernel_source
Este objetivo produce un paquete debianizado de las fuentes del n�cleo. Si la
variable de entorno 
.B SOURCE_CLEAN_HOOK
apunta a un ejecutable, �ste se ejecutar� desde el directorio temporal de las
fuentes del n�cleo justo antes de empaquetarlo,
.I ./debian/tmp\-source/usr/src/kernel\-source\-X.X.XX,
de esta forma puede tomar acciones necesarias para ajustar el n�cleo a sus
necesidades (eliminar arquitecturas, borrar los directorios de control de
versiones, 
.I find . \-type d \-name CVS \-prune \-exec rm \-rf {} \\;
etc). No tiene efecto sobre otra cosa que no sean las fuentes del n�cleo que van
a ser empaquetadas \-\- si el script opera en el directorio actual y sus
descendientes las fuentes originales del n�cleo deber�an permanecer
intactas. Las variables de entorno
.B HEADER_CLEAN_HOOK
y
.B DOC_CLEAN_HOOK
son similares. Deber�an apuntar a ejecutables, �stos se ejecutar�
respectivamente desde el directorio temporal de las fuentes del n�cleo justo
antes de empaquetarlo, de esta forma puede tomar acciones necesarias para
ajustar el n�cleo a sus necesidades. S�lo tiene efecto sobre las fuentes que se
est�n empaquetando.
.TP
.B kernel_headers
Este objetivo produce una paquete Debian que contiene las cabeceras del n�cleo
de Linux.
.TP
.B kernel_doc
Este objetivo produce un paquete Debian que contiene la documentaci�n incluida
con el n�cleo de Linux.
.TP
.B kernel_image
Este objetivo produce un paquete Debian con la imagen del n�cleo de Linux y
cualquier m�dulo configurado en el fichero de configuraci�n del n�cleo
.I .config.
Si no hay ning�n fichero
.I .config
en el directorio con las fuentes del n�cleo se proporciona una configuraci�n por
omisi�n parecida a la usada para crear los boot\-floppies de
.B Debian.
.IP
Si existe el fichero
.I ./debian/post\-install
y es ejecutable, �ste se ejecuta justo antes de crear el paquete con la imagen
del n�cleo. Adem�s, tenga en cuenta que si hay alg�n script en el directorio
.I ./debian/image.d/
, 
.B run\-parts 
debe de ser ejecutado en ese directorio justo antes construir el paquete con la
imagen del n�cleo. La localizaci�n de la ra�z del paquete con la imagen que se
est� construyendo debe de pasarse mediante la variable de entorno
.B IMAGE_TOP,
y la versi�n del n�cleo se pasa a trav�s de la variable de entorno
.B version
para todos los scripts.
.IP
En una instalaci�n inicial, el paquete con la imagen actualiza los enlaces
simb�licos en el directorio destino de los enlaces simb�licos (por omisi�n es
el directorio ra�z) para que apunten a la nueva imagen del n�cleo en el
directorio de las im�genes del n�cleo (
.I /boot).
Si el enlace simb�lico ya apunta a la imagen actual del n�cleo no se hace
nada. Si existe un enlace simb�lico anterior, �ste se mueve a un fichero con el
mismo nombre pero con el sufijo .old, y se instala en su lugar un nuevo enlace
simb�lico acorde a la nueva situaci�n (la variable minimal_swap en 
.I /etc/kernel\-img.conf
modifica este comportamiento). No se realiza ninguna actuaci�n en las
actualizaciones.
.IP
Por favor, lea la documentaci�n acerca de enganches en
.B kernel\-img.conf(5).
Estos enganches son variables que pueden apuntar a scripts que a�adan o eliminen
una l�nea a la lista del men� de grub durante la instalaci�n o desinstalaci�n
del n�cleo. Se incluye un script de ejemplo para a�adir l�neas al fichero de
men� de grub en el directorio
.I /usr/share/doc/kernel\-package/.
.IP
Adem�s de las variables de enganche que pueda establecer el administrador local,
hay una serie de directorios en los que los paquetes, o el administrador local,
pueden colocar scripts. Los directorios son
.I /etc/kernel/preinst.d/,
.I /etc/kernel/postinst.d/,
.I /etc/kernel/prerm.d/,
.I /etc/kernel/postrm.d/.
y
.I /etc/kernel/preinst.d/<VERSI�N>/,
.I /etc/kernel/postinst.d/<VERSI�N>/,
.I /etc/kernel/prerm.d/<VERSI�N>/,
.I /etc/kernel/postrm.d/<VERSI�N>/.
Si existen, el paquete kernel-image ejecutar�
.B run-parts
sobre los directorios (incluyendo los que tengan un n�mero de versi�n), usando
la versi�n a instalar o eliminar como argumento, en la fase correspondiente de
la instalaci�n o desinstalaci�n.
.IP
Durante la instalaci�n, tambi�n ofrece ejecutar
.I LILO
(o alternativas como 
.I loadlin, SILO, QUIK, VMELILO, ZIPL, yaboot, PALO 
o 
.I GRUB
), creando un fichero de configuraci�n para los cargadores de arranque si es
necesario. En ese momento tambi�n ofrece poner el nuevo n�cleo en un disquete,
dando formato al disquete si fuese necesario. Cuando se intente eliminar, se
comprobar� la versi�n del n�cleo en ejecuci�n, neg�ndose a desinstalar un n�cleo
en ejecuci�n.
.I grub
se merece una menci�n especial, aunque no necesite ejecutarse despu�s de
instalar la imagen del n�cleo no est� de m�s un cambio autom�tico a su men�
despu�s de instalar o desinstalar un paquete con una imagen del n�cleo.
.TP
.B build
Este objetivo, es usado por el objetivo
.B kernel_image
, compila la imagen del n�cleo de
Linux.
.TP
.B modules
Este objetivo permite construir todos los m�dulos a�adidos y paquetes muy
dependientes de la versi�n del n�cleo para la que han sido compilados al mismo
tiempo que se genera la imagen del n�cleo. Este objetivo espera encontrar los
m�dulos o paquetes bajo /usr/src/modules, y, para todos los subdirectorios,
cambia a MODULE_LOC/x (MODULE_LOC de forma predeterminada es
.I /usr/src/modules
), y ejecuta la regla
.B kdist
en el fichero local 
.I debian.rules.
Este objetivo debe crear uno o varios paquetes
.B Debian
con los m�dulos, y quiz� produzca un fichero tar comprimido, un fichero diff
comprimido, con las sumas
.I md5
guardadas en un fichero de cambios usando
.B dpkg\-genchanges.
El fichero es firmado por la misma identidad que se usa para firmar los paquetes
del n�cleo. Esta opci�n es usada por los responsables  de subir los paquetes a
los archivos de Debian.
.TP
.B modules_config
Este objetivo permite configurar todos los paquetes debajo de
.B MODULE_LOC,
que de forma predeterminada es
.B /usr/src/modules.
Esto es �til si necesita modificar manualmente algunos aspectos de
configuraci�n, o si quiere compilar manualmente los m�dulos a�adidos.
.TP
.B modules_image
Este objetivo permite construir todos los paquetes debajo de
.B MODULE_LOC,
que de forma predeterminada es
.B /usr/src/modules,
pero no crea las fuentes o los ficheros diff, tampoco crea ni firma el fichero
de cambios. �sta es la �nica opci�n relacionada con los m�dulos que necesita si
s�lo quiere compilar los m�dulos para instalarlos en una o m�s m�quinas.
Generalmente se usa junto con 
.B kernel_image,
especialmente si adem�s se usa la opci�n
.B append_to_version
(previene avisos esp�reos).
.TP
.B modules_clean
Este objetivo permite limpiar todos los paquetes bajo
.B MODULE_LOC,
que de forma predeterminada es
.B /usr/src/modules,
deber�a de ser todo lo necesario para deshacer el efecto de cualquiera de los
otros objetivos modules_.
.TP
.B configure
Este objetivo ejecuta pronto la configuraci�n (realmente,
.B config_target,
establecido por 
.B \-\-config 
que por omisi�n es
.I oldconfig
), de forma que pueda editar los ficheros generados por
.B make config
en el directorio de las fuentes del n�cleo y estar seguro de que
.B make\-kpkg 
no los sobreescribir� m�s tarde.
.TP
.B debian
Este objetivo crea el directorio
.I ./debian
, y opcionalmente aplica alg�n parche a las fuentes. Es llamado por el objetivo
.B configure.
Probablemente use este objetivo para aplicar alg�n parche a las fuentes y
despu�s ejecutar manualmente la fase de configuraci�n.
.TP
.B libc\-kheaders
Este es un objetivo especial para el responsable de libc\-dev, puede usarlo para
crear las cabeceras del n�cleo que necesita libc. Por favor, dese cuenta de que
es peligroso crear un paquete libc\-kheaders que sea diferente de las cabeceras
con las que fue compilado libc, se
.B sabe
que puede da�ar sutilmente el sistema. Lea 
.I /usr/share/kernel\-package/README.headers
para m�s detalles. Crear e instalar un paquete de libc\-kheaders personalizado
puede da�ar el sistema y volverlo inusable a menos que sepa lo que est�
haciendo. Est� avisado.
.SH "VARIABLES DE ENTORNO"
Las siguientes variables (documentadas arriba) afectan a 
.B make\-kpkg:
.I DEBIAN_REVISION_MANDATORY
.I APPEND_TO_VERSION
.I VERSION_H_OK
.I PATCH_THE_KERNEL
.I NO_UNPATCH_BY_DEFAULT
.I KPKG_ARCH
.I CROSS_COMPILE
.I KPKG_SUBARCH
.I ARCH_IN_NAME
.I INITRD
.I SOURCE_CLEAN_HOOK
.I MODULE_LOC
.I INITRD_OK
.I CONCURRENCY_LEVEL
.I IGNORE_UPPERCASE_VERSION
.SH FICHEROS
Aparte de las opciones de ejecuci�n, el fichero 
.I debian.rules
ejecutado por
.B make\-kpkg
tambi�n busca el fichero de configuraci�n de usuario
.I ~/.kernel\-pkg.conf.
Si no lo encuentra, busca el fichero de configuraci�n global del sistema
.I /etc/kernel\-pkg.conf.
La configuraci�n predeterminada permite que haya un predominio para el
nombre completo y la direcci�n de correo electr�nico de la persona responsable
de mantener los paquetes en el sitio, pero el fichero
.I /etc/kernel\-pkg.conf
(o
.I ~/.kernel\-pkg.conf.
) es realmente un peque�o Makefile, se puede incluir cualquier directiva v�lida
de make.  
.B Nota:
Se debe de tener mucho cuidado con este fichero, usted puede cambiar totalmente
el modo en que se ejecuta make editando este fichero. Por favor, lea
.I /usr/share/doc/kernel\-package/Problems.gz
para ver una lista de problemas conocidos compilando im�genes del n�cleo. Un
tutorial extensivo se encuentra disponible como documentaci�n en
.I /usr/share/doc/kernel\-package/README.gz
y es recomendable que uno lo lea antes de usar esta utilidad.
.SH "V�ASE TAMBI�N"
.BR kernel\-pkg.conf (5),
.BR kernel\-img.conf (5),
.BR mkinitrd (8),
.BR Getopt::Long (3perl),
.BR dpkg\-deb (1),
.BR dpkg\-source (1),
.BR make (1),
.BR The\ Programmers\ manual, 
.BR El\ manual\ de\ GNU\ Make\,
y la extensiva documentaci�n en el directorio
.B /usr/share/doc/kernel\-package
.SH AUTOR
Esta p�gina del manual fue escrita por Manoj Srivastava <[EMAIL PROTECTED]>,
para el sistema Debian GNU/Linux.
.SH TRADUCTOR
Traducci�n de Rub�n Porras Campo <[EMAIL PROTECTED]>

Reply via email to