Sous-routine genseq Device Configuration

Objectif

Génère un numéro de séquence unique pour la création du nom logique d'un périphérique.

Syntaxe

#include <cf.h>
#include <sys/cfgodm.h>
#include <sys/cfgdb.h>

int genseq (prefix)
char *prefix;

Paramètres

Descriptif

Le sous-programme de configuration de l'unité Genseq génère un numéro de séquence unique à concaténer avec le nom de préfixe de l'unité. Le nom d'unité dans la classe d'objets Customized Devices (CuDv) est la concaténation du nom de préfixe et du numéro de séquence. Les règles de génération des numéros de séquence sont les suivantes:

• Un numéro de séquence est un entier non négatif. Le plus petit numéro de séquence est 0.
• Lors de la dérivation d'un nom logique d'instance d'unité, le prochain numéro de séquence disponible (relatif à un nom de préfixe donné) est alloué. Ce numéro de séquence disponible suivant est défini comme étant le plus petit numéro de séquence qui n'est pas encore attribué aux instances d'unité utilisant le même nom de préfixe.
• L'attribution ou non d'un numéro de séquence est déterminée par les instances d'unité de la classe d'objets CuDv . Si une entrée utilisant le préfixe de votre choix existe dans cette classe, le numéro de séquence de cette entrée a déjà été attribué.

Il appartient à l'application de convertir ce numéro de séquence au format de caractère afin qu'il puisse être concaténé au préfixe pour former le nom de l'unité.

Valeurs renvoyées

Si la sous-routine Genseq aboutit, elle renvoie le numéro de séquence généré en format entier. Si le sous-programme échoue, il renvoie une valeur de-1 .

Fichiers