Requête¶

La requête débute par un en-tête struct nlmsghdr décrit dans netlink(7) avec un champ nlmsg_type réglé à SOCK_DIAG_BY_FAMILY. Il est suivi par un en-tête spécifique à une famille d’adresses qui débute par une partie commune partagée par toutes les familles d’adresses :

struct sock_diag_req {


    __u8 sdiag_family;


    __u8 sdiag_protocol;
};

Les membres de cette structure sont les suivants :

sdiag_family

Une famille d’adresses. Elle devrait être réglée à la constante AF_* appropriée.

sdiag_protocol

Fonction de sdiag_family. Il devrait être réglé à la constante IPPROTO_* appropriée pour AF_INET et AF_INET6, et à 0 autrement.

Si le champ nlmsg_flags de l’en-tête struct nlmsghdr a l’indicateur NLM_F_DUMP défini, cela signifie qu’une liste de sockets est demandée. Sinon, il s’agit d’une requête concernant un socket particulier.

Réponse¶

La réponse débute avec un en-tête struct nlmsghdr et est suivie par un tableau d’objets spécifique à la famille d’adresses. Le tableau est accessible avec les macros NLMSG_* standards de l’API de netlink(3).

Chaque objet est la liste NLA (attributs netlink) accessible avec les macros RTA_* de l’API de rtnetlink(3).

Sockets de domaine UNIX¶

Pour les sockets de domaine UNIX, la requête est décrite dans la structure suivante :

struct unix_diag_req {


    __u8    sdiag_family;


    __u8    sdiag_protocol;


    __u16   pad;


    __u32   udiag_states;


    __u32   udiag_ino;


    __u32   udiag_show;


    __u32   udiag_cookie[2];
};

Les membres de cette structure sont les suivants :

sdiag_family

La famille d’adresses. Elle devrait être AF_UNIX.

sdiag_protocol

pad

Ces champs devraient être réglés à 0.

udiag_states

C’est un masque de bits définissant un filtre d’états des sockets. Seuls les sockets dont les états sont dans le masque seront rapportés. Il est ignoré lors d’une requête pour un socket particulier. Les valeurs autorisées sont :

udiag_ino

C’est un numéro d’inœud lors d’une requête pour un socket particulier. Il est ignoré lors d’une requête pour une liste de sockets.

udiag_show

C’est un ensemble d’indicateurs définissant quelle sorte d’information rapporter. Chaque sorte d’information est rapportée sous forme d’attribut netlink comme décrit ci-dessous :

udiag_cookie

C’est un tableau d’identificateurs opaques pouvant être utilisés avec udiag_ino pour indiquer un socket particulier. Il est ignoré lors de la requête d’une liste de sockets ainsi que lorsque ses éléments sont réglés à -1.

La réponse à une requête de sockets de domaine UNIX est décrite sous forme de tableau de

struct unix_diag_msg {


    __u8    udiag_family;


    __u8    udiag_type;


    __u8    udiag_state;


    __u8    pad;


    __u32   udiag_ino;


    __u32   udiag_cookie[2];
};

suivis par les attributs de netlink.

Les membres de cette structure sont les suivants :

udiag_family

Ce champ a la même signification que struct unix_diag_req.

udiag_type

Ce champ est réglé à SOCK_PACKET, SOCK_STREAM ou SOCK_SEQPACKET.

udiag_state

Ce champ est réglé à TCP_LISTEN ou TCP_ESTABLISHED.

pad

Ce champ est réglé à 0.

udiag_ino

Ce champ est le numéro d’inœud de socket.

udiag_cookie

Ce champ est un tableau d’identificateurs opaques pouvant être utilisés dans des requêtes ultérieures.

Sockets IPv4 et IPv6¶

Pour les sockets IPv4 et IPv6, la requête est décrite dans la structure suivante :

struct inet_diag_req_v2 {


    __u8    sdiag_family;


    __u8    sdiag_protocol;


    __u8    idiag_ext;


    __u8    pad;


    __u32   idiag_states;


    struct inet_diag_sockid id;
};

où struct inet_diag_sockid est défini comme suit :

struct inet_diag_sockid {


    __be16  idiag_sport;


    __be16  idiag_dport;


    __be32  idiag_src[4];


    __be32  idiag_dst[4];


    __u32   idiag_if;


    __u32   idiag_cookie[2];
};

Les champs de struct inet_diag_req_v2 sont comme suit :

sdiag_family

Cela devrait être soit AF_INET ou AF_INET6 pour les sockets IPv4 ou IPv6 respectivement.

