This file is indexed.

/usr/lib/perl5/Net/RawIP/libpcap.pod is in libnet-rawip-perl 0.25-1build3.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
=head1 NAME

Net::RawIP::libpcap - An interface to B<libpcap> in Net::RawIP(3pm)

=head1 DESCRIPTION

 Function    The input parameters           The output parameters

 open_live   a network                      Return value is a pcap_t*
             device(eth0,ppp0,...);         If retval less than zero
             a snap length;                 then $err filled with
             a promisc - boolean;           an error string.
	     a timeout in sec;               
	     $err is an undef scalar;

 open_offline   a filename which is filled  Return value is pcap_t*
                with a raw output of dump;  If retval less than zero
                $err is an unfef scalar;    then $err filled with
		                            an error string.

 dump_open  pcap_t*;                        Return value is a FILE*
            $err; 

 lookupdev  $err;			    Return value is a name
                                            of first device which is
					    found by libpcap

 lookupnet  a network device;               a netnumber;
            a netnumer is undef;            a netmask;    
	    a netmask is undef;             If retval less than zero
	    $err is undef;                  then $err filled with
				            an error string.
  
 dispatch   a scalar with pcap_t*;          No output parameters.
            number of packets for proce-
	    ssing;
	    reference to the perl call-
	    back,this callback will be
	    called with 3 parameters:
	    $_[0] is fourth parameter
	    from dispatch,
	    $_[1] is a scalar with struc-
	    ture pcap_pkthdr for a current
	    packet,
	    $_[2] is a scalar with a current
	    packet;
	    fourth parameter could be
	    an array or a hash reference
	    or a pointer (FILE*) returned
	    by dump_open,it can be unre-
	    ferenced in the perl call-
	    back or be used as a perl
	    filehandle in that callback.
  
 loop 	    As for dispatch.                As for dispatch.
  
 dump       As for a perl callback          No output. 
            but $_[0] must be a pointer 
	    (FILE*) only.

 compile    a scalar with pcap_t*;        a scalar with bpf_program. 
            a bpf_program is undef;       If retval is less than zero
	    a scalar with filter string;  then there was a problem with
	    a boolean value (optimize or  filter grammar.
	    not);
	      a scalar with netmask;

 setfilter  a scalar with pcap_t*;        If retval is less than zero
	    a scalar with bpf_program     then there was a problem while
	    returned by compile.          settting filter.
  
 next     a scalar with pcap_t*;          A scalar with next packet;
          a scalar with with struc-       a scalar with with structure
	  ture pcap_pkthdr for a current  pcap_pkthdr also will be modi
	  packet,originally is undef.     filed for an every packet and 
		                          it can be accessed but for read
					  only.
					      
 datalink  a scalar with pcap_t*;         Retval is the link  layer type,
                                          e.g. DLT_EN10MB.
	 						        		 
 snapshot  a scalar with pcap_t*;         Retval is the snapshot length 
                                          specified when open_live was 
					  called.		 	 	 
    
 is_swapped  a scalar with pcap_t*;       returns true if the current 
                                          savefile uses a different 
					  byte order than the current 
					  system.                   
  
 major_version  a scalar with pcap_t*;    returns the major number 
                                          of the version of the pcap 
					  used to write the savefile.
  
 minor_version  a scalar with pcap_t*;    returns the minor number of the
                                          version of the pcap used to 
					  write the savefile.

 file       a scalar with pcap_t*;        returns the name of the 
                                          savefile.
   											      					      
 stats      a scalar with pcap_t*;        If retval 0 then a scalar 
            a scalar with structure       with structure pcap_stat will
	    pcap_stat,originally undef    be filled with the 
                                          packet statistics.

 fileno    a scalar with pcap_t*;        returns  the  file descriptor 
                                         number of the savefile.
					 A core perl function is 
					 available as CORE::fileno.
					      
 geterr   a scalar with pcap_t*;         returns  the  error  text 
                                         pertaining to the last pcap 
				         library error.
					      
 perror   a scalar with pcap_t*;         prints the text of the last  
          a scalar with prefix;          pcap  library error on stderr, 
		                         prefixed by prefix.
  
 close    a scalar with pcap_t*;         closes the files associated with 
                                         pcap_t* and deallocates 
					 resources.
	                                 A core perl function is 
					 available as CORE::close.
											    
 dump_close  a scalar with pcap_t*;      closes the savefile.    					      

=head1 AUTHOR

Sergey Kolychev <ksv@al.lg.ua>

=head1 SEE ALSO

Net::RawIP(3pm),pcap(3).

=cut