Partager via

Syntaxe de ligne de commande BinPlace

  • Article

BinPlace utilise la syntaxe suivante à la ligne de commande :

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

Paramètres

Options
Cela peut inclure l’un des commutateurs suivants. Les commutateurs doivent être précédés d’un trait d’union (-) ou d’une barre oblique (/). Il est possible de combiner plusieurs options après un trait d’union ou une barre oblique, mais les options qui prennent des paramètres supplémentaires doivent être suivies d’un espace. Ainsi, les deux commandes suivantes sont équivalentes :

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

Les commutateurs suivants sont disponibles :

-a
Fait en sorte que BinPlace supprime les symboles privés des fichiers de symboles lorsqu’ils sont placés. Cela crée des fichiers de symboles supprimés qui contiennent des symboles publics, mais pas des symboles privés. Lorsque vous utilisez le commutateur -a , vous devez également utiliser -s et -x . Lorsque -a est utilisé, les fichiers de symboles supprimés sont placés dans le chemin spécifié par -sSymbolRoot. Si -nFullSymbolRoot est également présent, les fichiers de symboles complets sont placés dans FullSymbolRoot. Sinon, ils ne seront pas placés n’importe où.

-b ExtraSubdirectory
Fait en effet que BinPlace place les fichiers dans un autre emplacement que d’habitude. Après avoir concaténé le répertoire de destination racine, le sous-répertoire de classe et le sous-répertoire de type fichier comme d’habitude, BinPlace ajoute ensuite ExtraSubdirectory à ce chemin pour créer le répertoire de destination final. ExtraSubdirectory ne doit ni commencer ni se terminer par une barre oblique inverse. Pour plus d’informations, consultez les répertoires de destination BinPlace.

-e
Provoque la poursuite de l’exécution de BinPlace si un fichier ne peut pas être placé. Par défaut, BinPlace se ferme lorsque cette erreur se produit.

-f
Force BinPlace à placer un fichier même s’il remplace un fichier plus récent. Par défaut, lorsque BinPlace tente de placer un fichier, il remplace une version antérieure, mais ne remplace pas une version plus récente.

-g LCFile
Provoque la vérification du fichier exécutable par BinPlace. LCFile spécifie le fichier de contrainte de localisation à utiliser pour cette vérification.

-h
Fait en sorte que BinPlace crée des liens durs au lieu de copier le fichier lors du placement de fichiers. Cette option est disponible uniquement sur le système de fichiers NTFS.

-j
Force BinPlace à vérifier que les symboles appropriés existent avant de copier les fichiers exécutables. Pour que cette option soit utilisée, l’outil SymChk doit se trouver dans votre chemin d’accès. (SymChk fait partie du package Outils de débogage pour Windows. Pour plus d’informations, consultez Débogage Windows.)

-k
Permet à BinPlace de conserver les attributs de fichier. Par défaut, BinPlace désactive l’attribut d’archive.

-n FullSymbolRoot
Spécifie le répertoire racine des fichiers de symboles complets (fichiers de symboles qui contiennent à la fois des symboles publics et privés). Cela nécessite également les commutateurs -a, -x et -s . Pour plus d’informations, consultez les répertoires de destination BinPlace.

-o RootSubdirectory
Spécifie un sous-répertoire du répertoire de destination racine à utiliser. Lorsque le répertoire de destination est créé, RootSubdirectory est inséré après le répertoire de destination racine et avant le sous-répertoire de classe. Pour plus d’informations, consultez les répertoires de destination BinPlace.

-p PlaceFile
Spécifie le chemin d’accès et le nom du fichier de place. Si le commutateur -p n’est pas utilisé, BinPlace utilise un emplacement nommé \tools\placefil.txt. Pour obtenir une explication du contenu d’un fichier place, consultez La syntaxe de fichier place.

Notez que le commutateur -p et les fichiers de place sont désormais obsolètes et ne doivent pas être utilisés.

-q
Empêche BinPlace d’utiliser un fichier journal. Si le commutateur -q est omis, le fichier spécifié par la variable d’environnement BINPLACE_LOG est utilisé comme fichier journal.

