Sous-routine d'arrêt

Editer en ligne

Objectif

Arrête toutes les opérations d'envoi et de réception de socket.

Bibliothèque

Bibliothèque C standard (libc.a)

Syntaxe

#include <sys/socket.h> int shutdown ( Socket, How) int Socket, How;

Descriptif

La sous-routine shutdown désactive toutes les opérations receive et send sur le socket spécifié.

Toutes les applications contenant la sous-routine shutdown 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
Socket	Indique le nom unique du socket.
Comment	Indique le type d'arrêt de la sous-routine. Utilisez les valeurs suivantes : 0 % Désactive les autres opérations de réception. 1 seul Désactive les autres opérations d'envoi. 2 Désactive les autres opérations d'envoi et de réception.

Valeurs renvoyées

Une fois l'opération terminée, la valeur 0 est renvoyée.

Si la sous-routine shutdown é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 General Programming Concepts: Writing and Debugging Programs.

Codes d'erreur

La sous-routine shutdown échoue si l'une des erreurs suivantes se produit:

Erreur	Descriptif
EBADF	Le paramètre Socket n'est pas valide.
EINVAL	Le paramètre How n'est pas valide.
ENOTCONN	Le socket n'est pas connecté.
ENOTSOCK	Le paramètre Socket fait référence à un fichier et non à un socket.

Fichiers

Article	Descriptif
/usr/include/sys/socket.h	Contient des définitions de socket.
/usr/include/sys/types.h	Contient les définitions des types de données non signés.