Category : Information about the Internet from the early 1990's
Archive   : WSK10A.ZIP
Filename : INSTALL.TXT

 
Output of file : INSTALL.TXT contained in archive : WSK10A.ZIP







Trumpet Winsock



Version 1.0



By Peter R. Tattam



Managed by Trumpet Software International




Copyright (C) 1993,1994 by Peter R. Tattam

All Rights Reserved



2


Introduction

Thank you for using the Trumpet Winsock. It is through
the kind support of many users out there that quality
networking software has been available at affordable
prices to the Internet community. The Trumpet Winsock is
a Windows Sockets 1.1 compatible TCP/IP stack which
provides a standard networking layer for many Windows(tm)
networking applications to use, and has itself been a
major vehicle in achieving widespread use of Windows
Sockets 1.1. The product is a shareware item and as
such, you are permitted to evaluate it for a period of 30
days. If you are satisfied with its usefulness, a
registration form is provided which you can fill out and
send to Trumpet Software International. A registration
fee is requested to maintain the development and support
of this software. Suitable arrangements have been made
for site licenses, and details can be found in a later
section.

Disclaimer & Copyright

These programs are Copyright (C) 1991-1994 by Peter R.
Tattam,
All Rights Reserved.

They are provided as shareware with the following
limitations:

These programs are shareware and are not to be
resold or distributed for sale with other programs
which are for sale. There is no warranty or claim
of fitness or reliability. The programs are
distributed AS IS, and as such neither the author,
nor Trumpet Software International nor the
University of Tasmania shall be held liable for
any loss of data, down time, loss of revenue or
any other direct or indirect damage or claims
caused by these programs.

Instructions for Installing the Trumpet Winsock.

The Trumpet Winsock will only run on your PC under the
following conditions. You must have either a packet
driver available for use by network programs, or if you
wish to use SLIP, a free comms port. Additionally,
packet drivers can only be used reliably under enhanced
mode using WINPKT. Standard mode can be used, but care
must be taken to avoid system crashes. NDIS and ODI can

be used via packet driver shims, but their use is not
supported. PKTMUX may also be used instead of WINPKT,
and must be version 1.2c or later, but again its use is
not supported.

If you already have some kind of TCP/IP networking
package installed, it is most likely that the Trumpet
Winsock will not run and you will have to massage your
system configuration to install the Trumpet Winsock,



3


possibly even to the extent of uninstalling that
networking package. Alternatively, there may be a
Winsock available for your package in which case the
Trumpet Winsock will not be required.

Installing Trumpet Winsock over Packet Driver.

Firstly, if you don't know what a packet driver is, it is
normally a small piece of software which sits in between
your network card and your TCP program. This provides a
standard interface which many programs can use in a
similar manner to BIOS calls using software interrupts.

Why is it called a packet driver? This is because modern
networks send information using packets of information
rather than sending information one byte or character at
a time. For example, Ethernet sends information in
frames of up to 1514 bytes long. The reason for sending
things in packets is that information can be transmitted
much more efficiently in packets.

Central to the concept of the packet driver is the vector
which is used to communicate with it. The 80x86 family
of processors allows programs to communicate with the
operating system through what is called a "software
interrupt", which always has a number in the range 0 to
255. This is termed a "vector" and is the one of the key
mechanisms to pass control to the MS-DOS operating
system. Usually the vectors are in hexadecimal, making
the range expressed as 0x00 to 0xFF. The 0x in front of
the number means that we are using hexadecimal numbers
instead of decimal numbers. They may also be expressed
in the notation 00H to FFH, or $00 to $FF. If you are
dealing with packet drivers, hexadecimal notation is much
more common, but occasionally they are expressed in
decimal. Examples of software interrupts in use on PC's
are 0x10 for the video BIOS, or 0x21 for calls to DOS.

Packet drivers are only allowed to have a software
interrupt vector in the range 0x60 to 0x7F. Normally, you
will pick 0x60 as the default place to install your
packet driver, but certain machine configurations may
make that vector unavailable. Just choose one that is
free - the packet driver should tell you if you can use
it or not.

The Trumpet Winsock also uses a special virtual packet
driver "wrapper" which enables your packet driver to
function correctly in Windows. While the packet driver
is an efficient way to communicate with your network
card, it will not work correctly from Windows without a
little assistance. The program "WINPKT" was written by
some clever people on the Internet to allow a packet
driver to work correctly within Windows by making sure
that packets get directed to the correct "virtual
machine" under Windows enhanced mode. A "virtual
machine" can be either the entire Windows session, or any



