make-kpkg - Online na nuvem

PROGRAMA:

NOME

make-kpkg - compilar pacotes de kernel Debian a partir de fontes de kernel Linux

SINOPSE

make-kpkg [opções] [alvo [alvo ...]]

DESCRIÇÃO

Esta página do manual explica o Debian make-kpkg utilitário, que é usado para criar o kernel
pacotes Debian relacionados. Este utilitário precisa ser executado a partir de uma fonte de kernel Linux de nível superior
diretório, que foi configurado anteriormente (a menos que você esteja usando o configure
alvo). Normalmente, se o kernel-package não encontrar um .config arquivo no atual
diretório, ele tenta muito obter um apropriado (geralmente um arquivo de configuração já
adaptado para kernels Debian para essa arquitetura), e então chama fazer configuração antiga deixar
o usuário responde a quaisquer novas perguntas. No entanto, isso ainda pode resultar em um
configuração, você é encorajado a configurar o kernel pelos meios usuais antes
invocando make-kpkg.

Tipicamente, make-kpkg deve ser executado sob raiz falsa,

make-kpkg --rootcmd fakeroot kernel_image

mas em vez disso, você executa este comando como root (isso não é recomendado), ou em raiz falsaou
dizer make-kpkg como se tornar root (também não recomendado, raiz falsa é talvez o mais seguro
opção), assim:

make-kpkg --rootcmd sudo kernel_image

O arquivo do pacote Debian é criado no diretório pai do diretório fonte do kernel
onde este comando é executado.

Além disso, observe que algumas versões do gcc não interagem bem com o código-fonte do kernel.
Você pode controlar qual versão do gcc usada na compilação do kernel configurando o Makefile
variáveis ​​CC e HOSTCC no Makefile do kernel de nível superior. Você pode fazer isso simplesmente
definindo a variável de ambiente MAKEFLAGS. Para observar, experimente:

% KBUILD_VERBOSE = 1 MAKEFLAGS = "CC = gcc-4.4" make-kpkg configure

Por favor note que o Makefile do kernel pode prestar atenção a outras variáveis ​​(por exemplo
KCFLAGS ) Isso pode ser resolvido da seguinte forma:

% KBUILD_VERBOSE = 1 MAKEFLAGS = 'CC = gcc-4.4 KCFLAGS = "- março = Athlon64"' make-kpkg configure

A KBUILD_VERBOSE mostra os detalhes dos comandos que estão sendo executados. (por favor, veja o nível superior
kernel Makefile para variáveis ​​que podem ser definidas).

ATENÇÃO: NÃO defina a opção -j em MAKEFLAGS diretamente, isso deve fazer com que a compilação
falhou. Use CONCURRENCY_LEVEL conforme especificado abaixo. Também existe um sinalizador -j que pode ser usado.

OPÇÕES

--Socorro Imprima uma mensagem de uso.

--revisão número
Muda o número da versão dos pacotes produzidos para o argumento número. Este
tem certas restrições: a versão deve começar com um dígito. a versão pode
contêm apenas alfanuméricos e os caracteres ~ +. (til, ponto final e mais) e
deve conter um dígito. (Consulte o manual de políticas para obter detalhes). Opcionalmente, você pode
prefixe a revisão com um dígito seguido de dois pontos (:). O padrão é
10.00. Custom a menos que a variável de ambiente DEBIAN_REVISION_MANDATORY É definido em
caso em que um erro é gerado se a revisão não for definida na linha de comando ou
o arquivo de configuração. Insinuar: Você pode configurá-lo para $ (versão) - no
arquivo de configuração para obter o número da versão upstream anexado ao seu
fragmento .

--append-to-version Foo

--append_to_version Foo
Este argumento (Foo) é anexado ao valor da variável EXTRAVERSION presente
no Makefile do kernel. Uma vez que EXTRAVERSION é um componente da versão do kernel,
também é adicionado ao nome do pacote Debian e, como tal, deve obedecer à política
que rege o nome do pacote. Isso significa que pode conter apenas minúsculas alfanuméricos
e os caracteres ~ - +. (til, ponto final, hífen e mais). Letras maiúsculas
não são permitidos pela Política para um novo pacote. Se a variável de ambiente
IGNORE_UPPERCASE_VERSION está definido, make-kpkg deve colocar números de versão em minúsculas definidos em
o Makefile ou no versão local Arquivo. Esta opção substitui o ambiente
variável APLICATIVOEND_TO_VERSION.

