l2_packet_ndis.c File Reference

WPA Supplicant - Layer2 packet handling with Microsoft NDISUIO. More...

#include "includes.h"
#include <winsock2.h>
#include <ntddndis.h>
#include "common.h"
#include "eloop.h"
#include "l2_packet.h"
Include dependency graph for l2_packet_ndis.c:

Go to the source code of this file.

Data Structures

struct  l2_packet_ndisuio_global
struct  l2_packet_data

Defines

#define FSCTL_NDISUIO_BASE   FILE_DEVICE_NETWORK
#define _NDISUIO_CTL_CODE(_Function, _Method, _Access)   CTL_CODE(FSCTL_NDISUIO_BASE, _Function, _Method, _Access)
#define IOCTL_NDISUIO_SET_ETHER_TYPE

Functions

HANDLE driver_ndis_get_ndisuio_handle (void)
int l2_packet_get_own_addr (struct l2_packet_data *l2, u8 *addr)
 Get own layer 2 address.
int l2_packet_send (struct l2_packet_data *l2, const u8 *dst_addr, u16 proto, const u8 *buf, size_t len)
 Send a packet.
struct l2_packet_datal2_packet_init (const char *ifname, const u8 *own_addr, unsigned short protocol, void(*rx_callback)(void *ctx, const u8 *src_addr, const u8 *buf, size_t len), void *rx_callback_ctx, int l2_hdr)
 Initialize l2_packet interface.
void l2_packet_deinit (struct l2_packet_data *l2)
 Deinitialize l2_packet interface.
int l2_packet_get_ip_addr (struct l2_packet_data *l2, char *buf, size_t len)
 Get the current IP address from the interface.
void l2_packet_notify_auth_start (struct l2_packet_data *l2)
 Notify l2_packet about start of authentication.

Detailed Description

WPA Supplicant - Layer2 packet handling with Microsoft NDISUIO.

Copyright
Copyright (c) 2003-2006, Jouni Malinen <j@w1.fi>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation.

Alternatively, this software may be distributed under the terms of BSD license.

See README and COPYING for more details.

This implementation requires Windows specific event loop implementation, i.e., eloop_win.c. In addition, the NDISUIO connection is shared with driver_ndis.c, so only that driver interface can be used and CONFIG_USE_NDISUIO must be defined.

WinXP version of the code uses overlapped I/O and a single threaded design with callback functions from I/O code. WinCE version uses a separate RX thread that blocks on ReadFile() whenever the media status is connected.

Definition in file l2_packet_ndis.c.


Define Documentation

#define IOCTL_NDISUIO_SET_ETHER_TYPE
Value:
_NDISUIO_CTL_CODE(0x202, METHOD_BUFFERED, \
                          FILE_READ_ACCESS | FILE_WRITE_ACCESS)

Definition at line 43 of file l2_packet_ndis.c.


Function Documentation

void l2_packet_deinit ( struct l2_packet_data l2  ) 

Deinitialize l2_packet interface.

Parameters:
l2 Pointer to internal l2_packet data from l2_packet_init()

Definition at line 454 of file l2_packet_ndis.c.

Here is the call graph for this function:

int l2_packet_get_ip_addr ( struct l2_packet_data l2,
char *  buf,
size_t  len 
)

Get the current IP address from the interface.

Parameters:
l2 Pointer to internal l2_packet data from l2_packet_init()
buf Buffer for the IP address in text format
len Maximum buffer length
Returns:
0 on success, -1 on failure

This function can be used to get the current IP address from the interface bound to the l2_packet. This is mainly for status information and the IP address will be stored as an ASCII string. This function is not essential for wpa_supplicant operation, so full implementation is not required. l2_packet implementation will need to define the function, but it can return -1 if the IP address information is not available.

Definition at line 509 of file l2_packet_ndis.c.

int l2_packet_get_own_addr ( struct l2_packet_data l2,
u8 *  addr 
)

Get own layer 2 address.

Parameters:
l2 Pointer to internal l2_packet data from l2_packet_init()
addr Buffer for the own address (6 bytes)
Returns:
0 on success, -1 on failure

Definition at line 91 of file l2_packet_ndis.c.

struct l2_packet_data* l2_packet_init ( const char *  ifname,
const u8 *  own_addr,
unsigned short  protocol,
void(*)(void *ctx, const u8 *src_addr, const u8 *buf, size_t len)  rx_callback,
void *  rx_callback_ctx,
int  l2_hdr 
) [read]

Initialize l2_packet interface.

Parameters:
ifname Interface name
own_addr Optional own MAC address if available from driver interface or NULL if not available
protocol Ethernet protocol number in host byte order
rx_callback Callback function that will be called for each received packet
rx_callback_ctx Callback data (ctx) for calls to rx_callback()
l2_hdr 1 = include layer 2 header, 0 = do not include header
Returns:
Pointer to internal data or NULL on failure

rx_callback function will be called with src_addr pointing to the source address (MAC address) of the the packet. If l2_hdr is set to 0, buf points to len bytes of the payload after the layer 2 header and similarly, TX buffers start with payload. This behavior can be changed by setting l2_hdr=1 to include the layer 2 header in the data buffer.

Definition at line 349 of file l2_packet_ndis.c.

Here is the call graph for this function:

void l2_packet_notify_auth_start ( struct l2_packet_data l2  ) 

Notify l2_packet about start of authentication.

Parameters:
l2 Pointer to internal l2_packet data from l2_packet_init()

This function is called when authentication is expected to start, e.g., when association has been completed, in order to prepare l2_packet implementation for EAPOL frames. This function is used mainly if the l2_packet code needs to do polling in which case it can increasing polling frequency. This can also be an empty function if the l2_packet implementation does not benefit from knowing about the starting authentication.

Definition at line 515 of file l2_packet_ndis.c.

int l2_packet_send ( struct l2_packet_data l2,
const u8 *  dst_addr,
u16  proto,
const u8 *  buf,
size_t  len 
)

Send a packet.

Parameters:
l2 Pointer to internal l2_packet data from l2_packet_init()
dst_addr Destination address for the packet (only used if l2_hdr == 0)
proto Protocol/ethertype for the packet in host byte order (only used if l2_hdr == 0)
buf Packet contents to be sent; including layer 2 header if l2_hdr was set to 1 in l2_packet_init() call. Otherwise, only the payload of the packet is included.
len Length of the buffer (including l2 header only if l2_hdr == 1)
Returns:
>=0 on success, <0 on failure

Definition at line 98 of file l2_packet_ndis.c.

Here is the call graph for this function:

 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Defines

Generated on Sat Nov 21 23:21:58 2009 for hostapd by  doxygen 1.6.1