| 1 |
/===================================================================\ |
| 2 |
|| || |
| 3 |
|| Simple Sockets Library Differences Document || |
| 4 |
|| Charles E. Campbell, Jr., PhD. || |
| 5 |
|| || |
| 6 |
|| HISTORY || |
| 7 |
|| || |
| 8 |
\===================================================================/ |
| 9 |
|
| 10 |
Version 7c: *** RELEASED *** Aug 22, 2005 |
| 11 |
a. (Marcel Satchel) improved <Sinit.c> for Windows |
| 12 |
b. (Aug 22, 2005) included the "b" option for Sopen() |
| 13 |
(block until requested server becomes available) |
| 14 |
c. (Marcel Satchel) Sinit.c fixed (yet again!) |
| 15 |
Version 6: *** RELEASED *** Mar 24, 2005 |
| 16 |
a. (Jul 16, 2004) Neeme Tingas suggested that several int declarations be changed |
| 17 |
to socklen_t for Gnu CC. I'm currently using __gnu_linux__ |
| 18 |
to test for using socklen_t instead of int. He also suggested |
| 19 |
using one int for sigio_handler in EXAMPLES/sktsig.c. IMHO, the |
| 20 |
signal() interface seems to be one where lots of different systems |
| 21 |
use different calling standards and their compilers are quite vigilant |
| 22 |
about complaining about other styles. |
| 23 |
b. (Mar 24, 2005) Blocking client opens (Sopen(servername,"b")) has been |
| 24 |
implemented. Clients can now request a block until the requested server |
| 25 |
registers itself with the PortMaster. |
| 26 |
|
| 27 |
Version 5: *** RELEASED *** May 24, 2004 |
| 28 |
a. Now supports cygwin. Note that some of the EXAMPLES programs will |
| 29 |
not compile under cygwin because it doesn't support sigcontext (yet): |
| 30 |
oobsend and sktsig. Thanks go to Frank Myers for this port! |
| 31 |
|
| 32 |
Version 4: *** RELEASED *** Apr 22, 2004 |
| 33 |
a. (thank you, Martin Wood!) prototype and declaration for sprt() changed |
| 34 |
to char *sprt(const char *). |
| 35 |
b. (thank you, Martin Wood!) Changed __linux to __linux__ in <setproto.h> |
| 36 |
to keep it consistent with <xtdio.h> |
| 37 |
c. (thank you, Martin Wood!) Changed inclusion of <strings.h> to <string.h> |
| 38 |
for Linux |
| 39 |
|
| 40 |
Version 3: *** RELEASED *** Apr 02, 2004 |
| 41 |
a. Cosmetic changes, extra initialization of pointers to NULL, |
| 42 |
to skdbg.c and Spm.c |
| 43 |
b. Mac OS-X supported (#ifdef MACOS_X...) You may need to put in a |
| 44 |
into <sockets.h> to get it to compile properly. Thanks to |
| 45 |
Paul Bourne for sharing this! |
| 46 |
|
| 47 |
Version 2.11a: *** RELEASED *** March 6, 2001 |
| 48 |
a. Steve Richards has ported the Simple Sockets Library to OS/2 |
| 49 |
and has given permission to distribute his changes. |
| 50 |
b. sktdbg's put command enhanced to understand \a is ctrl-a, |
| 51 |
\b is ctrl-b, ... \z is ctrl-z. |
| 52 |
|
| 53 |
Version 2.10: *** RELEASED *** Feb 28, 2001 |
| 54 |
a. Included Microsoft Developer Studio mods - thanks to David Dowd! |
| 55 |
b. Fixed Speername(), including peername and peeraddr commands in sktdbg |
| 56 |
c. Made ...->skt= NULL; be ...->skt= 0; because some compilers |
| 57 |
were complaining about making an integer from a pointer without a |
| 58 |
cast. |
| 59 |
d. talkclient.c had an uninitialized pointer that caused core dumps |
| 60 |
under Linux. Fixed! |
| 61 |
e. Servers named "$####" will attempt to use port #### (where # is |
| 62 |
a number from [0-9]). Note that ports 0-1023 are typically reserved. |
| 63 |
f. Moved "xtdio.h" to after the extern "C" in <sockets.h> |
| 64 |
(thanks to Ralf Moeller) |
| 65 |
g. Steve Richards has kindly ported the Simple Sockets Library to the |
| 66 |
AS/400 and has given permission to distribute his changes. |
| 67 |
|
| 68 |
Version 2.09: |
| 69 |
a. Includes two new examples: <talksrvr.c> and <talkclient.c> |
| 70 |
b. Sinit() refused to compile under Unix (its really for BillG's o/ses); |
| 71 |
now fixed. |
| 72 |
c. Spm now releases controlling terminal under Unix by itself (ie. nohup |
| 73 |
is no longer needed) (ie. uses setsid()). |
| 74 |
d. Spm now runs as a "task" under Windoze; ie. if Spm.exe is put into |
| 75 |
c:\Windows\Start Menu\Programs\StartUp |
| 76 |
it will run quietly (no window, no ctrl-c to close). |
| 77 |
e. Speername() and Speeraddr() passed the wrong length to the |
| 78 |
gethostbyaddr() and getpeername() functions; fixed! |
| 79 |
f. Sopen/Sclose will now accept NULL or "" for a sktname; in such a |
| 80 |
case, the user *must* specify the port number (ie. "s12345" or |
| 81 |
"c12345"). In such a case, the PortMaster is bypassed. Facilitates |
| 82 |
use with some firewalls. |
| 83 |
g. Dr Jon Christopher found a bug and provided a fix to <Speername.c> |
| 84 |
|
| 85 |
|
| 86 |
Version 2.08: *** RELEASED *** March 30, 1998 |
| 87 |
1. Sopen_server now sets up sin.sin_port with htons() rather than htonl() |
| 88 |
2. Sopen_server's gethostname call now checked for error (has never happened |
| 89 |
before, but you never know!) |
| 90 |
3. Changes were made to <xtdio.h> and <sockets.h> to support Linux. Thanks |
| 91 |
go to Gary Johnson ([email protected]). |
| 92 |
4. ***BIG CHANGE***: Starting with v2.08, the Simple Socket Library's |
| 93 |
PortMaster is now registered with IANA. However, its former port |
| 94 |
was already assigned by IANA elsewhere, so the PortMaster now has a new |
| 95 |
port number, 1750. This means that your current SSL-using s/w needs to |
| 96 |
be recompiled as it won't be able to contact the new PortMaster with its |
| 97 |
new port number. |
| 98 |
|
| 99 |
Web users, check out http://www.iana.org/iana/ |
| 100 |
Ftp users, check out ftp://ftp.isi.edu/in-notes/iana/assignments/ |
| 101 |
|
| 102 |
5. Modest changes made to the PortMaster's startup banner and |
| 103 |
stdio/stderr/stdout closing. |
| 104 |
6. freeSocket() now also nulls out the Socket's contents. This function |
| 105 |
is implicitly called by using Sclose(). |
| 106 |
7. Two new functions: Smaskisset(Socket *skt) and Smaskfdisset(int fd). |
| 107 |
These two functions are faster than using Smasktest() after a |
| 108 |
Smaskwait(). A supporting new command, "isset", is in sktdbg, |
| 109 |
and supporting changes were made to <sockets.tex>, the manual. |
| 110 |
8. spmtable issues warnings instead of errors on PortMaster problems, |
| 111 |
thereby allowing it to continue through a list of portmasters. |
| 112 |
9. PortMasters will now include the host of servers "sharing" another machine's |
| 113 |
PortMaster for PM_TABLE requests. Translated: spmtable will now show what |
| 114 |
machine a server is actually on if not the PortMaster's own host. |
| 115 |
10. ERROR -> XTDIO_ERROR, etc -- too many folks are using ERROR, WARNING, etc, |
| 116 |
and so this fixes that problem. |
| 117 |
11. Srmsrvr now uses PMSHARE if no hostname was specified; this improvement also |
| 118 |
affects the srmsrvr program. |
| 119 |
12. Sopen_client now attempts hostname first; if no success and PM_SHARE is defined, |
| 120 |
try Sopen_client to PM_SHARE's PortMaster. |
| 121 |
|
| 122 |
Version 2.07: |
| 123 |
1. Porting hint #5 was added to <DOC/porting.doc> |
| 124 |
2. The <xtdio.h> file was modified with a comment (concerning #define const) |
| 125 |
supporting porting hint #5 (see <sockets.tex>). |
| 126 |
3. To the signal() calls in <oobsend.c> and <oobrecv.c>, I included (void *) |
| 127 |
casts to the second argument (the name of the function to be called in |
| 128 |
the event of receipt of a signal). |
| 129 |
4. Modified Makefiles so that ${...} -> $(...), because some Suns had |
| 130 |
problems with expanding the ${...} form (wierd!). |
| 131 |
5. Improved <sockets.tex> documentation for VMS -- included notes on how to |
| 132 |
use VMS's DCL to allow for command line arguments. |
| 133 |
6. <cprt.c> now #includes <xtdio.h>, which provides prototyping. |
| 134 |
7. New functions: Speername() returns a string giving the peer's name |
| 135 |
Speeraddr() returns the internet address of the peer |
| 136 |
8. PortMaster now uses SO_REUSEADDR -- it doesn't seem necessary, as the |
| 137 |
PortMaster is very stable in operation, but I decided to do so for |
| 138 |
Murphy's Law handling. Any comments on this choice one way or the other |
| 139 |
are welcome! |
| 140 |
9. Sopen has been extended - it now will handle user-specified ports in |
| 141 |
addition to dynamic port binding, for both servers and clients. Check |
| 142 |
out Sopen()'s "mode" in the manual. |
| 143 |
|
| 144 |
--------------------------------------------------------------------- |
| 145 |
|
| 146 |
Version 2.06: |
| 147 |
1. spmtable improved so that it will not hang on non-responding |
| 148 |
PortMaster (and will give messages). |
| 149 |
2. Sopen_clientport had unnecessary copying removed: hostenstruct= *hostentptr; |
| 150 |
|
| 151 |
--------------------------------------------------------------------- |
| 152 |
|
| 153 |
Version 2.05: |
| 154 |
1. Sopen/SSLNEEDTOSHAREPM problem fixed: PCs should now be able to |
| 155 |
share other's PortMasters to instantiate servers. |
| 156 |
2. Fixed documentation on the PortMaster; its been using port 1541 |
| 157 |
for quite awhile now (it was changed from 1540 due to a problem |
| 158 |
with Suns in Version 2.01). |
| 159 |
3. Added shutdown() before close() to Sclose, Sopen (error handling), and |
| 160 |
Spm. |
| 161 |
|
| 162 |
--------------------------------------------------------------------- |
| 163 |
|
| 164 |
Version 2.04: |
| 165 |
1. spmchk.c now returns (0 usually, 1 for vms) or 2 -- facilitated |
| 166 |
vms usage |
| 167 |
2. If Sopenv's env_var is NULL or a null string (ie. ""), it will |
| 168 |
use SKTPATH for its socket path environment variable. |
| 169 |
|
| 170 |
--------------------------------------------------------------------- |
| 171 |
|
| 172 |
Version 2.03: |
| 173 |
|
| 174 |
1. sockets.h and Sopen now use the SSLNOSETSOCKOPT to specify which |
| 175 |
tcp/ip implementations do not support the setsockopt() call |
| 176 |
(currently, that's msdos and aix). |
| 177 |
|
| 178 |
2. OSF support tentatively added |
| 179 |
|
| 180 |
3. smsrvr.c and smclient.c examples added to the distribution |
| 181 |
|
| 182 |
--------------------------------------------------------------------- |
| 183 |
|
| 184 |
Version 2.02: |
| 185 |
|
| 186 |
1. The sockets.tex had Smaskwait calling syntax wrong: |
| 187 |
wrong : Smaskwait(Socket *) |
| 188 |
- instead of - |
| 189 |
correct : Smaskwait() |
| 190 |
The sockets.tex file has been corrected. |
| 191 |
|
| 192 |
2. The sockets.h file was improved so that Suns which have Standard C |
| 193 |
compilers will use <stdarg.h> instead of <varargs.h>. |
| 194 |
|
| 195 |
3. Marty Olevitch donated spmchk.c (he placed it into the public domain) |
| 196 |
and is included and documented in this distribution. |
| 197 |
|
| 198 |
4. Included out-of-band data handling example (both send and receive |
| 199 |
programs). |
| 200 |
|
| 201 |
5. Sread, Sreadbytes, Swrite, and Speek: now take void *buf instead of |
| 202 |
char * buf. This change should not affect any prior uses but allows |
| 203 |
SSL programmers to use fewer casts when dealing with these functions. |
| 204 |
|
| 205 |
6. Smasktest used to change the Smasktime information (to 0sec 0usec). |
| 206 |
Smasktest now saves the current time data, does its thing, and then |
| 207 |
restores the timeout info. |
| 208 |
|
| 209 |
7. Added cprt() to the library; its like sprt(), but for single characters. |
| 210 |
|
| 211 |
8. Used cprt() with the read command in sktdbg to make all characters read |
| 212 |
visible (and not depend on a null byte which may not be there). |
| 213 |
|
| 214 |
9. Thanks to R. Day, SCO and Solaris Unix support has been added (options |
| 215 |
to <sockets.h> and <xtdio.h>). |
| 216 |
|
| 217 |
10. The RDCOLOR environment variable is now used (instead of COLOR) to |
| 218 |
indicate what directory the <rdcolor.dat> file resides in. The |
| 219 |
documentation in <sockets.tex> has been changed to reflect this. |
| 220 |
|
| 221 |
--------------------------------------------------------------------- |
| 222 |
|
| 223 |
Version 2.01: |
| 224 |
|
| 225 |
1. Stimeoutwait : now takes three arguments: |
| 226 |
|
| 227 |
int Stimeoutwait(Socket *skt,long seconds,long useconds) |
| 228 |
|
| 229 |
instead of two (useconds was added in). This change impacted: |
| 230 |
Sclose Sopen Srmsrvr Stimeoutwait |
| 231 |
Portmaster (Spm) sktdbg |
| 232 |
|
| 233 |
2. Sgets : bug in high data transfer rate fixed. I've now transferred |
| 234 |
literally thousands of images (from a capacitance-based "camera") with |
| 235 |
no problems. |
| 236 |
|
| 237 |
3. PortMaster (Spm): firewall (security) support |
| 238 |
More resistance to crashing, two ways: first, more Stest()s, and |
| 239 |
second, the Stest function itself (see #9) has improved. |
| 240 |
|
| 241 |
4. Document: more examples, firewall discussion, and blather |
| 242 |
|
| 243 |
5. Sopen: opens with TCP_NODELAY for the machines which support it -- |
| 244 |
this setting helps small packets get across the Net faster at the price |
| 245 |
of net efficiency (default behavior: tcp/ip bundles small packets together |
| 246 |
within some time interval). |
| 247 |
|
| 248 |
6. AIX (IBM's risc machine) is now supported via <sockets.h> |
| 249 |
|
| 250 |
7. sktdbg: |
| 251 |
|
| 252 |
a) has an enhanced prompt: |
| 253 |
( 0 bytes) Enter: |
| 254 |
It now tells you how many bytes were awaiting processing when the prompt |
| 255 |
was issued (ie. it uses Stest()). |
| 256 |
|
| 257 |
b) fwinit command: tells the PortMaster to re-initialize its firewall list. |
| 258 |
Good for whoever owns the firewall list to update it and then to |
| 259 |
tell the PortMaster to re-read it. |
| 260 |
|
| 261 |
c) a "close" bug was stomped on |
| 262 |
|
| 263 |
8. Smaskwait : I'm not sure about the old release (Version 1.0) , so some of |
| 264 |
these functions may be new: Smaskfdset Smaskunfdset Smaskpush Smaskpop |
| 265 |
|
| 266 |
9. Stest Speek: used to have problems with a killed socket. These functions |
| 267 |
now detect dead sockets (ie. return a -1). |
| 268 |
|
| 269 |
10. The Sun Sparcstation operating system seems to use port 1540 for its own |
| 270 |
purposes, so the PortMaster's port was changed to be 1541 instead of |
| 271 |
1540. The new port assignment works on all the other machines in the |
| 272 |
test group (SGI Personal Iris, SGI Extreme, Sun 3, Sun Sparcstation, |
| 273 |
IBM/AIX, DecStation/Ultrix, IBM-PC/MSDOS, DEC/VMS). |
| 274 |
|
| 275 |
--------------------------------------------------------------------- |
| 276 |
|
| 277 |
Version 1.0: This was the original (and lacked a version number, sigh...) |
| 278 |
|
| 279 |
--------------------------------------------------------------------- |