--módulos adicionados Foo

--added_modules Foo
O argumento deve ser uma lista separada por vírgulas de módulos adicionais adicionais (não em
a árvore principal do kernel) que você deseja construir ao invocar o modules_blah
alvos. Você pode fornecer nomes de caminho completos do diretório em que os módulos residem, ou
apenas o nome do módulo se ele puder ser encontrado em MODULE_LOC, cujo padrão é
/ usr / src / modules. O padrão é que todos os módulos em MODULE_LOC, são compilados quando
os destinos modules_blah são chamados.

--arco Foo
Isso é útil para definir a arquitetura durante a compilação cruzada. Se você
não são compilações cruzadas, a arquitetura é determinada automaticamente. O mesmo
efeito pode ser alcançado definindo a variável de ambiente KPKG_ARCH. O valor que
deve ser qualquer coisa DEB_HOST_ARCH_CPU contém quando arquitetura dpkg é executado no
máquina de destino, ou pode ser outra arquitetura em um conjunto multi-arco (como
i386 / amd64).

--compilação cruzada Foo

--cross_compile Foo
Isso é útil para definir a string de destino durante a compilação cruzada. Use o
alvo fictício "-" se você estiver construindo para outros arcos de um conjunto multiarca, como
i386 / amd64. O mesmo efeito pode ser obtido definindo a variável de ambiente.
Por favor note que isto não configura de forma alguma o compilador no processo de construção do kernel
deve usar; se o compilador padrão com o qual o processo de construção vem não for o
desejado, especifique explicitamente o compilador que deve ser usado.
CROSS_COMPILE

--subarca Foo
Algumas arquiteturas (o Alpha e o m68k) requerem um kernel diferente para cada
subarquitetura. Esta opção fornece uma maneira de especificá-lo como um argumento para
make-kpkg. . nota que o suporte adicional para sub-arquiteturas pode ser
requerido nas fontes do kernel para fazer isso realmente fazer qualquer coisa. O mesmo efeito
pode ser alcançado definindo a variável de ambiente KPKG_SUBARCH.

--arch-in-nome

--arch_in_name
Esta opção usa um nome estendido para o pacote de imagem do kernel incorporando o
subarquitetura no nome da imagem, para que se pudesse escrever um script para criar vários
sub-arquiteturas uma após a outra. Você também pode fazer isso definindo o
variável de ambiente ARCH_IN_NAME. . nota que apenas o pacote nome is
afetados, não os locais dos módulos, etc.

--pgpsign nome
Defina a string usada para assinar o alterar arquivo para quaisquer módulos externos em
/ usr / src / modules / usando PGP. Esta opção irá sobrescrever o padrão embutido e o
personalizações em todo o site armazenadas no arquivo /etc/kernel-pkg.conf or
~ / .kernel-pkg.conf.

--config alvo
Altere o tipo de configuração feita a partir do oldconfig padrão. alvo deve ser um
de oldconfig, config, menuconfig, gconfig, nconfig, xconfig, randconfig, defconfig,
allmodconfig, allyesconfig, allnoconfig, old, menu, g ou x.

Note entretanto isso make-kpkg verifica o arquivo de configuração na inicialização para algumas opções,
notavelmente o fato de que os módulos estão habilitados ou não, alternando assim o status durante o
a configuração atrasada resulta em um erro. Se necessário, crie o arquivo de configuração
o mais próximo do desejado antes de chamar make-kpkg com esta opção.

--alvos
Imprime uma lista de alvos conhecidos. Veja a Seção Alvos abaixo.

--noexec
Passe um -n opção para fazer processo para que os comandos sejam meramente impressos no
tela, mas não realmente executado. Isso é muito útil para depuração.

--verbose
Isso chama fazer com a opção -V = 1, que chama os comandos Make de nível superior,
também é útil para ver o que está acontecendo.

