Apêndice A Referência rápida

Este apêndice resume as diretivas, as funções de manipulação de texto e as variáveis especiais que o make do GNU compreende. Para outras listas, consulte Nomes de alvos especiais embutidos, Catálogo de regras embutidas e Resumo de opções.

A seguir, um resumo das diretivas que o make do GNU reconhece:

define variable

define variable =

define variable :=

define variable ::=

define variable :::=

define variable +=

define variable ?=

endef

Define variáveis de várias linhas.
Consulte Definição de variáveis de várias linhas.

undefine variable

Cancela a definição de variáveis.
Consulte Cancelamento da definição de variáveis.

ifdef variable

ifndef variable

ifeq (a,b)

ifeq "a" "b"

ifeq 'a' 'b'

ifneq (a,b)

ifneq "a" "b"

ifneq 'a' 'b'

else

endif

Avalia parte do makefile de forma condicional.
Consulte Partes condicionais de Makefiles.

include file

-include file

sinclude file

Lê outro makefile.
Consulte Leitura de outros Makefiles.

override variable-assignment

Define uma variável, sobrepondo qualquer definição anterior, mesmo uma fornecida na linha de comando.
Consulte A diretiva override.

export

Instrui o make a exportar todas as variáveis para os processos filhos por padrão.
Consulte Comunicação de variáveis a um sub-make.

export variable

export variable-assignment

unexport variable

Instrui o make sobre exportar ou não uma variável específica para os processos filhos.
Consulte Comunicação de variáveis a um sub-make.

private variable-assignment

Impede que esta atribuição de variável seja herdada pelos pré-requisitos (prerequisite).
Consulte Supressão da herança.

vpath pattern path

Especifica um caminho de busca para arquivos que correspondam a um padrão ‘%’.
Consulte A diretiva vpath.

vpath pattern

Remove todos os caminhos de busca especificados anteriormente para pattern.

vpath

Remove todos os caminhos de busca especificados anteriormente em qualquer diretiva vpath.

A seguir, um resumo das funções embutidas (consulte Funções para transformar texto):

$(subst from,to,text)

Substitui from por to em text.
Consulte Funções para substituição e análise de strings.

$(patsubst pattern,replacement,text)

Substitui as palavras que correspondem a pattern por replacement em text.
Consulte Funções para substituição e análise de strings.

$(strip string)

Remove os caracteres de espaço em branco excedentes de string.
Consulte Funções para substituição e análise de strings.

$(findstring find,text)

Localiza find em text.
Consulte Funções para substituição e análise de strings.

$(filter pattern…,text)

Seleciona as palavras de text que correspondem a uma das palavras pattern.
Consulte Funções para substituição e análise de strings.

$(filter-out pattern…,text)

Seleciona as palavras de text que não correspondem a nenhuma das palavras pattern.
Consulte Funções para substituição e análise de strings.

$(sort list)

Ordena lexicograficamente as palavras de list, removendo duplicatas.
Consulte Funções para substituição e análise de strings.

$(word n,text)

Extrai a n-ésima palavra (com origem em um) de text.
Consulte Funções para substituição e análise de strings.

$(words text)

Conta o número de palavras em text.
Consulte Funções para substituição e análise de strings.

$(wordlist s,e,text)

Retorna a lista de palavras de text, de s até e.
Consulte Funções para substituição e análise de strings.

$(firstword names…)

Extrai a primeira palavra de names.
Consulte Funções para substituição e análise de strings.

$(lastword names…)

Extrai a última palavra de names.
Consulte Funções para substituição e análise de strings.

$(dir names…)

Extrai a parte de diretório de cada nome de arquivo.
Consulte Funções para nomes de arquivos.

$(notdir names…)

Extrai a parte que não é de diretório de cada nome de arquivo.
Consulte Funções para nomes de arquivos.

$(suffix names…)

Extrai o sufixo (o último ‘.’ e os caracteres seguintes) de cada nome de arquivo.
Consulte Funções para nomes de arquivos.

$(basename names…)

Extrai o nome base (o nome sem o sufixo) de cada nome de arquivo.
Consulte Funções para nomes de arquivos.

