コマンド ライン オプションの概要
コマンド ライン オプションのプレフィックスとして、ハイフン (-) またはスラッシュ (/) を付けます。
使用法:dotfuscator [options] [config_file]
既存のオプション
以下に、既存のコマンド ライン オプションの概要を示します。
| 既存のオプション | 説明 |
|---|---|
| /g | スタンドアロン GUI を起動する。 |
| /i | 調査のみを実行する。 |
| /p=<property list> | 構成ファイルでユーザーが定義したプロパティの値を指定する。プロパティ リストには、名前と値のペアのリストをカンマで区切って記述する。 (例 : /p=projectdir=c:\\temp,projectname=MyApp.exe) |
| /q | メッセージを何も出力しない。 |
| /v | 詳細な情報を出力する。 |
| /? | ヘルプを表示する。 |
| [config_file] | 実行時オプションが記述されている構成ファイルを指定する。 |
-v オプションを指定すると、実行中に処理の進行状況に関する情報が表示されます。このオプションで表示される情報の詳細レベルは、Dotfuscator のリリースによって異なる可能性があります。
-i オプションは、Dotfuscator に対して、出力アセンブリ ファイルを一切作成しないように指示します。構成ファイルによって割り当てファイルが指定されている場合、実行の結果はその割り当てファイルに格納されます (割り当てを生成しないでこのオプションを指定することはほとんど無意味です)。
-q オプションは、Dotfuscator に対して、出力をまったく表示しないで実行するように指示します。このオプションは、Dotfuscator をアプリケーションのビルド工程に組み込んで使用する場合に適しています。このオプションを指定すると、詳細出力モードはオーバーライドされます。
p オプションは、コマンド ラインで外部プロパティの値を設定するために使用します。コマンド ラインでプロパティの値を設定すると、構成ファイルの <properties> セクションで指定したプロパティの設定はオーバーライドされます。
<proplist> には名前と値のペアのリストをカンマで区切って記述します。p オプションによるプロパティの宣言と値の割り当ては、たとえば次のような形で指定します。
/p=projectdir=c:\temp,projectname=MyApp
プロパティ値にスペースが含まれている場合は、次の例のように引用符で囲んで指定します。
/p=MyProperty="value has spaces"
プロパティの名前では大文字と小文字が区別されます。
-g オプションは、Dotfuscator に対して、スタンドアロン GUI を起動するように指示します。
.jpg "ms227238.ce(ja-jp,VS.90).jpg")
Community Edition では、コマンド ライン オプションに関係なく GUI は常に起動されるため、/g オプションは必要ありません。
このオプションを使用する際は、次のように -p オプションを併用することにより、外部プロパティや特定の構成ファイルを指定して GUI を起動することができます。
Dotfuscator /g /p=projectdir=c:\temp project_template.xml
GUI を起動するには、コマンド ライン引数を何も指定せずに Dotfuscator を実行するという方法もあります。
config_file は、任意の構成ファイルです。
追加オプション
追加オプションは、構成ファイルを事前に作成する必要なしにコマンド ラインから基本的な難読化処理を実行できるようにするためのものです。コマンド ラインの追加オプションで構成ファイルを使用した場合、構成ファイルで指定されているコマンドは、コマンド ラインで指定したオプションによって補完またはオーバーライドされます。詳細については、「コマンド ラインでのオプション指定による構成ファイルの補完またはオーバーライド」を参照してください。
追加オプションは先頭の 4 文字によって認識されます。
以下に、コマンド ラインの追加オプションの概要を示します。アスタリスク (*) は、そのオプションが指定されず、構成ファイルも指定されていない場合に使用される既定の設定を示します。
| 追加オプション | 説明 |
|---|---|
| /in <file>[,<file>] | 入力アセンブリを指定する。既定値のモードはアセンブリ ファイルの拡張子によって決定される (EXE はプライベート、.DLL はライブラリ モードで実行)。 |
| /out:<directory> | 出力ディレクトリを指定する。既定値のディレクトリは ".\Dotfuscated"。 |
| /honor:[on|off*] | すべての入力アセンブリで見つかった難読化属性の使用命令を有効/無効にする。 |
| /strip:[on|off*] | すべての入力アセンブリからの難読化属性の除去を有効/無効にする。 |
| /makeconfig:<file> | すべての実行時オプション (コマンド ラインで指定されたオプション、および構成ファイルが存在する場合はそのファイルで指定されているオプション) を <file> に保存する。 |
| /disable | 他のオプションの設定にかかわらず、すべての変換を無効にする。 |
| /rename:[on|off*] | 名前の変更を有効/無効にする。 |
| /mapout:<file> | 出力割り当てファイルを指定する。
既定値のファイルは ".\Dotfuscated\map.xml"。 |
| /clobbermap:[on|off*] | 割り当てファイルの上書きモードを指定する。 |
| /keep:[namespace|hierarchy|none*] | 型の名前変更規則を指定する。 |
例 :
dotfuscator -in:my.dll
名前の変更、制御フローの難読化、不要コードの除去、および文字列の暗号化を有効にして、my.dll をライブラリとして難読化します (公開されているシンボルは除去されずに保持されます)。出力ディレクトリを指定していないので、出力アセンブリは既定の .\Dotfuscated ディレクトリに出力され、割り当てファイルとして .\Dotfuscated\map.xml が使用されます。
dotfuscator -in:myapp.exe,private.dll
myapp.exe および private.dll を 1 つのスタンドアロン アプリケーションとしてまとめて難読化します。DLL 内の公開されているシンボルも難読化されます。不要コードの除去は、myapp.exe 内のエントリ ポイント メソッドに基づいて有効化されます。
dotfuscator -in:myapp.exe -mapo:MyNames.xml
myapp.exe をスタンドアロン アプリケーションとして難読化します。このコマンドでは名前変更の出力割り当てファイルが指定されています。
© 2002-2007 PreEmptive Solutions. All rights reserved.