4


dos session active within Windows. Refer to the Windows
system documentation for more details.

In addition to this, you will need to have some
understanding of IRQ vectors and I/O addresses that may
be relevant to installing your network card.

Where do I obtain packet drivers from?

These days, packet drivers are usually provided with your
network card, but a comprehensive collection of public
domain packet driver can be obtained from a packet driver
collection called the "Crynwr Packet Driver Collection."
Information on where to get this packet driver collection
from is provided as an appendix to this document.

Actually Installing the Winsock.

Before you do anything, copy the files winsock.dll,
tcpman.exe, winpkt.com, hosts, services and protocol to a
suitable directory.

eg. c:\trumpet

the essential files:
winsock.dll the guts of the TCP/IP driver
tcpman.exe interface program for managing the
winsock
winpkt.com virtual packet driver interface for
windows
hosts list of host names & aliases
services list of Internet services
protocol list of Internet protocols

Modify the path line in your autoexec.bat to contain a
reference to that directory.

eg. path c:\dos;c:\windows;c:\trumpet

Make sure it is active by rebooting or executing
autoexec.bat again.

The most basic setup of packet driver and WINPKT would
look something like this example :


ne2000 0x60 2 0x300
WINPKT 0x60


The first line installs an NE2000 packet driver on vector
0x60 using IRQ 2 and I/O address 0x300

The second line installs the WINPKT virtual packet driver
using the same vector that the ne2000 packet driver was
installed on.



5


This is of course an example so your mileage will of
course vary. Some example configurations are described
later in this document. Choose the one which suits you
the best and modify it to your requirements.

Now you are ready to start windows. Start it up!!

From windows, start up tcpman. From the file manager, go
File/Run, and then "tcpman". If this fails, the path is
probably not set up correctly, so fix it. Later on, you
can install it as an icon to use it directly.

Assuming you are a first time user, a setup screen will
appear giving you a number of options to fill in. You
will need to fill in a few details to enable the TCP
package to function. Fill in the following details. If
you are unclear on any of them, try to seek some help
from qualified Internet support staff - it will save you
a lot of time.

IP address your Internet IP address, "bootp", or
"rarp". lower case please. If you
use BOOTP, be sure to have a BOOTP
service on the network or the winsock
will not load.
Netmask your Internet network mask. (eg.
255.255.0.0)
Default Gateway your default Internet gateway. (IP
address)
Name server your name server IP address for DNS
searches. You may provide more than
one address by separating the
addresses with spaces. (IP addresses
only)
Time server at present unused - future winsock
API's may support this. (IP addresses
only)
Domain suffix a space separated list of domain
suffixes to be used when resolving
names in the DNS system.
Packet Vector either leave this as 00 to search for
the packet driver, or the vector that
you installed the packet driver
under. The number is required in
hexadecimal without the leading "0x".
In our example, you would provide
"60". (numeric)

MTU Maximum Transmission Unit. (numeric)
For Ethernet, 1500 is the maximum,
and is recommended.
TCP RWIN TCP Receive Window (numeric) eg.
(defaults to 4096 but can be larger)
TCP MSS TCP Maximum Segment Size (numeric)
(usually MTU - 40)



6


The rest of the details should be greyed out and you need
not try to fill them in. The Internal SLIP check box
should not be checked.

The first four parameters and the packet vector are
required for successful functioning of the winsock, while
the rest can be tailored to suit your needs.

When you are done, click on and if all goes well,
the Trumpet Winsock will be initialised. You are now
ready to start using the winsock.


What to do if something goes wrong

Firstly...

The Trumpet Winsock requires that your have the correct
combination of tcpman.exe, winsock.dll and winpkt.com.
When upgrading to a new release, replace each of these
files to be sure that everything is up to date.

If you get the messages about not finding a packet driver
or unable to load TCP, then check that the packet driver
loaded properly, that WINPKT managed to find it, and that
the correct vector was chosen from tcpman.

At the moment, only Ethernet and SLIP packet driver types
are supported.
Token ring is only available via the ibmtoken packet
driver, and should work, but is untested by the author.

ODI can be used via the ODIPKT shim, and NDIS via the
DIS_PKT shim. examples are provided later on. Also,
examples are provided of installation using NetWare.

Possible causes for tcpman load errors specific to packet
drivers.

unable to bind protocol 0806 another TCP stack is
using the packet driver...
remove it.
WINPKT or pktdrv not found couldn't find the correct
packet driver. Also check
the vector number in
TCPMAN.
unable to allocate network buffers critical error...
try to free up some special
driver memory by removing
windows device drivers.
network buffers low not critical but
unadvisable... see above

