Sintaks Baris Perintah BinPlace

BinPlace menggunakan sintaks berikut pada baris perintah:

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

Parameter

Pilihan
Ini dapat mencakup salah satu sakelar berikut. Sakelar harus didahului oleh tanda hubung (-) atau garis miring (/). Dimungkinkan untuk menggabungkan beberapa opsi setelah satu tanda hubung atau garis miring, tetapi opsi yang mengambil parameter tambahan harus diikuti oleh spasi. Dengan demikian, dua perintah berikut setara:

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

Sakelar berikut tersedia:

-sebuah
Menyebabkan BinPlace melucuti simbol privat dari file simbol saat ditempatkan. Ini membuat file simbol bergaris yang berisi simbol publik tetapi bukan simbol privat. Saat menggunakan sakelar -a , Anda juga harus menggunakan -s dan -x . Ketika -a digunakan, file simbol yang dilucuti akan ditempatkan di jalur yang ditentukan oleh -sSymbolRoot. Jika -nFullSymbolRoot juga ada, file simbol lengkap akan ditempatkan di FullSymbolRoot. Jika tidak, mereka tidak akan ditempatkan di mana pun.

-b ExtraSubdirectory
Menyebabkan BinPlace menempatkan file di lokasi yang berbeda dari biasanya. Setelah menggabungkan direktori tujuan akar, subdirektori kelas, dan subdirektori jenis file seperti biasa, BinPlace kemudian akan menambahkan ExtraSubdirectory ke jalur ini untuk membuat direktori tujuan akhir. ExtraSubdirectory tidak boleh dimulai dengan atau diakhir dengan garis miring terbelakang. Lihat Direktori Tujuan BinPlace untuk detail selengkapnya.

-e
Menyebabkan BinPlace melanjutkan eksekusi jika file tidak dapat ditempatkan. Secara default, BinPlace akan keluar ketika kesalahan ini terjadi.

-f
Memaksa BinPlace untuk menempatkan file meskipun menimpa file yang lebih baru. Secara default, ketika BinPlace mencoba menempatkan file, binPlace akan menimpa versi yang lebih lama tetapi tidak akan menimpa versi yang lebih baru.

-g LCFile
Menyebabkan BinPlace memverifikasi file yang dapat dieksekusi. LCFile menentukan file batasan pelokalan yang akan digunakan untuk verifikasi ini.

-jam
Menyebabkan BinPlace membuat tautan keras alih-alih menyalin file saat menempatkan file. Opsi ini hanya tersedia pada sistem file NTFS.

-j
Menyebabkan BinPlace memverifikasi bahwa simbol yang tepat ada sebelum menyalin file yang dapat dieksekusi. Agar opsi ini digunakan, alat SymChk harus berada di jalur Anda. (SymChk adalah bagian dari paket Alat Penelusuran Kesalahan untuk Windows. Lihat Penelusuran Kesalahan Windows untuk detailnya.)

-k
Menyebabkan BinPlace mempertahankan atribut file. Secara default, BinPlace akan menonaktifkan atribut arsip.

-n FullSymbolRoot
Menentukan direktori akar untuk file simbol lengkap (file simbol yang berisi simbol publik dan privat). Ini memerlukan sakelar -a, -x, dan -s juga. Lihat Direktori Tujuan BinPlace untuk detail selengkapnya.

-o RootSubdirectory
Menentukan subdirektori direktori tujuan akar yang akan digunakan. Saat direktori tujuan dibuat, RootSubdirectory akan dimasukkan setelah direktori tujuan akar dan sebelum subdirektori kelas. Lihat Direktori Tujuan BinPlace untuk detail selengkapnya.

-p PlaceFile
Menentukan jalur dan nama file file tempat. Jika sakelar -p tidak digunakan, BinPlace menggunakan tempat bernama \tools\placefil.txt. Lihat Menempatkan Sintaks File untuk penjelasan tentang konten file tempat.

Perhatikan file -p switch dan place sekarang usang dan tidak boleh digunakan.

-q
Mencegah BinPlace menggunakan file log. Jika sakelar -q dihilangkan, file yang ditentukan oleh variabel lingkungan BINPLACE_LOG digunakan sebagai file log.

