rs_getpartition, Subroutine

Zweck

Ruft die Partitionsressourcengruppe ab, der ein Prozess zugeordnet ist.

Bibliothek

Standard-C-Bibliothek (libc.a)

Syntax

#include <sys/rset.h>
int rs_getpartition (pid, rset)
pid_t pid;
rsethandle_t rset;

Beschreibung

Die Subroutine rs_getpartition gibt die Partitionsressourcengruppe zurück, die dem angegebenen Prozess zugeordnet ist. Der Wert RS_MICH für die Prozess-ID gibt an, dass die Partitionsressourcengruppe angefordert wurde, die dem aktuellen Prozess zugeordnet ist.

Der Rückgabewert der Subroutine rs_getpartition gibt den Typ der zurückgegebenen Ressourcengruppe an.

Der Wert RS_PARTITION_RSET gibt an, dass der Prozess über eine Partitionsressourcengruppe verfügt, die explizit festgelegt ist. Dies kann mit der Subroutine rs_setpartition oder durch Verwendung von WLM-Arbeitsklassen mit Ressourcengruppen festgelegt werden.

Der Wert RS_DEFAULT_RSET gibt an, dass der Prozess keine explizit festgelegte Partitionsressourcengruppe hat. Die Systemstandardressourcengruppe wird zurückgegeben.

Parameter

Element	Beschreibung
pid	Gibt die Prozess-ID an, deren Partition RSet angefordert wird.
rset	Gibt die Ressourcengruppe an, die die Partitionsressourcengruppe des Prozesses empfangen soll.

Rückgabewerte

Bei erfolgreicher Ausführung wird der Wert RS_PARTITION_RSET oder RS_DEFAULT_RSET zurückgegeben. Wenn dies nicht gelingt, wird der Wert -1 zurückgegeben, und die globale Variable errno wird gesetzt, um den Fehler anzuzeigen.

Fehlercodes

Die Subroutine rs_getpartition ist nicht erfolgreich, wenn mindestens eine der folgenden Bedingungen zutrifft:

Element	Beschreibung
EFAULT	Ungültige Adresse.
ESRCH	Der durch den Parameter Pid angegebene Prozess ist nicht vorhanden.