GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NET::NMSG::INPUT (3)

.ds Aq ’

NAME

Net::Nmsg::Input - Perl interface for nmsg inputs

CONTENTS

SYNOPSIS



  use Net::Nmsg::Input;
  use Net::Nmsg::Output;

  my $in  = Net::Nmsg::Input->open(input.nmsg);
  my $out = Net::Nmsg::Output->open(output.nmsg);

  my $c = 0;

  while (my $msg = $in->read) {
    print "got message $c $msg\n";
    $out->write($msg);
    +$c;
  }

  # alternatively:

  my $cb = sub {
    print "got message $c ", shift, "\n"
    $out->write($msg);
    ++$c;
  };
  $in->loop($cb);



DESCRIPTION

Net::Nmsg::Input is the base class of a set format-specific input classes which provide perl interfaces for the Net::Nmsg::XS::input extension.

CONSTRUCTORS

open(%options) Creates a new input object. The class of the returned object depends on the apparent format of the input. The resulting object can be treated like an IO handle. The following both work:



  while (my $msg = <$in>) {
    # deal with $msg
  }

  while (my $msg = $in->read()) {
    # deal with $msg
  }



Options, where applicable, are valid for the more specific open calls detailed further below. Available options:
filter_vendor
filter_msgtype Filter incoming messages based on the given vendor/msgtype. Both are required if filtering is desired. Values can either be by name or numeric id.
filter_source Filter incoming messages based on the given source (nmsg only).
filter_operator Filter incoming messages based on the given operator (nmsg only).
filter_group Filter incoming messages based on the given group (nmsg only).
blocking_io Specify whether or not this input is blocking or not.
rcvbuf Set the receive buffer size (socket only)
bpf Specify a Berkley Packet Filter (pcap file/interface only)
snaplen Packet capture size (live interface only)
promisc Promiscuous mode (live interface only)

open_file($spec, %options) Opens an input in nmsg format, as specified by file name or file handle.
open_sock($spec, %options) Opens an input socket as specified by host/port or socket handle. The host and port can also be passed as separate arguments.
open_pcap($spec, %options) Opens an input in pcap format, as specified by file name. The ’filter_vendor’ and ’filter_msgtype’ options are required.
open_iface($spec, %options) Opens an input in pcap format, as specified by interface name. The ’filter_vendor’ and ’filter_msgtype’ options are required.

    ACCESSORS

set_msgtype($vendor, $msgtype)
get_msgtype()
set_filter_source($source)
get_filter_source()
set_filter_operator($operator)
get_filter_operator()
set_filter_group($group)
get_filter_group()
set_blocking_io($bool)
get_blocking_io()
set_bpf($bpf)
get_bpf()
set_snaplen($len)
get_snaplen()
set_promisc($bool)
get_promisc()

    METHODS

read() Returns the next message from this input, if available, as a Net::Nmsg::Msg object.
loop($callback, [$count]) Initiate processing of this input source, passing messages to the given code reference. Callbacks receive a single Net::Nmsg::Msg reference as an argument. An optional parameter count stops the loop after that many messages have been returned via the callback.

SEE ALSO

Net::Nmsg, Net::Nmsg::IO, Net::Nmsg::Output, Net::Nmsg::Msg, nmsgtool(1)

AUTHOR

Matthew Sisk, <sisk@cert.org>

COPYRIGHT & LICENSE

Copyright (C) 2010-2015 by Carnegie Mellon University

Use of the Net-Silk library and related source code is subject to the terms of the following licenses:

GNU Public License (GPL) Rights pursuant to Version 2, June 1991 Government Purpose License Rights (GPLR) pursuant to DFARS 252.227.7013

NO WARRANTY

See GPL.txt and LICENSE.txt for more details.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 NET::NMSG::INPUT (3) 2015-03-05

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.