Sintaxe de linha de comando BinPlace

O BinPlace usa a seguinte sintaxe na linha de comando:

    binplace [Options] File [ [Options] [@PlaceFile] File [...] ]

Parâmetros

Opções
Isso pode incluir qualquer uma das opções a seguir. As opções devem ser precedidas por um hífen (-) ou uma barra (/). É possível combinar várias opções após um hífen ou barra, mas as opções que recebem parâmetros adicionais devem ser seguidas por um espaço. Portanto, os dois comandos a seguir são equivalentes:

binplace -q -k -g LCFile -v -s SymbolRoot File 
binplace -qkg LCFile -vs SymbolRoot File 

Estão disponíveis os seguintes comutadores:

-a
Faz com que o BinPlace remova símbolos privados dos arquivos de símbolo quando eles estão sendo colocados. Isso cria arquivos de símbolo removidos que contêm símbolos públicos, mas não símbolos privados. Ao usar a opção -a , você também deve usar -s e -x . Quando -a é usado, os arquivos de símbolo removidos serão colocados no caminho especificado por -sSymbolRoot. Se -nFullSymbolRoot também estiver presente, os arquivos de símbolo completos serão colocados em FullSymbolRoot. Caso contrário, eles não serão colocados em nenhum lugar.

-b Subdiretório Extra
Faz com que o BinPlace coloque arquivos em um local diferente do normal. Depois de concatenar o diretório de destino raiz, o subdiretório de classe e o subdiretório de tipo de arquivo como de costume, o BinPlace acrescentará ExtraSubdirectory a esse caminho para criar o diretório de destino final. ExtraSubdirectory não deve começar nem terminar com uma barra invertida. Consulte Diretórios de destino do BinPlace para obter mais detalhes.

-e
Faz com que o BinPlace continue a execução se um arquivo não puder ser colocado. Por padrão, o BinPlace será encerrado quando esse erro ocorrer.

-f
Força o BinPlace a colocar um arquivo mesmo que ele esteja substituindo um arquivo mais recente. Por padrão, quando o BinPlace tenta colocar um arquivo, ele substitui uma versão mais antiga, mas não substitui uma versão mais recente.

-g LCFile
Faz com que o BinPlace verifique o arquivo executável. LCFile especifica o arquivo de restrição de localização a ser usado para essa verificação.

-h
Faz com que o BinPlace crie links físicos em vez de copiar o arquivo ao inserir arquivos. Essa opção só está disponível no sistema de arquivos NTFS.

-j
Faz com que o BinPlace verifique se os símbolos apropriados existem antes de copiar qualquer arquivo executável. Para que essa opção seja usada, a ferramenta SymChk deve estar em seu caminho. (SymChk faz parte do pacote Ferramentas de Depuração para Windows. Consulte Depuração do Windows para obter detalhes.)

-k
Faz com que o BinPlace preserve os atributos do arquivo. Por padrão, o BinPlace desativará o atributo de arquivo.

-n Raiz_FullSymbol_Root
Especifica o diretório raiz para arquivos de símbolo completos (arquivos de símbolo que contêm símbolos públicos e privados). Isso requer as opções -a, -x e -s também. Consulte Diretórios de destino do BinPlace para obter mais detalhes.

-o Subdiretório raiz
Especifica um subdiretório do diretório de destino raiz a ser usado. Quando o diretório de destino for criado, RootSubdirectory será inserido após o diretório de destino raiz e antes do subdiretório de classe. Consulte Diretórios de destino do BinPlace para obter mais detalhes.

-p Arquivo de Lugar
Especifica o caminho e o nome do arquivo de lugar. Se a opção -p não for usada, o BinPlace usará um local chamado \tools\placefil.txt. Consulte Sintaxe do arquivo de lugar para obter uma explicação do conteúdo de um arquivo de lugar.

Observação A opção -p e os arquivos de lugar agora estão obsoletos e não devem ser usados.