If WINPKT can't load (No packet driver found), check your
packet driver vector number. Some drivers may choose a
default vector which is not at 0x60. eg. ODIPKT default
is 0x69



7


If you are using ODIPKT and you can't get any response,
you probably accessing the wrong protocol. If you have
the ARP trace on, you will possibly get "ARP timed out"
messages as well. The first parameter of ODIPKT selects
the correct protocol. Try adjusting this.

Anything else... contact me. I'll try to figure out
what's wrong, but first browse the samples provided.



8



Installing Trumpet Winsock over Internal SLIP

SLIP is a simple protocol which allows an Async serial
connection to send Internet Protocol (IP). You usually
need to have access to a server which can understand
SLIP. Usually, SLIP is accessed via a phone line, and
with the advent of high speed modems, TCP/IP is a reality
over a dial-up connection.

The Trumpet Winsock has facilities for managing a SLIP
connection as well as the ability to use dialling scripts
for logging in and out of your SLIP server.

Actually Installing the Winsock.

Before you do anything, copy the files winsock.dll,
tcpman.exe, hosts, services and protocol to a suitable
directory.

eg. c:\trumpet

the essential files:
winsock.dll the guts of TCP/IP driver
tcpman.exe interface program for setting up the
winsock
hosts list of host names
services list of Internet services
protocol list of Internet protocols

Modify the path line in your autoexec.bat to contain a
reference to that
directory.

eg. path c:\dos;c:\windows;c:\trumpet

Make sure it is active by rebooting or executing
autoexec.bat again.

Now you are ready to start windows. Start it up!!

From windows, start up tcpman. From the file manager, go
File/Run, and then "tcpman". If this fails, the path is
probably not set up correctly, so fix it. Later on, you
can install it as an icon to use it directly.

Assuming you are a first time user, a setup screen will
appear giving you a number of options to fill in. You
will need to fill in a few details to enable the TCP
package to function. Fill in the following details. If
you are unclear on any of them, try to seek some help
from qualified Internet support staff - it will save you
a lot of time.

Firstly, click on Internal SLIP. Some of the parameters
will be greyed and others ungreyed.



9


IP address your Internet IP address or "bootp".
lower case only. Only use BOOTP if
you are not intending to use a dial
in script. If using a dialler script
with the address extracted by the
script, or BOOTP later, just leave it
with default value of 0.0.0.0 Only
use BOOTP if your server supports it,
otherwise the winsock will delay for
about 15 seconds and the message
"Unable to load TCP" will come up.
Name server your name server IP address for DNS
searches. You may provide more than
one address by separating the
addresses with spaces. (IP addresses
only).
Time server at present unused - future winsock
API's may support this. (IP addresses
only).
Domain suffix a space separated list of domain
suffixes to be used when resolving
names in the DNS system.
MTU Maximum Transmission Unit. Related to
TCP MSS... usually TCP MSS + 40.
(Numeric)
TCP RWIN TCP Receive Window. It is recommended
that this value be roughly 3 to 4
times the value of TCP MSS. (Numeric)
TCP MSS TCP Maximum Segment Size, It is
recommended that this be a smallish
value when using SLIP - say 512 bytes
for SLIP and lower for CSLIP. CSLIP
is able to compress data more
efficiently when it is less than 255.
(numeric)
SLIP port your comms port number ..1=com1,
2=com2 etc. (numeric)
baud rate the speed you wish to run at.
(numeric)
hardware handshake recommended if your link
supports it.
Van Jacobson CSLIP
Compression if your server will support it. You
may also have to adjust MTU, MSS &
RWIN. to be suitable.
Online Status
Detection if your modem will support it, select
DCD or DSR on-line status detection.


The rest of the details should be greyed out and you need
not try to fill them in.

When you are done, click on and if all goes well,
the Trumpet Winsock will be initialised. You are now
ready to start using the winsock.

Logging in to the server.



10



You can use either the manual login or the automatic
scripting to access your server. For the time being,
choose manual and log into your server with the
appropriate commands. Don't forget to use the key
to get out when you have finished dialling in. After
logging in, you may need to go and set your IP address if
it is allocated dynamically.

If you wish to use another terminal program to dial in to
the server, don't forget to issue AT&D0, or disable DTR
dropping when exiting the program, or the connection will
be severed when the application closes the comms port.

Try out pingw to a well known host IP address to see if
all is well.

Problems

