BinPlace Command-Line語法

BinPlace 會在命令列使用下列語法：

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

參數

選項
這可以包含下列任何參數。 參數前面應該加上連字號 () 或斜線 (/) 。 在一個連字號或斜線之後，可以結合數個選項，但採用其他參數的選項應該接著空格。 因此，下列兩個命令相等：

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

下列參數可供使用：

-a
讓 BinPlace 在放置符號檔時，將私用符號從符號檔移除。 這會建立包含公用符號但不包含私用符號的等量符號檔。 使用 -a 參數時，您也必須使用 -s 和 -x 。 使用 -a 時，移除的符號檔將會放在 -sSymbolRoot所指定的路徑中。 如果 也存在 -nFullSymbolRoot ，則會將完整符號檔放在 FullSymbolRoot中。 否則，它們不會放在任何位置。

-bExtraSubdirectory
導致 BinPlace 將檔案放在與平常不同的位置。 串連根目的地目錄、類別子目錄和檔案類型子目錄之後，BinPlace 接著會將 ExtraSubdirectory 附加至此路徑，以建立最終目的地目錄。 ExtraSubdirectory 不應該以反斜線開頭或結尾。 如需詳細資訊，請參閱 BinPlace 目的地目錄 。

-e
如果無法放置檔案，會導致 BinPlace 繼續執行。 根據預設，當發生此錯誤時，BinPlace 將會結束。

-F
強制 BinPlace 放置檔案，即使檔案覆寫較新的檔案也一樣。 根據預設，當 BinPlace 嘗試放置檔案時，它會覆寫較舊的版本，但不會覆寫較新的版本。

-gLCFile
導致 BinPlace 驗證可執行檔。 LCFile 會指定要用於這項驗證的當地語系化條件約束檔案。

-H
導致 BinPlace 在放置檔案時建立硬式連結，而不是複製檔案。 此選項僅適用于 NTFS 檔案系統。

-J
讓 BinPlace 在複製任何可執行檔之前，先確認有適當的符號存在。 若要使用此選項，SymChk 工具必須位於您的路徑中。 (SymChk 是 Windows 偵錯工具套件的一部分。如需詳細資訊，請參閱 Windows 偵 錯。)

-K
導致 BinPlace 保留檔案屬性。 根據預設，BinPlace 會關閉封存屬性。

-nFullSymbolRoot
指定完整符號檔的根目錄， (包含公用和私用符號的符號檔) 。 這也需要 -a、 -x和 -s 參數。 如需詳細資訊，請參閱 BinPlace 目的地目錄 。

-oRootSubdirectory
指定要使用之根目的地目錄的子目錄。 建立目的地目錄時， RootSubdirectory 將會插入根目的地目錄和類別子目錄之前。 如需詳細資訊，請參閱 BinPlace 目的地目錄 。

-pPlaceFile
指定放置檔案的路徑和檔案名。 如果未使用 -p 參數，BinPlace 會使用名為 \tools\placefil.txt的位置。 如需放置檔案內容的說明，請參閱 放置檔案語法 。

注意-p參數和放置檔案現在已過時，不應使用。

-問
防止 BinPlace 使用記錄檔。 如果省略 -q 參數，BINPLACE_LOG環境變數指定的檔案會當做記錄檔使用。

-rRootDestinationPath
指定根目錄。 如果省略此專案，則預設值是由 x86 型、Itanium 型或 x64 型電腦上的_NT386TREE、_NTIA64TREE或_NTAMD64TREE環境變數決定。 如需詳細資訊，請參閱 BinPlace 目的地目錄 。

-sSymbolRoot
指定符號檔的根目錄。 如果也使用 -a 和 -x 參數，則私用符號會從符號檔中去除，而等量符號檔將會放在 SymbolRoot所指定的目錄中。 如果您想要同時放置等量和完整符號檔，您應該使用 -a -x -s SymbolRoot -n FullSymbolRoot。 如需詳細資訊，請參閱 BinPlace 目的地目錄 。

-t
測試模式。 使用此參數時，不會複製任何檔案，但 BinPlace 會顯示警告和錯誤訊息，就像是放置檔案一樣。 您也可以使用 -v 參數來增加訊息數目。

-美國
導致 BinPlace 將 \up 附加至類別子目錄。 這適用于分隔出單處理器 (UP) 驅動程式。 此外，每當使用此參數時，BinPlace 將不會分割包含符號的可執行檔。 如需詳細資訊，請參閱 BinPlace 目的地目錄 。

-V
詳細資訊模式。 導致 BinPlace 顯示更詳細的錯誤、警告和進度訊息。

-w
導致 BinPlace 將 Windows 95 符號檔 (.sym) 新增至符號樹狀結構。

