table of contents
- buster 12.1.1
- buster-backports 13.3.1~bpo10+1
- testing 13.3.3
- unstable 13.3.4
DH_INSTALL(1) | Debhelper | DH_INSTALL(1) |
NOME¶
dh_install - instala ficheiros em directórios de compilação de pacotesRESUMO¶
dh_install [-Xitem] [--autodest] [--sourcedir=directório] [opções do debhelper] [ficheiro|directório ... directório de destino]DESCRIÇÃO¶
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.
From debhelper compatibility level 7 on, dh_install will fall back to looking in debian/tmp for files, if it does not find them in the current directory (or wherever you've told it to look using --sourcedir).
FICHEIROS¶
- 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.
- debian/not-installed
- Used with the deprecated --list-missing and --fail-missing options. Please refer to dh_missing(1) for the documentation of this file.
OPÇÕES¶
- --list-missing
- Deprecated: Please use dh_missing --list-missing instead. If
you use this option, dh_install will call dh_missing with
that option after it has processed all the files. Please see
dh_missing(1) for the documentation of this option.
This option is removed in compat 12.
- --fail-missing
- Deprecated: Please use dh_missing --fail-missing instead. If
you use this option, dh_install will call dh_missing with
that option after it has processed all the files. Please see
dh_missing(1) for the documentation of this option.
This option is removed in compat 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.
LIMITAÇÕES¶
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.
VEJA TAMBÉM¶
debhelper(7)Este programa é parte do debhelper.
AUTOR¶
Joey Hess <joeyh@debian.org>TRADUÇÃO¶
Américo MonteiroSe encontrar algum erro na tradução deste documento, por favor comunique para Américo Monteiro a_monteiro@gmx.com ou Equipa Debian de Tradução Portuguesa traduz@debianpt.org.
2019-02-23 | 12.1.1 |