pj_dump - Online în cloud

PROGRAM:

NUME

pj_dump - aruncă un fișier de urmărire paje într-un format textual asemănător CSV

REZUMAT

pj_dump [OPŢIUNI] [FILE]

DESCRIERE

pj_dump(1) comanda traduce fișierul de urmărire paje FILE într-un format textual asemănător CSV
(descris mai jos). Este un program util pentru a analiza comportamentul paralel și
aplicații distribuite care au fost urmărite folosind o bibliotecă care generează fișiere de urmărire în
formatul de fișier Paje. Odată ce aruncați conținutul fișierului de urmărire Paje într-un CSV asemănător
mod, sunteți liber să analizați conținutul urmei așa cum doriți. Puteți folosi R
de exemplu pentru a desena diagrame de dispersie și diagrame Gantt. Dacă FILE nu este furnizat, atunci
este utilizată intrarea standard.

În mod implicit, pj_dump va citi fișierul de urmărire de la început până la sfârșitul fișierului
găsite. În timpul acestui proces, pj_dump se bazează pe biblioteca Paje pentru a recrea în memorie
comportament care este înregistrat în fișierele de urmărire. Aceasta înseamnă că pj_dump va pune în memorie
tot conținutul fișierului de urmărire, chiar dacă intrarea este foarte mare. Odată ce tot conținutul
ale fișierului de urmărire sunt simulate, pj_dump aruncă informațiile în textul de tip CSV
format descris mai jos în secțiunea DESCRIERE IEȘIRI.

Puteți modifica comportamentul implicit al pj_dump prin furnizarea parametrilor --start=START
si --end=END unde START și END sunt marcaje temporale valide ale traseului de intrare. Dacă este furnizat, acesta
aruncă doar conținutul urmei între START și END. Rețineți că, chiar dacă este utilizat,
pj_dump va simula întregul fișier de urmărire pentru a păstra aceeași semantică a comportamentului. O alta
modalitatea de a schimba comportamentul implicit este prin intermediul --stop-at=TIME parametru. Dacă este furnizat,
pj_dump va citi fișierul de urmărire până la marcajul de timp TIME (având în vedere că fișierul de urmărire este
complet comandat în timp) și aruncă ceea ce a fost simulat până atunci. The --nu-strict
comutatorul trebuie evitat și poate fi folosit numai cu fișierele de urmărire Paje vechi cu câmp vechi
nume în definițiile evenimentelor. The --ignore-linkuri-incomplete face comutator pj_dump ignora
link-uri incomplete în tăcere. Mai multe detalii despre acest comutator mai jos, în DESCRIEREA IEȘIRII
secţiune.

OPŢIUNI

pj_dump acceptă următoarele opțiuni:

-A, --opreste la=TIMP
Opriți simularea urmăririi la TIME.

-da, --start=START
Dump-ul începe la marcajul de timp START (în loc de marcajul de timp 0).

-e, --Sfârșit=Sfârşit
Dump ends timestamp END (în loc de End Of File).

-n, --nu-strict
Acceptă nume de câmpuri vechi în definițiile evenimentelor.

-z, --ignore-linkuri-incomplete
Ignorați linkurile incomplete fără avertismente.

-u, --definit de utilizator
Eliminați câmpurile definite de utilizator. Consultați secțiunea CÂMPURI DEFINITE DE UTILIZATOR de mai jos.

-f, --contracta
Utilizați un cititor de fișiere alternativ bazat pe flex/bison (experimental).

-?, --Ajutor
Afișați toate opțiunile disponibile.

--utilizare
Trimiteți un scurt mesaj de utilizare.

INTRARE DESCRIERE

pj_dump(1) comanda așteaptă o intrare care urmează formatul de fișier Paje (așa cum este descris în
documentul PDF listat în secțiunea RESURSE a acestei pagini). Dacă FILE nu este furnizat,
pj_dump(1) va încerca să citească din intrarea standard.

REZULTATE DESCRIERE

Este mai ușor de înțeles ce scrie aici dacă cunoști Paje
terminologie (container, stat, variabilă, link, eveniment și informațiile atașate fiecăruia
din acestea). Aruncă o privire la descrierea formatului de fișier Paje (link de mai jos în
secțiunea RESURSE) pentru mai multe detalii.

Conținutul liniilor generate de pj_dump(1) comenzile sunt separate prin virgule,
definirea coloanelor. Deci, o linie ca aceasta:

Container, 0, LINK, 0, 4.48514, 4.48514, 9

are șapte coloane. Prima coloană este întotdeauna una dintre: Container, State, Variable, Event sau
Legătură. Coloanele rămase ale liniei au informații specifice în funcție de prima
coloană. Iată o descriere sintetică a celor cinci tipuri diferite de linii pe care le veți găsi ca
ieșire din pj_dump(1):

Container, parentContainer, containerType, startTime, endTime, duration, name
Stare, container, stateType, startTime, endTime, duration, imbrication, value
Variabilă, container, VariabilType, startTime, endTime, duration, value
Eveniment, container, eventType, timp, valoare
Link, container, linkType, startTime, endTime, duration, value, startContainer, endContainer

Vezi mai jos o descriere detaliată cu exemple pentru fiecare dintre ele.

Recipient
Toate liniile incep cu Recipient arata asa:

Container, 0, HOST, 0, 4.48514, 4.48514, Tremblay

1. „Container”

2. „0” - Numele containerului părinte

3. „HOST” - Tipul acestui container

4. "0" - Ora de începere

5. „4.48514” - Timpul final