Check your baud rates...
If using hardware hand shaking with an external modem,
make sure the cable is correctly wired.
At the moment, all dialling must be done with 8bits, no
parity. This may not work for you... you will then need
to use an external dialler. The next revision will have
an extension to the dialler to allow this.

If all else fails... contact me !!

Once you have determined your login sequence, you can set
up a login script. A sample script is provided along
with a listing of a typical session.

Automatic dialling.

Minimal scripting is supported, and the script commands
are

input wait for string received.
output send string.
display display string on display.
wait { DSR | CTS | RLSD | DCD}
wait for DSR or CTS or
RLSD(DCD)
trace ( on | off ) useful for debugging
scripts
echo (on | off) defaults to on
password message box for password
username message box for username
address parse IP address
set (DTR | RTS) (on | off) set/reset the modem lines.
sleep pause for so many seconds.
exec program will be started up
concurrently using
winexec().
online enter SLIP mode. commands
depending on received
characters will not work



11


correctly after this
command is issued since the
winsock will interpret data
as SLIP frames. Useful
before an exec command
which uses the winsock.
BOOTP inform the winsock that a
BOOTP will be required
after the script has
finished.

# means start comment except inside string

string arguments
\l line feed
\r return
\n cr/lf pair
\f form feed
\t tab
\b backspace
\nnn ASCII value in decimal
\i IP address
\p password
\u username
\c comm port number (as you have configured it)

a sample script is given for logging in to our Xylogics
terminal server.

output atz\13
input 10 OK\n
#output atd242284\13
output atd241644\13
input 30 CONNECT
input 30 \n
wait 30 dsr
output \13
input 30 username:
output tattam\13
input 30 password:
password Enter your password
output \p\13
input 30 >
output who\13
input 30 >
output slip\13
input 30 Your address is
address 30
input 30 \n
display \n
display Connected. Your IP address is \i.\n
exec pingw 131.217.10.1


Here's a log of a typical session. Names have been
blanked out for security.

Trumpet Winsock Version 1.00 Alpha #18



12


Copyright (c) 1993 by Peter R. Tattam
All Rights Reserved.
SLIP ENABLED
Internal SLIP driver COM3 Baud rate = 38400 Hardware
handshaking
My ip = 131.217.8.4 netmask = 255.255.0.0 gateway =
131.217.250.1
Executing script c:\dev\tcpip\winsock\login.cmd
SLIP DISABLED
atz
OK
atd241644
CONNECT 38400


Annex Command Line Interpreter * Copyright 1991
Xylogics, Inc.

Checking authorization, Please wait...
Annex username: xxxxxx
Annex password:

Permission granted
University of Tasmania
AARNet Terminal Server

SLIP users:
Use a maximum segment size (MSS) of 209
and a maximum transmission unit (MTU) of 255.

Async AppleTalk users:
Configure MacTCP to use the Computing Centre zone.
*** Note change in procedures for starting
async AppleTalk.
*** After typing atalk you will be prompted
for your password
*** again.
AARNET TS5 >who
Port What User Location When
Idle Address
2 CLI xxxxxxxx --- 8:01pm
[local]
+1 'telnet tasman.cc'
3 CLI xxxxxxxx --- 8:15pm
[local]
+1 'rlogin franklin.cc'
4 SLIP modem4 --- 8:19pm
ants
5 CLI xxxxxxxx --- 8:34pm
[local]
6 CLI xxxxxxxx --- 7:19pm
[local]
+1 'rlogin baudin.cc'
17 SLIP modem18 --- 6:39pm
ants
AARNET TS5 >slip

Switching to SLIP.



13


Annex address is 131.217.250.10. Your address is
131.217.8.5.

Connected. Your IP address is 131.217.8.5.

Script completed
SLIP ENABLED

Dialler problems.

Q. tcpman just pauses when starting up, then gives the
message "unable to load TCP".

A. You've probably got BOOTP set. Replace it by 0.0.0.0
before dialling and try again. RARP is impossible to send
via SLIP so don't bother with that.

Q. The connection appears to be too slow compared to
Xmodem.

A. Possibly the MTU/MSS & RWIN settings are not right.
Try to make RWIN about 3 to 4 times MSS and an exact
multiple if possible. Turn on the IP trace to see if
fragmentation is occurring on TCP connections. If so,
then reduce MSS until it stops. UDP packets will still
be fragmented, but nothing can be done about that. On
the trace, TCP is type 6 while UDP is type 17.

Q. Some input commands in the script don't work.

A. Check for upper case/lower case conflicts. Also check
for blanks at the end of the lines.


For other problems, contact me at

