dscr_ctl, Subroutine

Zweck

Syntax

#include <sys/machine.h>

int dscr_ctl(int operation, void * buf_p, int size);

Beschreibung

Die Firmware stellt einen Plattformstandardwert für das DSCR-Register bereit. Wenn die Vorablesezugriffstiefe im DSCR-Register auf 0 gesetzt ist, verwendet der Prozessor diesen Standardwert implizit.

Der Systemaufruf dscr_ctl ermöglicht einer privilegierten Anwendung, einen Betriebssystemstandardwert für das DSCR festzulegen, der den Plattformstandardwert überschreibt.

Mit dem Systemaufruf dscr_ctl kann jede Anwendung einen prozessspezifischen Wert für das DSCR-Register festlegen, der den Standardwert des Betriebssystems für diesen Prozess überschreibt.

Wenn ein Thread den Systemaufruf dscr_ctl ausgibt, um die Vorablesezugriffstiefe für den Prozess zu ändern, wird der neue Wert in den AIX® -Prozesskontext und in das DSCR des Threads geschrieben, der den Systemaufruf ausführt. Wenn ein anderer Thread im Prozess gleichzeitig auf einem anderen Prozessor ausgeführt wird, wird er erst mit dem neuen DSCR-Wert gestartet, nachdem der neue Wert erneut aus dem Prozesskontext geladen wurde.

Wenn die Ausführung eines Threads auf einem Prozessor gestartet wird, wird der Wert des DSCR für den Eignerprozess in das DSCR-Register geschrieben. Wenn der Prozess seinen DSCR-Wert nicht mit dem Systemaufruf dscr_ctl festgelegt hat, wird der Standardwert des Betriebssystems verwendet.

Wenn die Subroutine fork aufgerufen wird, übernimmt der neue Prozess den DSCR-Wert von seinem übergeordneten Prozess. Dieser Wert wird auf den Systemstandardwert zurückgesetzt, wenn die Subroutine exec aufgerufen wird.

Auf Systemen, die die programmgesteuerte Einstellung des DSCR über den Fehlerstatuszugriff (Benutzerzugriff) unterstützen, wie z. B. POWER8, ist der durch diesen Zugriff festgelegte Wert threadspezifisch und überschreibt alle anderen Werte, auch die Werte, die durch diesen Service geschrieben werden. Mit anderen Worten: Die Bearbeitung des Problemstatus des DSCR ermöglicht die feinste Granularität des Zugriffs (pro Thread) auf die Funktionalität der Hardwaredatenströme.

DPFD_DEFAULT            0
DPFD_NONE               1
DPFD_SHALLOWEST         2
DPFD_SHALLOW            3
DPFD_MEDIUM             4
DPFD_DEEP               5
DPFD_DEEPER             6
DPFD_DEEPEST            7

DSCR_SSE                1<<3
DSCR_SNSE               1<<4
DSCR_LSD                1<<5

URG_DEFAULT             0<<6
URG_NOT_URGENT          1<<6
URG_LEAST_URGENT        2<<6
URG_LEAST_URGENT        3<<6
URG_LESS_URGENT         4<<6
URG_MEDIUM              5<<6
URG_MORE_URGENT         6<<6
URG_MOST_URGENT         7<<6

DSCR_HWUE (1<<19)
DSCR_SWUE (1<<20)
DSCR_LTE  (1<<21)
DSCR_STE  (1<<22)
DSCR_HWTE (1<<23)
DSCR_SWTE (1<<24)

Im Folgenden wird die Struktur dscr_properties in der Datei <sys/machine.h> beschrieben:

struct dscr_properties {
      uint        version;             /* Properties struct version                   */
      uint        number_of_streams;   /* Number of hardware streams                  */
      long long   platform_default_pd; /* PFW default DSCR value                      */
      long long   os_default_pd;       /* AIX default DSCR value                      */
      int         dscr_version;        /* Architecture version, such as PowerISA 2.07 */
      uint        dscr_control;        /* System-wide DSCR control (read only)        */
      long long   dscr_smt[5];         /* DSCR/SMT Matrix                             */
      long long   dscr_mask;           /* Mask of valid bits per architecture version */
};

Abhängig von der Version von Instruction Set Architecture (ISA) für Power Systems-Server, die von einer bestimmten AIX -Version auf einer angegebenen Hardwareplattform unterstützt wird, wird möglicherweise nur eine Untergruppe der zuvor angezeigten Bits unterstützt.

In der Headerdatei <sys/machine.h> finden Sie die Definitionen für das Feld dscr_version und die entsprechenden Bits, die für jede Version unterstützt werden.

#include <sys/machine.h>
int rc;
long long dscr = DSCR_SSE | DPFD_DEEPER;
rc = dscr_ctl(DSCR_WRITE, &dscr);

Parameter

Rückgabewerte

Fehlercodes

Wenn die Subroutine dscr_ctl fehlschlägt, wird errno auf einen der folgenden Werte gesetzt: