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.

EXPORT

None by default.

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

SEE ALSO

lorcon(7), 802.11 Wireless Networks by Matthew Gast.

AUTHOR

David Leadbeater, <dgl at dgl dot cx>

COPYRIGHT AND LICENSE

Copyright (C) 2007 by David Leadbeater

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.