-X
如果 BinPlace 遇到使用 舊符號系統的檔案，此參數會使它從可執行檔中移除所有符號，並將此資訊移至不同的符號檔。 如需詳細資訊，請參閱 符號檔案系統 。 使用 -x 參數時，您也必須使用 -s 和 -a 。

-Y
防止 BinPlace 使用任何類別子目錄。 目的地目錄只會從根目的地目錄加上檔案類型子目錄建立。 如需詳細資訊，請參閱 BinPlace 目的地目錄 。

-Z
取消 -x 參數。 如果您在數個目標上使用 BinPlace，您可以使用 binplace引數Target1argumentsTarget2的命令，而且因為命令列是從左至右剖析， 所以 Target1 和 Target2 會受到不同引數的影響。 (請參閱) 後面的剖析順序一節。 如果遇到 -z 參數，這會取消任何先前 -x 參數的效果。

-ciReturnCode，Application，Argument，Argument， ...
導致 BinPlace 使用自訂應用程式來驗證所有可執行檔。 如果您想要 BinPlace 使用其他應用程式進行驗證，可以使用 -ci 參數。

ReturnCode 應該是這個應用程式在可執行檔中找到錯誤時所傳回的值。 其他參數是用來啟動此應用程式。 這些都必須以逗號分隔。 應用程式 會指定程式的名稱。 這後面可以接著任意數目的命令列引數。 程式會以命令列開頭，其中包含 Application ，後面接著以空格分隔的所有自 (變數，而不是以逗號分隔) ，最後以要檢查的可執行檔名稱結尾。

-：弧
讓 BinPlace 只放置已設定封存屬性的檔案。

-:D BG
防止 BinPlace 放置 .dbg 檔案。 如果使用 -j 參數，這會防止 BinPlace 放置指向 .dbg 檔案的二進位檔。 若要使用此選項，SymChk 工具必須位於您的路徑中。 (SymChk 是 Windows 套件偵錯工具的一部分。如需詳細資訊，請參閱 Windows 偵錯 。)

-:D ESTClassPath
讓 BinPlace 忽略放置檔案，並使用指定的 ClassPath 做為類別子目錄。 如需詳細資訊 ，請參閱 BinPlace 目的地目錄 。

-：LOGPDB
導致 BinPlace 在記錄檔中包含完整的 .pdb 路徑。

-：RENNewName
導致 BinPlace 重新命名放置的檔案。 原始檔案名，包括副檔名，將會由 NewName取代。 (如果原始檔案是正在分割的可執行檔，則會將新的符號檔指定為原始檔案名稱加上副檔名 .dbg.)

-：TMF
讓 BinPlace 從 PDB 符號檔擷取追蹤訊息格式指示，以建立 追蹤訊息格式 (.tmf) 檔案。 TMF 檔案會放在 BinPlace TRACE_FORMAT_PATH 環境變數所指定的目錄中。 請參閱 BinPlace 宏和環境變數。

-ChangeAsmsToRetailForSymbols
如果字串在符號檔的目的地目錄中發生，則會導致 BinPlace 將字串 「asms」 取代為 「retail」。 如需詳細資訊 ，請參閱 BinPlace 目的地目錄 。

檔
指定 BinPlace 將處理之檔案的完整路徑和檔案名。 您可以列出任意數目的檔案，並以空格分隔。 如果路徑和檔案名包含空格，您必須以引號括住路徑和檔案名。

@PlaceFile
如果任何檔案名前面加上 at 符號 () @ ，則檔案名代表位置檔案的名稱。 如需詳細資訊，請參閱下列檔案中的提供參數一節。

剖析順序

BinPlace 會從左至右剖析命令列。 您可以指定數個選項、 檔案 參數、新選項、另一個 File 參數等等。 每次 BinPlace 遇到新的選項時，都會採用它，覆寫先前看到的任何衝突選項。 每當遇到 檔案 規範時，它會使用已在命令列上遇到的累積選項來處理該檔案。

在檔案中提供參數

您可以從文字檔將參數傳遞至 BinPlace。 作法有二：

• 您可以在BINPLACE_OVERRIDE_FLAGS環境變數中指定檔案名。 每當執行 BinPlace 時，將會讀取此檔案及其內容做為參數。 此檔案中的參數會在實際出現在 BinPlace 命令列的參數之前剖析。

• 您可以在 BinPlace 命令列上指定檔案名，方法是在符號 (前面 @ 加上 ) 。 當 BinPlace 在其命令列上看到以這個符號開頭的字串時，它會採用字串、移除 at sign，然後尋找具有此名稱的檔案。 如果找到此檔案，它會將其文字插入命令列，完全位於原始參數開頭為 at sign 的位置。 由於 BinPlace 會從左至右剖析參數，因此您可以使用這項技術以及多個 檔案 實例，在具有不同選項的多個檔案上使用 BinPlace，而不需要每次輸入所有選項。 (如果找不到此檔案，BinPlace 會將原始字串視為 File 參數。)