strace(1M)                                                       strace(1M)

NAME
     strace - Ausgabe von STREAMS-Trace-Meldungen

SYNTAX
     strace [Modul Untermodul Ebene] ...

BESCHREIBUNG
     strace ohne Argumente schreibt alle STREAMS-Trace-Meldungen von allen
     Treibern und Modulen in die eigene Standardausgabe. Diese Meldungen
     kommen vom STREAMS Protokolltreiber [log(7)]. Argumente müssen als
     Tripel der Form Modul, Untermodul, Ebene angegeben werden, wobei Modul
     die STREAMS Modulnummer bezeichnet, Untermodul die Nummer eines Unter-
     moduls, und Ebene die Trace-Ebene. Jedes Tripel bestimmt, für welchen
     Modul/Treiber und Untermodul (üblicherweise das untergeordenete Gerät)
     Trace-Meldungen empfangen werden sollen, und die gewünschte Trace-
     Ebene (gleich oder unterhalb der aktuellen Ebene). Das reservierte
     Wort all innerhalb eines solchen Tuples bewirkt, daß das entsprechende
     Attribut nicht eingeschränkt wird.

     Jede Trace-Meldung hat das Format:

     Nr Uhrzeit Systemzeit Ebene Status Modul Untermodul Text

     Nr           Laufende Nummer der Trace-Meldung

     Uhrzeit      Uhrzeit der Meldung in hh:mm:ss

     Systemzeit   Systemzeit der Meldung seit dem letztem Laden

     Ebene        Prioritätsebene

     Status       E: Meldung wurde auch in die Fehlerdatei geschrieben

                  F: Schwerer Fehler

                  N: Eine Nachricht wurde an den Systemverwalter gesendet

     Modul        Modulnummer der Sendequelle

     Untermodul   Untermodulnummer der Sendequelle

     Text         Klartext der Trace-Meldung

     Ein einmal gestarteter strace bleibt aktiv, bis er wieder vom Benutzer
     beendet wird.










Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

strace(1M)                                                       strace(1M)

BEISPIELE
     Ausgabe aller Trace-Meldungen für das Modul bzw. den Treiber mit der
     Nummer 41:

          strace  41 all all

     Ausgabe aller Trace-Meldungen für das Modul bzw. den Treiber mit der
     Nummer 41 und der Untermodulnummer 0, 1 oder 2:

          strace  41 0 1  41 1 1  41 2 0

     Meldungen von den Untermodulen 0 und 1 müssen eine Trace-Ebene von 1
     oder weniger haben, diejenigen vom Untermodul 2 eine Trace-Ebene von
     0.

HINWEISE
     Aufgrund von Durchsatzgründen darf nur ein einziger strace-Prozeß im
     System Zugriff zum STREAMS-Protokolltreiber haben. Der Protokolltrei-
     ber verwaltet die Liste der im Funktionsaufruf angegebenen Tripel und
     vergleicht sie mit jeder anfallenden Trace-Meldung. Bei Übereinstim-
     mung wird die Meldung aufbereitet und an den strace-Prozeß gesendet.
     Das bedeutet, daß eine lange Liste von Tripeln eine größere Auswirkung
     auf den STREAMS-Durchsatz insgesamt hat. Ein laufender strace hat die
     größte Auswirkung auf das Laufzeitverhalten derjenigen Module und
     Treiber, die die Trace-Meldungen für den strace-Prozeß auslösen. Immer
     dann, wenn Trace-Meldungen schneller erzeugt werden, als sie der
     strace-Prozeß verarbeiten kann, können einzelne Meldungen verloren
     gehen. Dies kann anhand der laufenden Numerierung der Trace-Meldungen
     überprüft werden.

SIEHE AUCH
     log(7).

     Leitfaden für Programmierer: STREAMS




















Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98