# &kcachegrind; Priročnik

Josef Weidendorfer

    Josef.Weidendorfer@gmx.de

Izvirni avtor dokumentacije
Federico Zenith

    federico.zenith@member.fsf.org

Posodobitve in popravki
Matjaž Jeran

    matjaz.jeran@amis.net

Prevod
2002-2004 &Josef.Weidendorfer;
2009 Federico Zenith
&FDLNotice;
18.11.2016
0.8.0 (aplikacije 17.04)

&kcachegrind; je orodje za vizualizacijo podatkov profila, napisano z uporabo &kde-frameworks;.

KDE kdesdk Cachegrind Callgrind Valgrind Profiliranje

## Uvod

&kcachegrind; je brskalnik za podatke, ki so jih ustvarila orodja za profiliranje. V tem poglavju je razloženo, čemu je namenjeno profiliranje, kako se izvaja in podaja nekaj primerov razpoložljivih orodij za profiliranje.

### Profiliranje

Pri razvoju programa eden od zadnjih korakov pogosto vključuje optimizacijo delovanja. Ker redko uporabljenih funkcij nima smisla optimizirati, ker bi bila to izguba časa, je treba vedeti, v katerem delu programa se preživi največ časa.

Za zaporedno kodo običajno zadostuje zbiranje statističnih podatkov o značilnostih izvajalnega časa programa, kot so številke časa, porabljenega v funkcijah in vrsticah kode. To se imenuje profiliranje. Program se izvaja pod nadzorom orodja za profiliranje, ki na koncu poda povzetek izvajanja. Nasprotno pa pri vzporedni kodi težave z zmogljivostjo običajno nastanejo, ko en procesor čaka na podatke drugega. Ker tega čakalnega časa običajno ni mogoče preprosto pripisati, je tukaj bolje ustvariti sledi dogodkov s časovnimi žigi. &kcachegrind; ne more vizualizirati te vrste podatkov.

Po analizi ustvarjenih podatkov o profilu bi moralo biti enostavno videti vroče točke in ozka grla kode: preveriti je mogoče na primer predpostavke o številu klicev in optimizirati identificirana področja kode. Nato je treba uspešnost optimizacije preveriti z drugim zagonom profila.

### Metode profiliranja

Za natančno merjenje pretečenega časa ali beleženje dogodkov, ki se zgodijo med izvajanjem področja kode (⪚ funkcije), je treba pred in za danim območjem vstaviti dodatno kodo merjenja. Ta koda prebere čas ali globalno število dogodkov in izračuna razlike. Zato je treba prvotno kodo pred izvedbo spremeniti. To se imenuje instrumentacija. Instrumentacijo lahko izvede programer sam, prevajalnik ali izvajalni sistem. Ker so zanimiva območja običajno ugnezdena, režijski stroški merjenja vedno vplivajo na samo merjenje. Zato je treba instrumentacijo izvajati selektivno, rezultate pa je treba razlagati previdno. Seveda je zaradi tega analiza delovanja z natančnimi meritvami zelo zapleten proces.

Natančne meritve so možne zaradi števcev strojne opreme (vključno s števci, ki se povečujejo ob časovnem tiku), ki so na voljo v sodobnih procesorjih in se povečajo vsakič, ko se zgodi dogodek. Ker želimo dogodke pripisati regijam kode, bi morali brez števcev vsak dogodek obravnavati tako, da sami povečamo števec za trenutno regijo kode. Izvajanje tega v programski opremi seveda ni mogoče; toda ob predpostavki, da je porazdelitev dogodkov po izvorni kodi podobna, če gledamo samo vsak n-ti dogodek namesto vsakega dogodka, je bila razvita merilna metoda, katere režijski stroški so nastavljivi: imenuje se vzorčenje. Časovno zasnovano vzorčenje (&TBS;) uporablja časovnik za redno pregledovanje programskega števca za ustvarjanje histograma nad programsko kodo. Vzorčenje na podlagi dogodkov (&EBS;) izkorišča števce strojne opreme sodobnih procesorjev in uporablja način, v katerem se obdelovalnik prekinitev kliče ob pretoku števca, da ustvari histogram ustrezne porazdelitve dogodkov: v upravljalniku se števec dogodkov vedno znova inicializira na n metode vzorčenja. Prednost vzorčenja je, da kode ni treba spreminjati, vendar je še vedno kompromis: zgornja predpostavka bo pravilnejša, če je n majhen, manjši pa kot je n, višji so stroški obdelovalnika prekinitev.

