NAME

Net::Lorcon - Raw wireless packet injection using the Lorcon library

SYNOPSIS

  use Net::Lorcon;

  my $tx = Net::Lorcon->new("eth1", "prism54");

  $tx->open;

  $tx->txpacket("packet..");

DESCRIPTION

This module enables raw 802.11 packet injection provided you have a Wi-Fi card supported by Lorcon.

Lorcon can be obtained from http://www.802.11mercenary.net/lorcon/.

FUNCTIONS

Net::Lorcon::getcardlist: Returns a list of supported driver names.
Net::Lorcon::resolvecard: Returns the ID of the given card. Not normally needed as new will automatically call this.

METHODS

new(device, driver): Constructs a new Net::Lorcon object. device is the name of the device to use for packet injection. driver is the driver to use (one of the names returned from getcardlist)
getcapabilities(): Returns the capabilites of this device. This is an integer with the TX80211_CAP_* constants below ORed together.
open(): Opens the device ready for transmitting packets
close(): Closes the device. (Automatically called when object is destroyed).
setmode(mode): Sets the mode of the device. Expects constants from <linux/wireless.h> (IW_MODE_MONITOR, etc).
getmode(): Returns an integer representing the current mode.
setfunctionalmode(func_mode): (Not implemented in the version of Lorcon I have)
setchannel(channel): Sets the channel to trasmit on.
getchan: Returns the channel the wireless card is currently on.
txpacket(packet): Transmits the given packet. The expected input is a full 802.11 packet.

Exportable constants

INJ_* are the various injection methods supported by Lorcon. TX80211_CAP_* are returned by getcapabilites.

  INJ_AIRJACK
  INJ_HOSTAP
  INJ_MADWIFING
  INJ_MADWIFIOLD
  INJ_MAX
  INJ_NODRIVER
  INJ_PRISM54
  INJ_RT2500
  INJ_RT2570
  INJ_RTL8180
  INJ_WLANNG
  MAX_IFNAME_LEN
  TX80211_CAP_BSSTIME
  TX80211_CAP_CTRL
  TX80211_CAP_DSSSTX
  TX80211_CAP_DURID
  TX80211_CAP_FRAG
  TX80211_CAP_MIMOTX
  TX80211_CAP_NONE
  TX80211_CAP_OFDMTX
  TX80211_CAP_SELFACK
  TX80211_CAP_SEQ
  TX80211_CAP_SETRATE
  TX80211_CAP_SNIFF
  TX80211_CAP_SNIFFACK
  TX80211_CAP_TRANSMIT
  TX80211_CAP_TXNOWAIT
  TX80211_STATUS_MAX
  TX80211_ENOERR
  TX80211_ENOSUCHINJ
  TX80211_ENOHANDLER
  IW_MODE_AUTO
  IW_MODE_ADHOC
  IW_MODE_INFRA
  IW_MODE_MASTER
  IW_MODE_REPEAT
  IW_MODE_SECOND
  IW_MODE_MONITOR

AUTHOR

David Leadbeater, <dgl at dgl dot cx>

COPYRIGHT AND LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.