pm_set_program_mythread_mx und pm_set_program_mythread_mm Subroutinen

Online bearbeiten

Zweck

Legt die Performance Monitor-Programmierung im Zählermultiplexmodus und im Multimodus für den aufrufenden Thread fest.

Bibliothek

Performance Monitor APIs Library (libpmapi.a)

Syntax

#include <pmapi.h>

int pm_set_program_mythread_mx ( *prog)
pm_prog_mx_t *prog;

int pm_set_program_mythread_mm ( *prog_mm)
pm_prog_mm_t *prog_mm;

Beschreibung

Die Subroutinen pm_set_program_mythread_mx und pm_set_program_mythread_mm legen die Performance Monitor-Programmierung im Zählermultiplexmodus bzw. im Multimodus für den aufrufenden Kernel-Thread fest.

Die Subroutineneinstellung pm_set_program_mythread_mx enthält die Liste der zu zählenden Ereignisarrays und einen Modus, in dem gezählt werden kann. Der Modus ist für alle Ereignislisten global. Die zu zählenden Ereignisse befinden sich in einem Array mit einer Liste von Ereignis-IDs.

Die Einstellung pm_set_program_mythread_mm enthält die Listen der zu zählenden Ereignisarrays und die zugehörigen Modi, in denen jedes Ereignisarray gezählt werden soll. Für jedes Ereignisarray wird ein Zählmodus definiert.

Die Ereignis-IDs müssen aus den von der Subroutine pm_initialize zurückgegebenen Listen ausgewählt werden.

Der Zählmodus für beide Subroutinen umfasst den Benutzermodus und/oder den Kernelmodus sowie den Anfangszählungsstatus. Die Standardwerte sind für den Benutzermodus und den Kernelmodus inaktiviert und der Anfangsstandardstatus ist so eingestellt, dass die Zählung verzögert wird, bis die Subroutine pm_start_mythread aufgerufen wird.

Wenn Sie die Subroutine pm_set_program_mythread_mm für die Multimoduszählung verwenden, werden der Prozessbaummodus und der Startzählungsmodus durch die Werte festgelegt, die in der ersten Programmiergruppe definiert sind.

Wenn die Liste ein Ereignis enthält, das mit einem Schwellenwert verwendet werden kann (wie durch die Subroutine pm_init angegeben) kann auch ein Schwellenwert angegeben werden.

Parameter

Element Beschreibung
* prog Gibt die Ereignisse und Modi an, die in der Konfiguration des Leistungsmonitors verwendet werden. Der Parameter prog unterstützt die folgenden Modi:
PM-BENUTZER
Zählt Prozesse, die im Benutzermodus ausgeführt werden (Standardeinstellung ist 'Aus').
PM_KERNEL
Zählt Prozesse, die im Kernelmodus ausgeführt werden (der Standardwert ist Off).
PM_XX_ENCODE_CASE_ONE anzahl
Startet die Zählung sofort (Standardwert ist "Zählung nicht starten").
PM_PROCESS (Prozess)
Erstellt eine Zählgruppe auf Prozessebene.
* prog_mm Gibt die Ereignisse und Modi an, die in der Konfiguration des Leistungsmonitors verwendet werden. Der Parameter prog_mm unterstützt die folgenden Modi:
PM-BENUTZER
Zählt Prozesse, die im Benutzermodus ausgeführt werden (Standardeinstellung ist 'Aus').
PM_KERNEL
Zählt Prozesse, die im Kernelmodus ausgeführt werden (der Standardwert ist Off).
PM_XX_ENCODE_CASE_ONE anzahl
Startet die Zählung sofort (standardmäßig wird die Zählung nicht gestartet).
PM_PROZESSBAUM
Setzt die Zählung nur für den aufrufenden Prozess und seine untergeordneten Prozesse auf "Ein" (Standardeinstellung ist "Aus").

Der Modus PM_PROCTREE und der Modus PM_COUNT , der in der ersten Einstellung definiert ist, korrigieren den Wert für die Zählung.

Rückgabewerte

Element Beschreibung
0 Operation wurde erfolgreich beendet.
Positiver Fehlercode Verwenden Sie die Subroutine pm_error , um den Fehlercode zu decodieren.

Fehlercodes

Weitere Informationen finden Sie in der Beschreibung der Subroutine pm_error.

Dateien

Element Beschreibung
/usr/include/pmapi.h Definiert Standardmakros, Datentypen und Subroutinen.