Druga merilna metoda je simulacija stvari, ki se dogajajo v računalniškem sistemu pri izvajanju dane kode, &ie; simulacija, ki jo poganja izvajanje. Simulacija vedno izhaja iz bolj ali manj natančnega strojnega modela; pri zelo podrobnih modelih strojev, ki dajejo zelo blizu realnosti, pa je lahko čas simulacije v praksi nesprejemljivo visok. Prednost simulacije je, da je mogoče v dano kodo vstaviti poljubno zapleteno merilno/simulacijsko kodo brez motečih rezultatov. Izvajanje tega neposredno pred izvajanjem (imenovano instrumentacija izvajalnega časa) z uporabo izvirne binarne datoteke je zelo udobno za uporabnika: ponovno prevajanje ni potrebno. Simulacija postane uporabna, če simuliramo le dele stroja s preprostim modelom; druga prednost je, da so rezultati, ki jih ustvarijo preprosti modeli, pogosto lažje razumljivi: pogosto je težava z resnično strojno opremo v tem, da rezultati vključujejo prekrivajoče se učinke iz različnih delov stroja.

### Orodja za profiliranje

Najbolj znano je orodje za profiliranje GCC gprof: program je treba prevesti z možnostjo `-pg`; zagon programa generira datoteko `gmon.out`, ki jo je mogoče pretvoriti v človeku berljivo obliko z `gprof`. Ena pomanjkljivost je potreben korak ponovnega prevajanja za pripravo izvršljive datoteke, ki mora biti statično povezana. Tukaj uporabljena metoda je instrumentacija, ki jo ustvari prevajalnik, ki meri loke klicev, ki se dogajajo med funkcijami, in ustrezna števila klicev v povezavi z &TBS;, ki daje histogram časovne porazdelitve po kodi. Z uporabo obeh informacij je mogoče hevristično izračunati inkluzivni čas funkcij, &ie; čas, porabljen v funkciji, skupaj z vsemi funkcijami, ki so iz nje priklicane.

Za natančno merjenje dogajanja obstajajo knjižnice s funkcijami, ki lahko preberejo števce zmogljivosti strojne opreme. Najbolj znan tukaj je popravek PerfCtr za &Linux; in arhitekturno neodvisni knjižnici PAPI in PCL. Kljub temu je za natančno merjenje potrebna instrumentacija kode, kot je navedeno zgoraj. Bodisi uporablja knjižnice same bodisi uporablja samodejne instrumentacijske sisteme, kot je ADAPTOR (za izvorne instrumente FORTRAN) ali DynaProf (vbrizgavanje kode prek DynInsta).

&oprofile; je sistemsko orodje za profiliranje za &Linux; z uporabo vzorčenja.

V mnogih pogledih je udoben način profiliranja uporaba &cachegrind; ali &callgrind;, ki sta simulatorja, ki uporabljata okvir izvajalnega instrumentarija &valgrind;. Ker ni potrebe po dostopu do števcev strojne opreme (kar je pogosto težko pri današnjih namestitvah &Linux;), binarne datoteke, ki jih želite profilirati, pa lahko pustite nespremenjene, je dobra alternativa drugim orodjem za profiliranje. Pomanjkljivost simulacije - upočasnitev - lahko zmanjšamo tako, da simulacijo izvajamo samo na zanimivih delih programa in morda le na nekaj ponovitvah zanke. Brez merilnih/simulacijskih instrumentov ima uporaba &valgrind; le faktor upočasnitve v razponu od 3 do 5. Poleg tega, ko sta zanimiva samo graf klicev in štetje klicev, lahko simulator predpomnilnika izklopite.

Simulacija predpomnilnika je prvi korak pri približevanju realnega časa, saj je čas izvajanja zelo občutljiv na izkoriščanje tako imenovanih predpomnilnikov, majhnih in hitrih vmesnih pomnilnikov, ki pospešujejo ponavljajoče se dostope do istih glavnih pomnilniških celic v sodobnih sistemih. &cachegrind; izvaja simulacijo predpomnilnika z lovljenjem dostopov do pomnilnika. Proizvedeni podatki vključujejo število dostopov do pomnilnika ukazov/podatkov ter zgrešenih predpomnilnika prve in druge ravni ter jih povezujejo z izvornimi vrsticami in funkcijami zagnanega programa. Z združevanjem teh števila zamud in z uporabo zakasnitev tipičnih procesorjev je mogoče podati oceno porabljenega časa.