--initrd
If make-kpkg está gerando um imagem do kernel pacote, providencie para transportar para o gancho
scripts executados a partir dos scripts do mantenedor pós-instalação que esta imagem requer
an initrde que o initrd scripts de gancho de geração não devem causar curto-circuito
cedo. Sem esta opção, o exemplo initramfs scripts de gancho empacotados com
pacote do kernel não executará nenhuma ação na instalação. O mesmo efeito pode ser
alcançada definindo a variável de ambiente INITRD para qualquer valor não vazio. Por favor
observe que, a menos que haja scripts de gancho em / etc / kernel ou adicionado ao gancho
parâmetro de script de /etc/kernel-img.conf, nenhum initrd será criado (o agrupado em
scripts de exemplo são apenas exemplos - a ação do usuário é necessária antes de qualquer coisa
acontece). Na maioria dos sistemas, no entanto ferramentas initramfs instala scripts (desde a versão
0.94 (e eles respeitaram a variável INITRD desde 0.98)). Dracut também faz
esta.

--empregos número

-j número
Defina a variável de ambiente CONCURRENCY_LEVEL para número.

--overlay-dir / caminho / para / diretório
O diretório especificado deve conter arquivos que serão colocados no ./debian
diretório dos fontes do kernel, em preparação para construir os pacotes debian.
Os arquivos substituirão tudo em / usr / share / kernel-package isso normalmente seria
colocados lá, e cabe ao usuário certificar-se de que os arquivos na sobreposição
diretório são compatíveis com make-kpkg. Se você quebrar make-kpkg com uma sobreposição
arquivo, você consegue manter as peças. O mesmo efeito pode ser alcançado definindo o
variável de ambiente KPKG_OVERLAY_DIR.

Por favor, note que overlay-dir / Control e overlay-dir / changelog são especiais e
a substituição de variável é executada nesses arquivos. Usar
/ usr / share / kernel-package / Control e / usr / share / kernel-package / changelog arquivos como
templates.

Se um overlay-dir / post-install executável (ou script executável) existe, deve ser
correr imediatamente depois ./debian é preenchido. O script deve ser executado no
./debian diretório. Isso pode ser usado, por exemplo, para excluir arquivos que o usuário faz
não deseja, ou tomar outras medidas além da simples substituição.

