Sous-routine pcap_open_live

Objectif

Ouvre un périphérique réseau pour la capture de paquets.

Bibliothèque

Bibliothèque pcap (libpcap.a)

Syntaxe

#include <pcap.h>

pcap_t *pcap_open_live( const char * device, const int snaplen,
const int promisc, const int to_ms, char * ebuf);

Descriptif

La sous-routine pcap_open_live ouvre le périphérique réseau spécifié pour la capture de paquets. Le terme "live" signifie qu'un périphérique réseau est en cours d'ouverture, par opposition à un fichier contenant des données de capture de paquets. Cette sous-routine doit être appelée avant toute capture de paquet. Toutes les autres routines traitant de la capture de paquets nécessitent le descripteur de capture de paquets qui est créé et initialisé avec cette routine. Voir la sous-routine pcap_open_offline pour plus de détails sur l'ouverture d'un fichier précédemment sauvegardé qui contient des données de capture de paquets.

Paramètres

Article	Descriptif
dispositif	Indique une chaîne contenant le nom du périphérique réseau à ouvrir pour la capture de paquets, par exemple, en0.
ebuf	Renvoie un texte d'erreur et n'est défini que lorsque la sous-routine pcap_open_live échoue.
promisc	Indique que l'unité doit être placée en mode espion. La valeur 1 (True) active le mode espion. Si ce paramètre est défini sur 0 (False), l'unité reste inchangée. Dans ce cas, s'il a déjà été mis en mode promiscuité (pour une autre raison), il restera dans ce mode.
mnaplen	Indique le nombre maximal d'octets à capturer par paquet.
to_ms	Indique le délai d'attente de lecture en millisecondes.

Valeurs renvoyées

Une fois l'opération terminée, la sous-routine pcap_open_live renvoie un pointeur vers le descripteur de capture de paquet qui a été créé. Si la sous-routine pcap_open_live échoue, la valeur Null est renvoyée et le texte indiquant l'erreur spécifique est écrit dans la mémoire tampon ebuf .