[email protected], or subscribe to
the Trumpet discussion group and ask your question.
Details are at the end of this document. As time goes
on, various FAQ's will be constructed to cope with the
more common problems.



14


Sample Configurations for Packet Driver.

1. Plain ne2000 packet driver using WINPKT.

ne2000 0x60 2 0x300
WINPKT 0x60

2. Ne2000 packet driver with Novell NetWare access using
WINPKT.
Important is the specification of the -n switch of the
packet driver. Some packet drivers don't support this
switch. In that case, you may be forced to use ODI
instead. An example could be the Xircom Pocket Adapter.

ne2000 -n 0x60 2 0x300
WINPKT 0x60
pdipx
netx
path c:\dos;c:\network\win31
f:
login


3. Ne2000 packet driver with Novell NetWare access using
PKTMUX. Notice that WINPKT is not required since PKTMUX
does a similar job.

ne2000 -n 0x60 2 0x300
pktmux 4
pktdrv
pktdrv
pktdrv
pktdrv
pdipx
netx
path c:\dos;c:\network\win31
f:
login

4. ODI setup with NetWare access.

You will need ODIPKT. The latest known release is 2.4 It
is important that ODIPKT reference the correct protocol
for IP access. This can be specified as the first
parameter to ODIPKT (0=1st, 1=2nd and so forth)

Here's a sample of my network attach batch file.

@echo off
cd \
lh lsl
lh \odi\ne2000
cd \net
lh ipxodi
lh odipkt
lh WINPKT 0x69
lh netx
path c:\dos;c:\net\win31



15


f:
echo on
login

Also, your net.cfg must be suitably configured. Here are
the relevant excerpts from my net.cfg

Link Support
Buffers 8 1586
MemPool 16384

Link Driver NE2000
Port #1 300 20
Int #1 2
Frame Ethernet_II
Frame Ethernet_802.3
Protocol IPX 0 Ethernet_802.3


The ordering of the frame protocols is important for the
default setup of ODIPKT. Also, users should be aware
that there are two versions of ODIPKT, one released I
believe by FTP Software, and the public domain one. I
refer to the public domain version. Also note that there
are two programs with the same name of "ne2000.com". One
is a packet driver and is referred to in an earlier
section. The one referred to in this section is actually
an ODI driver and won't function as a packet driver at
all.

5. NDIS & Windows for Workgroups setup. (courtesy of
Peter Whisker, [email protected])

Installation of Trumpet Winsock makes use of the
DIS_PKT9.DOS or DIS_PKT.DOS shims which provide a Packet
Driver interface the NDIS. The version I have tested is
found on a number of sites as DISPKT11.ZIP, and contains
DIS_PKT.DOS dated 28/4/93. The example is based upon an
actual configuration using DEC Pathworks version 4.1
(DECNET version) with a DEPCA Ethernet card. This
installation assumes that you have NDIS up and running
and have a valid PROTOCOL.INI file.

You need to perform three basic steps:
Load the DIS_PKT driver in CONFIG.SYS following the
load of PROTMAN.SYS:

DEVICEHIGH=\DECNET\PROTMAN.SYS /I:C:\DECNET
DEVICEHIGH=\DECNET\DEPCA.DOS
DEVICEHIGH=\DECNET\DIS_PKT.DOS

Add a few lines to PROTOCOL.INI (here labelled
[PKTDRV]) in order to bind it to the Ethernet driver.
In this example, DIS_PKT.DOS is configured with packet
vector 60.

[DEPCA.DOS]
DRIVERNAME = DEPCA$



16


.
.
.
[PKTDRV]
DRIVERNAME = PKTDRV
BINDINGS = DEPCA.DOS
INTVEC = 0x60

In AUTOEXEC.BAT, load WINPKT or PKTMUX as described in
examples 2 and 3 above. This should be done after the
NETBIND command in your NDIS startup has been executed.
In the case of Pathworks, this command is normally
contained in STARTNET.BAT. For example:

call \decnet\startnet.bat
WINPKT 0x60


6. Some more packet driver installations courtesy of
Ashok Aiyar ([email protected])

Configuration for Cabletron Network Cards. The packet
driver provided by Cabletron is a little confusing as it
doesn't use the same parameters as packet-drivers that
use the Crynwr skeleton.

Typically the Cabletron driver is loaded as:

"csipd_e /s:62 /h:7 /p:300"

In this example the software interrupt is 0x62. Load
winpkt.com as

"WINPKT 0x62"

