Service de noyau kwpar_checkpoint_status

Objectif

Fournit une méthode pour les services de noyau afin d'informer le système qu'un événement s'est produit dans une partition de charge de Partition de charge (WPAR) qui nie ou réautorise par la suite un point de contrôle de la WPAR.

Syntaxe

#include <sys/wparid.h>

Int kwpar_checkpoint_status (Kcid, Cmd, Varp)
Cid_t Kcid;
Int Cmd;
Void * Varp;

Paramètres

Article	Descriptif
CMD	Commande de type entier qui informe l'API de l'action à effectuer pour le compte de l'appelant.
Kcid	ID WPAR où l'opération de commande doit avoir lieu.
Varp	Pointeur de vide vers différents éléments qui dépend du paramètre Cmd . Si le paramètre Cmd est défini sur la valeur WPAR_CHECKPOINT_TRY , le paramètre Varp est un pointeur vers une variable entière qui contient le nombre de secondes que l'appelant est prêt à attendre avant qu'un événement de blocage ne soit supprimé. Si le paramètre Cmd est défini sur la valeur WPAR_CHECKPOINT_DENY , le paramètre Varp est un pointeur vers une chaîne de caractères indéfinie qui contient une raison lisible par l'utilisateur pour l'affichage de l'événement.

Types de commande

Le paramètre Cmd est fourni sur l'entrée de l'API Kwpar_checkpoint_status et décrit le type d'action ou de notification d'événement attendu par l'appelant. Les types Cmd suivants sont pris en charge:

Article	Descriptif
WPAR_CHECKPOINT_DENY	L'appelant fait l'expérience d'un événement dans la WPAR identifiée par le paramètre Kcid qui refuserait une opération de point de contrôle. L'appelant doit fournir un pointeur vers une chaîne de caractères lisible par l'utilisateur dans le paramètre Varp .
WPAR_CHECKPOINT_ALLOW	L'appelant effacait une opération de refus de point de contrôle précédente. Les opérations de refus et d'autorisation sont cumulatives et chaque opération de refus doit donc être associée à une opération d'autorisation avant qu'un point de contrôle soit finalement reautorisé.
WPAR_CHECKPOINT_TRY	Utilisé par le système de point de contrôle AIX® lui-même. L'appelant fournit le pointeur Varp à un entier qui contient un délai d'attente "prêt à attendre" en secondes avant l'effacement d'une opération de refus de point de contrôle.
WPAR_CHECKPOINT_CLEAR	Utilisé par le système de point de contrôle AIX lui-même. L'appelant a terminé un point de contrôle après une opération WPAR_TRY_CHKPNT réussie.
WPAR_RESTART_CLEAR	Utilisé par le système de point de contrôle AIX lui-même. L'appelant a terminé un redémarrage. L'état de redémarrage de la WPAR est initialement défini lors de la recréinstallation de la WPAR sur le système d'arrivée.

Descriptif

Le service de noyau Kwpar_checkpoint_status fournit un mécanisme pour les services de noyau pour informer ou interroger le système sur un événement de refus de point de contrôle. Les extensions de noyau qui font l'expérience d'un événement temporaire qui empêche une WPAR d'être la cible d'une opération de point de contrôle, doivent utiliser cette API pour refuser et ensuite réautoriser un point de contrôle lorsque l'événement s'efface. Un exemple d'événement de déni peut se produire si un périphérique ouvert se trouve dans un état provisoire non sérialisé qui ne peut pas gérer une opération de point de contrôle.

Environnement d'exécution

Le service de noyau Kwpar_checkpoint_status peut être appelé à partir de Environnement de processus uniquement.

Valeurs renvoyées

Article	Descriptif
0 %	L'opération a abouti.
différent de zéro	Incident.

Codes d'erreur

Le service Kwpar_checkpoint_status échoue si une ou plusieurs des erreurs suivantes se produisent:

Article	Descriptif
EINVAL	L'appelant a fourni un paramètre Cmd ou un autre paramètre non valide.
ENOENT	Aucune WPAR avec l'ID Kcid n'est active dans le système.
EBUSY	L'une ou l'autre des situations suivantes peut entraîner l'erreur EOCCUPÉ . La WPAR se trouve à un point de contrôle ou à un état de redémarrage. L'appelant n'a pas réussi dans une opération WPAR_CHECKPOINT_DENY . La WPAR est dans un état qui ne peut pas participer à un point de contrôle. L'appelant n'a pas réussi dans une opération WPAR_CHECKPOINT_TRY .
ETIMEDOUT	L'appelant est en attente d'un délai d'attente au cours d'une opération WPAR_CHECKPOINT_TRY , mais le temporisateur a expiré.