&callgrind; je razširitev &cachegrind; ki sproti gradi graf klicev programa, &ie; kako se funkciji kličeta in koliko dogodkov se zgodi med izvajanjem funkcije. Poleg tega je mogoče podatke o profilu, ki jih je treba zbrati, ločiti po nitih in kontekstih verige klicev. Zagotovi lahko podatke o profiliranju na ravni navodil, da omogoči zaznamovanje razstavljene kode.

### Vizualizacija

Orodja za profiliranje običajno ustvarijo veliko količino podatkov. Želja po enostavnem brskanju navzdol in navzgor po grafu klicev, skupaj s hitrim preklapljanjem načina razvrščanja funkcij in prikazom različnih vrst dogodkov, motivira &GUI; aplikacijo za izpolnitev te naloge.

&kcachegrind; je orodje za vizualizacijo podatkov profila, ki izpolnjuje te želje. Čeprav je bil najprej programiran z brskanjem po podatkih iz &cachegrind; in &calltree; v mislih so na voljo pretvorniki, ki lahko prikažejo podatke o profilu, ki jih ustvarijo druga orodja. V dodatku je opis datoteke &cachegrind;/&callgrind; podana oblika datoteke.

Poleg seznama funkcij, razvrščenih glede na izključne ali vključujoče meritve stroškov in neobvezno razvrščenih glede na izvorno datoteko, knjižnico v skupni rabi ali razred C++, &kcachegrind; ponuja različne poglede za izbrano funkcijo, in sicer:

- pogled grafa klicev, ki prikazuje del grafa klicev okoli izbrane funkcije,

- pogled drevesnega pogleda, ki omogoča vizualizacijo odnosov ugnezdenih klicev, skupaj z vključujočo stroškovno metriko za hitro vizualno odkrivanje problematičnih funkcij,

- pogled izvorne kode in opomb razzbrinika, ki omogoča ogled podrobnosti o stroških, povezanih z izvornimi vrsticami in navodili za zbirnik.

## Uporaba &kcachegrind;

### Ustvarite podatke za vizualizacijo

Prvič, želimo ustvariti podatke o zmogljivosti z merjenjem vidikov značilnosti časa izvajanja aplikacije z uporabo orodja za profiliranje. &kcachegrind; sama po sebi ne vključuje nobenega orodja za profiliranje, vendar je dobra za uporabo skupaj s &callgrind;, z uporabo pretvornika pa se lahko uporablja tudi za vizualizacijo podatkov, proizvedenih z &oprofile;. Čeprav namen tega priročnika ni dokumentiranje profiliranja s temi orodji, so v naslednjem razdelku kratke vadnice za hiter začetek, s katerimi lahko začnete.

#### &callgrind;

&callgrind; je del &valgrind;. Upoštevajte, da se je prej imenoval &calltree;, vendar je bilo to ime zavajajoče.

Najpogostejša uporaba je predpona ukazne vrstice za zagon aplikacije z ``valgrind` `--tool=callgrind`` , kot v:

> ``valgrind` `--tool=callgrind` myprogram myargs`

Ob zaključku programa bo ustvarjena datoteka `callgrind.out.pid`, ki jo lahko naložite v &kcachegrind;.

Naprednejša uporaba je izpis podatkov profila vsakič, ko se pokliče določena funkcija vaše aplikacije. Npr. za &konqueror;, če si želite ogledati podatke profila samo za upodabljanje spletne strani, se lahko odločite za izpis podatkov vsakič, ko izberete menijski element Pogled Znova naloži . To ustreza klicu KonqMainWindow::slotReload. Uporabite:

> ``valgrind` `--tool=callgrind` `--dump-before=KonqMainWindow::slotReload` konqueror`

To bo ustvarilo več podatkovnih datotek profila z dodatno zaporedno številko na koncu imena datoteke. Izdelana bo tudi datoteka brez te številke na koncu (konča se le v PID procesa); z nalaganjem te datoteke v &kcachegrind;, se naložijo tudi vse druge in si jih lahko ogledate v Pregledu delov in seznamu Deli.

#### &oprofile;

&oprofile; je na voljo na njegovi domači strani. Sledite navodilom za namestitev na spletnem mestu, vendar preden to storite, preverite, ali ga vaša distribucija že ponuja kot paket (kot &SuSE;).

Sistemsko profiliranje je dovoljeno le korenskemu uporabniku, saj je mogoče opazovati vsa dejanja v sistemu; zato je treba kot root narediti naslednje. Najprej konfigurirajte postopek profiliranja z &GUI; `oprof_start` ali orodje ukazne vrstice `opcontrol`. Standardna konfiguracija mora biti način časovnika (&TBS;, glejte uvod). Za začetek meritve zaženite ``opcontrol` `-s``. Nato zaženite aplikacijo, ki vas zanima, in nato naredite ``opcontrol` `-d``. S tem boste rezultate meritev zapisali v datoteke v mapo `/var/lib/oprofile/samples/`. Da bi lahko vizualizirali podatke v &kcachegrind;, naredite v praznem imeniku:

