Service réseau ns_alloc
Objectif
Allocalise l'utilisation d'un pilote de périphérique réseau (NDD).
Syntaxe
Paramètres
| Article | Descriptif |
|---|---|
| Nddname | Indique le nom de l'unité à allouer. |
| Nddpp | Indique l'adresse du pointeur vers une structure Ndd . |
Descriptif
Le service réseau Ns_alloc recherche la chaîne d'unités Network Service (NS) pour rechercher le pilote de périphérique avec le paramètre Nddname indiqué. Si le service détecte une correspondance, il incrémente le nombre de références pour le pilote de périphérique spécifié. Si le nombre de références est incrémenté à 1, la sous-routine Ndd_open spécifiée dans la structure Ndd est appelée pour ouvrir le pilote de périphérique.
Exemples
L'exemple suivant illustre le service réseau Ns_alloc :
struct ndd *nddp;
error = ns_alloc("en0", &nddp);Valeurs renvoyées
Si une correspondance est trouvée et que la sous-routine Ndd_open de l'unité aboutit, un pointeur vers la structure Ndd pour l'unité spécifiée est stocké dans le paramètre Nddpp . Si aucune correspondance n'est trouvée ou si l'ouverture de l'unité échoue, une valeur différente de zéro est renvoyée.
| Article | Descriptif |
|---|---|
| 0 % | Indique que l'opération a abouti. |
| ENODEV | Indique un périphérique réseau non valide. |
| ENOENT | Indique qu'aucun démultiplexeur réseau n'est disponible pour ce périphérique. |
La routine Ndd_open peut spécifier d'autres valeurs de retour.