dh_install - instala ficheiros em directórios de compilação
de pacotes
dh_install [
-Xitem] [
--autodest]
[
--sourcedir= directório]
[
opções do debhelper] [
ficheiro|directório ...
directório de destino]
dh_install é um programa debhelper que lida com a
instalação de ficheiros em directórios de
compilação de pacotes. Existem muitos comandos
dh_install* que lidam com a instalação de tipos de
ficheiros específicos como documentação, exemplos,
manuais, e por ai fora, e esses devem ser usados sempre que possível
pois geralmente eles têm inteligência extra para essas tarefas
particulares. Então, o
dh_install é útil para
instalar tudo o resto, para qual não é necessária
inteligência particular. É um substituto do antigo comando
dh_movefiles.
Este programa pode ser usado de uma ou duas maneiras. Se você tem apenas
um ficheiro ou dois que o Makefile do autor não instala por si, pode
correr o
dh_install neles para os mover para a
localização. Por outro lado, talvez você tenha um pacote
grande que compila vários pacotes binários. Você pode
usar o Makefile do autor para os instalar todos em
debian/tmp, e depois
usar o
dh_install para copiar directórios e ficheiros de
lá para para os directórios apropriados de
compilação de pacotes.
Desde nível de compatibilidade 7 do debhelper em diante, o
dh_install irá procurar os ficheiros em
debian/tmp, se
não os encontrar no directório actual (ou onde você o
mandou procurar usando
--sourcedir).
- debian/pacote.install
- Lista os ficheiros a instalar em cada pacote e o
directório onde eles devem ser instalados. O formato é um
conjunto de linhas, onde cada linha lista um ficheiro ou ficheiros a
instalar, e no fim da linha diz o directório onde deverão
ser instalados. O nome dos ficheiros (ou directórios) a instalar
devem ser fornecidos relativamente ao directório actual, enquanto
que o directório de instalação é fornecido
relativamente ao directório de compilação do pacote.
Você pode usar wildcards nos nomes dos ficheiros a instalar.
Note que se você lista exactamente um nome de ficheiro ou um
padrão de wildcard numa linha sozinho, sem um destino
explícito, então o dh_install irá adivinhar
automaticamente o destino a usar, do mesmo modo em que se a
opção --autodest fosse usada.
Suporta variáveis de substituição em compatibilidade 13
e posterior como documentado em debhelper(7).
- debian/not-installed
- Usado com as opções --list-missing e
--fail-missing descontinuadas. Por favor consulte
dh_missing(1) para a documentação deste
ficheiro.
- --list-missing
-
Descontinuado: Por favor use dh_missing
--list-missing em vez deste. Se usar esta opção, o
dh_install irá chamar dh_missing com essa
opção após ter processado todos os ficheiros. Por
favor veja dh_missing(1) para a documentação sobre
esta opção.
Esta opção foi removida no nível de compatibilidade
12.
- --fail-missing
-
Descontinuado: Por favor use dh_missing
--fail-missing em vez deste. Se usar esta opção,
dh_install irá chamar dh_missing com essa
opção após ter processado todos os ficheiros. Por
favor veja dh_missing(1) para a documentação sobre
esta opção.
Esta opção foi removida no nível de compatibilidade
12.
-
--sourcedir=directório
- Procura no directório especificado por ficheiros a
instalar.
Note que isto não é o mesmo que a opção
--sourcedirectory usada pelos comandos dh_auto_*.
Você raramente vai precisar de usar esta opção, pois
o dh_install procura automaticamente por ficheiros em
debian/tmp no nível de compatibilidade 7 e superiores do
debhelper.
- --autodest
- Adivinha o directório de destino para onde instalar
as coisas. Se isto for especificado, você não deve listar
directórios de destino nos ficheiros debian/package.install
nem na linha de comandos. Em vez disso, o dh_install irá
adivinhar no método que se segue:
Despoja debian/tmp (ou o sourcedir se for fornecido um) da frente do
nome de ficheiro, se estiver presente, e instala-lo no nome de
directório do nome de ficheiro. Então, se o nome de ficheiro
for debian/tmp/usr/bin, então esse directório
será copiado para debian/package/usr/. Se o nome de ficheiro
for debian/tmp/etc/passwd, será copiado para
debian/package/etc/.
-
ficheiro|dir ... destdir
- Lista ficheiros (ou directórios) a instalar e onde
os instalar. Os ficheiros serão instalados no primeiro pacote em
que o dh_install actua.
Aqui estão alguns pequenos exemplos de ficheiros de
configuração para dh_install.
# Install my-prog into usr/bin (as "usr/bin/my-prog")
my-prog usr/bin
# Install a plugins directory into usr/share/my-prog
# (as "usr/share/my-prog/plugins/")
plugins usr/share/my-prog
# Install a file with spaces in into usr/share/my-prog/data
# (as "usr/share/my-prog/data/my datafile with spaces.txt")
# ASSUMES COMPAT 13, where substitution patterns are available
my${Space}datafile${Space}with${Space}spaces.txt usr/share/my-prog/data
# Install a library into the multi-arch lib directory
# ASSUMES COMPAT 13, where substitution patterns are available
build/output/libfrop*.so.* usr/lib/${DEB_HOST_MULTIARCH}
dh_install não pode renomear ficheiros ou directórios, pode
apenas instalá-los com os nomes que já têm para onde
você os deseja na árvore de compilação do pacote.
No entanto, o renomear pode ser conseguido ao usar o
dh-exec com
compatibilidade 9 ou posterior. Um ficheiro exemplo debian/
pacote.install que usa o
dh-exec poderá ser parecer com:
#!/usr/bin/dh-exec
debian/default.conf => /etc/my-package/start.conf
Por favor lembre-se das três coisas seguintes:
- •
- O pacote tem se usar nível de compatibilidade 9 ou
superior veja debhelper(7))
- •
- O pacote irá precisar de uma dependência de
compilação em dh-exec.
- •
- O ficheiro install tem de ser marcado como
executável.
debhelper(7)
Este programa é parte do debhelper.
Joey Hess <
[email protected]>
Américo Monteiro
Se encontrar algum erro na tradução deste documento, por favor
comunique para Américo Monteiro
[email protected] ou Equipa
Debian de Tradução Portuguesa
[email protected].