> ``opreport` `-gdf` | `op2callgrind``

To bo proizvedlo veliko datotek, eno za vsak program, ki se izvaja v sistemu. Vsakega lahko naložite v &kcachegrind; samega.

### Osnove uporabniškega vmesnika

Ko zaženete &kcachegrind; s podatkovno datoteko profila kot argumentom ali po nalaganju z Datoteka Odpri boste na levi strani videli navigacijsko ploščo s seznamom funkcij ; in na desni glavni del, območje s pogledi za izbrano funkcijo. To območje pogleda je mogoče poljubno konfigurirati za prikaz več pogledov hkrati.

Ob prvem zagonu bo to območje razdeljeno na zgornji in spodnji del, vsak z različnimi pogledi, ki jih je mogoče izbrati z zavihki. Za premikanje pogledov uporabite kontekstni meni zavihkov in prilagodite razdelilnike med pogledi. Če želite hitro preklapljati med različnimi postavitvami ogleda, uporabite &Ctrl;→ Pogled Postavitev Pojdi na Naprej in &Ctrl;← Pogled Postavitev Pojdi na prejšnji.

Vrsta aktivnega dogodka je pomembna za vizualizacijo: za &callgrind; je to na primer zgrešeno predpomnilnik ali ocena cikla; za &oprofile; je to v najpreprostejšem primeru Timer. Vrsto dogodka lahko spremenite prek kombiniranega polja v orodni vrstici ali v pogledu Vrsta dogodka. Ko izberete funkcijo `main` na levem seznamu, morate dobiti prvi pregled značilnosti časa izvajanja; nato si oglejte pogled grafa klicev. Tam vidite klice, ki se pojavljajo v vašem programu. Upoštevajte, da pogled grafa klicev prikazuje samo funkcije z velikim številom dogodkov. Če dvokliknete funkcijo v grafu, se ta spremeni in prikaže klicane funkcije okoli izbrane.

Za raziskovanje &GUI; Poleg tega priročnika si oglejte tudi razdelek z dokumentacijo na spletnem mestu. Prav tako vsak gradnik v &kcachegrind; ima Kaj je to pomoč.

## Osnovni pojmi

To poglavje pojasnjuje nekatere koncepte &kcachegrind; in uvaja izraze, ki se uporabljajo v vmesniku.

### Podatkovni model za podatke o profilu

#### Stroškovne entitete

Štetje stroškov vrst dogodkov (kot so napake L2) se pripišejo stroškovnim entitetam, ki so postavke v povezavi z izvorno kodo ali podatkovnimi strukturami danega programa. Entitete stroškov niso lahko samo preprosta koda ali podatkovni položaji, ampak tudi pozicijska torka. Na primer, klic ima vir in cilj ali pa ima lahko podatkovni naslov vrsto podatkov in položaj kode, kjer je prišlo do njegove dodelitve.

Entitete stroškov, ki jih pozna &kcachegrind; so podani v nadaljevanju. Preprosti položaji:

Navodilo

  Navodilo za zbirnik na določenem naslovu.

Izvorna vrstica funkcije

  Vsa navodila, ki jih prevajalnik (prek informacij o odpravljanju napak) preslika v dano navedeno izvorno vrstico z imenom izvorne datoteke in številko vrstice in ki se izvajajo v kontekstu neke funkcije. Slednje je potrebno, ker se izvorna vrstica znotraj vstavljene funkcije lahko pojavi v kontekstu več funkcij. Navodila brez preslikave v dejansko izvorno vrstico so preslikana v vrstico številka 0 v datoteki `???`.

Funkcija

  Vse izvorne vrstice dane funkcije sestavljajo samo funkcijo. Funkcija je podana z imenom in lokacijo v nekem binarnem objektu, če je na voljo. Slednje je potrebno, ker lahko binarni objekti enega programa vsebujejo funkcije z enakim imenom (do teh je mogoče dostopati ⪚ s `dlopen` ali `dlsym`; povezovalnik izvajalnega časa razreši funkcije v danem iskalnem vrstnem redu uporabljenih binarnih objektov). Če orodje za profiliranje ne more zaznati imena simbola funkcije, ⪚ ker informacije o odpravljanju napak niso na voljo, se običajno uporabi naslov prvega izvedenega ukaza ali `???`.

