Transaksi SymStore

Setiap panggilan ke SymStore dicatat sebagai transaksi. Ada dua jenis transaksi: tambahkan dan hapus.

Ketika penyimpanan simbol dibuat, direktori, yang disebut "000admin", dibuat di bawah akar server. Direktori 000admin berisi satu file untuk setiap transaksi, serta file log server.txt dan history.txt. File server.txt berisi daftar semua transaksi yang saat ini ada di server. File history.txt berisi riwayat kronologis semua transaksi.

Setiap kali SymStore menyimpan atau menghapus file simbol, nomor transaksi baru dibuat. Kemudian, file, yang namanya adalah nomor transaksi ini, dibuat dalam 000admin. File ini berisi daftar semua file atau penunjuk yang telah ditambahkan ke penyimpanan simbol selama transaksi ini. Jika transaksi dihapus, SymStore akan membaca file transaksinya untuk menentukan file dan pointer mana yang harus dihapus.

Opsi tambahkan dan del menentukan apakah transaksi tambahkan atau hapus akan dilakukan. Termasuk opsi /p dengan operasi penambahan menentukan bahwa penunjuk akan ditambahkan; menghilangkan opsi /p menentukan bahwa file simbol aktual akan ditambahkan.

Anda juga dapat membuat penyimpanan simbol dalam dua tahap terpisah. Pada tahap pertama, Anda menggunakan SymStore dengan opsi /x untuk membuat file indeks. Pada tahap kedua, Anda menggunakan SymStore dengan opsi /y untuk membuat penyimpanan file atau pointer aktual dari informasi dalam file indeks.

Ini bisa menjadi teknik yang berguna karena berbagai alasan. Misalnya, ini memungkinkan penyimpanan simbol untuk dibuat ulang dengan mudah jika penyimpanan entah bagaimana hilang, selama file indeks masih ada. Atau mungkin komputer yang berisi file simbol memiliki koneksi jaringan lambat ke komputer tempat penyimpanan simbol akan dibuat. Dalam hal ini, Anda dapat membuat file indeks pada komputer yang sama dengan file simbol, mentransfer file indeks ke komputer kedua, lalu membuat penyimpanan di komputer kedua.

Untuk daftar lengkap semua parameter SymStore, lihat Opsi Command-Line SymStore.

Nota SymStore tidak mendukung transaksi simultan dari beberapa pengguna. Disarankan agar satu pengguna ditunjuk sebagai "administrator" dari penyimpanan simbol dan bertanggung jawab atas semua menambahkan transaksi dan del.

Contoh Transaksi

Berikut adalah dua contoh SymStore menambahkan penunjuk simbol untuk build 2195 Windows 2000 ke \\MyDir\symsrv:

symstore add /r /p /f \\BuildServer\BuildShare\2195free\symbols\*.* /s \\MyDir\symsrv /t "Windows 2000" /v "Build 2195 x86 free" /c "Sample add"
symstore add /r /p /f \\BuildServer\BuildShare\2195free\symbols\*.* /s \\MyDir\symsrv /t "Windows 2000" /v "Build 2195 x86 checked" /c "Sample add"

Dalam contoh berikut, SymStore menambahkan file simbol aktual untuk proyek aplikasi di \\largeapp\appserver\bins ke \\MyDir\symsrv:

symstore add /r /f \\largeapp\appserver\bins\*.* /s \\MyDir\symsrv /t "Large Application" /v "Build 432" /c "Sample add"

Berikut adalah contoh bagaimana file indeks digunakan. Pertama, SymStore membuat file indeks berdasarkan kumpulan file simbol di \\largeapp\appserver\bins\. Dalam hal ini, file indeks ditempatkan di komputer ketiga, \\hubserver\hubshare. Anda menggunakan opsi /g untuk menentukan bahwa awalan file "\\largeapp\appserver" mungkin berubah di masa mendatang:

symstore add /r /p /g \\largeapp\appserver /f \\largeapp\appserver\bins\*.* /x \\hubserver\hubshare\myindex.txt

Sekarang misalkan Anda memindahkan semua file simbol dari komputer \\largeapp\appserver dan menempatkannya di \\myarchive\appserver. Anda kemudian dapat membuat penyimpanan simbol itu sendiri dari file indeks \\hubserver\hubshare\myindex.txt sebagai berikut:

symstore add /y \\hubserver\hubshare\myindex.txt /g \\myarchive\appserver /s \\MyDir\symsrv /p /t "Large Application" /v "Build 432" /c "Sample Add from Index"

Terakhir, berikut adalah contoh SymStore yang menghapus file yang ditambahkan oleh transaksi sebelumnya. Lihat bagian "File server.txt dan history.txt" di bawah ini untuk penjelasan tentang cara menentukan ID transaksi (dalam hal ini, 0000000096).

symstore del /i 0000000096 /s \\MyDir\symsrv

File server.txt dan history.txt

Saat transaksi ditambahkan, beberapa item informasi ditambahkan ke server.txt dan history.txt untuk kemampuan pencarian di masa mendatang. Berikut ini adalah contoh baris di server.txt dan history.txt untuk transaksi penambahan:

0000000096,add,ptr,10/09/99,00:08:32,Windows Vista SP 1,x86 fre 1.156c-RTM-2,Added from \\mybuilds\symbols,

Ini adalah baris yang dipisahkan koma. Bidang dijelaskan sebagai berikut:

Bidang	Deskripsi
0000000096	Nomor ID Transaksi, seperti yang dibuat oleh SymStore.
tambahkan	Jenis transaksi. Bidang ini dapat tambahkan atau hapus.
ptr	Apakah berkas atau penunjuk ditambahkan. Bidang ini dapat berupa file atau ptr.
10/09/99	Tanggal ketika transaksi terjadi.
00:08:32	Waktu ketika transaksi dimulai.
Windows Vista SP 1	Produk.
x86 fre	Versi (opsional).
Ditambahkan dari	Komentar (opsional)
Tidak terpakai	(Dicadangkan untuk digunakan nanti.)

Berikut adalah beberapa baris sampel dari file transaksi 0000000096. Setiap baris merekam direktori dan lokasi file atau penunjuk yang ditambahkan ke direktori.

canon800.dbg\35d9fd51b000,\\mybuilds\symbols\sp4\dll\canon800.dbg
canonlbp.dbg\35d9fd521c000,\\mybuilds\symbols\sp4\dll\canonlbp.dbg
certadm.dbg\352bf2f48000,\\mybuilds\symbols\sp4\dll\certadm.dbg
certcli.dbg\352bf2f1b000,\\mybuilds\symbols\sp4\dll\certcli.dbg
certcrpt.dbg\352bf04911000,\\mybuilds\symbols\sp4\dll\certcrpt.dbg
certenc.dbg\352bf2f7f000,\\mybuilds\symbols\sp4\dll\certenc.dbg

Jika Anda menggunakan transaksi del untuk membatalkan asli menambahkan transaksi, baris ini akan dihapus dari server.txt, dan baris berikut akan ditambahkan ke history.txt:

0000000105,del,0000000096

Bidang untuk transaksi penghapusan dijelaskan sebagai berikut.

Bidang	Deskripsi
0000000105	Nomor ID Transaksi, seperti yang dibuat oleh SymStore.
del	Jenis transaksi. Bidang ini dapat tambahkan atau hapus.
0000000096	Transaksi yang dihapus.