1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- This document was generated using DocBuilder 3.3.3 -->
<HTML>
<HEAD>
<TITLE>Erl_Interface Release Notes History</TITLE>
<SCRIPT type="text/javascript" src="../../../../doc/erlresolvelinks.js">
</SCRIPT>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#FF00FF"
ALINK="#FF0000">
<CENTER>
<A HREF="http://www.erlang.se"><IMG BORDER=0 ALT="[Ericsson AB]" SRC="min_head.gif"></A>
</CENTER>
<A NAME="1"><!-- Empty --></A>
<H2>1 Erl_Interface Release Notes History</H2>
<A NAME="1.1"><!-- Empty --></A>
<H3>1.1 Erl_Interface 3.4</H3>
<A NAME="1.1.1"><!-- Empty --></A>
<H4>1.1.1 Fixed Bugs and Malfunctions</H4>
<P>
<UL>
<LI>
<CODE>erl_print_term()</CODE> and <CODE>erl_copy_term()</CODE> could not
previously handle uints. This bug has now been fixed.<BR>
Own Id: OTP-4061 Aux Id: seq7079<BR>
</LI>
<LI>
<CODE>ei_x_format()</CODE> was not working correctly for floating
point arguments on some platforms. This is now corrected.
<BR>
Own Id: OTP-4379<BR>
</LI>
<LI>
<CODE>erl_compare_ext()</CODE> did not compare the node parts of
pids, ports, and references. This has now been fixed.
Comparison between two pids, ports, or references does now
conform to the Erlang specification.<BR>
Own Id: OTP-4512 Aux Id: OTP-4511<BR>
</LI>
</UL>
<A NAME="1.1.2"><!-- Empty --></A>
<H4>1.1.2 Improvements and New Features</H4>
<P>
<UL>
<LI>
Erl_Interface and EI now supports 64 bit architectures.
<BR>
Own Id: OTP-4772<BR>
</LI>
<LI>
There are new functions that support the GCC and Visual
C++ 64 bit extended integer types.<BR>
<PRE>
int ei_decode_longlong(const char *buf, int *index, EI_LONGLONG *p);
int ei_decode_ulonglong(const char *buf, int *index, EI_ULONGLONG *p);
int ei_encode_longlong(char *buf, int *index, EI_LONGLONG p);
int ei_encode_ulonglong(char *buf, int *index, EI_ULONGLONG p);
int ei_x_encode_longlong(ei_x_buff* x, EI_LONGLONG n);
int ei_x_encode_ulonglong(ei_x_buff* x, EI_ULONGLONG n);
</PRE>
Own Id: OTP-4772<BR>
</LI>
<LI>
If you compile the library from source you can use the ei
library together with GMP, the GNU multi precision
library, to convert integers larger than 64 bits from and
to the external format.<BR>
<PRE>
int ei_decode_bignum(const char *buf, int *index, mpz_t obj);
int ei_encode_bignum(char *buf, int *index, mpz_t obj);
int ei_x_encode_bignum(ei_x_buff *x, mpz_t obj);
</PRE>
Own Id: OTP-4772<BR>
</LI>
<LI>
Some general code improvements where done like correcting
buffer sizes, added more error checking etc.<BR>
Own Id: OTP-4772<BR>
</LI>
<LI>
In order to conform to the Erlang specification,
comparison between two pids was changed in the R9B
release. This change did however break a deadlock
prevention algorithm used by Mnesia during release
upgrade. Therefore, comparison between two pids has been
changed back so that R9B nodes are compatible with Erlang
nodes running pre-R9 releases.<BR>
Pre-R9 comparison between two pids which now is used
again: If t1 and t2 are both pids, t1 will precede t2 if
and only if either<BR>
<UL>
<LI>
the node local id of t1 precedes the node local id
of t2, or
</LI>
<LI>
the node local ids of t1 and t2 are equal, and
node(t1) precedes node(t2), or
</LI>
<LI>
the node local ids of t1 and t2 are equal, and also
node(t1) and node(t2) are equal, and node(t1) was
created before node(t2).
</LI>
</UL>
The node local id consist of two integers; serial which
is most significant, and number.<BR>
The Erlang specification states: If t1 and t2 are both
refs, both PIDs, or both ports, then t1 precedes t2 if
and only if either<BR>
<UL>
<LI>
node(t1) precedes node(t2), or
</LI>
<LI>
node(t1) equals node(t2) and t1 was created before
t2.
</LI>
</UL>
Note that comparisons between two refs, or two ports will
still conform to the Erlang specification.<BR>
*** POTENTIAL INCOMPATIBILITY ***<BR>
Own Id: OTP-4715 Aux Id: OTP-4511, OTP-4512<BR>
</LI>
</UL>
<A NAME="1.2"><!-- Empty --></A>
<H3>1.2 ErlInterface 3.3</H3>
<A NAME="1.2.1"><!-- Empty --></A>
<H4>1.2.1 Improvements and New Features</H4>
<P>
<UL>
<LI>
Erl_Interface has been rewritten extensively. The library
<CODE>ei</CODE> is now documented and supported. The old
<CODE>erl_interface</CODE> is considered obsolete, and provided
only for backward compatibility.<BR>
</LI>
<LI>
Erl_Interface is now thread-safe, and multiple C-nodes may
run from the same process.<BR>
</LI>
<LI>
New functions are added for connecting and accepting
connections from <CODE>ei</CODE>; these are documented in
<CODE>ei_connect</CODE>.<BR>
</LI>
<LI>
New functions are added for converting to and from Erlang
binary format; these are documented in <CODE>ei</CODE>.<BR>
</LI>
</UL>
<A NAME="1.3"><!-- Empty --></A>
<H3>1.3 Erl_Interface 3.2.9</H3>
<A NAME="1.3.1"><!-- Empty --></A>
<H4>1.3.1 Fixed Bugs and Malfunctions</H4>
<P>
<UL>
<LI>
Changed back the return values from <CODE>erl_send()</CODE> and
<CODE>erl_reg_send()</CODE> to 1 (as they used to be).
Incompatible with plain R7, compatible with previous
versions.<BR>
*** INCOMPATIBILITY with R7B ***<BR>
Own Id: OTP-3772<BR>
</LI>
<LI>
A race-condition bug in the term allocation routines was
corrected.<BR>
Own Id: OTP-3809<BR>
</LI>
<LI>
Erl_Interface could not be linked with pthreads.<BR>
Own Id: OTP-3810 Aux Id: Seq 5032<BR>
</LI>
<LI>
The TCB of VxWorks processes no longer grows when
<CODE>erl_errno</CODE> is accessed. On Pthreads plattforms
the use of <CODE>erl_errno</CODE> no longer crashes programs
using multithreading.<BR>
Own Id: OTP-3820<BR>
</LI>
<LI>
Name clashes between Erlang emulator and Erl_Interface
on VxWorks removed.<BR>
Own Id: OTP-3824<BR>
</LI>
</UL>
<A NAME="1.4"><!-- Empty --></A>
<H3>1.4 Erl_Interface 3.2.3</H3>
<A NAME="1.4.1"><!-- Empty --></A>
<H4>1.4.1 Fixed Bugs and Malfunctions</H4>
<P>
<UL>
<LI>
Memory lossage affecting pids, ports and refs fixed.<BR>
</LI>
</UL>
<A NAME="1.5"><!-- Empty --></A>
<H3>1.5 Erl_Interface 3.2.2</H3>
<A NAME="1.5.1"><!-- Empty --></A>
<H4>1.5.1 Improvements and New Features</H4>
<P>
<UL>
<LI>
An error reporting facility <CODE>erl_errno</CODE> has been
introduced.<BR>
Own Id: OTP-3641<BR>
</LI>
<LI>
ETERMs are now shrunk to a more reasonable size.<BR>
Own Id: OTP-3648<BR>
<BR>
</LI>
</UL>
<A NAME="1.6"><!-- Empty --></A>
<H3>1.6 Erl_Interface 3.2.1</H3>
<A NAME="1.6.1"><!-- Empty --></A>
<H4>1.6.1 Fixed Errors and Malfunctions</H4>
<P>
<UL>
<LI>
Lists containing negative numbers were incorrectly
encoded by <CODE>erl_encode()</CODE>. This has been corrected.
<BR>
Own Id: OTP-3535<BR>
</LI>
</UL>
<A NAME="1.7"><!-- Empty --></A>
<H3>1.7 Erl_Interface 3.2</H3>
<A NAME="1.7.1"><!-- Empty --></A>
<H4>1.7.1 Improvements and New Features</H4>
<P>
<UL>
<LI>
The reference type has been extended from 18 bits to
82 bits. For compatibility with older nodes, an R6 node
can send a ref to an older node; if the older node sends
it back, it has lost all but its 18 least significant
bits, but still compares equal to the original ref.
The external format has been extended to represent the new
longer refs; that means for example that binaries with
refs, produced on an R6 node, cannot be converted to a
term on an older node.
In <CODE>erl_interface</CODE>, a function <CODE>erl_mk_long_ref</CODE>
has been added, and macros <CODE>ERL_REF_NUMBERS</CODE> and
<CODE>ERL_REF_LEN</CODE>.<BR>
*** POTENTIAL INCOMPATIBILITY ***<BR>
Own Id: OTP-3140 Aux Id: OTP-3139<BR>
</LI>
<LI>
The function <CODE>erl_receive_msg</CODE> has the problem that
a fixed buffer must be given - a larger message than
expected is simply discarded. A function
<CODE>erl_xreceive_msg</CODE> has been introduced, which
dynamically resizes the buffer given to it, if needed.<BR>
Own Id: OTP-3313 Aux Id: OTP-2927<BR>
</LI>
</UL>
<A NAME="1.8"><!-- Empty --></A>
<H3>1.8 Erl_Interface 3.1.1</H3>
<A NAME="1.8.1"><!-- Empty --></A>
<H4>1.8.1 Improvements and New Features</H4>
<P>
<UL>
<LI>
<CODE>#ifdef __cplusplus extern C {</CODE> is added to all the
<CODE>erl*.h</CODE> and <CODE>ei*.h</CODE> files in order to support
use from C++.<BR>
On Unix the object files are now produced with
the <CODE>-fPIC</CODE> option to make it possible to include
them in a shared library.<BR>
Own Id: OTP-3138 Aux Id: Seq 1722<BR>
</LI>
</UL>
<A NAME="1.9"><!-- Empty --></A>
<H3>1.9 Erl_Interface 3.1</H3>
<A NAME="1.9.1"><!-- Empty --></A>
<H4>1.9.1 Fixed Bugs and Malfunctions</H4>
<P>
<UL>
<LI>
A buffer overflow in <CODE>erl_connect()</CODE> was causing
C-node crashes on Linux.<BR>
Own Id: OTP-2743<BR>
</LI>
<LI>
When decoding very long strings (more than 65535
characters) the terminating 0 was left out.<BR>
Own Id: OTP-2744<BR>
</LI>
<LI>
<CODE>erl_accept()</CODE> was not handshaking properly with
Erlang, causing incoming connection attempts to fail.<BR>
Own Id: OTP-2862<BR>
</LI>
<LI>
Very large negative numbers are no longer encoded
incorrectly.<BR>
Own Id: OTP-2897<BR>
</LI>
<LI>
Atoms could sometimes contain an unterminated string.
This is fixed.<BR>
Own Id: OTP-2956<BR>
</LI>
<LI>
Erl_Interface now uses the SENS resolver functions if
they are available at runtime. This primarily concerns
use on the VxWorks platform.<BR>
Own Id: OTP-3034 Aux Id: Seq 1559<BR>
</LI>
<LI>
The documentation for <CODE>erl_connect_init()</CODE> no longer
makes erroneous reference to the remote node.<BR>
Own Id: OTP-3102 Aux Id: Seq 1671<BR>
</LI>
</UL>
<A NAME="1.9.2"><!-- Empty --></A>
<H4>1.9.2 Improvements and New Features</H4>
<P>
<UL>
<LI>
Erl_Interface has been moved out of the Erlang runtime
system (ERTS) and is now a separate application. This has
implications for all users of Erl_Interface, who will
need to make changes to the Makefiles used to build
applications based on Erl_Interface. In particular,
header and library files are no longer in
<CODE>$(OTPROOT)/usr/</CODE>. The <CODE>include</CODE> and <CODE>lib</CODE>
directories are now located in the directory
<CODE>$(OTPROOT)/lib/erl_interface-3.1</CODE> (i.e.
the directory name is now version specific).<BR>
Own Id: OTP-3082<BR>
</LI>
</UL>
<CENTER>
<HR>
<SMALL>
Copyright © 1991-2006
<A HREF="http://www.erlang.se">Ericsson AB</A><BR>
</SMALL>
</CENTER>
</BODY>
</HTML>
|
