VIRTUAL PACKET DRIVER FOR WINDOWS
SwsVpkt provides a packet driver emulation for DOS networking applications running on Windows XP, 2000 and NT4 systems. NB Windows 95, 98 and Me are not supported.
SwsVpkt is shareware; that is it may be freely used by any individual for personal and private use or for their business without any restriction or charge. Companies, organizations or governments may not use it without a license. In no case may SwsVpkt be re-sold or used in a system to deprive anyone of life, liberty, livelihood or privacy
Copyright © 2005-2006 Software Systems Consultants. All rights reserved
Tel: +33 5 49 72 79 63
If you have a self-extracting archive file (.exe) then double click it to expand the files into an empty folder. If you have a ZIP archive then use WinZip or similar to extract the files into an empty folder.
NB the SwsVpkt protocol driver may be installed on Windows 9x systems but the packet driver emulation will be non-functional. However, the protocol driver exposes a set of private ioctls that can be called from any Win32 program. See www.sofysystem.co.uk/readme.htm for information on using this API.
By default, SwsVpkt does not send or receive data over dial-up connections. This feature can be enabled by double clicking the file DialupEnable.reg supplied in the SwsVpkt distribution. Confirm the action by clicking yes when prompted. Similarly, the feature can be disabled by double clicking DialupDisable.reg. After either change the system must either be re-booted or the SwsVpkt driver restarted from the command line:
net stop swsvpkt
net start swsvpkt
Disabling SwsVpkt over dial-up
Normally SwsVpkt is enabled as a protocol in the network control panel for the dial-up adapter. This can be changed by selecting the networking tab for the dial-up adapter and ensuring that the checkbox next to 'Software System virtual packet driver' is clear.
The virtual packet driver does not normally require special configuration. However, for advanced uses, the following registry settings may be made:
Windows NT4, 2000 and XP
Under the key HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SwsVpkt\Parameters
Windows 98 and Me
Under the key HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Class\NetTrans\00XX\Parameters
Where X is in the range 0..FF.
The following registry values affect the NDIS driver:
Under the key HKEY_LOCAL_MACHINE\Software\Software Systems\SwsVpkt
The following registry values affect the packet driver emulation:
Before starting any packet driver clients (DOS applications), the real mode packet driver stub must be installed in the virtual DOS machine. This can be accomplished from a Command Prompt by typing:
which will install the driver on the default software interrupt of 0x60, using the default hardware interrupt 7.
The full command line syntax is:
SwsVpkt [options] [SWI]
-i<u> : Hardware IRQ
-l : List adapters
-a<u> : Select adapter
-u : Unload driver
-t : Quiet mode
-h : Help
The driver may also be installed from a batch file.
In common with its DOS counterparts, SwsVpkt plays no part in the setup or configuration of third party communications libraries such as TCP/IP stacks. SwsVpkt solely conveys raw Ethernet frames to and from the local network. The IP address and settings of the host computer, apart from the hardware MAC address, have no effect upon SwsVpkt.
By default, SwsVpkt binds to all LAN adapters. You can change this by opening the 'Network and Dial-up connections' control panel, right click the adapter you wish to change and select properties. In the components list box you should see 'Software Systems virtual packet driver' - uncheck the box next to this. When the dialog is closed the driver unbinds from the adapter, a re-boot is not required. From this point on, the adapter is not accessible via SwsVpkt. If there is an active SwsVpkt session when the driver is disabled then Windows will prompt you to reboot since it can't unbind the driver until all open handles are closed. To avoid the reboot you should either close the SwsVpkt session or exit your app and execute SwsVpkt -u, before changing the driver bindings.
The SwsVpkt packet driver emulation provides access to multiple adapters through a single driver instance. However, many applications are coded to only use the first adapter. In this case it is necessary to start multiple instances of SwsVpkt, specifying a different adapter and software interrupt for each e.g.
Swsvpkt -a0 0x60
Swsvpkt -a1 0x61
Swsvpkt -a2 0x62
SwsVpkt is designed to be compatible with all recent Windows systems and common DOS networking applications. The following limitations are known:
If you should have other problems, issues or for technical support contact: firstname.lastname@example.org
WHO ARE SOFTWARE SYSTEMS?
Software Systems provide software development services and consultancy. Our current products include:
Tel: +33 5 49 72 79 63
SwsVpkt is supplied 'as is' with absolutely no warranty given or implied. The use of SwsVpkt is entirely at the risk of the end user. Software Systems will not be held responsible for any loss or damage, however caused, resulting from the use of SwsVpkt.