Diretórios de destino BinPlace

O BinPlace cria uma árvore de diretório para armazenar os arquivos que está colocando. The structure of that tree is determined by the parameters that are passed to BinPlace's command line, the values of certain environment variables, and the contents of a text file known as a place file.

O BinPlace colocará arquivos se uma das duas condições for atendida:

1. O arquivo é especificado na linha de comando BinPlace.

2. O arquivo é um arquivo de símbolo que reside no mesmo diretório que o arquivo executável associado e o arquivo executável é especificado na linha de comando. Nesse caso, o arquivo de símbolo e o arquivo executável serão colocados em diretórios diferentes. O BinPlace também pode executar divisão ou remoção (consulte Símbolos Públicos e Símbolos Privados) ou remoção (consulte Sistemas de Arquivos de Símbolo) neste cenário.

Quando o BinPlace coloca arquivos, ele substitui automaticamente um arquivo mais antigo com o mesmo nome. No entanto, o BinPlace não substituirá, por padrão, um arquivo mais recente. Em particular, se uma versão mais recente (ou idêntica) de um arquivo executável estiver presente, nem o arquivo executável nem os arquivos de símbolo associados serão gravados no disco. If you wish BinPlace to overwrite files regardless of their timestamp, use the -f command-line option.

Destinos de arquivo

O nome do diretório no qual o BinPlace coloca qualquer arquivo especificado em sua linha de comando é criado concatenando dois diretórios: o diretório de destino raiz e o subdiretório de classe. (Os diretórios podem ter qualquer nome escolhido, mas normalmente o diretório de destino raiz é a raiz da árvore de diretório em que você está colocando seus arquivos e o subdiretório de classe é um subdiretório em que parece lógico colocar um arquivo ou grupo específico de arquivos.)

• O diretório de destino raiz pode ser especificado usando o parâmetro de linha de comando -r RootDestinationPath. Se isso for omitido, o padrão será determinado pelo _NT386TREE, _NTIA64TREE ou _NTAMD64TREE variável de ambiente em um computador baseado em x86, baseado em Itanium ou x64, respectivamente. O diretório de destino raiz deve ser definido de uma destas maneiras; se não estiver definido, o BinPlace não será executado.

• O subdiretório de classe geralmente é especificado no arquivo local. É possível especificar vários subdiretórios de classe para um arquivo; isso faz com que o BinPlace faça cópias do arquivo e coloque-as em cada um dos locais especificados. Confira a sintaxe do arquivo Place para obter detalhes completos. O subdiretório de classe também pode ser especificado usando o parâmetro de linha de comando -:D EST ClassPath.

Destinos de arquivo de símbolo

Quando um arquivo executável é listado na linha de comando do BinPlace e há um arquivo de símbolo associado no mesmo diretório, o BinPlace também copiará (ou alterará) o arquivo de símbolo. O diretório no qual esse arquivo de símbolo é colocado é criado concatenando três diretórios: o diretório raiz do símbolo, o subdiretório de classe e o subdiretório do tipo arquivo.

• O diretório raiz do símbolo pode ser especificado usando o parâmetro de linha de comando -s SymbolRoot. If you are using the -a and -x switches, stripped symbol files will be placed under the SymbolRoot directory -- in this case, you can use -n FullSymbolRoot to specify the location of full symbol files.

• O subdiretório de classe geralmente é especificado no arquivo local. É possível especificar vários subdiretórios de classe para um arquivo; isso faz com que o BinPlace faça cópias do arquivo e coloque-as em cada um dos locais especificados. Confira a sintaxe do arquivo Place para obter detalhes completos. O subdiretório de classe também pode ser especificado usando o parâmetro de linha de comando -:D EST ClassPath. And if the -y command-line switch is used, no class subdirectory will be used for symbol files -- the destination directory will simply consist of the symbol root directory plus the file-type subdirectory.

• O subdiretório do tipo arquivo é usado apenas para arquivos de símbolo. Ele é determinado pela extensão de nome de arquivo do arquivo executável original. Assim, arquivos de símbolo associados a arquivos .exe serão colocados em um subdiretório exe, arquivos de símbolo associados a DLLs serão colocados em um subdiretório dll e arquivos de símbolo associados a drivers serão colocados em um subdiretório sys. Essa convenção ajuda a evitar conflitos de nome de arquivo , por exemplo, myprogram.exe e myprogram.dll podem ter arquivos de símbolo chamados myprogram.pdb, mas esses arquivos de símbolo serão colocados em subdiretórios diferentes.

Há uma exceção a esse algoritmo. If neither -s nor -n is supplied, the full symbol files will be placed in the same location as the binaries.

Note If you list the symbol file name in BinPlace's command line, BinPlace will move it like any other file and will not examine its contents. Para usar as técnicas de manipulação de arquivo de símbolo do BinPlace, você deve listar o nome do arquivo executável, não o nome do arquivo de símbolo.