Résumé des options de ligne de commande

Les options de ligne de commande peuvent commencer par les caractères « / » ou « - ».

Utilisation : dotfuscator [options] [fichier_configuration]

Options classiques

Les éléments suivants résument les options de ligne de commande classiques.

Options classiques	Description
/g	Lance l'interface GUI autonome.
/i	Recherche uniquement.
/p=<liste_props>	Spécifie des valeurs pour les propriétés définies par l'utilisateur dans le fichier de configuration. Liste de paires nom-valeur séparées par des virgules (par exemple /p=projectdir=c:\\temp,projectname=MyApp.exe).
/q	Sortie silencieuse.
/v	Sortie des commentaires.
/?	Affiche l'aide.
[fichier_configuration]	Fichier de configuration contenant les options d'exécution.

L'option -v impose à Dotfuscator de fournir des informations sur sa progression lors de l'exécution. Le niveau de détail peut être amené à changer d'une version à l'autre.

L'option -i indique à Dotfuscator qu'il ne doit pas créer de fichiers d'assembly de sortie. Si le fichier de configuration spécifie un fichier de mappage, les résultats de l'exécution s'y trouvent (cette option est pratiquement inutile si aucun fichier de mappage n'est généré).

L'option -q indique à Dotfuscator qu'il doit s'exécuter en totalité sans afficher de sortie. Cela permet l'inclusion dans des séquences de génération d'applications. Cette option remplace le mode Commentaires.

L'option –p indique à Dotfuscator qu'il doit définir des propriétés externes au niveau de la ligne de commande. La définition de ces propriétés remplace celles spécifiées dans la section <properties> du fichier de configuration.

Le paramètre <liste_props> est une liste de paires nom-valeur, séparées par des virgules. Par exemple, la déclaration et l'assignation de propriétés conjointement avec l'option –p peuvent se présenter de la façon suivante :

/p=projectdir=c:\temp,projectname=MyApp

Les propriétés peuvent être précisées entre guillemets si elles contiennent des espaces :

/p=MyProperty="value has spaces"

Les noms des propriétés respectent la casse.

L'option –g indique à Dotfuscator qu'il doit lancer l'interface GUI autonome.

L'option /g n'est pas obligatoire pour Community Edition, car l'interface GUI est lancée quelles que soient les options de ligne de commande.

Vous pouvez démarrer l'interface GUI avec des propriétés externes et un fichier de configuration spécifique, à l'aide de cette option :

Dotfuscator /g /p=projectdir=c:\temp project_template.xml

L'interface GUI démarre également si Dotfuscator est exécuté sans arguments de ligne de commande.

fichier_configuration représente votre fichier de configuration facultatif.

Options étendues

Les options étendues sont conçues pour permettre une obfuscation de base à partir de la ligne de commande, sans que vous soyez obligé de créer au préalable un fichier de configuration. Si vous utilisez un fichier de configuration avec une option de ligne de commande étendue, celle-ci complète ou substitue les commandes du fichier de configuration. Pour plus d'informations, consultez Extension ou substitution d'un fichier de configuration à partir de la ligne de commande.

Les options étendues sont reconnaissables à leurs quatre premiers caractères.

Le tableau suivant résume les options de ligne de commande étendues. Un astérisque désigne le paramètre par défaut si une option manque et si aucun fichier de configuration n'est spécifié.

	Options étendues	Description
	/in <fichier>[,<fichier>]	Permet de spécifier des assemblys d'entrée. La valeur par défaut dépend de l'extension du fichier d'assembly (les fichiers .EXE sont privés ; les fichiers .DLL sont exécutés en mode bibliothèque).
	/out:<répertoire>	Permet de spécifier le répertoire de sortie. La valeur par défaut est « .\Dotfuscated ».
	/honor:[on|off*]	Bascule des directives Honorer les attributs d'obfuscation trouvées pour tous les assemblys d'entrée.
	/strip:[on|off*]	Bascule des directives Éliminer les attributs d'obfuscation pour tous les assemblys d'entrée.
	/makeconfig:<fichier>	Permet d'enregistrer toutes les options d'exécution (de la ligne de commande et du fichier de configuration, le cas échéant) dans <fichier>.
	/disable	Permet de désactiver toutes les transformations indépendamment des autres options.
	/rename:[on|off*]	Permet d'activer ou de désactiver l'attribution d'un nouveau nom.
	/mapout:<fichier>	Permet de spécifier le fichier de mappage de sortie. La valeur par défaut est « .\Dotfuscated\map.xml ».
	/clobbermap:[on|off*]	Permet de spécifier le mode de remplacement du fichier de mappage.
	/keep:[namespace|hierarchy|none*]	Permet de spécifier le schéma d'attribution d'un nouveau nom pour un type.

Exemples :

dotfuscator -in:my.dll

Effectue une obfuscation de my.dll en tant que bibliothèque (symboles visibles conservés et non réduits) avec attribution d'un nouveau nom, flux de contrôle, réduction et chiffrement de chaînes activés. L'assembly de sortie est écrit dans un répertoire appelé .\Dotfuscated ; par ailleurs, le fichier de mappage est écrit dans .\Dotfuscated\map.xml, car aucun répertoire de sortie n'est spécifié.

dotfuscator -in:myapp.exe,private.dll

Effectue une obfuscation conjointe de myapp.exe et de private.dll en tant qu'application autonome. Même les symboles visibles à l'intérieur de la DLL sont obfusqués. La réduction est activée en fonction de la méthode de point d'entrée contenue dans myapp.exe.

dotfuscator -in:myapp.exe -mapo:MyNames.xml

Cette commande effectue une obfuscation de myapp.exe en tant qu'application autonome. Un mappage d'attribution d'un nouveau nom de sortie est spécifié.

© 2002-2007 PreEmptive Solutions. Tous droits réservés.