-r RootDestinationPath
Menentukan direktori tujuan akar. Jika ini dihilangkan, default ditentukan oleh variabel lingkungan _NT386TREE, _NTIA64TREE, atau _NTAMD64TREE pada komputer berbasis x86, berbasis Itanium, atau x64. Lihat Direktori Tujuan BinPlace untuk detailnya.

-s SymbolRoot
Menentukan direktori akar untuk file simbol. Jika sakelar -a dan -x juga digunakan, simbol privat akan dilucuti dari file simbol, dan file simbol yang dilucuti akan ditempatkan di direktori yang ditentukan oleh SymbolRoot. Jika Anda ingin menempatkan file simbol yang dilucuti dan penuh, Anda harus menggunakan -a -x -s SymbolRoot -n FullSymbolRoot. Lihat Direktori Tujuan BinPlace untuk detail selengkapnya.

-t
Mode pengujian. Ketika sakelar ini digunakan, tidak ada file yang akan disalin, tetapi BinPlace akan menampilkan pesan peringatan dan kesalahan seolah-olah menempatkan file. Anda mungkin ingin menggunakan sakelar -v juga untuk meningkatkan jumlah pesan.

-u
Menyebabkan BinPlace menambahkan \hingga subdirektori kelas. Ini berguna untuk memisahkan driver uniprocessor (UP). Selain itu, setiap kali sakelar ini digunakan, BinPlace tidak akan membagi file yang dapat dieksekusi yang berisi simbol. Lihat Direktori Tujuan BinPlace untuk detail selengkapnya.

-v
Mode verbose. Menyebabkan BinPlace menampilkan pesan kesalahan, peringatan, dan kemajuan yang lebih rinci.

-w
Menyebabkan BinPlace menambahkan file simbol Windows 95 (.sym) ke pohon simbol.

-x
Jika BinPlace menemukan file yang menggunakan sistem simbol lama, sakelar ini menyebabkannya menghapus semua simbol dari file yang dapat dieksekusi dan memindahkan informasi ini ke file simbol terpisah. Lihat Sistem File Simbol untuk detailnya. Saat menggunakan sakelar -x , Anda harus menggunakan -s dan -a juga.

-y
Mencegah BinPlace menggunakan subdirektori kelas apa pun. Direktori tujuan akan dibuat hanya dari direktori tujuan akar ditambah subdirektori jenis file. Lihat Direktori Tujuan BinPlace untuk detailnya.

-z
Membatalkan sakelar -x . Ini dapat berguna jika Anda menggunakan BinPlace pada beberapa target -- Anda dapat menggunakan perintah argumen binplace formulirTarget1argumentsTarget2, dan karena baris perintah diurai dari kiri ke kanan, Target1 dan Target2 akan dipengaruhi oleh argumen yang berbeda. (Lihat bagian Penguraian Pesanan berikut). Jika sakelar -z ditemui, ini membatalkan efek dari sakelar -x sebelumnya.

-ci ReturnCode,Application,Argument,Argument, ...
Menyebabkan BinPlace menggunakan aplikasi kustom untuk memvalidasi semua file yang dapat dieksekusi. Anda dapat menggunakan sakelar -ci jika Anda ingin BinPlace menggunakan beberapa aplikasi lain untuk melakukan validasinya.

ReturnCode harus menjadi nilai yang akan dikembalikan oleh aplikasi ini jika menemukan kesalahan dalam file yang dapat dieksekusi. Parameter tambahan digunakan untuk meluncurkan aplikasi ini. Ini semua harus dipisahkan oleh koma. Aplikasi menentukan nama program. Ini dapat diikuti oleh sejumlah argumen baris perintah. Program akan dimulai dengan baris perintah yang menyertakan Aplikasi diikuti oleh semua argumen (dipisahkan oleh spasi daripada koma), dan akhirnya diakhir dengan nama file yang dapat dieksekusi untuk diperiksa.

-:ARC
Menyebabkan BinPlace hanya menempatkan file yang atribut arsipnya diatur.