--rootcmd Foo
O comando que fornece um meio de obter acesso de superusuário (por exemplo, `sudo '
ou `fakeroot ') conforme necessário pela opção -r do dpkg-buildpackage. Esta opção não
trabalhar para três dos alvos, a saber, binário, binário indep e arco binário. Para
esses alvos o todo make-kpkg comando deve ser executado como (falso) root.

--tronco Foo
Ligue para os pacotes Foo- * em vez de kernel- *. Isso é útil para ajudar na transição
de chamar os pacotes kernel- * para linux- *, em preparação para
kernels não-Linux na distribuição. O padrão é linux. O caule, uma vez que é
a parte inicial do nome de um pacote deve consistir apenas em letras minúsculas (`a-z '),
dígitos (`0-9 '), sinais de mais (` +') e menos (`- ') e pontos (`.'). Deve ser em
pelo menos dois caracteres e deve começar com um caractere alfanumérico.

--nós Esta opção é passada para dpkg-buildpackage, e direciona esse pacote para não assinar
a fonte. Isso é relevante apenas para o destino do buildpackage.

--uc Esta opção é passada para dpkg-buildpackage, e direciona esse pacote para não assinar
o changelog. Isso é relevante apenas para o destino do buildpackage.

As opções podem ser encurtadas para a menor string única e podem ser inseridas com qualquer
um prefixo - ou um -, e você pode usar um espaço ou um símbolo = entre uma string de opção e um
valor. Você também pode usar o formulário opção = valor; para obter detalhes estes e outros formulários variantes
suportado, por favor leia Getopt ::longo(3perl).

CONCURRENCY_LEVEL
Se definido, esta variável de ambiente define o nível de simultaneidade de make usado para
compilar o kernel e os módulos configurados usando -j sinalizadores para o sub fazer no construir
alvo de make-kpkg. Deve ser um número inteiro (pequeno), se usado. Você pode obter o atual
número de CPUs usando o comando:

grep -c '^ processador' / proc / cpuinfo

ATENÇÃO: NÃO defina a opção -j em MAKEFLAGS diretamente, isso deve chamar o build
falhar. É possível definir -j como um argumento make-kpkg.

ALVOS

limpar Limpa o diretório de origem do kernel de todos os arquivos criados pelo destino Construir, e executa um
make distclean. (Por favor, veja o Makefile do kernel Linux para detalhes). Observe
que embora cuidemos da lista de configuração do kernel atual contida em
o arquivo .config, o arquivo include / linux / autoconf.h não é preservado. Este alvo
não deve ser combinado com outros alvos, uma vez que make-kpkg lê todos os dados antes
executando qualquer alvo, portanto, os alvos subsequentes devem ser executados com os dados antigos, que
pode não ser o que você deseja. Por favor, note que por padrão o alvo limpo não é executado
como root, o que funciona bem com o comando raiz falsa foi usado. No entanto, se anteriormente
a construção foi feita usando sudo, você precisa correr make-kpkglimpar também sob sudo.

pacote de compilação
Este alvo executa os alvos limpar e binário, e produz o pacote completo
utilização dpkg-buildpackage.

binário Este destino produz todos os quatro pacotes do kernel Debian executando os destinos
binário indep e arco binário. No entanto, isso requer make-kpkg para ser executado como root
(ou fakeroot), uma vez que --rootcmd não funciona.

binário indep
Este alvo produz os pacotes independentes do arco, executando os alvos
fonte_do_kernel, kernel_manual e kernel_doc. No entanto, isso também requer make-kpkg
para ser executado como root (ou fakeroot), uma vez que --rootcmd não funciona.

arco binário
Este alvo produz os pacotes dependentes do arco, executando os alvos
kernel_headers e imagem_do_kernel. No entanto, isso também requer make-kpkg ser executado
como root (ou fakeroot), uma vez que --rootcmd não funciona.

fonte_do_kernel
Este destino produz um pacote debianizado das fontes do kernel do Linux. Se o
variável de ambiente SOURCE_CLEAN_HOOK aponta para um executável, então isso
executável deve ser executado a partir do diretório temporário (topo) das fontes do kernel
pouco antes de embalá-lo, ./debian/tmp-source/usr/src/kernel-source-XXXX, so
as pessoas podem realizar qualquer ação que considerem adequada (remover árvores em arco, podar o controle de versão
diretórios, find . -Tipo d -nome CVS -ameixa seca -Exec rm -rf {} ; etc.). Isso não tem
efeito em qualquer coisa que não seja as fontes do kernel que estão sendo empacotadas - se o
o script opera no diretório atual e seus filhos, a árvore fonte original
deve permanecer intacto. As variáveis ​​de ambiente HEADER_CLEAN_HOOK e
DOC_CLEAN_HOOK são similares. Eles devem apontar para executáveis, então esse executável
deve ser executado a partir do diretório temporário (topo) dos cabeçalhos do kernel e
documentação antes de empacotar, respectivamente, para que as pessoas possam tomar qualquer ação
eles vêem o ajuste. Isso também não tem efeito sobre nada além das fontes que são
sendo embalado.

kernel_debug
Este alvo produz um pacote Debian contendo os símbolos de depuração para o
módulos contidos no pacote de imagem correspondente. A ideia básica aqui é
mantenha o espaço em / lib / modules / sob controle, uma vez que pode ser em uma raiz
partição com restrições de espaço. Por favor nota que se as assinaturas do módulo estiverem habilitadas
na configuração do kernel o pacote de imagem correspondente não terá módulos
com o link de depuração apontando para esses arquivos de símbolo de depuração. A fim de virar
em links de depuração para módulos no pacote de imagem, você precisa desligar o módulo
assinaturas.

kernel_headers
Este destino produz um pacote Debian contendo os arquivos de cabeçalho incluídos no
Kernel do Linux.

kernel_manual
Este alvo produz um pacote Debian contendo as páginas de manual da seção 9
incluído no kernel do Linux. Por favor, note que este não é realmente um independente
alvo; chamar isso também deve invocar o kernel_doc alvo, e cria um
pacote kernel-doc ao mesmo tempo.

kernel_doc
Este alvo produz um pacote Debian contendo a documentação incluída no
Kernel do Linux. Isso pode ser chamado independentemente do kernel_manual alvo, mas não
o contrário.

imagem_do_kernel
Este destino produz um pacote Debian da imagem fonte do kernel Linux, e qualquer
módulos configurados no arquivo de configuração do kernel .config. Se não há
.config arquivo no diretório de origem do kernel, uma configuração padrão é fornecida
semelhante ao usado para criar o Debian boot-floppies. Se o kernel
arquivo de configuração habilitou suporte para módulos, módulos serão criados e
instalado. Se as assinaturas do módulo não estiverem habilitadas, os módulos resultantes terão um
link para a localização do arquivo de símbolos de depuração para o módulo, geralmente
instalado pelo pacote de depuração.

Se o arquivo ./debian/post-install existe, e é um executável, é executado apenas
antes que o pacote da imagem do kernel seja criado. Além disso, observe que se houver
quaisquer scripts em ./debian/image.d/ diretório, partes corridas será chamado naquele
imediatamente antes do pacote de imagem do kernel ser construído. A localização da raiz
do pacote de imagem que está sendo construído deve ser passado na variável de ambiente
IMAGE_TOP, e a versão do kernel é passada por meio da variável de ambiente
versão para todos esses scripts.

Por favor, consulte a documentação sobre ganchos em kernel-img.conf(5). Esses ganchos são
variáveis ​​que podem ser apontadas pelo administrador de sistema local para scripts que adicionam ou removem um
linha da lista de menu grub na instalação e remoção da imagem do kernel vezes. Uma amostra
script para adicionar linhas a um arquivo de menu grub está incluído no diretório
/ usr / share / doc / kernel-package /.

Além das variáveis ​​de gancho que o administrador local pode definir, há um conjunto de
diretórios onde os pacotes, ou o administrador local, podem inserir os arquivos de script. o
diretórios são /etc/kernel/preinst.d/, /etc/kernel/postinst.d/,
/etc/kernel/prerm.d/, /etc/kernel/postrm.d/, /etc/kernel/preinst.d//,
/etc/kernel/postinst.d//, /etc/kernel/prerm.d/ / e
/etc/kernel/postrm.d//. Se eles existirem, o pacote kernel-image deve
executar um partes corridas programa sobre o diretório (incluindo o versionado), dando
a versão sendo instalada ou removida como argumento, na fase correspondente
de instalação ou remoção. Antes de chamar esses scripts, a variável env STEM
deve ser definido para o valor do --tronco argumento (ou o valor padrão, linux), e
a variável KERNEL_PACKAGE_VERSION deve ser definido para a versão do
kernel-package que criou o pacote. Esses scripts devem ser chamados com dois
argumentos, sendo o primeiro o versão da imagem do kernel, e o segundo argumento
sendo o localização da própria imagem do kernel. Uma vez que o debconf está em uso antes do
script é chamado, este script não deve emitir nenhuma mensagem de diagnóstico para stdout -
enquanto o postinst chama db_stop, o debconf não restaura o stdout, então as mensagens
para stdout desaparecer.

Na instalação, também oferece a execução do carregador Linux, LILO (ou alternativos como
carregarlin, SILO, QUIK, VMELILO, ZIP, Yaboot, Stick or GRUB), criando uma configuração
arquivo para carregadores de inicialização compatíveis, se necessário. Naquela época, também se oferece para colocar o
novo kernel em um disquete, formatar o disquete se necessário. Na exclusão, o pacote
verifica a versão do kernel em execução e se recusa a excluir um kernel em execução.
larva classifica uma menção especial aqui, uma vez que o grub pode não precisar ser executado novamente após
instalar uma imagem do kernel, embora uma mudança automática na lista do menu seria
bom na instalação e remoção de pacotes de imagem do kernel.

construir Este alvo, usado por alvo imagem_do_kernel acima, compila a imagem do kernel do Linux.

módulos
Este alvo permite que você construa todos os módulos e pacotes adicionais que são muito
dependente da versão precisa do kernel para a qual eles são compilados ao mesmo tempo que você
construa sua imagem de kernel. Este alvo espera encontrar os módulos ou pacotes em
/ usr / src / modules, e, para todos esses diretórios, muda para MODULE_LOC / x
(MODULE_LOC padrão para / usr / src / modules), e executa o kdist governar no local
debian.rules Arquivo. Este alvo deve criar o Debian pacote (s) de módulo, e pode
também produz um arquivo tar compactado e um arquivo diff compactado, com md5somas
registrado em um arquivo de alterações usando dpkg-genchanges. O arquivo é assinado pelo mesmo
identidade que seria usada para assinar os pacotes do kernel. Esta opção é usada por
mantenedores enviando o pacote para os arquivos do Debian.

module_config
Este alvo permite que você configure todos os pacotes em MODULE_LOC, cujo padrão
para / usr / src / modules. Isso é útil se você precisar modificar manualmente alguns aspectos do
a configuração ou se você deseja compilar manualmente os módulos adicionais. Esse
não deve ser chamado a menos que você já tenha um diretório ./debian.

module_image
Este alvo permite que você construa todos os pacotes sob MODULE_LOC, cujo padrão é
/ usr / src / modules, mas não cria os arquivos fonte ou diff, e não cria
e assine um arquivo de alterações. Esta é a única opção relacionada aos módulos que você precisa se você
deseja apenas compilar os arquivos de imagem dos módulos adicionais para instalação em um ou mais
máquinas. Geralmente chamado em conjunto com imagem_do_kernel, especialmente se também
usando a opção anexar_à_versão (evita avisos falsos). Isso não deveria
ser chamado a menos que você já tenha um diretório ./debian.

module_clean
Este alvo permite que você limpe todos os pacotes sob MODULE_LOC, cujo padrão é
/ usr / src / modules, e isso deve ser tudo o que é necessário para desfazer o efeito de qualquer
dos outros módulos_alvos. Isso não deve ser chamado a menos que você já tenha um
diretório ./debian.

configurar
Este destino executa configure (na verdade, config_target, definido pela --config quais padrões
para configuração antiga) no início, para que você possa editar os arquivos gerados por fazer configuração no kernel
diretório de origem e não tê-los pisoteado por make-kpkg mais tarde.

debian Este alvo cria o ./debian diretório e, opcionalmente, corrige o código-fonte. Esse
alvo é chamado pelo configurar alvo. Você pode usar este alvo para ter o
fontes corrigidas e, em seguida, execute manualmente a etapa de configuração para atualizar o
arquivo de configuração, com quaisquer novas opções de configuração que os patches possam ter
introduzido.

libc-kheaders
Este é um alvo especial para o mantenedor da libc-dev, que pode usá-lo para criar o
pacote de cabeçalhos de que a libc precisa. Observe que é perigoso criar um
pacote libc-kheaders que é diferente dos cabeçalhos com os quais a libc foi compilada; isto
is conhecido para quebrar sistemas sutilmente. Por favor olhe para
/usr/share/kernel-package/README.headers para detalhes. Criação e instalação de um
o pacote libc- kheaders criado por você mesmo pode quebrar seu sistema a menos que você saiba o que
estão fazendo. Você foi avisado.

MEIO AMBIENTE VARIÁVEIS

KPKG_DEBUG, se definido, faz com que make-kpkg cuspa mensagens de depuração sobre algum shell
funções executadas internamente. Isso provavelmente não é do interesse de ninguém que não esteja depurando
make-kpkg. As seguintes variáveis ​​(documentadas acima) também afetam make-kpkg:
DEBIAN_REVISION_MANDATORY, APLICATIVOEND_TO_VERSION, VERSÃO_H_OK, KPKG_ARCH, CROSS_COMPILE,
KPKG_SUBARCH, KPKG_OVERLAY_DIR, ARCH_IN_NAME, INITRD, SOURCE_CLEAN_HOOK, MODULE_LOC,
CONCURRENCY_LEVEL e IGNORE_UPPERCASE_VERSION.

Use make-kpkg online usando serviços onworks.net