Libpcap庫主要函數

Libpcap庫主要函數 以下摘自：http://blog.csdn.net/zjl_1026_2001/archive/2008/03/21/2202436.aspx 函數名稱：pcap_t *pcap_open_live(char *device, int snaplen, int promisc, int to_ms, char *ebuf) 函數功能：獲得用於捕獲網絡數據包的數據包捕獲描述字。 參數說明：device 參數爲指定打開的網絡設備名。snaplen參數定義捕獲數據的最大字節數。promisc指定是否將網絡接口置於混雜模式。to_ms參數指*定超時時 間（毫秒）。ebuf參數則僅在pcap_open_live()函數出錯返回NULL時用於傳遞錯誤消息。 函數名稱：pcap_t *pcap_open_offline(char *fname, char *ebuf) 函數功能：打開以前保存捕獲數據包的文件，用於讀取。 參數說明：fname參數指定打開的文件名。該文件中的數據格式與tcpdump和tcpslice兼容。”-“爲標準輸入。ebuf參數則僅在pcap_open_offline()函數出錯返回NULL時用於傳遞錯誤消息。 函數名稱：pcap_dumper_t *pcap_dump_open(pcap_t *p, char *fname) 函數功能：打開用於保存捕獲數據包的文件，用於寫入。 參數說明：fname 參數爲”-“時表示標準輸出。出錯時返回NULL。p參數爲調用pcap_open_offline()或pcap_open_live()函數後返回的 pcap結構指針。fname參數指定打開的文件名。如果返回NULL，則可調用pcap_geterr()函數獲取錯誤消 息。 函數名稱：char *pcap_lookupdev(char *errbuf) 函數功能：用於返回可被pcap_open_live()或pcap_lookupnet()函數調用的網絡設備名指針。參數說明：如果函數出錯，則返回NULL，同時errbuf中存放相關的錯誤消息。 函數名稱：int pcap_lookupnet(char *device, bpf_u_int32 *netp,bpf_u_int32 *maskp, char *errbuf) 函數功能：獲得指定網絡設備的網絡號和掩碼。 參數說明：netp參數和maskp參數都是bpf_u_int32指針。如果函數出錯，則返回-1，同時errbuf中存放相關的錯誤消息。 函數名稱：int pcap_dispatch(pcap_t *p, int cnt,pcap_handler callback, u_char *user) 函數功能：捕獲並處理數據包。 參數說明：cnt 參數指定函數返回前所處理數據包的最大值。cnt=-1表示在一個緩衝區中處理所有的數據包。cnt=0表示處理所有數據包，直到產生以下錯誤之一：讀取 到EOF；超時讀取。callback參數指定一個帶有三個參數的回調函數，這三個參數爲：一個從pcap_dispatch()函數傳遞過來的 u_char指針，一個pcap_pkthdr結構的指針，和一個數據包大小的u_char指針。如果成功則返回讀取到的字節數。讀取到EOF時則返回零 值。出錯時則返回-1，此時可調用pcap_perror()或pcap_geterr()函數獲取錯誤消息。 函數名稱：int pcap_loop(pcap_t *p, int cnt,pcap_handler callback, u_char *user) 函數功能： 功能基本與pcap_dispatch()函數相同，只不過此函數在cnt個數據包被處理或出現錯誤時才返回，但讀取超時不會返回。而如果爲 pcap_open_live()函數指定了一個非零值的超時設置，然後調用pcap_dispatch()函數，則當超時發生時 pcap_dispatch()函數會返回。cnt參數爲負值時pcap_loop()函數將始終循環運行，除非出現錯誤。 函數名稱：void pcap_dump(u_char *user, struct pcap_pkthdr *h,u_char *sp) 函數功能：向調用pcap_dump_open()函數打開的文件輸出一個數據包。該函數可作爲pcap_dispatch()函數的回調函數。 函數名稱：int pcap_compile(pcap_t *p, struct bpf_program *fp,char *str, int optimize, bpf_u_int32 netmask) 函數功能：將str參數指定的字符串編譯到過濾程序中。 參數說明：fp是一個bpf_program結構的指針，在pcap_compile()函數中被賦值。optimize參數控制結果代碼的優化。netmask參數指定本地網絡的網絡掩碼。 函數名稱：int pcap_setfilter(pcap_t *p, struct bpf_program *fp) 函數功能：指定一個過濾程序。 參數說明：fp參數是bpf_program結構指針，通常取自pcap_compile()函數調用。出錯時返回-1；成功時返回0。 函數名稱：u_char *pcap_next(pcap_t *p, struct pcap_pkthdr *h) 函數功能：返回指向下一個數據包的u_char指針。 函數名稱：int pcap_datalink(pcap_t *p) 函數功能：返回數據鏈路層類型，例如DLT_EN10MB。 函數名稱：int pcap_snapshot(pcap_t *p) 函數功能：返回pcap_open_live被調用後的snapshot參數值。 函數名稱：int pcap_is_swapped(pcap_t *p) 函數功能：返回當前系統主機字節與被打開文件的字節順序是否不同。 函數名稱：int pcap_major_version(pcap_t *p) 函數功能：返回寫入被打開文件所使用的pcap函數的主版本號。 函數名稱：int pcap_minor_version(pcap_t *p) 函數功能：返回寫入被打開文件所使用的pcap函數的輔版本號。 函數名稱：int pcap_stats(pcap_t *p, struct pcap_stat *ps) 函數功能：向pcap_stat結構賦值。成功時返回0。這些數值包括了從開始捕獲數據以來至今共捕獲到的數據包統計。如果出錯或不支持數據包統計，則返回-1，且可調用pcap_perror()或pcap_geterr()函數來獲取錯誤消息。 函數名稱：FILE *pcap_file(pcap_t *p) 函數功能：返回被打開文件的文件名。 函數名稱：int pcap_fileno(pcap_t *p) 函數功能：返回被打開文件的文件描述字號碼。 函數名稱：void pcap_perror(pcap_t *p, char *prefix) 函數功能：在標準輸出設備上顯示最後一個pcap庫錯誤消息。以prefix參數指定的字符串爲消息頭。 函數名稱：char *pcap_geterr(pcap_t *p) 函數功能：返回最後一個pcap庫錯誤消息。 函數名稱：char *pcap_strerror(int error) 函數功能：如果strerror()函數不可用，則可調用pcap_strerror函數替代。 函數名稱：void pcap_close(pcap_t *p) 函數功能：關閉p參數相應的文件，並釋放資源。 函數名稱：void pcap_dump_close(pcap_dumper_t *p) 函數功能：關閉相應的被打開文件。 -------------------------------------------------------------------------------------------------------------------- 以下爲特別注意的地方： 對於最常用的 pcap_loop: pcap_loop原型是pcap_loop(pcap_t *p,int cnt,pcap_handler callback,u_char *user) 其中第一個參數是winpcap的句柄,第二個是指定捕獲的數據包個數,如果爲-1則無限循環捕獲。第四個參數user是留給用戶使用的。 第三個是回調函數其原型如下: pcap_callback(u_char* argument,const struct pcap_pkthdr* packet_header,const u_char* packet_content) 其中參數pcap_content表示的捕獲到的數據包的內容 參數argument是從函數pcap_loop()傳遞過來的。注意：這裏的參數就是指 pcap_loop中的 *user 參數 參數pcap_pkthdr 表示捕獲到的數據包基本信息,包括時間,長度等信息. 另外:回調函數必須是全局函數或靜態函數,其參數默認,比如pcap_loop()可以寫成 pcap_loop(pcap_handle,10,pcap_callback,NULL)不能往裏面傳遞實參. ----------------------------------------------------------------------------------------------------------------- pcap_loop和callback之間參數存在聯繫： pcap_loop的最後一個參數user是留給用戶使用的，當callback被調用的時候這個值會傳遞給callback的第一個參數(也叫user)，callback的最後一個參數p指向一塊內存空間，這個空間中存放的就是pcap_loop抓到的數據包。callback的第二個參數是一個結構體指針，該結構體定義如下： struct pcap_pkthdr { struct timeval ts; /* 時間戳 */ bpf_u_int32 caplen; /* 已捕獲部分的長度 */ bpf_u_int32 len; /* 該包的脫機長度 */ }; 這個結構體是由pcap_loop自己填充的，用來取得一些關於數據包的信息 所以，在callback函數當中只有第一個user指針是可以留給用戶使用的，如果你想給callback傳遞自己參數，那就只能通過pcap_loop的最後一個參數user來實現了 0 0 (請您對文章做出評價) posted @ 2009-03-10 16:25 紅袖添香 閱讀(231) 評論(0) 編輯 收藏 網摘