Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

pcap_open_dead (3pcap)

Name

pcap_open_dead - open a fake pcap_t for compiling filters or opening a capture for output

Synopsis

#include <pcap/pcap.h>

pcap_t *pcap_open_dead(int linktype, int snaplen);
pcap_t *pcap_open_dead_with_tstamp_precision(int linktype, int snaplen,
u_int precision);

Description

PCAP_OPEN_DEAD(3pcap)                                    PCAP_OPEN_DEAD(3pcap)



NAME
       pcap_open_dead,  pcap_open_dead_with_tstamp_precision  -  open  a  fake
       pcap_t for compiling filters or opening a capture for output

SYNOPSIS
       #include <pcap/pcap.h>

       pcap_t *pcap_open_dead(int linktype, int snaplen);
       pcap_t *pcap_open_dead_with_tstamp_precision(int linktype, int snaplen,
           u_int precision);

DESCRIPTION
       pcap_open_dead() and  pcap_open_dead_with_tstamp_precision()  are  used
       for creating a pcap_t structure to use when calling the other functions
       in libpcap.  It is typically used when just using libpcap for compiling
       BPF   code;  it  can  also  be  used  if  using  pcap_dump_open(3PCAP),
       pcap_dump(3PCAP), and pcap_dump_close(3PCAP) to  write  a  savefile  if
       there is no pcap_t that supplies the packets to be written.

       linktype specifies the link-layer type for the pcap_t.

       snaplen specifies the snapshot length for the pcap_t.

       When pcap_open_dead_with_tstamp_precision(), is used to create a pcap_t
       for use with pcap_dump_open(), precision specifies the time stamp  pre-
       cision  for packets; PCAP_TSTAMP_PRECISION_MICRO should be specified if
       the packets to be written have time stamps in seconds and microseconds,
       and PCAP_TSTAMP_PRECISION_NANO should be specified if the packets to be
       written have time stamps in seconds and nanoseconds.   Its  value  does
       not affect pcap_compile(3PCAP).


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------------+
       |ATTRIBUTE TYPE |    ATTRIBUTE VALUE     |
       +---------------+------------------------+
       |Availability   | system/library/libpcap |
       +---------------+------------------------+
       |Stability      | Uncommitted            |
       +---------------+------------------------+

SEE ALSO
       pcap(3PCAP), pcap-linktype(7)



NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source   was   downloaded  from   https://www.tcpdump.org/release/libp-
       cap-1.9.1.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.tcpdump.org/.



                                3 January 2014           PCAP_OPEN_DEAD(3pcap)