Binarni objekt

  Vse funkcije, katerih koda je znotraj obsega danega binarnega objekta, bodisi glavnega izvršljivega ali skupna knjižnica.

Izvorna datoteka

  Vse funkcije, katerih prvi ukaz je preslikan v vrstico dane izvorne datoteke.

Razred

  Imena simbolov funkcij so običajno hierarhično urejena v imenskih prostorih, ⪚ Imenski prostori C++ ali razredi objektno orientiranih jezikov; tako lahko razred vsebuje funkcije razreda ali samih vdelanih razredov.

Del profila

  Nek časovni odsek izvajanja profila z danim ID-jem niti, ID-jem procesa in ukazno vrstico izvedeno.

Kot je razvidno iz seznama, niz stroškovnih entitet pogosto definira drugo stroškovno entiteto; tako obstaja hierarhija vključitve stroškovnih entitet.

Pozicijske torke:

- Klic z naslova ukaza na ciljno funkcijo.

- Klic iz izvorne vrstice v ciljno funkcijo.

- Klic iz izvorne funkcije v ciljno funkcijo.

- (Brez)pogojni skok od izvornega do ciljnega ukaza.

- (Brez)pogojni skok iz izvorne v ciljno vrstico.

Skoki med funkcijami niso dovoljeni, ker to nima smisla v grafu klicev; zato je treba konstrukte, kot so obravnavanje izjem in dolgi skoki v C, po potrebi prevesti v izpiranje klicnega sklada.

#### Vrste dogodkov

Poljubne vrste dogodkov lahko določite v podatkih profila tako, da jim daste ime. Njihov strošek, povezan s stroškovno entiteto, je 64-bitno celo število.

Vrste dogodkov, katerih stroški so določeni v podatkovni datoteki profila, se imenujejo resnični dogodki. Poleg tega lahko podate formule za vrste dogodkov, izračunane iz resničnih dogodkov, ki se imenujejo podedovani dogodki.

### Stanje vizualizacije

Stanje vizualizacije &kcachegrind; okno vključuje:

- primarni in sekundarni tip dogodka, izbran za prikaz,

- združevanje funkcij (uporabljeno v Function Profile seznam in barvanje entitet),

- deli profila, katerih stroški bodo vključeni v vizualizacijo,

- aktivni stroškovna entiteta (⪚ funkcija, izbrana iz stranske plošče profila funkcij),

- izbrana stroškovna entiteta.

To stanje vpliva na poglede.

Pogledi so vedno prikazani za eno stroškovno entiteto, aktivno. Ko dani pogled ni primeren za stroškovno entiteto, je onemogočen: pri izbiri ⪚ &ELF; predmet na seznamu skupine, izvorna opomba nima smisla.

Na primer, za aktivno funkcijo seznam klicanih prikazuje vse funkcije, ki so bile priklicane iz aktivne funkcije: eno od teh funkcij lahko izberete, ne da bi jo aktivirali. Če je zraven prikazan graf klicev, bo samodejno izbral isto funkcijo.

### Deli &GUI;

#### Stranski doki

Stranski doki so stranska okna, ki jih je mogoče postaviti na katero koli obrobo &kcachegrind; okna. Vedno vsebujejo na nek način razvrščen seznam stroškovnih entitet.

- Profil funkcije je seznam funkcij, ki prikazuje vključujoče in izključne stroške, število klicev, ime in položaj funkcij.

- Pregled delov

- Sklad klicev

#### Razgledno območje

Območje pogleda, običajno desni del &kcachegrind; glavno okno je sestavljeno iz enega (privzeto) ali več zavihkov, ki so poravnani vodoravno ali navpično. Vsak zavihek ima različne poglede samo ene stroškovne entitete naenkrat. Ime te entitete je navedeno na vrhu zavihka. Če je zavihkov več, je aktiven samo eden. Ime entitete v aktivnem zavihku je prikazano krepko in določa aktivno stroškovno entiteto datoteke &kcachegrind; oknu.

#### Območja zavihka

Vsak zavihek lahko vsebuje do štiri področja pogleda, in sicer zgoraj, desno, levo in dno. Vsako območje lahko vsebuje več zloženih pogledov. Vidni del območja je izbran z vrstico z zavihki. Vrstici z zavihki zgornjega in desnega območja sta na vrhu; vrstici z zavihki levega in spodnjega območja sta na dnu. S kontekstnimi meniji zavihkov lahko določite, kateri pogled naj gre v katero področje.