Release 11 of the Crynwr packet drivers includes a driver
for Cabletron cards written by Kai Getrost using the
Crynwr skeleton that uses the same parameters as the
other Crynwr drivers. This driver (CTRONDNI.COM) seems
to work well with E1020/1040 and E2020 Cabletron cards.
Indeed I see a performance gain over the Cabletron
driver. Your mileage may vary.

C/SLIPPER with PKTMUX. Although the Trumpet Winsock has
built in support for C/SLIP, there are situations when in
addition to Winsock applications there is a need to run
packet driver applications simultaneously over a SLIP
link. For such situations, PKTMUX is of utility.

Example:

CSLIPPER vec=65 com1 irq=04H baud=57600 ether
PKTMUX 4 65 /4 .... (support for a maximum of 4 virtual
packet drivers)
PKTDRV 60 65

Configure the Trumpet Winsock to use the virtual packet
driver at 0x60. All other virtual packet drivers



17


(PKTDRV) can be loaded in the DOS Windows in which they
are used. They need not be loaded before entering
Windows.

(Ed. Note... You may also require the use of a special
comms buffer to enhance the buffering capabilities of
Windows when using slipper/cslipper. An FAQ on doing
this is available from biochemistry.bioc.cwru.edu via
gopher or FTP. It is not needed when using the internal
SLIP functions of the Winsock)

Extra Info

You may use environment variables or command line options
to override some of the network parameters. They have
the same names as the saved parameters in trmpwsk.ini.
This file normally resides in the winsock directory
rather than the windows directory since this facilitates
setting up the winsock in a networked environment. IP
addresses can be overridden by using the environment
variables, or the command line.

example of command line.

tcpman -ip=123.231.213.123 -netmask=255.255.255.0

example of environment variable

set ip=123.231.213.123
set netmask=255.255.255.0

Here's a list of parameters.

ip/myip your IP address or 'bootp' or 'rarp'
(lower case only)
netmask your netmask. eg. 255.255.0.0
gateway/mygatewayyour gateway (IP address)
dns list of DNS IP addresses
time list of time server IP addresses
domain list of domain name suffixes
vector packet driver vector in hex
MTU Maximum Transmission Unit
RWIN TCP Receive Window.
MSS TCP Maximum Segment Size
slip-enabled 0 = off, 1 = on
slip-port port number (1-9)
slip-baudrate baud rate in decimal
slip-handshake 0 = off, 1 = on
slip-compressed 0 = off, 1 = on

The Crynwr packet driver collection

Availability

The Crynwr packet driver collection is available by mail,
by FTP, by e-mail, by UUCP and by modem. The drivers are
distributed in three files: drivers.zip, which contains
executables and documentation, drivers1.zip, which



18


contains the first half of the .ASM files, and
drivers2.zip, which contains the second half of the .ASM
files.

Mail:

Columbia University distributes packet drivers by mail.
The formats are 9-track 1600 bpi tapes in ANSI, tar, or
OS SL format, or PC diskettes (360K 5.25" and 720K 3.5").
The exact terms and conditions have yet to be worked out,
please call (212) 854-3703 for ordering information, or
write to:

Kermit Distribution, Dept PD
Columbia University Center for Computing Activities
612 West 115th Street
New York, NY 10025

or send e-mail to [email protected]
(Internet) or
[email protected] (BITNET/EARN).


FTP/e-mail:

The packet driver collection has its own directory
devoted to it, pd1:. The drivers are
there, along with many free programs that use the packet
drivers.

SIMTEL20 files are also available from mirror sites
OAK.Oakland.Edu
(141.210.10.117), wuarchive.wustl.edu (128.252.135.4),
ftp.uu.net (192.48.96.9), nic.funet.fi (128.214.6.100),
src.doc.ic.ac.uk (146.169.3.7) or rana.cc.deakin.oz.au
(128.184.1.4), or by e-mail through the BITNET/EARN file
servers.

Modem:

If you cannot access them via FTP or e-mail, most
SIMTEL20 MSDOS files, including the PC-Blue collection,
are also available for downloading from Detroit Download
Central (313) 885-3956. DDC has multiple lines which
support 300/1200/2400/9600/14400 bps
(103/212/V22bis/HST/V32bis/V42bis/MNP). This is a
subscription system with an average hourly cost of 17
cents. It is also accessable on Telenet via PC Pursuit
and on Tymnet via StarLink outdial. New files uploaded
to SIMTEL20 are usually available on DDC within 24 hours.

CD-ROM:

Public, private or corporate institutions and libraries
interested in the SIMTEL20 MSDOS collection in CD-ROM
format bundled with library card-catalog type access and
duplication software can contact Coyote Data, Ltd. by



