Sous-routine krs_getinfo

Editer en ligne

Objectif

Permet d'obtenir des informations sur un ensemble de ressources.

Syntaxe

#include <sys/rset.h>
int krs_getinfo(rset, info_type, flags, result)
rsethandle_t rset;
rsinfo_t info_type;
unsigned int flags;
int *result;

Descriptif

La sous-routine Krs_getinfo extrait des informations sur l'ensemble de ressources identifié par le paramètre Rset . En fonction de la valeur du paramètre Type_info , la sous-routine Krs_getinfo renvoie des informations sur le nombre de processeurs disponibles, le nombre de pools de mémoire disponibles ou la quantité de mémoire disponible contenue dans la ressource Rset.

La sous-routine peut également renvoyer des informations système globales telles que le niveau de détail maximal du système, le niveau de détail du système multiprocesseur symétrique (SMP) et le système MCM (multiple chip module), ainsi que le nombre maximal de ressources de pool de mémoire ou de processeur dans un jeu de ressources.

Paramètres

Article Descriptif
rset Indique un descripteur de jeu de ressources d'un ensemble de ressources dont les informations doivent être extraites. Ce paramètre n'est pas significatif si le paramètre Type_info est R_MAXSDL, R_MAXPROCS, R_MAXMEMPS, R_SMPSDL ou R_MCMSDL.
Type_info Indique le type d'informations demandées. L'une des valeurs suivantes (définie dans rset.h) peut être utilisée:
  • R_NUMPROCS: le nombre de processeurs disponibles dans l'ensemble de ressources est renvoyé.
  • R_NUMMEMPS: le nombre de pools de mémoire disponibles dans l'ensemble de ressources est renvoyé.
  • TAILLE DE FICHIER: La quantité de mémoire disponible (en Mo) contenue dans l'ensemble de ressources est renvoyée.
  • R_MAXSDL: Le niveau de détail système maximal du système est renvoyé.
  • R_MAXPROCS: le nombre maximal de processeurs pouvant être contenus dans un jeu de ressources est renvoyé.
  • R_MAXMEMPS: le nombre maximal de pools de mémoire pouvant être contenus dans un jeu de ressources est renvoyé.
  • R_SMPSDL: le niveau de détail système correspondant à la notion traditionnelle d'un SMP est renvoyé. Un niveau de détail de système 0 est renvoyé si le système matériel ne fournit pas de données de topologie système.
  • R_MCMSDL: le niveau de détail système correspondant aux ressources conditionnées dans un MCM est renvoyé. Un niveau de détail de système 0 est renvoyé si le système matériel n'a pas de MCM ou ne fournit pas de données de topologie système.
Flags Réservé pour une utilisation future. Doit être indiqué comme 0.
résultat Pointe vers un entier où le résultat est stocké lors de l'exécution réussie.

Valeurs renvoyées

Une fois l'exécution terminée, la sous-routine Krs_getinfo renvoie une valeur 0, et la zone Résultat contient les informations demandées. En cas d'échec, un ou plusieurs des éléments suivants sont renvoyés:
Article Descriptif
EINVAL Les causes possibles sont les suivantes :
  • Le paramètre Type_info indique une valeur de type de ressource non valide.
  • Le paramètre Indicateurs n'a pas été spécifié en tant que 0.
EDÉFAUT Adresse non valide.