$(addsuffix suffix,names…)

Acrescenta suffix ao final de cada palavra em names.
Consulte Funções para nomes de arquivos.

$(addprefix prefix,names…)

Antepõe prefix a cada palavra em names.
Consulte Funções para nomes de arquivos.

$(join list1,list2)

Concatena as palavras de duas listas paralelas.
Consulte Funções para nomes de arquivos.

$(wildcard pattern…)

Localiza nomes de arquivos que correspondam a um padrão de nome de arquivo do shell (não um padrão ‘%’).
Consulte A função wildcard.

$(realpath names…)

Para cada nome de arquivo em names, expande para um nome absoluto que não contém nenhum ., .. nem links simbólicos.
Consulte Funções para nomes de arquivos.

$(abspath names…)

Para cada nome de arquivo em names, expande para um nome absoluto que não contém componentes . ou .., mas preserva os links simbólicos.
Consulte Funções para nomes de arquivos.

$(error text…)

Quando esta função é avaliada, o make gera um erro fatal com a mensagem text.
Consulte Funções que controlam o Make.

$(warning text…)

Quando esta função é avaliada, o make gera um aviso com a mensagem text.
Consulte Funções que controlam o Make.

$(shell command)

Executa um comando do shell e retorna sua saída.
Consulte A função shell.

$(origin variable)

Retorna uma string que descreve como a variável variable do make foi definida.
Consulte A função origin.

$(flavor variable)

Retorna uma string que descreve o tipo (flavor) da variável variable do make.
Consulte A função flavor.

$(let var [var ...],words,text)

Avalia text com os var vinculados às palavras de words.
Consulte A função let.

$(foreach var,words,text)

Avalia text com var vinculado a cada palavra de words e concatena os resultados.
Consulte A função foreach.

$(if condition,then-part[,else-part])

Avalia a condição condition; se não for vazia, substitui pela expansão da then-part; caso contrário, substitui pela expansão da else-part.
Consulte Funções para condicionais.

$(or condition1[,condition2[,condition3…]])

Avalia cada condição conditionN uma de cada vez e substitui pela primeira expansão não vazia. Se todas as expansões forem vazias, substitui pela string vazia.
Consulte Funções para condicionais.

$(and condition1[,condition2[,condition3…]])

Avalia cada condição conditionN uma de cada vez; se qualquer expansão resultar na string vazia, substitui pela string vazia. Se todas as expansões resultarem em uma string não vazia, substitui pela expansão da última condition.
Consulte Funções para condicionais.

$(intcmp lhs,rhs[,lt-part[,eq-part[,gt-part]]])

Compara lhs e rhs numericamente; substitui pela expansão de lt-part, eq-part ou gt-part conforme o lado esquerdo seja menor que, igual a ou maior que o lado direito, respectivamente.
Consulte Funções para condicionais.

$(call var,param,…)

Avalia a variável var, substituindo quaisquer referências a $(1), $(2) pelos valores do primeiro, segundo etc. param.
Consulte A função call.

$(eval text)

Avalia text e, em seguida, lê os resultados como comandos de makefile. Expande para a string vazia.
Consulte A função eval.

$(file op filename,text)

Expande os argumentos, depois abre o arquivo filename usando o modo op e escreve text nesse arquivo.
Consulte A função file.

$(value var)

Avalia para o conteúdo da variável var, sem que nenhuma expansão seja realizada sobre ele.
Consulte A função value.

A seguir, um resumo das variáveis automáticas. Para informações completas, consulte Variáveis automáticas.

$@

O nome de arquivo do alvo.

$%

O nome do membro do alvo, quando o alvo é um membro de um arquivo de arquivo (archive).

$<

O nome do primeiro pré-requisito.

$?

Os nomes de todos os pré-requisitos que são mais recentes que o alvo, separados por espaços. Para pré-requisitos que são membros de um arquivo de arquivo, apenas o membro indicado é usado (consulte Usar o make para atualizar arquivos de arquivo).

$^

$+