#### Sinhroniziran pogled z izbrano entiteto v zavihku

Poleg aktivne entitete ima vsak zavihek izbrano entiteto. Ker večina vrst pogledov prikazuje več entitet, pri čemer je aktivna nekako na sredini, lahko izbrani element spremenite tako, da se pomaknete znotraj pogleda (s klikom z miško ali s tipkovnico). Običajno so izbrani elementi prikazani v označenem stanju. Če spremenite izbrano entiteto v enem od pogledov zavihka, vsi drugi pogledi ustrezno označijo novo izbrano entiteto.

#### Sinhronizacija med zavihki

Če je zavihkov več, sprememba izbire na enem zavihku povzroči spremembo aktivacije na naslednjem zavihku, bodisi desno od prejšnjega ali pod njim. Tovrstna povezava naj bi na primer omogočala hitro brskanje po grafih klicev.

#### Postavitve

Postavitev vseh zavihkov v oknu je mogoče shraniti (Pogled Postavitev). Po podvajanju trenutne postavitve (&Ctrl; + Pogled Postavitev Dvojnik ) in spreminjanje nekaterih velikosti ali premikanje pogleda na drugo področje zavihka, lahko hitro preklapljate med staro in novo postavitvijo prek &Ctrl;← in &Ctrl; →. Nabor postavitev bo shranjen med &kcachegrind; seje istega profiliranega ukaza. Trenutni nabor postavitev lahko nastavite kot privzeto za novi &kcachegrind; seje ali obnovite privzeti nabor postavitve.

### Stranski doki

#### Ravni profil

Ravni profil vsebuje seznam skupin in seznam funkcij. Seznam skupin vsebuje vse skupine, v katerih se porabljajo stroški, odvisno od izbrane vrste skupine. Seznam skupin je skrit, ko je združevanje izklopljeno.

Seznam funkcij vsebuje funkcije izbrane skupine (ali vse funkcije, če je združevanje izklopljeno), razvrščene po nekem stolpcu, ⪚ vključno z lastnimi stroški. Na seznamu je prikazano največje število funkcij, ki jih je mogoče konfigurirati v Nastavitve Konfiguriraj KCachegrind.

#### Pregled delov

Pri izvajanju profila je mogoče ustvariti več podatkovnih datotek profila, ki jih je mogoče skupaj naložiti v &kcachegrind;. Stranski dokPregled delov jih prikazuje, razvrščene vodoravno glede na čas ustvarjanja; velikosti pravokotnika so sorazmerne s stroški, porabljenimi za vsak del. Izberete lahko enega ali več delov, da omejite stroške, prikazane v drugem &kcachegrind; pogled samo na te dele.

Deli so nadalje razdeljeni na razdelitev in vključujoč način delitve stroškov:

Način particioniranja

  Razdelitev je prikazana v skupinah za del podatkov profila glede na izbrano vrsto skupine. Na primer, če &ELF; so izbrane skupine predmetov, vidite barvne pravokotnike za vsak uporabljen &ELF; predmet (knjižnica v skupni rabi ali izvršljiva datoteka), velikosti glede na stroške, porabljene v njem.

Način diagrama

  Prikazan je pravokotnik, ki prikazuje vključujoče stroške trenutne aktivne funkcije v delu. To je spet razdeljeno, da prikaže vključujoče stroške klicanih.

#### Sklad klicev

To je čisto izmišljen najverjetnejši sklad klicev. Sestavi se tako, da se začne s trenutno aktivno funkcijo in doda klicatelje in klicane z najvišjimi stroški na vrhu in na dnu.

Stolpca Strošek in Klici prikazujeta stroške, uporabljene za vse klice funkcije v zgornji vrstici.

### Pogledi

#### Vrsta dogodka

Seznam Vrsta dogodka prikazuje vse razpoložljive vrste stroškov ter ustrezne lastne in vključujoče stroške trenutne aktivne funkcije za to vrsto dogodka.

Če na seznamu izberete vrsto dogodka, spremenite vrsto stroškov, prikazanih v celotnem &kcachegrind; izbranemu.

#### Seznami klicev

Ti seznami prikazujejo klice do in iz trenutno aktivne funkcije. Z Vsi klicatelji in Vsi klicatelji so mišljene tiste funkcije, ki so dosegljive v smeri klicatelja in klicanega, tudi če so druge funkcije vmes.

Pogledi seznama klicev vključujejo:

- Neposredne Klicatelje

- Neposredne Klicane

- Vsi klicatelji

- Vsi klicani

#### Zemljevidi

