Transakce SymStore

Každé volání SymStore je zaznamenáno jako transakce. Existují dva typy transakcí: přidání a odstranění.

Při vytvoření úložiště symbolů se v kořenovém adresáři serveru vytvoří adresář s názvem 000admin. Adresář 000admin obsahuje jeden soubor pro každou transakci, stejně jako soubory protokolu server.txt a history.txt. Soubor server.txt obsahuje seznam všech transakcí, které jsou aktuálně na serveru. Soubor history.txt obsahuje chronologickou historii všech transakcí.

Při každém uložení nebo odebrání souborů symbolů SymStore se vytvoří nové číslo transakce. Potom se vytvoří soubor, jehož název je toto číslo transakce, v 000admin. Tento soubor obsahuje seznam všech souborů nebo ukazatelů, které byly přidány do úložiště symbolů během této transakce. Pokud je transakce odstraněna, SymStore přečte svůj transakční soubor, aby určil, které soubory a ukazatele má odstranit.

přidat a del možnosti určují, zda se má provést přidání nebo odstranění transakce. Zahrnutí možnosti /p s operací přidání určuje, že se má přidat ukazatel; Vynechání možnosti /p určuje, že se má přidat skutečný soubor symbolů.

Úložiště symbolů je také možné vytvořit ve dvou samostatných fázích. V první fázi použijete SymStore s možností /x k vytvoření indexového souboru. Ve druhé fázi použijete SymStore s možností /y k vytvoření skutečného úložiště souborů nebo ukazatelů z informací v souboru indexu.

To může být užitečná technika z různých důvodů. To například umožňuje snadné opětovné vytvoření úložiště symbolů, pokud se úložiště nějak ztratí, pokud soubor indexu stále existuje. Nebo třeba počítač obsahující soubory symbolů má pomalé síťové připojení k počítači, na kterém se vytvoří úložiště symbolů. V tomto případě můžete vytvořit indexový soubor na stejném počítači jako soubory symbolů, přenést indexový soubor do druhého počítače a pak vytvořit úložiště na druhém počítači.

Úplný seznam všech parametrů SymStore naleznete v tématu SymStore Command-Line Možnosti.

Poznámka SymStore nepodporuje souběžné transakce od více uživatelů. Doporučuje se, aby byl jeden uživatel označený jako "správce" úložiště symbolů a zodpovědný za všechny přidávat a del transakce.

Příklady transakcí

Zde jsou dva příklady, jak SymStore přidává ukazatele symbolů pro sestavení 2195 systému Windows 2000 do \\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"

V následujícím příkladu přidá SymStore skutečné soubory symbolů pro projekt aplikace v \\largeapp\appserver\bins do \\MyDir\symsrv:

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

Tady je příklad použití indexového souboru. Nejprve SymStore vytvoří indexový soubor založený na kolekci souborů symbolů v \\largeapp\appserver\bins\. V tomto případě se indexový soubor umístí do třetího počítače \\hubserver\hubshare. Pomocí možnosti /g určíte, že předpona souboru \\largeapp\appserver se může v budoucnu změnit:

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

Teď předpokládejme, že přesunete všechny soubory symbolů z počítače \\largeapp\appserver a umístíte je na \\myarchive\appserver. Pak můžete vytvořit samotné úložiště symbolů z indexového souboru \\hubserver\hubshare\myindex.txt následujícím způsobem:

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"

Nakonec zde je příklad odstranění souboru přidaného předchozí transakcí SymStore. Pro podrobné vysvětlení, jak zjistit ID transakce (v tomto případě 0000000096), viz níže v části "Soubory server.txt a history.txt".

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

Soubory server.txt a history.txt

Při přidání transakce se do server.txt přidá několik položek informací a history.txt pro budoucí vyhledávání. Následuje příklad řádku v server.txt a history.txt pro přidání transakce:

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

Toto je čárkami oddělený řádek. Pole jsou vysvětlena následujícím způsobem:

Obor	Popis
0000000096	Číslo ID transakce vytvořené pomocí SymStore.
přidat	Typ transakce. Toto pole může být buď přidat nebo odebrat.
ptr	Zda byly přidány soubory nebo ukazatele. Toto pole může být buď soubor , nebo ptr .
10/09/99	Datum, kdy došlo k transakci.
00:08:32	Čas, kdy byla transakce spuštěna.
Windows Vista SP 1	Výrobek.
x86 fre	Verze (volitelné).
Přidáno z	Komentář (volitelné)
Nepoužitý	(Vyhrazeno pro pozdější použití.)

Tady jsou některé ukázkové řádky z transakčního souboru 0000000096. Každý řádek zaznamenává adresář a umístění souboru nebo ukazatele, který byl přidán do adresáře.

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

Pokud použijete transakci del k vrácení původní transakce add, tyto řádky budou odebrány z server.txta následující řádek bude přidán do history.txt:

0000000105,del,0000000096

Pole pro transakci odstranění jsou popsána následujícím způsobem.

Obor	Popis
0000000105	Číslo ID transakce vytvořené pomocí SymStore.
del	Typ transakce. Toto pole může být buď přidat nebo odebrat.
0000000096	Transakce, která byla odstraněna.