= Welcome to Libmac =

The '''libmac''' library is designed for the NSF '''[http://www.orbit-lab.org ORBIT ]''' Testbed Project. it is a user-space C library that provides applications with an API for,
 * Injection and capture of MAC layer frames.
 * Manipulation of a subset of wireless interface parameters at both aggregate and per-frame granularity levels. 
 * Communication of a subset of wireless interface parameters from one end of a network connection to the other, on a per-frame granularity level. 

Manipulation and communication of wireless interface parameters, was achieved by modifying open-source Linux device drivers for atheros and Intel a/b/g 802.11 cards. 

The architecture diagram is shown below - Libmac uses open-source libraries [http://www.tcpdump.org/ libpcap], for frame capture and [http://www.packetfactory.net/libnet/ libnet], for frame injection.

[[Image(libmac_layering.jpg)]] [[BR]]

== Starting Points ==

== For Experimenters ==
  Currently supported linux device drivers in the libmac package include ipw2200(version 1.0.8) and   madwifi(old version-approx June 2005, NOT madwifi-ng). Supported parameters include RSSI, 802.11 PHY Bit-rate, MAC timestamp (all on the receive side).

== For Developers ==
 * Sample code and function specifications are available [http://www.winlab.rutgers.edu/~kishore/libmac_docs here]
 * Check out source using [http://www.subversion.org subversion] at  http://svn.orbit-lab.org/svn/orbit/libmac/trunk.