.\" -*- nroff -*- .TH SYSTEMTAP 8 .SH JMÉNO systemtap \- systemtap initskript služba .\" macros .de SAMPLE .nr oldin \\n(.i .br .RS .nf .nh .. .de ESAMPLE .hy .fi .RE .in \\n[oldin]u .. .SH POUŽITÍ .B service systemtap .IR COMMAND " [" OPTIONS "] [" SCRIPT ...] .SH POPIS SystemTap initskript služba umožňuje spouštět systemtap skripty jako systémové služby a pohodlně je ovládat. Skripty mohou být nastartovány na individuální žádost, nebo při startu systému. Na systémech, které využívají dracut je také možné umístit skripty do initramfs a mít je spuštěné během boot procesu. Existují volby a parametry, které ovlivňují globální chování služby nebo jednotlivých skriptů. Mezi skripty lze vytvořit závislosti, tak že nastartování jednoho automaticky způsobí nastartování jiného. Konfigurační soubor initskriptu se nachází v \fB/etc/systemtap/config\fR. Přijatelné parametry jsou detailně popsány v sekci GLOBÁLNÍ PARAMETRY. Skript musí být umístěn v adresáři \fB/etc/systemtap/script.d\fR a musí mít příponu \fB.stp\fR. Poznamenejme, že když se systemtap skripty pouštějí z příkazové řádky, jak je obvyklé, není přípona \fB.stp\fR povinná. Jméno skriptu smí obsahovat jen alfanumerické znaky a '_', a nesmí začínat číslem. Adresář pro skripty lze změnit nastavením parametru SCRIPT_PATH v konfiguračním souboru. .SH PŘÍKAZY Musí být uveden jeden z následující příkazů: .TP .B start Start skriptů. Pokud žádné skripty nebyly určeny, nastartují se skripty určené nastavením DEFAULT_START. Pokud DEFAULT_START není nastaveno, nastartují se všechny skripty v adresáři skriptů. Pro skripty, které již běží se příkaz "start" ignoruje. Příkaz "start" selže, pokud start skriptů selže (viz též nastavení PASSALL). Pokud je zapnutá volba AUTOCOMPILE, příkaz se pokusí sestavit (nebo obnovit sestavení) skriptů v případě, že je platná jedna z následujících podmínek: .RS .IP - 2 Cache se zkompilovanými skripty neexistuje. .IP - Čas modifikace (mtime) původního skriptu se změnil. .IP - Skript se spouští s jinými volbami. .IP - Změnil se výstup `uname -a`. .RE .TP .B stop Zastavit skripty. Pokud žádné skripty nebyly určeny, zastaví se všechny běžící skripty. Pro skripty, které neběží, se tento příkaz bude ignorovat. Příkaz selže pokud selže zastavení některého ze skriptů (viz též nastavení PASSALL). .TP .B restart Zastavit a opět nastartovat skripty. .TP .B status Zobrazit stav skriptů a jejich závislosti. .TP .B compile Přeložit skripty, ale nestartovat je. Pokud skripty již byly přeloženy, dotázat se na potvrzení dříve, než dojde k přepsání cache. Kompilovat pro běžící jádro, nebo pro jádro určené prostřednictvím volby \fB-r\fR. .TP .B onboot Učinit určené skripty součástí initramfs, aby mohly být spuštěny během startu stroje. Tento příkaz je dostupný jen na systémech, které používají dracut. Pokud se neurčí žádný skript, všechny systemtap skripty se z initramfs odstraní. Initramfs se vytváří pro aktuální jádro, nebo pro jádro určené volbou \fB-r\fR. Výchozí umístění initramfs je \fB/boot/initramfs-KVER.img\fR, kde KVER odpovídá výstupu `uname -r`. Příkaz "onboot" dále obnoví nastavení zavaděče systému tak, aby byl použit nový initramfs. Pokud se má vytvořit initramfs v jiném umístění, použijte volbu \fB-o\fR. V tomto případě se nastavení zavaděče systému nezmění. Pokud výstupní soubor již existuje, bude přepsán pokud není dán přepínač \fB-b\fR , kdy se původnímu souboru přidá přípona \fB.bak\fR namísto přepsání. Pokud ale \fB.bak\fR soubor již existuje, nebude přepsán. UPOZORNĚNÍ: Nepoužívejte volbu \fB-o\fR příkazu \fIstap\fR(1) u "onboot" skriptů, protože skript poběží dříve, než se namountuje kořenový souborový systém. Pokud potřebujete více místa pro výstup, zvětšete velikost bufferu. .TP .B cleanup Odstranit specifikované skripty z cache. Pokud není specifikován žádný skript, budou smazány všechny. Smaže se jen cache pro aktuální jádro, nebo pro jádro určené volbou \fB-r\fR. Před smazáním cache bude požadováno potvrzení. .SH VOLBY Některé příkazy přijímají volby. Nicméně, protože uživatelé nemohou předávat volby při zavádění OS, jsou volby určeny pouze pro ovládání skriptů běžících až po nabootování systému a pro testování. .TP .BI "-c " CONFIG_FILE Určuje alternativní konfigurační soubor. .TP .B -R Při použití s \fBstart\fR a \fBstop\fR příkazy značí, že mají být vzaty v potaz závislosti mezi skripty a to rekurzivně. .TP .BI "-r " KERNEL_RELEASE Při použití s \fBcompile\fR, \fBonboot\fR, a \fBcleanup\fR příkazy, určuje cílové jádro. Formát KERNEL_RELEASE musí odpovídat formátu `uname -r`. .TP .B -y Odpověz ano na všechny dotazy. .TP .BI "-o " PATH.IMG Při použití s příkazem \fBonboot\fR určuje umístění initramfs. Pokud se určí, konfigurace zavaděče se nezmění. Pokud určen není, konfigurace zavaděče se změní tak, aby byl při následujícím startu použit nový initramfs. .TP .B -b Při použití s příkazem \fBonboot\fR, zazálohuje existující initramfs připojením přípony \fB.bak\fR namísto aby existující initramfs přepsal, což se stane není-li tato volba použita. .SH GLOBÁLNÍ PARAMETRY Tyto parametry ovlivňují obecné chování služby. Nastavují se v konfiguračním souboru. .TP .B SCRIPT_PATH Určuje absolutní cestu adresáře pro skripty, se kterými může služba pracovat. Skripty musí mít příponu \fB.stp\fR. Výchozí hodnota je \fB/etc/systemtap/script.d\fR. .TP .B CONFIG_PATH Určuje absolutní cestu adresáře pro konfigurační soubory skriptů. Tyto konfigurační soubory obsahují volby specifické pro jednotlivé skripty. Musí mít příponu \fB.conf\fR. Výchozí umístění je \fB/etc/systemtap/conf.d\fR. .TP .B CACHE_PATH Umístění cache adresáře. Výchozí umístění je \fB/var/cache/systemtap\fR. .TP .B TEMP_PATH Umístění dočasného adresáře, kam systemtap odkládá dočasné soubory, které vznikají při kompilaci systemtap jaderného modulu. Výchozí umístění je \fB/tmp\fR. .TP .B STAT_PATH Absolutní cesta k adresáři se stavovými soubory pro jednotlivé skripty. Výchozí umístění je \fB/var/run/systemtap\fR. .TP .B LOG_FILE Absolutní cesta k logovacímu souboru. Všechny zprávy se posílají do tohoto souboru (včetně kompilačních chybových hlášení a hlášení o chybách běhu). Výchozí umístění je \fB/var/log/systemtap.log\fR. .TP .B PASSALL Pokud tato volba je nastavena (\fByes\fR), pak systemtap služba pracující s mnoha skripty zahlásí chybu, pokud kterýkoliv ze skriptů zhavaruje. Pokud tato volba není nastavena (\fBno\fR) vypíše systemtap služba v takovém případě jen varování. .TP .B RECURSIVE Pokud tato volba je nastavena (\fByes\fR), služba systemtap bude brát v potaz závislosti mezi skripty a to rekurzivně (odpovídá volbě \fB-R\fR). Tato volba je platná jen pokud byly na příkazové řádce určeny skripty. Výchozí hodnota je \fBno\fR. .TP .B AUTOCOMPILE Pokud je tato volba nastavena (\fByes\fR), služba systemtap se pokusí zkompilovat určené skripty pokud nenalezne odpovídající validní položky v cache. Jinak související příkaz selže. Výchozí hodnota je \fByes\fR. .TP .B DEFAULT_START Určuje skripty, které se mají nastartovat jako výchozí. Pokud je tato volba vynechána (nebo nastavena na prázdnou hodnotu), nastartují se všechny skripty v adresáři. Výchozí hodnota je \fB""\fR. .TP .B ALLOW_CACHEONLY Pokud je tato volba nastaveba (\fByes\fR), služba umožní nastartování také skriptům, pro něž existují v cache validní data, ale v adresáři pro skripty jejich zdrojový kód chybí. Výchozí hodnota je \fBno\fR. VAROVÁNÍ: S touto volbou může služba nastartovat neočekávané skripty nacházející se v cache. Před startem služby je vhodné obsah cache zkontrolovat. .TP .B LOG_BOOT_ERR Protože "boot-time" skripty se spouštějí dříve než je namountován kořenový souborový systém, nelze chybový výstup programy staprun posílat do LOG_FILE jak je obvyklé. Nicméně log lze přesměrovat do /var/run/systemtap/$script.log nastavením LOG_BOOT_ERR na \fByes\fR. Pokud STAT_PATH je odlišná od výchozí hodnoty, budou logovací soubory přesunuty na požadované místo dříve, než se spustí jakýkoliv příkaz služby. Výchozí hodnota je \fBno\fR. .PP Zde je ukázka konfiguračního souboru. .SAMPLE SCRIPT_PATH=/var/systemtap/script.d/ PASSALL=yes RECURSIVE=no .ESAMPLE .SH PARAMETRY SKRIPTŮ Tyto parametry ovlivňují kompilaci skriptů, nebo jejich chování za běhu. Nastavují se v konfiguračních souborech umístěných v adresáři CONFIG_PATH. .TP .B