Os nomes de todos os pré-requisitos, separados por espaços. Para pré-requisitos que são membros de um arquivo de arquivo, apenas o membro indicado é usado (consulte Usar o make para atualizar arquivos de arquivo). O valor de $^ omite pré-requisitos duplicados, enquanto $+ os mantém e preserva sua ordem.

$*

O radical (stem) com o qual uma regra implícita corresponde (consulte Como os padrões correspondem).

$(@D)

$(@F)

A parte de diretório e a parte de arquivo-dentro-do-diretório de $@.

$(*D)

$(*F)

A parte de diretório e a parte de arquivo-dentro-do-diretório de $*.

$(%D)

$(%F)

A parte de diretório e a parte de arquivo-dentro-do-diretório de $%.

$(<D)

$(<F)

A parte de diretório e a parte de arquivo-dentro-do-diretório de $<.

$(^D)

$(^F)

A parte de diretório e a parte de arquivo-dentro-do-diretório de $^.

$(+D)

$(+F)

A parte de diretório e a parte de arquivo-dentro-do-diretório de $+.

$(?D)

$(?F)

A parte de diretório e a parte de arquivo-dentro-do-diretório de $?.

As variáveis a seguir são usadas de forma especial pelo make do GNU:

MAKEFILES

Makefiles a serem lidos a cada invocação do make.
Consulte A variável MAKEFILES.

VPATH

Caminho de busca de diretórios para arquivos não encontrados no diretório atual.
Consulte Caminho de busca VPATH para todos os pré-requisitos.

SHELL

O nome do interpretador de comandos padrão do sistema, normalmente /bin/sh. É possível definir SHELL no makefile para alterar o shell usado para executar as receitas (recipe). Consulte Execução de receitas. A variável SHELL é tratada de forma especial ao importar do ambiente e exportar para ele. Consulte Escolha do shell.

MAKESHELL

Apenas no MS-DOS, o nome do interpretador de comandos a ser usado pelo make. Esse valor tem precedência sobre o valor de SHELL. Consulte variável MAKESHELL.

MAKE

O nome com o qual o make foi invocado. Usar esta variável em receitas tem um significado especial. Consulte Como funciona a variável MAKE.

MAKE_VERSION

A variável embutida ‘MAKE_VERSION’ expande para o número de versão do programa make do GNU.

MAKE_HOST

A variável embutida ‘MAKE_HOST’ expande para uma string que representa o host para o qual o make do GNU foi compilado para ser executado.

MAKELEVEL

O número de níveis de recursão (sub-makes).
Consulte Comunicação de variáveis a um sub-make.

MAKEFLAGS

Os sinalizadores fornecidos ao make. É possível defini-la no ambiente ou em um makefile para definir sinalizadores.
Consulte Comunicação de opções a um sub-make.

Nunca é apropriado usar MAKEFLAGS diretamente em uma linha de receita: seu conteúdo pode não estar corretamente entre aspas para uso no shell. Sempre permita que os make recursivos obtenham esses valores por meio do ambiente, a partir do pai.

GNUMAKEFLAGS

Outros sinalizadores analisados pelo make. É possível defini-la no ambiente ou em um makefile para definir os sinalizadores de linha de comando do make. O make do GNU nunca define esta variável por conta própria. Esta variável só é necessária quando se deseja definir sinalizadores específicos do make do GNU em um makefile compatível com POSIX. Esta variável será vista pelo make do GNU e ignorada por outras implementações de make. Ela não é necessária quando se usa apenas o make do GNU; basta usar MAKEFLAGS diretamente. Consulte Comunicação de opções a um sub-make.

MAKECMDGOALS

Os alvos fornecidos ao make na linha de comando. Definir esta variável não tem efeito sobre a operação do make.
Consulte Argumentos para especificar as metas.

CURDIR

Definida como o nome de caminho absoluto do diretório de trabalho atual (depois de todas as opções -C serem processadas, se houver). Definir esta variável não tem efeito sobre a operação do make.
Consulte Uso recursivo do make.

SUFFIXES

A lista padrão de sufixos antes de o make ler qualquer makefile.

.LIBPATTERNS

Define a nomenclatura das bibliotecas que o make busca e sua ordem.
Consulte Busca em diretórios por bibliotecas de vínculo.