-r RootDestinationPath
Spécifie le répertoire de destination racine. Si cela est omis, la valeur par défaut est déterminée par les _NT386TREE, les _NTIA64TREE ou _NTAMD64TREE variable d’environnement sur un ordinateur x86, Itanium ou x64, respectivement. Pour plus d’informations, consultez les répertoires de destination BinPlace.

-s SymbolRoot
Spécifie le répertoire racine des fichiers de symboles. Si les commutateurs -a et -x sont également utilisés, les symboles privés sont supprimés des fichiers de symboles, et les fichiers de symboles supprimés sont placés dans le répertoire spécifié par SymbolRoot. Si vous souhaitez placer à la fois des fichiers de symboles supprimés et complets, vous devez utiliser -a -x -s SymbolRoot -n FullSymbolRoot. Pour plus d’informations, consultez les répertoires de destination BinPlace.

-t
Mode de test. Lorsque ce commutateur est utilisé, aucun fichier n’est copié, mais BinPlace affiche les messages d’avertissement et d’erreur comme s’il plaçant des fichiers. Vous pouvez également utiliser le commutateur -v pour augmenter le nombre de messages.

-u
Force BinPlace à ajouter \up au sous-répertoire de classe. Cela est utile pour séparer les pilotes uniprocesseur (UP). En outre, chaque fois que ce commutateur est utilisé, BinPlace ne fractionne pas les fichiers exécutables contenant des symboles. Pour plus d’informations, consultez les répertoires de destination BinPlace.

-v
Mode détaillé. Provoque l’affichage des messages d’erreur, d’avertissement et de progression plus détaillés de BinPlace.

-w
Provoque l’ajout de fichiers de symboles Windows 95 (.sym) à l’arborescence de symboles.

-x
Si BinPlace rencontre des fichiers qui utilisent l’ancien système de symboles, ce commutateur l’entraîne à supprimer tous les symboles des fichiers exécutables et à déplacer ces informations vers des fichiers de symboles distincts. Pour plus d’informations, voir Systèmes de fichiers de symboles. Lorsque vous utilisez le commutateur -x , vous devez également utiliser -s et -a .

-y
Empêche BinPlace d’utiliser des sous-répertoires de classe. Le répertoire de destination est créé uniquement à partir du répertoire de destination racine, ainsi que du sous-répertoire de type fichier. Pour plus d’informations, consultez les répertoires de destination BinPlace.

-z
Annule le commutateur -x . Cela peut être utile si vous utilisez BinPlace sur plusieurs cibles : vous pouvez utiliser une commande des arguments binplace de formulaireTarget1argumentsTarget2, et étant donné que la ligne de commande est analysée de gauche à droite, Target1 et Target2 sera affectée par différents arguments. (Consultez la section Analyse de l’ordre ci-dessous). Si un commutateur -z est rencontré, cela annule l’effet d’un commutateur -x précédent.

-ci ReturnCode, Application, Argument, Argument, ...
Entraîne l’utilisation d’une application personnalisée pour valider tous les fichiers exécutables. Vous pouvez utiliser le commutateur -ci si vous souhaitez que BinPlace utilise une autre application pour effectuer sa validation.

ReturnCode doit être la valeur qui sera retournée par cette application s’il trouve une erreur dans un fichier exécutable. Les paramètres supplémentaires sont utilisés pour lancer cette application. Elles doivent toutes être séparées par des virgules. L’application spécifie le nom du programme. Cela peut être suivi de n’importe quel nombre d’arguments de ligne de commande. Le programme est démarré avec une ligne de commande qui inclut l’application suivie de tous les arguments (séparés par des espaces plutôt que des virgules) et se terminant enfin par le nom du fichier exécutable à vérifier.

-:ARC
Force BinPlace à placer uniquement des fichiers dont les attributs d’archivage sont définis.