Pogled drevesnega zemljevida primarne vrste dogodka, navzgor ali navzdol po hierarhiji klicev. Vsak barvni pravokotnik predstavlja funkcijo; njegova velikost je približno sorazmerna s stroški, porabljenimi za to, medtem ko aktivna funkcija teče (vendar obstajajo omejitve risanja).

Za Zemljevid klicateljev graf prikazuje ugnezdeno hierarhijo vseh klicateljev trenutno aktivirane funkcije; za Zemljevid klicanih prikazuje podatke vseh klicanih.

Možnosti videza najdete v kontekstnem meniju. Če želite dobiti natančna razmerja velikosti, izberite Preskoči nepravilne obrobe. Ker je ta način lahko zelo zamuden, boste morda želeli prej omejiti največjo narisano raven gnezdenja. Najboljše določa smer razdelitve za otroke glede na razmerje stranic starša. Vedno najboljše odloča o preostalem prostoru za vsakega brata ali sestro. Prezri razmerja zavzame prostor za risanje imena funkcije pred risanjem podrejenih elementov. Upoštevajte, da so razmerja velikosti lahko močno napačna.

Krmarjenje po tipkovnici je na voljo s puščičnimi tipkami levo in desno za premikanje po bratih in sestrah ter s puščičnima tipkama navzgor in navzdol za premikanje po ravni gnezdenja navzgor in navzdol. &Enter; aktivira trenutni element.

#### Graf klicev

Ta pogled prikazuje graf klicev okoli aktivne funkcije. Prikazani stroški so samo stroški, porabljeni med dejanskim izvajanjem aktivne funkcije, &ie; strošek, prikazan za `main()` (če je viden), mora biti enak strošku aktivne funkcije, saj je to del vključujočega stroška `main()` porabljen, medtem ko je delovala aktivna funkcija.

Pri ciklih modre puščice za klic kažejo, da gre za umeten klic, ki se dejansko nikoli ni zgodil, dodan za pravilno risanje.

Če je graf večji od območja risanja, je ob strani prikazan pogled iz ptičje perspektive. Obstajajo možnosti pogleda, podobne tistim pri zemljevidih klicev; izbrana funkcija je označena.

#### Opombe

Označeni izvorni ali zbirniški seznami prikazujejo izvorne vrstice ali razstavljena navodila trenutne aktivne funkcije skupaj s (samo)stroški, porabljenimi za izvajanje kode izvorne vrstice ali navodila. Če je prišlo do klica, se v vir vstavijo vrstice s podrobnostmi o klicu: (vključno) stroški, porabljeni v klicu, število klicev in cilj klica.

Izberite takšno vrstico s podatki o klicu, da aktivirate cilj klica.

## Referenca ukazov

### Glavno &kcachegrind; okno

#### Meni Datoteka

&Ctrl;N Datoteka Novo

  Odpre prazno okno najvišje ravni, v katerega lahko naložite podatke profila. To dejanje pravzaprav ni potrebno, saj vam Datoteka Odpri odpre novo okno najvišje ravni, če trenutno že prikazuje nekaj podatkov.

&Ctrl;O Datoteka Odpri

  Odpre &kde; izbirnik datotek, da izberete datoteko s podatki profila, ki jo želite naložiti. Če so nekateri podatki že prikazani v trenutnem oknu najvišje ravni, se bo odprlo novo okno; če želite odpreti dodatne podatke o profilu v trenutnem oknu, uporabite Datoteka Dodaj.

  Ime podatkovnih datotek profila se običajno konča na `.pid.part-threadID`, kjer del in threadID nista obvezna. pid in part se uporabljata za več podatkovnih datotek profila, ki pripadajo enemu izvajanju aplikacije. Z nalaganjem datoteke, ki se konča samo z `pid`, se naložijo tudi vse obstoječe podatkovne datoteke za ta zagon z dodatnimi končnicami.

  Če obstajata podatkovni datoteki profila `cachegrind.out.123` in `cachegrind.out.123.1`, se bo z nalaganjem prve samodejno naložila tudi druga.

Datoteka Dodaj

  Doda podatkovno datoteko profila v trenutno okno. S tem lahko prisilite, da se več podatkovnih datotek naloži v isto okno najvišje ravni, tudi če niso iz istega izvajanja, kot določa konvencija o poimenovanju podatkovnih datotek profila. To lahko na primer uporabite za vzporedno primerjavo.

F5 Datoteka Znova naloži

  Znova naloži podatke profila. To je uporabno, če je bila ustvarjena druga podatkovna datoteka profila za že naloženo izvajanje aplikacije.