-:D BG
Mencegah BinPlace menempatkan file .dbg. Jika sakelar -j juga digunakan, ini akan mencegah BinPlace menempatkan biner yang menunjuk ke file .dbg. Agar opsi ini digunakan, alat SymChk harus berada di jalur Anda. (SymChk adalah bagian dari paket Alat Penelusuran Kesalahan untuk Windows. Lihat Penelusuran Kesalahan Windows untuk detailnya.)

ClassPath -:D EST
Menyebabkan BinPlace mengabaikan file tempat dan menggunakan ClassPath yang ditentukan sebagai subdirektori kelas. Lihat Direktori Tujuan BinPlace untuk detailnya.

-:LOGPDB
Menyebabkan BinPlace menyertakan jalur .pdb lengkap dalam file log.

-:REN NewName
Menyebabkan BinPlace mengganti nama file yang ditempatkan. Nama file asli, termasuk ekstensi, akan digantikan oleh NewName. (Jika file asli adalah file yang dapat dieksekusi yang sedang dipisahkan, file simbol baru akan diberikan nama file asli ditambah ekstensi .dbg.)

-:TMF
Menyebabkan BinPlace membuat file format pesan pelacakan (.tmf) dengan mengekstrak petunjuk pemformatan pesan pelacakan dari file simbol PDB. File TMF akan ditempatkan di direktori yang ditentukan oleh variabel lingkungan binPlace TRACE_FORMAT_PATH. Lihat Makro BinPlace dan Variabel Lingkungan.

-ChangeAsmsToRetailForSymbols
Menyebabkan BinPlace mengganti string "asms" dengan string "retail" jika terjadi di direktori tujuan untuk file simbol. Lihat Direktori Tujuan BinPlace untuk detail selengkapnya.

Arsip
Menentukan jalur lengkap dan nama file file yang akan ditindaklanjuti BinPlace. Anda dapat mencantumkan sejumlah file, dipisahkan oleh spasi. Jika jalur dan nama file berisi spasi, Anda harus menyertakan jalur dan nama file dalam tanda kutip.

@PlaceFile
Jika ada nama file yang didahului dengan tanda ( @ ), nama file mewakili nama file tempat. Untuk informasi selengkapnya, lihat bagian Parameter Penyediaan di File berikut ini.

Urutan Penguraian

BinPlace mengurai baris perintah dari kiri ke kanan. Anda dapat menentukan beberapa opsi, lalu parameter File, lalu opsi baru, lalu parameter File lain, dan sebagainya. Setiap kali BinPlace menemukan opsi baru, binPlace akan diadopsi, mengesampingkan opsi kontradiktif yang terlihat sebelumnya. Setiap kali menemukan penentu File , itu akan bertindak pada file tersebut menggunakan opsi akumulasi yang telah ditemuinya pada baris perintah.

Menyediakan Parameter dalam File

Dimungkinkan untuk meneruskan parameter ke BinPlace dari file teks. Ada dua cara untuk melakukannya:

• Anda dapat menentukan nama file dalam variabel lingkungan BINPLACE_OVERRIDE_FLAGS. File ini akan dibaca dan isinya digunakan sebagai parameter setiap kali BinPlace dijalankan. Parameter dalam file ini akan diurai sebelum parameter yang benar-benar muncul di baris perintah BinPlace.

• Anda dapat menentukan nama file pada baris perintah BinPlace dengan mengawalinya dengan tanda ( @ ). Ketika BinPlace melihat string yang dimulai dengan tanda ini pada baris perintahnya, itu akan mengambil string, menghapus tanda saat, lalu mencari file dengan nama ini. Jika menemukan file ini, file akan menyisipkan teksnya ke dalam baris perintah tepat di tempat parameter asli dimulai dengan tanda at telah. Karena BinPlace menguraikan parameter dari kiri ke kanan, Anda dapat menggunakan teknik ini bersama dengan beberapa instans File untuk menggunakan BinPlace pada beberapa file dengan opsi yang berbeda untuk masing-masing, tanpa harus mengetik semua opsi setiap saat. (Jika file ini tidak ditemukan, BinPlace akan memperlakukan string asli, termasuk tanda saat, sebagai Parameter file .)