6. "4.48514" -Durata

7. „Tremblay” - Numele acestui container

Stat
Toate liniile incep cu Stat arata asa:

Stat, nod48, SERVICE, 691, 692, 1, 0, rezervat

1. „Stat”

2. "node48" - Numele containerului

3. „SERVICE” – Tipul acestei stări

4. "691" - Ora de începere

5. „692” - Timpul final

6. „1” - Durata

7. "0" - Nivelul de imbricare

8. „rezervat” - Valoarea statului

Variabil
Toate liniile incep cu Variabil arata asa:

Variabilă, Tremblay, pcompute, 2.15357, 2.17013, 0.016554, 9.8095e+07

1. „Variabilă”

2. „Tremblay” - Numele containerului

3. "pcompute" - Numele variabilei

4. "2.15357" - Ora de începere

5. „2.17013” – Ora de încheiere

6. „0.016554” - Durata

7. "9.8095e+07" - Valoarea variabilei

eveniment
Toate liniile incep cu eveniment arata asa:

Eveniment, Tremblay, msmark, 3.4286, finish_send_tasks

1. „Eveniment”

2. „Tremblay” - Numele containerului

3. „msmark” - Numele evenimentului

4. „3.4286” - Momentul în care a avut loc acest eveniment

5. „finish_send_tasks” - Valoarea evenimentului

Link
Toate liniile incep cu Link arata asa:

Link, 0, 0-HOST1-LINK4, 0, 0, 0, G, Tremblay, 9

1. „Link”

2. „0” - Numele containerului

3. „0-HOST1-LINK4” - Tipul acestui link

4. "0" - Ora de începere

5. „0” – Ora de încheiere

6. „0” - Durata

7. „G” – Valoarea acestui link

8. „Tremblay” - Containerul de pornire

9. „9” - Containerul final

Incomplet Link-uri
Conform descrierii formatului de fișier Paje, o legătură este formată din două evenimente:
PajeStartLink și PajeEndLink. Aceste evenimente sunt egalate de Simulatorul Paje folosind a
cheie care este furnizată în fișierul de urmărire. Dacă unul dintre aceste două evenimente lipsește pentru
un motiv arbitrar și fișierul de urmărire se termină (sau containerul este distrus), veți
ai o simulare cu incomplet Link-uri. În general, Paje Simulator și de
consecință pj_dump, considerați aceste linkuri drept erori și enumerați-le în cele ce urmează
manieră:

$ pj_dump ~/tracefile.paje
Lista de linkuri incomplete din containerul „0”:
Link, 0, MSG_PROCESS_TASK_LINK, 0, -1, 0, SR, broadcaster-12, NULL
Link, 0, MSG_PROCESS_TASK_LINK, 0.00013, -1, 0, SR, broadcaster-13, NULL
Link, 0, MSG_PROCESS_TASK_LINK, 0.002868, -1, 0, SR, broadcaster-13, NULL
(...)
PajeLinkException: linkuri incomplete la sfârșitul containerului cu numele „0”

Cea mai bună acțiune atunci când se întâmplă acest lucru este să reparați trasorul sau convertorul care a generat
urma, deoarece indică probabil o eroare în timpul execuției. Daca tu crezi
că această eroare este acceptabilă, puteți furniza -z schimba cu pj_dump să-i spună
Paje Simulator pentru a ignora link-urile incomplete. Toate fișierele de urmărire vor fi descărcate și toate
erorile privind linkurile incomplete vor fi ignorate în tăcere. Utilizați cu prudență.

DEFINIT DE UTILIZATOR CÂMPURI

Câmpurile definite de utilizator este o caracteristică a formatului de fișier de urmărire Paje pentru a adăuga suplimentar
informaţii din urmă care nu aparţin domeniilor tradiţionale ale fiecărui eveniment
definiție. O definiție de eveniment cu patru câmpuri definite de utilizator (Dimensiune, Parametri, Amprentă și
Tag) arată astfel:

%EventDef PajeSetState 20
% Data oră
% șir container
% Tip șir
% șir de valoare
% Dimensiune șir
% șir de parametri
% șir de amprentă
% șir de etichete
%EndEventDef

Dump-ul câmpurilor definite de utilizator este dezactivat implicit în pj_dump. Utilizatorul poate activa
ei prin trecere -u (Sau --definit de utilizator) ca argument. Când faceți acest lucru, ieșirea de tip CSV a
pj_dump va fi modificat de la definiția de mai sus (vezi DESCRIEREA IEȘIRII). in afara de asta
dumping câmpurile implicite pentru fiecare entitate și container al urmei, CSV-ul va avea
câmpuri suplimentare care corespund câmpurilor definite de utilizator. Ordinea în care apar
în ieșire respectă ordinea definiției evenimentului corespunzătoare. Deci a Stat definit
cu definiția evenimentului 20 de mai sus va avea patru câmpuri suplimentare în CSV-like
ieșire.

RESURSE

Descrierea fișierului de urmărire Paje:
http://paje.sourceforge.net/download/publication/lang-paje.pdf

Site-ul web principal: http://github.com/schnorr/pajeng/

RAPORTAREA GANDACI

Raportați erorile pj_dump cătrehttp://github.com/schnorr/pajeng/issues>

DREPTURI DE AUTOR

Copyright (C) 2012-2014 Lucas M. Schnorr. Utilizarea gratuită a acestui software este acordată în temeiul
termenii GNU General Public License (GPL).

Utilizați pj_dump online folosind serviciile onworks.net