&Ctrl;Q Datoteka Zapusti

  Zapusti &kcachegrind;

## Vprašanja in odgovori

Zakaj je &kcachegrind;? Nimam pojma.

&kcachegrind; je v pomoč v pozni fazi razvoja programske opreme, imenovani profiliranje. Če ne razvijate aplikacij, ne potrebujete &kcachegrind;.

Kakšna je razlika med Incl. in sam?

To so atributi stroškov za funkcije glede neke vrste dogodka. Ker lahko funkcije kličejo druga drugo, je smiselno razlikovati med stroški same funkcije (Samo stroški) in stroški, vključno z vsemi klicanimi funkcijami (Vključni stroški). Samo se včasih imenuje tudi Izključni stroški.

Tako boste na primer za `main()` vedno imeli vključujoče stroške skoraj 100 %, medtem ko so lastni stroški zanemarljivi, ko je dejansko delo opravljeno v drugi funkciji.

Če dvakrat kliknem na funkcijo spodaj v pogledu Grafa klicev, prikaže za funkcijo `main()` enako ceno kot izbrana funkcija. Ali ne bi to moralo biti konstantno pri 100%?

Aktivirali ste funkcijo pod `main()`, ki očitno stane manj kot sama `main()`. Za vsako funkcijo je prikazan samo del stroškov, porabljen med izvajanjem aktivirane funkcije; to pomeni, da cena, prikazana za katero koli funkcijo, nikoli ne more biti višja od cene aktivirane funkcije.

Stroškovni subjekt

  Abstraktna postavka, povezana z izvorno kodo, ki ji je mogoče pripisati dogodek. Dimenzije za stroškovne entitete so lokacija kode (⪚ izvorna vrstica, funkcija), lokacija podatkov (⪚ tip podatkov, do katerega se dostopa, podatkovni objekt), lokacija izvajanja (⪚ nit, proces) in torkeali trojke zgoraj omenjenih pozicij (⪚ klici, dostop do objekta iz izjave, izločeni podatki iz predpomnilnika).

Stroški dogodka

  Vsota dogodkov neke vrste dogodka, ki se zgodijo, medtem ko je izvedba povezana z neko stroškovno entiteto. Stroški se pripišejo subjektu.

Vrsta dogodka

  Vrsta dogodka, katerega stroške je mogoče pripisati stroškovni entiteti. Obstajajo pravi tipi dogodkov in podedovani tipi dogodkov.

Podedovani tip dogodka

  Tip navideznega dogodka, viden le v pogledu, definiran s formulo, ki se izračuna iz dejanskih vrst dogodkov.

Podatkovna datoteka profila

  Datoteka, ki vsebuje podatke, izmerjene v eksperimentu s profilom, ali njegov del, ali pridobljene z naknadno obdelavo sledi. Njegova velikost je običajno linearna z velikostjo kode programa.

Podatkovni del profila

  Podatki iz podatkovne datoteke profila.

Preizkus profila

  Zagon programa, ki ga nadzoruje orodje za profiliranje, ki po možnosti ustvari več podatkovnih datotek profila iz delov ali niti zagona.

Profilni projekt

  Konfiguracija za poskuse profilov, ki se uporablja za profiliranje enega programa, morda v več različicah. Primerjave podatkov o profilih so običajno smiselne le med podatki o profilih, proizvedenimi v poskusih enega projekta profila.

Profiliranje

  Postopek zbiranja statističnih informacij o značilnostih izvajalnega časa izvajanja programa.

Vrsta resničnega dogodka

  Vrsta dogodka, ki ga je mogoče izmeriti z orodjem. To zahteva obstoj senzorja za dano vrsto dogodka.

Sled

  Zaporedje dogodkov s časovnim žigom, ki so se zgodili med sledenjem izvajanju programa. Njegova velikost je običajno linearna glede na čas izvajanja programa.

Del sledi
Sledenje

  Postopek nadzora izvajanja programa in shranjevanja njegovih dogodkov, razvrščenih po časovnem žigu, v izhodno datoteko, sled.

## Zasluge in licenca

Hvala Julianu Sewardu za njegov odličen &valgrind; in Nicholasu Nethercoteju za &cachegrind; dodatek. Brez teh programov &kcachegrind; ne bi obstajal. Nekaj idej za ta &GUI; so bili tudi od njih.

Hvala za vsa poročila o napakah in predloge različnih uporabnikov.

Prevod: Matjaž Jeranmatjaz.jeran@amis.net

&underFDL;
&documentation.index;