Sous-routine wlm_load

Objectif

Charge une configuration Workload Manager (WLM) dans le noyau.

Bibliothèque

Bibliothèque Workload Manager (libwlm.a)

Syntaxe

#include <sys/wlm.h> int wlm_load ( wlmargs) struct wlm_args *wlmargs;

Descriptif

Le sous-programme Wlm_load charge dans le noyau les fichiers de propriétés pour la configuration WLM transmise dans la zone Confrép de la structure Wlmargs . La zone Confrép peut également faire référence à un ensemble de configurations temporelles, auquel cas la configuration appropriée de l'ensemble sera chargée et le démon WLM basculera ultérieurement vers les autres configurations de l'ensemble sur une base de temps.

Si WLM est en cours d'exécution et que Confrép n'est pas à jour, cela permet de passer à la configuration spécifiée (ou à l'ensemble de configurations).

Si WLM est en cours d'exécution et que Confrép est en cours, Wlm_load actualisez la configuration WLM en cours dans le noyau. Si un nom de superclasse est indiqué dans la zone Nom de la sous-structure class_definition, seules les sous-classes de la superclasse donnée sont régénérées. Dans ce contexte:

Le sous-programme Wlm_load est accessible aux utilisateurs root et aux utilisateurs disposant de droits d'administration sur les sous-classes de la superclasse. Dans tous les autres cas, le sous-programme Wlm_load n'est accessible qu'aux utilisateurs root.
La sous-routine Wlm_load ne peut pas être utilisée pour modifier le mode de fonctionnement de WLM (par exemple, pour passer d'un mode actif à un mode passif).
Si Courant est un ensemble de configuration, Confrép doit être indiqué sous la forme Courant/Configuration où Configuration correspond à la configuration normale de l'ensemble auquel appartient la superclasse. Si Configuration est la configuration active de l'ensemble, les modifications prennent effet immédiatement, sinon elles prendront effet la prochaine fois que Configuration sera activé.

Si l'appelant de Wlm_load dispose de privilèges root et ne spécifie pas de superclasse, les indicateurs transmis dans Versindicateurs peuvent être utilisés pour démarrer WLM en mode actif ou passif, basculer entre les modes actif et passif, ou activer / désactiver les liaisons rset ou les limites totales du processus ou de la classe. La sous-routine Wlm_load ne peut pas être utilisée pour arrêter WLM. Utilisez la sous-routine Wlm_set à la place.

Paramètre

Article	Descriptif
Wlmargs	Indique l'adresse de la structure de données Struct wlm_args contenant des informations sur la configuration (ou le jeu de configuration ou la superclasse) à charger et sur le mode de fonctionnement de WLM.

Les zones suivantes de la structure Wlm_args et des sous-structures imbriquées peuvent être fournies:

Article	Descriptif
Versindicateurs	Doit être initialisé avec WLM_VERSION. Peut être ORed avec WLM_MUTE pour Wlm_load pour être silencieux. Si aucune modification ne doit être effectuée pour le mode de fonctionnement de WLM, elle doit être ORed avec WLM_TEST_ON (obligatoire si la superclasse est spécifiée). Sinon, l'un des indicateurs mutuellement exclusifs (WLM_ACTIVE, WLM_CPUONLY ou WLM_PASSIVE) doit être indiqué. Un ou plusieurs des indicateurs WLM_BIND_RSETS, WLM_PROCTOTAL ou WLM_CLASSTOTAL peuvent être donnés en option.
Confrép	Indique le nom de la configuration WLM à charger dans le noyau. Il doit s'agir du nom d'une configuration ou d'un ensemble de configurations valide dans le sous-répertoire /etc/wlm , de la chaîne current pour faire référence à la configuration active, ou, si la superclasse est spécifiée et que la configuration en cours est un ensemble de configurations, il doit indiquer la configuration de l'ensemble en cours à laquelle la superclasse appartient sous la forme: current/config (différent de la spécification de config uniquement, qui est considérée comme une demande de commutateur de configuration).
nom	Indique le nom d'un Superclasse. Cette option permet d'actualiser uniquement les sous-classes d'une superclasse donnée.

Article

Descriptif

Versindicateurs

Doit être initialisé avec WLM_VERSION. Peut être ORed avec WLM_MUTE pour Wlm_load pour être silencieux.

Si aucune modification ne doit être effectuée pour le mode de fonctionnement de WLM, elle doit être ORed avec WLM_TEST_ON (obligatoire si la superclasse est spécifiée).

Sinon, l'un des indicateurs mutuellement exclusifs (WLM_ACTIVE, WLM_CPUONLY ou WLM_PASSIVE) doit être indiqué. Un ou plusieurs des indicateurs WLM_BIND_RSETS, WLM_PROCTOTAL ou WLM_CLASSTOTAL peuvent être donnés en option.

Confrép

Indique le nom de la configuration WLM à charger dans le noyau. Il doit s'agir du nom d'une configuration ou d'un ensemble de configurations valide dans le sous-répertoire /etc/wlm , de la chaîne current pour faire référence à la configuration active, ou, si la superclasse est spécifiée et que la configuration en cours est un ensemble de configurations, il doit indiquer la configuration de l'ensemble en cours à laquelle la superclasse appartient sous la forme: current/config (différent de la spécification de config uniquement, qui est considérée comme une demande de commutateur de configuration).

nom

Indique le nom d'un Superclasse. Cette option permet d'actualiser uniquement les sous-classes d'une superclasse donnée.

Valeurs renvoyées

Une fois l'exécution terminée, la sous-routine Wlm_load renvoie une valeur de 0. Si la sous-routine Wlm_load échoue, une valeur différente de zéro est renvoyée.

Codes d'erreur

Pour obtenir la liste des codes d'erreur possibles renvoyés par les fonctions d'API WLM, voir la description du fichier d'en-tête wlm.h .