-q
Impede que o BinPlace use um arquivo de log. Se a opção -q for omitida, o arquivo especificado pela variável de ambiente BINPLACE_LOG será usado como o arquivo de log.

-r RootDestinationPath
Especifica o diretório de destino raiz. Se isso for omitido, o padrão será determinado pela variável de ambiente _NT386TREE, _NTIA64TREE ou _NTAMD64TREE em um computador baseado em x86, Itanium ou x64, respectivamente. Consulte Diretórios de destino do BinPlace para obter detalhes.

-s Raiz_de_Símbolo
Especifica o diretório raiz para arquivos de símbolo. Se as opções -a e -x também forem usadas, os símbolos privados serão removidos dos arquivos de símbolo e os arquivos de símbolo removidos serão colocados no diretório especificado por SymbolRoot. Se você deseja colocar arquivos de símbolo removidos e completos, você deve usar -a -x -s SymbolRoot -n FullSymbolRoot. Consulte Diretórios de destino do BinPlace para obter mais detalhes.

-t
Modo de teste. Quando essa opção é usada, nenhum arquivo será copiado, mas o BinPlace exibirá mensagens de aviso e erro como se estivesse colocando arquivos. Você também pode usar a opção -v para aumentar o número de mensagens.

-u
Faz com que o BinPlace acrescente \up ao subdiretório da classe. Isso é útil para separar drivers de uniprocessador (UP). Além disso, sempre que essa opção for usada, o BinPlace não dividirá arquivos executáveis contendo símbolos. Consulte Diretórios de destino do BinPlace para obter mais detalhes.

-v
Modo detalhado. Faz com que o BinPlace exiba mensagens de erro, aviso e progresso mais detalhadas.

-w
Faz com que o BinPlace adicione arquivos de símbolo do Windows 95 (.sym) à árvore de símbolos.

-x
Se o BinPlace encontrar arquivos que usam o sistema de símbolos antigo, essa opção fará com que ele remova todos os símbolos dos arquivos executáveis e mova essas informações para arquivos de símbolo separados. Consulte Sistemas de arquivos de símbolo para obter detalhes. Ao usar a opção -x , você também deve usar -s e -a .

-y
Impede que o BinPlace use qualquer subdiretório de classe. O diretório de destino será criado exclusivamente a partir do diretório de destino raiz mais o subdiretório do tipo de arquivo. Consulte Diretórios de destino do BinPlace para obter detalhes.

-z
Cancela a opção -x . Isso pode ser útil se você estiver usando BinPlace em vários destinos -- você pode usar um comando do formato binplace argumentsTarget1argumentsTarget2, e como a linha de comando é analisada da esquerda para a direita, Target1 e Target2 serão afetados por argumentos diferentes. (Consulte a seção Ordem de análise a seguir). Se uma opção -z for encontrada, isso cancelará o efeito de qualquer opção -x anterior.

-ci ReturnCode,Aplicativo,Argumento,Argumento, ...
Faz com que o BinPlace use um aplicativo personalizado para validar todos os arquivos executáveis. Você pode usar a opção -ci se quiser que o BinPlace use algum outro aplicativo para fazer sua validação.

ReturnCode deve ser o valor que será retornado por esse aplicativo se encontrar um erro em um arquivo executável. Os parâmetros adicionais são usados para iniciar este aplicativo. Todos eles devem ser separados por vírgulas. O aplicativo especifica o nome do programa. Isso pode ser seguido por qualquer número de argumentos de linha de comando. O programa será iniciado com uma linha de comando que inclui Application seguido de todos os argumentos (separados por espaços em vez de vírgulas) e, finalmente, terminando com o nome do arquivo executável a ser verificado.

-:ARCO
Faz com que o BinPlace coloque apenas arquivos cujos atributos de arquivamento estão definidos.

