88 lines
2.7 KiB
Plaintext
88 lines
2.7 KiB
Plaintext
|
This code provides a sample implementation of an IP routing protocol. It
|
||
|
|
illustrates the interaction with the IP Router Manager and the Route Table
|
||
|
|
Manager (v2). It also provides guidelines for efficient use of the event
|
||
|
|
logging and tracing facilities provided with the Routing SDK. The code uses
|
||
|
|
WinSock2 functionality for optimized execution. It also contains comments
|
||
|
|
about the preferred usage of NT and Routing functionalities (such as worker
|
||
|
|
threads, etc).
|
||
|
|
|
||
|
|
To run the sample, you need to build the LoadProtocol sample, which will load
|
||
|
|
this sample protocol. Please see ..\LoadProtocol for more info.
|
||
|
|
|
||
|
|
The sample protocol DLL (ipsample.dll) needs to be copied to the
|
||
|
|
%SytemRoot%system32 folder
|
||
|
|
|
||
|
|
The sample protocol should be registered in the following registry
|
||
|
|
location (invoke ipsample.reg to effect these changes):
|
||
|
|
|
||
|
|
|
||
|
|
\HKEY_LOCAL_MACHINE
|
||
|
|
\Software
|
||
|
|
\Microsoft
|
||
|
|
\Router
|
||
|
|
\CurrentVersion
|
||
|
|
\RouterManagers
|
||
|
|
\IP
|
||
|
|
\IPSAMPLE
|
||
|
|
VendorName = Microsoft (Value Type: REG_SZ)
|
||
|
|
Title = Sample IP Routing Protocol (Value Type: REG_SZ)
|
||
|
|
ProtocolId = 0x00c8 (Value Type:REG_DWORD)
|
||
|
|
Flags = 0 (Value Type:REG_DWORD)
|
||
|
|
DLLName = IPSAMPLE.DLL (Value Type: REG_SZ)
|
||
|
|
ConfigDLL = admin application dll (Value Type: REG_EXPAND_SZ)
|
||
|
|
ConfigClsid = admin application CLSID (Value Type: REG_SZ)
|
||
|
|
|
||
|
|
|
||
|
|
DESCRIPTION
|
||
|
|
|
||
|
|
Once the sample protocol is installed, it will periodically send out hello
|
||
|
|
messages on every active (enabled and bound) interface. These are received
|
||
|
|
by all routers on the subnet running the sample protocol. The MIB api
|
||
|
|
allows one to get and set the global and interface specific configuration
|
||
|
|
and to obtain the interface bindings as well as the global and interface
|
||
|
|
statistics. These structures are defined in <ipsamplerm.h>...
|
||
|
|
|
||
|
|
|
||
|
|
CAVEAT
|
||
|
|
|
||
|
|
At this moment the sample does not support unnumbered interfaces. This
|
||
|
|
feature will be demonstrated in a future release.
|
||
|
|
|
||
|
|
|
||
|
|
FILES
|
||
|
|
|
||
|
|
README this file
|
||
|
|
|
||
|
|
makefile unchanged
|
||
|
|
makefile.inc build instructions for resources
|
||
|
|
makefile.sdk build instructions for external distribution
|
||
|
|
sources compilation instructions for sample.dll and sampletest.exe
|
||
|
|
|
||
|
|
ipsample.def functions and variables exported by sample.dll
|
||
|
|
|
||
|
|
list.h
|
||
|
|
hashtable.[ch]
|
||
|
|
sync.h
|
||
|
|
utils.[ch]
|
||
|
|
packet.[ch]
|
||
|
|
socket.[ch]
|
||
|
|
networkentry.[ch]
|
||
|
|
networkmgr.[ch]
|
||
|
|
configentry.[ch]
|
||
|
|
configmgr.[ch]
|
||
|
|
mibmgr.[ch]
|
||
|
|
rtmapi.[ch]
|
||
|
|
rmapi.[ch]
|
||
|
|
test.c
|
||
|
|
|
||
|
|
log.h localizable error codes
|
||
|
|
ipsample.rc dll resources file
|
||
|
|
ipsample.[ch] dll main file
|
||
|
|
|
||
|
|
pchsample.h precompiled header
|
||
|
|
|
||
|
|
sampletest.rc test resources file
|
||
|
|
sampletest.h test header file
|
||
|
|
sampletest.cxx test main file (cxx extention precludes pch inclusion)
|
||
|
|
|