krs_alloc Subroutine

Online bearbeiten

Zweck

Ordnet eine Ressourcengruppe zu und gibt ihre Kennung zurück.

Syntax

#include <sys/rset.h>
int krs_alloc (rset, flags)
rsethandle_t *rset;
unsigned int flags;

Beschreibung

Die Subroutine Krs_Alloc ordnet eine Ressourcengruppe entsprechend den im Parameter Flags angegebenen Informationen zu und initialisiert sie. Der Wert des Parameters Flags bestimmt, wie die neue Ressourcengruppe initialisiert wird.

Parameter

Element Beschreibung
rset Verweist auf eine Satzkennung (rsethandle_t) , in der die Kennung der Ressourcengruppe nach erfolgreichem Abschluss gespeichert wird.
Flags Gibt an, wie die neue Ressourcengruppe initialisiert wird. Sie hat einen der folgenden Werte, die in rset.hdefiniert sind:
  • RS_LEER (oder 0 Wert): Die Ressourcengruppe wird so initialisiert, dass sie keine Ressourcen enthält.
  • RS_SYSTEM: Die Ressourcengruppe wird so initialisiert, dass sie verfügbare Systemressourcen enthält.
  • RS_ALLE: Die Ressourcengruppe wird so initialisiert, dass sie alle Ressourcen enthält.
  • RS_PARTITION: Die Ressourcengruppe wird so initialisiert, dass sie die Ressourcen in der Ressourcengruppe der Prozesspartition des Aufrufenden enthält.

Rückgabewerte

Nach erfolgreicher Beendigung gibt die Subroutine Krs_Alloc den Wert 0 zurück. Ist dies nicht erfolgreich, wird mindestens eines der folgenden Elemente zurückgegeben:
Element Beschreibung
EINVAL Der Parameter Flags enthält einen ungültigen Wert.
ENOMEM Es ist nicht genügend Speicherplatz vorhanden, um die Datenstrukturen zu erstellen, die sich auf die Ressourcengruppe beziehen.