Sous-routine sethostid
Objectif
Définit l'identificateur unique de l'hôte en cours.
Bibliothèque
Bibliothèque C standard (libc.a)
Syntaxe
int HostID;
Descriptif
La sous-routine sethostid permet à un processus appelant avec un ID utilisateur root de définir un nouvel identificateur 32 bits pour l'hôte en cours. La sous-routine sethostid permet à un programme d'application de réinitialiser l'ID hôte.
Toutes les applications contenant la sous-routine sethostid doivent être compilées avec la macro _BSD définie sur une valeur spécifique. Les valeurs admises sont 43 et 44. De plus, toutes les applications socket doivent inclure la bibliothèque BSD libbsd.a .
Paramètres
| Article | Descriptif |
|---|---|
| HostID | Indique l'identificateur 32 bits unique de l'hôte en cours. |
Valeurs renvoyées
Une fois l'opération terminée, la sous-routine sethostid renvoie la valeur 0.
Si la sous-routine sethostid échoue, le gestionnaire de sous-routine exécute les fonctions suivantes:
- Renvoie une valeur de -1 au programme appelant.
- Déplace un code d'erreur, indiquant l'erreur spécifique, dans la variable globale errno . Pour plus d'informations sur la variable errno , voir Error Notification Object Class dans Communications Programming Concepts.
Codes d'erreur
La sous-routine sethostid échoue si les conditions suivantes sont remplies:
| Erreur | Descriptif |
|---|---|
| EPERM | Le processus appelant ne possède pas d'ID utilisateur effectif de superutilisateur. |