-:D BG
Impede que o BinPlace coloque arquivos .dbg. Se a opção -j também for usada, isso impedirá que o BinPlace coloque binários que apontem para arquivos .dbg. Para que essa opção seja usada, a ferramenta SymChk deve estar em seu caminho. (SymChk faz parte do pacote Ferramentas de Depuração para Windows. Consulte Depuração do Windows para obter detalhes.)

-:D EST ClassPath
Faz com que o BinPlace ignore o arquivo de local e use o ClassPath especificado como o subdiretório da classe. Consulte Diretórios de destino do BinPlace para obter detalhes.

-:LOGPDB
Faz com que o BinPlace inclua os caminhos .pdb completos no arquivo de log.

-:REN NewName
Faz com que o BinPlace renomeie os arquivos que estão sendo colocados. O nome do arquivo original, incluindo a extensão, será substituído por NewName. (Se o arquivo original for um arquivo executável que está sendo dividido, o novo arquivo de símbolo receberá o nome do arquivo original mais a extensão .dbg.)

-:TMF
Faz com que o BinPlace crie um arquivo de formato de mensagem de rastreamento (.tmf) extraindo instruções de formatação de mensagem de rastreamento do arquivo de símbolo PDB. O arquivo TMF será colocado no diretório especificado pela variável de ambiente BinPlace TRACE_FORMAT_PATH. Consulte Macros e variáveis de ambiente do BinPlace.

-ChangeAsmsToRetailForSymbols
Faz com que o BinPlace substitua a cadeia de caracteres "asms" pela cadeia de caracteres "retail" se ela ocorrer no diretório de destino dos arquivos de símbolo. Consulte Diretórios de destino do BinPlace para obter mais detalhes.

Arquivo
Especifica o caminho completo e o nome do arquivo de um arquivo no qual o BinPlace atuará. Você pode listar qualquer número de arquivos, separados por espaços. Se um caminho e um nome de arquivo contiverem um espaço, você deverá colocar o caminho e o nome do arquivo entre aspas.

@Arquivo de Lugar
Se qualquer nome de arquivo for precedido por um sinal de arroba ( @ ), o nome do arquivo representará o nome de um arquivo de lugar. Para obter mais informações, consulte a seção Fornecendo parâmetros em um arquivo a seguir.

Ordem de análise

O BinPlace analisa a linha de comando da esquerda para a direita. Você pode especificar várias opções, depois um parâmetro File , depois novas opções, depois outro parâmetro File e assim por diante. Cada vez que o BinPlace encontrar uma nova opção, ela será adotada, substituindo quaisquer opções contraditórias vistas anteriormente. Sempre que encontrar um especificador de arquivo , ele atuará nesse arquivo usando as opções acumuladas que já encontrou na linha de comando.

Fornecendo parâmetros em um arquivo

É possível passar parâmetros para o BinPlace a partir de um arquivo de texto. Há duas maneiras de fazer isso:

• Você pode especificar um nome de arquivo na variável de ambiente BINPLACE_OVERRIDE_FLAGS. Este arquivo será lido e seu conteúdo usado como parâmetros sempre que o BinPlace for executado. Os parâmetros neste arquivo serão analisados antes dos parâmetros que realmente aparecem na linha de comando do BinPlace.

• Você pode especificar um nome de arquivo na linha de comando do BinPlace prefixando-o com um sinal de arroba ( @ ). Quando o BinPlace vê uma cadeia de caracteres começando com esse sinal em sua linha de comando, ele pega a cadeia de caracteres, remove o sinal de arroba e procura um arquivo com esse nome. Se encontrar esse arquivo, ele inserirá seu texto na linha de comando exatamente no local onde o parâmetro original que começa com o sinal de arroba estava. Como o BinPlace analisa parâmetros da esquerda para a direita, você pode usar essa técnica junto com várias instâncias de File para usar o BinPlace em vários arquivos com opções diferentes para cada um, sem precisar digitar todas as opções a cada vez. (Se esse arquivo não for encontrado, o BinPlace tratará a string original, incluindo o sinal de arroba, como um Parâmetro de arquivo .)