-:D BG
Empêche BinPlace de placer des fichiers .dbg. Si le commutateur -j est également utilisé, cela empêche BinPlace de placer des fichiers binaires pointant vers des fichiers .dbg. Pour que cette option soit utilisée, l’outil SymChk doit se trouver dans votre chemin d’accès. (SymChk fait partie du package Outils de débogage pour Windows. Pour plus d’informations, consultez Débogage Windows.)

-:D EST, ClassPath
Force BinPlace à ignorer le fichier place et à utiliser le ClassPath spécifié comme sous-répertoire de classe. Pour plus d’informations, consultez les répertoires de destination BinPlace.

- :LOGPDB
Permet à BinPlace d’inclure les chemins d’accès .pdb complets dans le fichier journal.

- :REN NewName
Provoque le changement de nom des fichiers binPlace. Le nom de fichier d’origine, y compris l’extension, sera remplacé par NewName. (Si le fichier d’origine est un fichier exécutable en cours de fractionnement, le nouveau fichier de symboles reçoit le nom de fichier d’origine et l’extension .dbg.)

- :TMF
Permet à BinPlace de créer un fichier de format de message de trace (.tmf) en extrayant les instructions de mise en forme des messages de trace à partir du fichier de symboles PDB. Le fichier TMF est placé dans le répertoire spécifié par la variable d’environnement BinPlace TRACE_FORMAT_PATH. Consultez macros BinPlace et variables d’environnement.

-ChangeAsmsToRetailForSymbols
Provoque le remplacement de la chaîne « asms » par la chaîne « retail » si elle se produit dans le répertoire de destination pour les fichiers de symboles. Pour plus d’informations, consultez les répertoires de destination BinPlace.

Fichier
Spécifie le chemin d’accès complet et le nom de fichier d’un fichier sur lequel BinPlace agit. Vous pouvez répertorier n’importe quel nombre de fichiers, séparés par des espaces. Si un chemin d’accès et un nom de fichier contient un espace, vous devez placer le chemin d’accès et le nom de fichier entre guillemets.

@PlaceFile
Si un nom de fichier est précédé d’un signe à signe ( ), @ le nom du fichier représente le nom d’un fichier de lieu. Pour plus d’informations, consultez la section Paramètres d’approvisionnement dans une section Fichier suivante.

Ordre d’analyse

BinPlace analyse la ligne de commande de gauche à droite. Vous pouvez spécifier plusieurs options, puis un paramètre File , puis de nouvelles options, puis un autre paramètre File , etc. Chaque fois que BinPlace rencontre une nouvelle option, elle sera adoptée, remplaçant toutes les options contradictoires précédemment vues. Chaque fois qu’il rencontre un spécificateur de fichier, il agit sur ce fichier à l’aide des options accumulées qu’il a déjà rencontrées sur la ligne de commande.

Fourniture de paramètres dans un fichier

Il est possible de passer des paramètres à BinPlace à partir d’un fichier texte. Il existe deux façons d'effectuer cette opération :

  • Vous pouvez spécifier un nom de fichier dans la variable d’environnement BINPLACE_OVERRIDE_FLAGS. Ce fichier est lu et son contenu est utilisé comme paramètres chaque fois que BinPlace est exécuté. Les paramètres de ce fichier sont analysés avant les paramètres qui apparaissent réellement sur la ligne de commande BinPlace.

  • Vous pouvez spécifier un nom de fichier sur la ligne de commande BinPlace en le préfixant avec un signe ( @ ). Lorsque BinPlace voit une chaîne commençant par cette connexion sur sa ligne de commande, elle prend la chaîne, supprime le signe au niveau du signe, puis recherche un fichier portant ce nom. S’il trouve ce fichier, il insère son texte dans la ligne de commande exactement à l’endroit où le paramètre d’origine commençant par le signe a été. Étant donné que BinPlace analyse les paramètres de gauche à droite, vous pouvez utiliser cette technique avec plusieurs instances de Fichier pour utiliser BinPlace sur plusieurs fichiers avec différentes options pour chacun, sans avoir à taper toutes les options à chaque fois. (Si ce fichier n’est pas trouvé, BinPlace traite la chaîne d’origine, y compris le signe au format a Paramètre de fichier .)