19


mail at 1142 N. Main, Rochester, MI 48307 or by FAX at
(313) 651-4071.

UUCP:

The packet driver files are available from UUNET's 1-900-
GOT-SRCS, in uunet!~/systems/msdos/simtel20/pktdrvr. See
UUNET.DOC for details.

ODIPKT location

I am told that the originating site for ODIPKT is the
following...

Host hsdndev.harvard.edu

Location: /pub/odipkt
FILE -rwxr-xr-x 2915 Aug 21 20:01
odipkt.com

A copy of the NDIS shim is there also.



20



Trumpet General Discussion Group.

The machine petros.psychol.utas.edu.au is now running a
local news service with the news groups

trumpet.announce
trumpet.bugs
trumpet.feedback
& trumpet.questions

If you do not have access directly to this service, these
news groups are gatewayed to the following mailing list.

You may join the new Trumpet mailing list by sending a
message to

[email protected]

with just one line in the body.

subscribe trumpet-user Your Full Name

Where "Your Full Name" should be replaced by your actual
full name.

The list is called

[email protected]


and is running on a 486/50 FreeBSD system. Hopefully it
will cope 😉

You can ask questions, or discuss any aspect of any
Trumpet program on this group. Feedback is always
welcome. There is also an anonymous FTP area with all
the latest Trumpet programs and pre-releases. If you do
use a pre-release, be prepared for unexpected problems
since such programs are in alpha/beta test.


Bugs or Comments

Send to

[email protected]

For bug reports, please send a copy of config.sys,
autoexec.bat, trumpwsk.ini, and any other relevant
network configurations. In the case of ODI, also send
net.cfg. We will do my best to sort out your problem.
Due to the high demand for the Trumpet Winsock, my mail
box can be overloaded at times. Be patient... someone
will answer you.



21


TCPMAN - The Trumpet Winsock TCP Manager

Menu options.

File/Setup calls up the setup dialog for
configuration

IP address your IP address, "bootp" or
"rarp" (lower case).
BOOTP will only work if there is
a BOOTP service on-line.
RARP will only work if using
Ethernet, and there is an RARP
service on-line.
Netmask your network mask.
Default gateway your default Internet gateway or
router.
Name server your Domain Name Server address.
Time server (unused leave empty)
Domain Suffix A space separated list of
suffixes to be tried when
looking up names via the name
server.
Packet Vector for accessing the packet driver
in hex.
MTU Maximum Transmission Unit.
TCP RWIN TCP Receive Window
TCP MSS TCP Maximum Segment Size

Demand Load Timeout Number of seconds tcpman stays
loaded after the application has
finished with it.

Internal SLIP Click on this for internal SLIP
support & dialler support.
SLIP port which comms port to use.
Baud Rate speed of the connection.
Hardware Handshaking turn on for RTS/CTS
handshaking. May require the
AT&K3 modem command to function
properly.
Van Jacobson CSLIP compression
turn on for CSLIP TCP header
compression.

Online Status Detection needed for dialler
autologin / autologout enabling.
None no online status detection

DCD (RLSD) check may require AT&C1 modem command
to function.

DSR check may require AT&S1 modem command
to function.



22


File/Register calls up the registration dialog.
File/Exit quits the TCP manager, forcing the
winsock to be unloaded.

Edit/Copy copy selected text on tcpman display
to the clipboard
Edit/Clear clear the tcpman display

Tracing options. Use with care since some applications
may crash when the traces are active. Should a program
crash with stack overflow, the winsock may remain loaded
in memory even though tcpman has exited. It is advisable
to restart windows if this happens and possibly even to
reboot your machine. Also, timing measurements of the
winsock throughput will be severely affected by the trace
options.

Trace/TCP turn TCP trace on/off
Trace/UDP turn UDP trace on/off
Trace/IP turn IP tracing on/off
Trace/ARP turn ARP tracing on/off
Trace/RARP turn RARP tracing on/off
Trace/Ethernet add Ethernet headers to IP/ARP/RARP
traces.
Trace/Extra detail add some extra detail to TCP, UDP &
IP traces.
Trace/Socket calls trace each winsock call.
most parameters are displayed as
well.
Trace/DNS trace Domain Name Server operations.
Use with care, stack overflows can be
frequent.
Trace/Messages trace Async Socket messages.



23



Dialler/Login invoke the login.cmd dialler script.
Dialler/Bye invoke the bye.cmd dialler script.
Dialler/Other invoke other scripts.
a file selection dialog of *.cmd will
be
displayed.
Dialler/Options call up the dialler options dialog.

