Debian Codegraph @

COSMIC/DOC/History

raw
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 ---------------------------------------------------------------------