unix_socket = socket(PF_UNIX, type, 0);
error = socketpair(PF_UNIX, type, 0, int *sv);  

Les types valides sont : SOCK_STREAM, pour une socket orientée flux et SOCK_DGRAM, pour une socket orientée datagramme, préservant les limites entre messages (comme sur la plupart des implémentations Unix, les sockets datagramme de domaine Unix sont toujours fiables et ne réordonnent pas les datagrammes) ; et (depuis Linux 2.6.4) SOCK_SEQPACKET, pour un socket orientée connexion, préservant les limites entre messages et délivrant les messages dans l'ordre où ils ont été envoyés.

Les sockets Unix supportent la transmission de descripteurs de fichiers ou d'identificateurs d'un processus à l'autre en utilisant des données annexes.  

#define UNIX_PATH_MAX    108

struct sockaddr_un {
    sa_family_t    sun_family;               /* AF_UNIX */
    char           sun_path[UNIX_PATH_MAX];  /* chemin accès */
};

sun_family contient toujours la valeur AF_UNIX. sun_path contient le chemin d'accès à la socket, terminé par un zéro, dans le système de fichiers. Si sun_path commence par un octet nul, il se réfère à l'espace abstrait maintenu par le module du protocole Unix. L'adresse de la socket dans cet espace est donné par le reste des octets dans sun_path. Notez que les noms dans l'espace abstrait ne sont pas terminés par un zéro.  

SO_PASSCRED

Valide la réception des identifiants dans les messages annexes du processus émetteur. Lorsque cette option est active et la socket non encore connectée un nom unique dans l'espace abstrait sera généré automatiquement. On attend un attribut booléen entier.

Les sockets de domaine unix ne supportent pas la transmission de données hors-bande (l'attribut MSG_OOB pour send(2) et recv(2)).

L'attribut MSG_MORE de send(2) n'est pas supporté par les sockets de domaine Unix.

L'option SO_SNDBUF a un effet pour les sockets de domaine Unix, mais l'option SO_RCVBUF n'en a pas. pour les sockets datagramme, la valeur SO_SNDBUF impose une limite supérieure sur la taille des datagrammes sortants. Cette limite est calculée comme étant le double (voir socket(7)) de la valeur de l'option moins 32 octets utilisés pour l'entête.  

SCM_RIGHTS

Envoie ou reçoit un jeu de descripteurs de fichiers ouverts par un autre processus. La portion de données contient une table de descripteurs. Les descripteurs passés se comportent comme s'ils avaient été créés avec dup(2).

SCM_CREDENTIALS

Envoyer ou recevoir les identifiants Unix. Ceci peut servir à l'authentification. Les identifications sont passés en message annexe en struct ucred.

struct ucred {
    pid_t pid;    /* PID processus émetteur */
    uid_t uid;    /* UID processus émetteur */
    gid_t gid;    /* GID processus émetteur */
};

Les identifiants que l'émetteur envoie sont vérifiés par le noyau. Un processus avec un UID effectif nul est autorisé à indiquer des valeurs autres que les siennes. L'émetteur doit indiquer son propre PID (sauf s'il a la capacité CAP_SYS_ADMIN), son UID réel, effectif ou sauvé (sauf s'il a la capacité CAP_SETUID), et son GID réel, effecif ou sauvé (sauf s'il a la capacité CAP_SETGID). Pour recevoir un message struct ucred, l'option SO_PASSCRED doit être validée sur la socket.

EADDRINUSE

L'adresse locale est déjà prise ou l'objet existe déjà dans le système de fichier.

ECONNREFUSED

connect(2) a été appelé sur une socket qui n'est pas en écoute. Ceci peut arriver si la socket distante n'existe pas ou si le fichier n'est pas une socket.

ECONNRESET

La socket distante a été fermée de manière inattendue.

EFAULT

Adresse mémoire utilisateur invalide.

EINVAL

Argument invalide. Une cause habituelle est l'oubli de AF_UNIX dans le champ sun_type de l'adresse passée ou lorsque la socket est dans un état invalide pour l'opération.

EISCONN

connect(2) a été appelée sur une socket déjà connectée, ou l'adresse cible a été indiquée sur une socket connectée.

ENOMEM

Plus de mémoire.

ENOTCONN

L'opération nécessite une adresse cible, mais la socket n'est pas connectée.

EOPNOTSUPP

Opération de flux sur une socket non orientée flux, ou tentatice d'utiliser des options de données hors-bande.

EPERM

L'émetteur a transmis des identifiants invalide dans la struct ucred.

EPIPE

La socket distante, de type flux, a été fermée. Dans ce cas un signal SIGPIPE est émis également. Ceci peut être évité en passant l'attribut MSG_NOSIGNAL dans sendmsg(2) ou recvmsg(2).

EPROTONOSUPPORT

Le protocole passé n'est pas PF_UNIX.

EPROTOTYPE

La socket distante ne correspond pas au type local (SOCK_DGRAM vs. SOCK_STREAM)

ESOCKTNOSUPPORT

Type de socket inconu.

D'autres erreurs peuvent être déclenchées par le niveau socket générique ou par le système de fichiers. Voir les pages de manuel correspondantes pour plus de détails.  

Lier une socket avec un nom de fichier crée la socket dans le système de fichier, qu'il faudra détruire lorsqu'elle n'est plus utile (en appelant unlink(2)). La sémantique habituelle Unix s'applique ; la socket peut être effacée à tout moment, et sera effectivement supprimée lorsque sa dernière référence sera fermée.

Pour passer un descripteur ou des identifiants par dessus un SOCK_STREAM, il faut envoyer ou recevoir au moins un octet de donnée non-méta dans l'appel correspondant.

Les sockets flux Unix ne supportent pas la notion de données hors-bande.  

Ce document est une traduction réalisée par Christophe Blaess <ccb AT club-internet DOT fr> le 25 juillet 2003, mise à jour par Alain Portal <aportal AT univ-montp2 DOT fr> le 23 décembre 2005 et révisée le 6 juin 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 7 unix ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

NOM

SYNOPSIS

DESCRIPTION

Format d'adresse

Options des sockets

Fonctionnalités (non) supportées

Messages annexes

ERREURS

VERSIONS

NOTES

EXEMPLE

VOIR AUSSI

TRADUCTION