No automatic login
Automatic login on startup only.
Automatic login and logout on demand.

SLIP inactivity timeout (minutes) Number of minutes
to wait before exiting
winsock. (when no
application is using the
winsock.) Automatic login
& logout must be enabled
for this to close the SLIP
connection. A value of 0
disables the timeout.

Dialler/Manual Login invoke the dialler manually.
Use to exit from the manual
dialler.
Dialler/Edit Scripts invokes notepad to edit any
script.

Help/About Display the version number and
copyright.



24


Registration


Registration of the Trumpet Winsock is encouraged since
it funds further development of the winsock. It involves
sending in a registration form filled in with your
registration name and other details. On receipt of your
registration, you will receive a password which will
remove the UNREGISTERED VERSION notice and replace it
with your registration name. As part of this
registration, you will receive enough support to get you
going within the existing capabilities of the winsock at
the present time, and preference will be given to
registered users when it comes to bug fixes or future
enhancements to the winsock. Packet drivers using
Ethernet and SLIP are presently the only supported
network access. The winsock will function through the
use of packet driver shims for ODI, NDIS and token ring,
but the use of these is not supported, neither is the
winsock supported should you be using PKTMUX.


The Trumpet Winsock is currently distributed as
shareware. You may use the Trumpet Winsock for 30 days to
evaluate its usefulness. If at the end of that time you
are satisfied with the Trumpet Winsock as a product, you
can register it. The basic registration fee for a single
user version of the Trumpet Winsock is US$20. See a
later section for details on multi-user site licenses.

Australian users should contact me regarding Australian
pricing information and availability.

Cheques or Postal Orders should be made out to

Trumpet Software International

and sent to

Trumpet Software International
GPO Box 1649,
HOBART, TAS AUSTRALIA 7001

You should fill out the following order form and send it
along with your cheque or Postal Order to the above
address.

FAX/Phone International 61-02-487049, Australia 002-
487049

Please note that International mail can be rather slow,
and it may take up to 2 months to receive your
registration.



25



+----------------------------------------------+
| O R D E R F O R M |
| for Trumpet Winsock version 1.0 Software |
+----------------------------------------------+






Ship to: Bill to:

[ ] [
]
[ ] [
]
[ ] [
]
[ ] [
]
[ ] [
]


Please supply the following items:

---------------------------------------------------------
-------------

Licence to use Trumpet Winsock 1.0 for [ ] users
. . . .
. US$[ ]

Tick at least one of the following options.
[ ] 5.25" disk with the latest version of Trumpet Winsock
+ password
[ ] 3.5" disk with the latest version of Trumpet Winsock
+ password
[ ] registration password via post
[ ] registration password via e-mail

Your registration name (required) (will appear on
program)

[________________________________________________________
____________]

Your e-mail address (optional - print clearly)
[________________________________________________________
____________]


Date sent [______________] Expected delivery Date
[_______________]



26


Site Licenses

A site license is defined as being a sale to an
organisation or company, and may not be resold or
redistributed for profit. It may only be used within that
organisation.

prices valid until 30-Jun-1994

Single User license

1 user $20 US

Multi-user site license

Trumpet Winsock will be charged by the number of
simultaneous users.
The pricing structure for commercial users is thus

1-99 users $20 US per user
100-499 users $2000 US + $10 US per additional user
over 100
500-999 users $6000 US + $5 US per additional user
over 500
1000+ users $8500 US + $2 US per additional user
over 1000

site restriction 10km radius (negotiable)

Unlimited Commercial Site License

$10,000 US for first year.
subsequent years, 25% of unlimited site license fee
for that year.
site restriction 100km radius (negotiable)

The pricing structure for educational users is thus

1-100 users $20 US per user
100+ $2000 US

site restriction unlimited.

Your site license will give you support for up to 12
months from the date of purchase. Such support will
include upgrades and bug fixes within that 12 months
within the constraints of the program's existing
capabilities. Future upgrades will be 25% of the
original license fee per annum. Arrangements will also
be made for conversion of smaller licenses to larger
ones.



27



Should you wish to obtain the Trumpet Winsock to
distribute with other programs, you should make a
suitable offer to Trumpet Software International, and it
will be considered. Source code will not be made
available under any circumstances, and Trumpet Software
International reserves the right not to accept any offer
which is not considered acceptable.

Trumpet Software International
GPO Box 1649,
HOBART, TAS AUSTRALIA 7001

FAX/Phone International 61-02-487049, Australia 002-
487049