sdiag_protocol

Cela devrait être réglé à IPPROTO_TCP, IPPROTO_UDP ou IPPROTO_UDPLITE.

idiag_ext

C’est un ensemble d’indicateurs définissant quelle sorte d’informations étendues à rapporter. Chaque sorte d’informations est rapportée sous forme d’attribut de netlink comme décrit ci-dessous :

pad

Cela devrait être réglé à 0.

idiag_states

C’est un masque de bits définissant un filtre d’états des sockets. Seuls les sockets dont les états sont dans le masque seront rapportés. Il est ignoré lors d’une requête pour un socket particulier.

id

C’est un objet d’ID de socket utilisé dans les requêtes de vidage, dans les requêtes à propos de sockets particuliers et qui est rapporté dans chaque réponse. Au contraire des sockets de domaine UNIX, les sockets IPv4 et IPv6 sont identifiés en utilisant des adresses et des ports. Toutes les valeurs sont dans l’ordre d’octets du réseau.

Les champs de struct inet_diag_sockid sont comme suit :

idiag_sport

Le port de la source.

idiag_dport

Le port de la destination.

idiag_src

L’adresse de la source.

idiag_dst

L’adresse de la destination.

idiag_if

Le numéro d’interface auquel le socket est lié.

idiag_cookie

C’est un tableau d’identificateurs opaques pouvant être utilisés dans d’autres champs de cette structure pour indiquer un socket particulier. Il est ignoré lors d’une requête pour une liste de sockets, de même que lorsque tous ses éléments sont réglés à -1.

La réponse à une requête de sockets IPv4 ou IPv6 est décrite sous forme d'un tableau de

struct inet_diag_msg {


    __u8    idiag_family;


    __u8    idiag_state;


    __u8    idiag_timer;


    __u8    idiag_retrans;


    struct inet_diag_sockid id;


    __u32   idiag_expires;


    __u32   idiag_rqueue;


    __u32   idiag_wqueue;


    __u32   idiag_uid;


    __u32   idiag_inode;
};

suivis par les attributs de netlink.

Les membres de cette structure sont les suivants :

idiag_family

c’est le même champ que dans struct inet_diag_req_v2.

idiag_state

Cela indique l’état comme dans struct inet_diag_req_v2.

idiag_timer

Pour les sockets TCP, ce champ décrit le type de temporisateur actuellement actif pour le socket. Il est réglé à une des constantes suivantes :

Pour les sockets non TCP, ce champ doit être réglé à 0.

idiag_retrans

Pour les valeurs 1, 2 et 4 d’idiag_timer, ce champ contient le nombre de retransmissions. Pour les autres valeurs d’idiag_timer, ce champ est réglé à 0.

idiag_expires

Pour les sockets TCP ayant un temporisateur actif, ce champ indique son délai d’expiration en milliseconde. Pour les autres sockets, ce champ est réglé à 0.

idiag_rqueue

Pour les sockets à l’écoute : le nombre de connexions en attente.

Pour les autres sockets : la quantité de données dans la file d’attente entrante.

idiag_wqueue

Pour les sockets à l’écoute : la taille de l’arriéré.

Pour les autres sockets : la quantité de mémoire disponible pour l’envoi.

idiag_uid

C’est l’UID du propriétaire du socket.

idiag_inode

Ce champ est le numéro d’inœud de socket.

Informations sur la mémoire du socket¶

La charge utile associée avec les attributs UNIX_DIAG_MEMINFO et INET_DIAG_SKMEMINFO de netlink est un tableau des valeurs __u32 suivantes :

SK_MEMINFO_RMEM_ALLOC

La quantité de données dans la file d’attente de réception.

SK_MEMINFO_RCVBUF

Le tampon de réception de socket comme réglé par SO_RCVBUF.

SK_MEMINFO_WMEM_ALLOC

La quantité de données dans la file d’émission.

SK_MEMINFO_SNDBUF

Le tampon d’émission de socket comme réglé par SO_SNDBUF.

SK_MEMINFO_FWD_ALLOC

La quantité de mémoire prévue pour une utilisation future (TCP uniquement).

SK_MEMINFO_WMEM_QUEUED

La quantité de données mises en attente par TCP, mais pas encore envoyées.

SK_MEMINFO_OPTMEM

La quantité de mémoire allouée pour les besoins du service du socket (par exemple, filtre du socket).

SK_MEMINFO_BACKLOG

La quantité de paquets dans l’arriéré (pas encore traité).