Difference between revisions of "Lan.sys"

From ReactOS Wiki
Jump to: navigation, search
(Import from old Wiki)
 
(Mark outdated)
Line 1: Line 1:
A simple adapter neutral driver for sending and receiving packets from ndis adapters, querying adapters, and assigning and querying protocol addresses.
+
{{outdated}}
 +
 
 +
A simple adapter neutral driver for sending and receiving packets from NDIS adapters, querying adapters, and assigning and querying protocol addresses.
  
 
It supports these operations:
 
It supports these operations:
  
Read -- Get the next packet that matches our target type
+
* Read - Get the next packet that matches our target type
Write -- Put a packet on the indicated adapter, building a link layer header as appropriate
+
* Write - Put a packet on the indicated adapter, building a link layer header as appropriate
 
+
* LookupAddress - Match a partial address (either the protocol address or the link layer address) on the indicated adapter and return the full address.
LookupAddress -- Match a partial address on the indicated adapter and return the full address.  Match can be against either the protocol address or the link layer address.
+
* PushAddress - Set an address mapping, deleting previous matching protocol addresses.
 
+
* EraseAddress - Remove matching address mappings.
PushAddress   -- Set an address mapping, deleting previous matching protocol addresses.
+
* EnumAdapters - Return an array of adapter indices.
 
+
* Bufferedmode - Set buffered mode to allow userland use of NtReadFile in lan.sys (mostly testing).
EraseAddress -- Remove matching address mappings.
+
* AddAddress - Set an address association for the indicated adapter. This will be considered to be a local address and will be associated with the adapter's link layer address.
 
+
* RemAddress - Remove a local address from the indicated adapter.
EnumAdapters -- Return an array of adapter indices.
+
* AdapterInfo - Return a struct containing information about the indicated adapter, including its ndis registry key, speed, link layer address, etc.
 
+
* Sending a packet from LAN.SYS: fill out a LAN_PACKET_HEADER and do WriteFile on it. The specified link layer address will be used as the target address. A zero-length address means broadcast.
Bufferedmode -- Set buffered mode to allow userland use of NtReadFile in lan.sys (mostly testing).
+
* Receiving a packet from LAN.SYS: just do ReadFile on a buffer and wait for a LAN_PACKET_HEADER to appear.
 
 
AddAddress   -- Set an address association for the indicated adapter. This will be considered to be a local address and will be associated with the adapter's link layer address.
 
 
 
RemAddress   -- Remove a local address from the indicated adapter.
 
 
 
AdapterInfo   -- Return a struct containing information about the indicated adapter, including its ndis registry key, speed, link layer address, etc.
 
 
 
Sending a packet from LAN.SYS: fill out a LAN_PACKET_HEADER and do WriteFile on it. The specified link layer address will be used as the target address. A zero-length address means broadcast.
 
 
 
Receiving a packet from LAN.SYS: just do ReadFile on a buffer and wait for a LAN_PACKET_HEADER to appear.
 

Revision as of 23:02, 6 September 2010

This page is probably outdated

The information on this page might not be valid for the current state of ReactOS.
A Wiki Administrator should look at this page and decide or discuss what to do with it.


A simple adapter neutral driver for sending and receiving packets from NDIS adapters, querying adapters, and assigning and querying protocol addresses.

It supports these operations:

  • Read - Get the next packet that matches our target type
  • Write - Put a packet on the indicated adapter, building a link layer header as appropriate
  • LookupAddress - Match a partial address (either the protocol address or the link layer address) on the indicated adapter and return the full address.
  • PushAddress - Set an address mapping, deleting previous matching protocol addresses.
  • EraseAddress - Remove matching address mappings.
  • EnumAdapters - Return an array of adapter indices.
  • Bufferedmode - Set buffered mode to allow userland use of NtReadFile in lan.sys (mostly testing).
  • AddAddress - Set an address association for the indicated adapter. This will be considered to be a local address and will be associated with the adapter's link layer address.
  • RemAddress - Remove a local address from the indicated adapter.
  • AdapterInfo - Return a struct containing information about the indicated adapter, including its ndis registry key, speed, link layer address, etc.
  • Sending a packet from LAN.SYS: fill out a LAN_PACKET_HEADER and do WriteFile on it. The specified link layer address will be used as the target address. A zero-length address means broadcast.
  • Receiving a packet from LAN.SYS: just do ReadFile on a buffer and wait for a LAN_PACKET_HEADER to appear.