Referência do Utilitário rafmake

A interface para o Build Catalyst é o utilitário make chamado rafmake. A interface tem várias opções que controlam o seu comportamento.

A sintaxe para o comando depende do sistema operacional, conforme mostrado na tabela a seguir.

Tabela 1. Opções por Sistema Operacional
Sistema operacional Opções
Linux e Solaris (Construir um destino.) rafmake [ –f makefile ] ... [ –ukinservwdpqUN ] [ –J num ] [ –B bldhost-file ] [ –c compat-mode ] [ –C change-directory ] [ –A BOS-file ] ... [ macro=value ... ] [ target-name ... ]
Windows (Construir um destino.) rafmake [ –f makefile ] ... [ –ukinservwdpqUN ] [ –J num ] [ –c compat-mode ] [ –C change-directory ] [ –A BOS-file ] ... [ macro=value ... ] [ target-name ... ]
Todos (Exibir informações de versão para o utilitário rafmake.) rafmake { –ver/sion | –VerAll }

Descrições de Opções

O comando rafmake suporta a maioria das opções comuns do comando make do GNU versão 3.80. O comando rafmake também fornece opções adicionais.

Dica: É possível combinar opções que não consideram argumentos, por exemplo, –rNi.
Tabela 2. Descrições de Opções
Opção Descrição
–f makefile Use o makefile como um arquivo de entrada. Se omitir essa opção, o comando rafmake procura por arquivos de entrada nomeados makefile e Makefile (nessa ordem) no diretório ativo atual. É possível especificar mais de um par de argumentos –f makefile . Vários arquivos de entrada são efetivamente concatenados.
–u (Incondicional) Reconstrói todos os destinos especificados e todas as suas dependências, independentemente de se elas precisam ser reconstruídas. (Consulte também –U.)
–k Abandona o trabalho na entrada atual se ela falhar, mas continua em outros destinos que não dependem dessa entrada.
–i Ignora códigos de erro que o comandos retornam.
–n (Sem execução) Lista linhas de comando, incluindo aquelas que começam com um sinal de arroba (@), a partir do makefile para os destinos que precisam se reconstruídos, mas não os executa. Exceção: Um comando que contém a sequência $(MAKE) é sempre executado.
–s (Silencioso) Não lista linhas de comando antes de executá-las.
–e Variáveis de ambiente substituem designações de macro no arquivo makefile. (Porém, designações de macro=value na linha de comandos ou em uma especificação de opções de construção substituem variáveis de ambiente.)
–r (Sem regras) Não usa as regras integradas no arquivo buildcatalyst-home-dir/etc/builtin.mk (Linux e Solaris) ou no arquivo buildcatalyst-home-dir\etc\builtin.mk (Windows). Quando usada com a opção –c , a opção –r também desativa a leitura de arquivos de inicialização específicos de plataforma. Consulte a opção –c para obter informações adicionais.
–v (Detalhado) Um pouco mais detalhado do que o modo de saída padrão.
–w (Diretório ativo) Imprime uma mensagem que contém o diretório ativo antes e depois da execução do makefile.
–d (Depurar) Bastante detalhado e inclui uma lista de variáveis de ambiente que o comando rafmake lê durante a construção. Use essa opção somente ao depurar makefiles.
–p (Imprimir) Lista todas as descrições de destino e todas as definições de macro, incluindo definições de macro específicas de destino e regras implícitas. Não executa nada.
–q

(Consulta) Avalia destinos de makefile, mas não executa os scripts de construção. O comando rafmake retorna uma dessas respostas:

  • 0 se os destinos estão atualizados
  • 1 se quaisquer destinos precisarem ser reconstruídos
–U Incondicionalmente constrói somente destinos de objetivo. Não constrói subdestinos de construção. Se não desejar especificar nenhum destino na linha de comandos, o destino padrão é o objetivo. (A opção –u constrói incondicionalmente ambos, os destinos de objetivo e as dependências de construção.)
–N Desativa o procedimento padrão para leitura de um ou mais arquivos de especificação de opção de construção (BOS).
–J num Ativa o recurso de construção paralela. O número máximo de reconstruções de destino simultâneas é definido para o número inteiro num. Se num=0, a construção paralela é desativada. (Isso é equivalente a não especificar uma opção –J.) De maneira alternativa, é possível especificar num como o valor da variável de ambiente RAFMAKE_CONC.
–B bldhost-file Usa o arquivo bldhost-file como o arquivo hosts de construção para uma construção paralela. Se você não especificar a opção –B, o comando rafmake usa o arquivo .bldhost.$RAFMAKE_HOST_TYPE no seu diretório inicial. Ao usar a opção –B , você também deve usar a opção –J ou ter a variável de ambiente RAFMAKE_CONC definida.
–c compat-mode

(Compatibilidade) Chama o comando rafmake em um modo de compatibilidade.

(De maneira alternativa, é possível usar a variável de ambiente RAFMAKE_COMPAT para especificar um modo de compatibilidade.)

É possível definir a variável compat-mode para um dos seguintes valores:

gnu

Emula o programa make da GNU do Free Software Foundation. Para definir regras de make integradas, o comando rafmakegnubuiltin.mk em vez de builtin.mk.

Esse modo é o modo de compatibilidade padrão.

std
Executa o comando rafmake com o modo de compatibilidade de comando clearmake do IBM Rational® ClearCase® ativado.

Somente em sistemas Linux e Solaris, a variável compat-mode também pode ter um dos seguintes valores. A opção –c é independente da plataforma Linux e Solaris. Porém, alguns modos tentam ler arquivos específicos de sistema; se esses arquivos não existirem, o comando falha.

sun
Emula o comando make(1) padrão que os sistemas SunOS fornecem.
aix
Emula o comando make(1) padrão que os sistemas IBM AIX® fornecem.
–C dir Muda o diretório. O comando rafmake muda para o diretório dir antes de iniciar a construção.
–A BOS-file

Especifica arquivos BOS para serem lidos imediatamente após aqueles que são lidos por padrão. Use essa opção várias vezes para especificar vários arquivos BOS.

Ao usar –N com essa opção, rafmake lê os arquivos BOS especificados em vez dos arquivos BOS padrão.

De maneira alternativa, é possível especificar uma lista de nomes do caminho de arquivo BOS separados por vírgula (Linux e Solaris) ou uma lista separada por ponto e vírgula de nomes do caminho como o valor da variável de ambiente RAFMAKE_OPTS_SPECS.

–ver/sion Imprime informações de versão sobre o comando rafmake.
–VerAll Imprime informações de versão sobre o comando rafmake e as bibliotecas (Linux e Solaris) ou as DLLs (Windows) que o comando rafmake usa.

Feedback