1eXosip2_license(3)                libeXosip2                eXosip2_license(3)
2
3
4

NAME

6       eXosip2_license - COPYING
7
8                     GNU GENERAL PUBLIC LICENSE
9                        Version 2, June 1991
10
11        Copyright (C) 1989, 1991 Free Software Foundation, Inc.
12            59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
13        Everyone is permitted to copy and distribute verbatim copies
14        of this license document, but changing it is not allowed.
15
16                          Preamble
17
18         The licenses for most software are designed to take away your
19       freedom to share and change it.  By contrast, the GNU General Public
20       License is intended to guarantee your freedom to share and change free
21       software--to make sure the software is free for all its users.  This
22       General Public License applies to most of the Free Software
23       Foundation's software and to any other program whose authors commit to
24       using it.  (Some other Free Software Foundation software is covered by
25       the GNU Library General Public License instead.)  You can apply it to
26       your programs, too.
27
28         When we speak of free software, we are referring to freedom, not
29       price.  Our General Public Licenses are designed to make sure that you
30       have the freedom to distribute copies of free software (and charge for
31       this service if you wish), that you receive source code or can get it
32       if you want it, that you can change the software or use pieces of it
33       in new free programs; and that you know you can do these things.
34
35         To protect your rights, we need to make restrictions that forbid
36       anyone to deny you these rights or to ask you to surrender the rights.
37       These restrictions translate to certain responsibilities for you if you
38       distribute copies of the software, or if you modify it.
39
40         For example, if you distribute copies of such a program, whether
41       gratis or for a fee, you must give the recipients all the rights that
42       you have.  You must make sure that they, too, receive or can get the
43       source code.  And you must show them these terms so they know their
44       rights.
45
46         We protect your rights with two steps: (1) copyright the software, and
47       (2) offer you this license which gives you legal permission to copy,
48       distribute and/or modify the software.
49
50         Also, for each author's protection and ours, we want to make certain
51       that everyone understands that there is no warranty for this free
52       software.  If the software is modified by someone else and passed on, we
53       want its recipients to know that what they have is not the original, so
54       that any problems introduced by others will not reflect on the original
55       authors' reputations.
56
57         Finally, any free program is threatened constantly by software
58       patents.  We wish to avoid the danger that redistributors of a free
59       program will individually obtain patent licenses, in effect making the
60       program proprietary.  To prevent this, we have made it clear that any
61       patent must be licensed for everyone's free use or not licensed at all.
62
63         The precise terms and conditions for copying, distribution and
64       modification follow.
65       
66                     GNU GENERAL PUBLIC LICENSE
67          TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
68
69         0. This License applies to any program or other work which contains
70       a notice placed by the copyright holder saying it may be distributed
71       under the terms of this General Public License.  The "Program", below,
72       refers to any such program or work, and a "work based on the Program"
73       means either the Program or any derivative work under copyright law:
74       that is to say, a work containing the Program or a portion of it,
75       either verbatim or with modifications and/or translated into another
76       language.  (Hereinafter, translation is included without limitation in
77       the term "modification".)  Each licensee is addressed as "you".
78
79       Activities other than copying, distribution and modification are not
80       covered by this License; they are outside its scope.  The act of
81       running the Program is not restricted, and the output from the Program
82       is covered only if its contents constitute a work based on the
83       Program (independent of having been made by running the Program).
84       Whether that is true depends on what the Program does.
85
86         1. You may copy and distribute verbatim copies of the Program's
87       source code as you receive it, in any medium, provided that you
88       conspicuously and appropriately publish on each copy an appropriate
89       copyright notice and disclaimer of warranty; keep intact all the
90       notices that refer to this License and to the absence of any warranty;
91       and give any other recipients of the Program a copy of this License
92       along with the Program.
93
94       You may charge a fee for the physical act of transferring a copy, and
95       you may at your option offer warranty protection in exchange for a fee.
96
97         2. You may modify your copy or copies of the Program or any portion
98       of it, thus forming a work based on the Program, and copy and
99       distribute such modifications or work under the terms of Section 1
100       above, provided that you also meet all of these conditions:
101
102           a) You must cause the modified files to carry prominent notices
103           stating that you changed the files and the date of any change.
104
105           b) You must cause any work that you distribute or publish, that in
106           whole or in part contains or is derived from the Program or any
107           part thereof, to be licensed as a whole at no charge to all third
108           parties under the terms of this License.
109
110           c) If the modified program normally reads commands interactively
111           when run, you must cause it, when started running for such
112           interactive use in the most ordinary way, to print or display an
113           announcement including an appropriate copyright notice and a
114           notice that there is no warranty (or else, saying that you provide
115           a warranty) and that users may redistribute the program under
116           these conditions, and telling the user how to view a copy of this
117           License.  (Exception: if the Program itself is interactive but
118           does not normally print such an announcement, your work based on
119           the Program is not required to print an announcement.)
120       
121       These requirements apply to the modified work as a whole.  If
122       identifiable sections of that work are not derived from the Program,
123       and can be reasonably considered independent and separate works in
124       themselves, then this License, and its terms, do not apply to those
125       sections when you distribute them as separate works.  But when you
126       distribute the same sections as part of a whole which is a work based
127       on the Program, the distribution of the whole must be on the terms of
128       this License, whose permissions for other licensees extend to the
129       entire whole, and thus to each and every part regardless of who wrote it.
130
131       Thus, it is not the intent of this section to claim rights or contest
132       your rights to work written entirely by you; rather, the intent is to
133       exercise the right to control the distribution of derivative or
134       collective works based on the Program.
135
136       In addition, mere aggregation of another work not based on the Program
137       with the Program (or with a work based on the Program) on a volume of
138       a storage or distribution medium does not bring the other work under
139       the scope of this License.
140
141         3. You may copy and distribute the Program (or a work based on it,
142       under Section 2) in object code or executable form under the terms of
143       Sections 1 and 2 above provided that you also do one of the following:
144
145           a) Accompany it with the complete corresponding machine-readable
146           source code, which must be distributed under the terms of Sections
147           1 and 2 above on a medium customarily used for software interchange; or,
148
149           b) Accompany it with a written offer, valid for at least three
150           years, to give any third party, for a charge no more than your
151           cost of physically performing source distribution, a complete
152           machine-readable copy of the corresponding source code, to be
153           distributed under the terms of Sections 1 and 2 above on a medium
154           customarily used for software interchange; or,
155
156           c) Accompany it with the information you received as to the offer
157           to distribute corresponding source code.  (This alternative is
158           allowed only for noncommercial distribution and only if you
159           received the program in object code or executable form with such
160           an offer, in accord with Subsection b above.)
161
162       The source code for a work means the preferred form of the work for
163       making modifications to it.  For an executable work, complete source
164       code means all the source code for all modules it contains, plus any
165       associated interface definition files, plus the scripts used to
166       control compilation and installation of the executable.  However, as a
167       special exception, the source code distributed need not include
168       anything that is normally distributed (in either source or binary
169       form) with the major components (compiler, kernel, and so on) of the
170       operating system on which the executable runs, unless that component
171       itself accompanies the executable.
172
173       If distribution of executable or object code is made by offering
174       access to copy from a designated place, then offering equivalent
175       access to copy the source code from the same place counts as
176       distribution of the source code, even though third parties are not
177       compelled to copy the source along with the object code.
178       
179         4. You may not copy, modify, sublicense, or distribute the Program
180       except as expressly provided under this License.  Any attempt
181       otherwise to copy, modify, sublicense or distribute the Program is
182       void, and will automatically terminate your rights under this License.
183       However, parties who have received copies, or rights, from you under
184       this License will not have their licenses terminated so long as such
185       parties remain in full compliance.
186
187         5. You are not required to accept this License, since you have not
188       signed it.  However, nothing else grants you permission to modify or
189       distribute the Program or its derivative works.  These actions are
190       prohibited by law if you do not accept this License.  Therefore, by
191       modifying or distributing the Program (or any work based on the
192       Program), you indicate your acceptance of this License to do so, and
193       all its terms and conditions for copying, distributing or modifying
194       the Program or works based on it.
195
196         6. Each time you redistribute the Program (or any work based on the
197       Program), the recipient automatically receives a license from the
198       original licensor to copy, distribute or modify the Program subject to
199       these terms and conditions.  You may not impose any further
200       restrictions on the recipients' exercise of the rights granted herein.
201       You are not responsible for enforcing compliance by third parties to
202       this License.
203
204         7. If, as a consequence of a court judgment or allegation of patent
205       infringement or for any other reason (not limited to patent issues),
206       conditions are imposed on you (whether by court order, agreement or
207       otherwise) that contradict the conditions of this License, they do not
208       excuse you from the conditions of this License.  If you cannot
209       distribute so as to satisfy simultaneously your obligations under this
210       License and any other pertinent obligations, then as a consequence you
211       may not distribute the Program at all.  For example, if a patent
212       license would not permit royalty-free redistribution of the Program by
213       all those who receive copies directly or indirectly through you, then
214       the only way you could satisfy both it and this License would be to
215       refrain entirely from distribution of the Program.
216
217       If any portion of this section is held invalid or unenforceable under
218       any particular circumstance, the balance of the section is intended to
219       apply and the section as a whole is intended to apply in other
220       circumstances.
221
222       It is not the purpose of this section to induce you to infringe any
223       patents or other property right claims or to contest validity of any
224       such claims; this section has the sole purpose of protecting the
225       integrity of the free software distribution system, which is
226       implemented by public license practices.  Many people have made
227       generous contributions to the wide range of software distributed
228       through that system in reliance on consistent application of that
229       system; it is up to the author/donor to decide if he or she is willing
230       to distribute software through any other system and a licensee cannot
231       impose that choice.
232
233       This section is intended to make thoroughly clear what is believed to
234       be a consequence of the rest of this License.
235       
236         8. If the distribution and/or use of the Program is restricted in
237       certain countries either by patents or by copyrighted interfaces, the
238       original copyright holder who places the Program under this License
239       may add an explicit geographical distribution limitation excluding
240       those countries, so that distribution is permitted only in or among
241       countries not thus excluded.  In such case, this License incorporates
242       the limitation as if written in the body of this License.
243
244         9. The Free Software Foundation may publish revised and/or new versions
245       of the General Public License from time to time.  Such new versions will
246       be similar in spirit to the present version, but may differ in detail to
247       address new problems or concerns.
248
249       Each version is given a distinguishing version number.  If the Program
250       specifies a version number of this License which applies to it and "any
251       later version", you have the option of following the terms and conditions
252       either of that version or of any later version published by the Free
253       Software Foundation.  If the Program does not specify a version number of
254       this License, you may choose any version ever published by the Free Software
255       Foundation.
256
257         10. If you wish to incorporate parts of the Program into other free
258       programs whose distribution conditions are different, write to the author
259       to ask for permission.  For software which is copyrighted by the Free
260       Software Foundation, write to the Free Software Foundation; we sometimes
261       make exceptions for this.  Our decision will be guided by the two goals
262       of preserving the free status of all derivatives of our free software and
263       of promoting the sharing and reuse of software generally.
264
265                          NO WARRANTY
266
267         11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
268       FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
269       OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
270       PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
271       OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
272       MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
273       TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
274       PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
275       REPAIR OR CORRECTION.
276
277         12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
278       WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
279       REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
280       INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
281       OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
282       TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
283       YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
284       PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
285       POSSIBILITY OF SUCH DAMAGES.
286
287                      END OF TERMS AND CONDITIONS
288       
289                How to Apply These Terms to Your New Programs
290
291         If you develop a new program, and you want it to be of the greatest
292       possible use to the public, the best way to achieve this is to make it
293       free software which everyone can redistribute and change under these terms.
294
295         To do so, attach the following notices to the program.  It is safest
296       to attach them to the start of each source file to most effectively
297       convey the exclusion of warranty; and each file should have at least
298       the "copyright" line and a pointer to where the full notice is found.
299
300           <one line to give the program's name and a brief idea of what it does.>
301           Copyright (C) <year>  <name of author>
302
303           This program is free software; you can redistribute it and/or modify
304           it under the terms of the GNU General Public License as published by
305           the Free Software Foundation; either version 2 of the License, or
306           (at your option) any later version.
307
308           This program is distributed in the hope that it will be useful,
309           but WITHOUT ANY WARRANTY; without even the implied warranty of
310           MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
311           GNU General Public License for more details.
312
313           You should have received a copy of the GNU General Public License
314           along with this program; if not, write to the Free Software
315           Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
316
317
318       Also add information on how to contact you by electronic and paper mail.
319
320       If the program is interactive, make it output a short notice like this
321       when it starts in an interactive mode:
322
323           Gnomovision version 69, Copyright (C) year  name of author
324           Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
325           This is free software, and you are welcome to redistribute it
326           under certain conditions; type `show c' for details.
327
328       The hypothetical commands `show w' and `show c' should show the appropriate
329       parts of the General Public License.  Of course, the commands you use may
330       be called something other than `show w' and `show c'; they could even be
331       mouse-clicks or menu items--whatever suits your program.
332
333       You should also get your employer (if you work as a programmer) or your
334       school, if any, to sign a "copyright disclaimer" for the program, if
335       necessary.  Here is a sample; alter the names:
336
337         Yoyodyne, Inc., hereby disclaims all copyright interest in the program
338         `Gnomovision' (which makes passes at compilers) written by James Hacker.
339
340         <signature of Ty Coon>, 1 April 1989
341         Ty Coon, President of Vice
342
343       This General Public License does not permit incorporating your program into
344       proprietary programs.  If your program is a subroutine library, you may
345       consider it more useful to permit linking proprietary applications with the
346       library.  If this is what you want to do, use the GNU Library General
347       Public License instead of this License.
348
349
350       eXosip2 (5.3.0) - 2021-11-22
351            * rewrite socket error management in order to apply them to all pending ICT and NICT transactions
352              - with previous code, some transactions won't see the transport-error and will fail with unnecessary delay.
353            * add time information in cb_xixt_kill_transaction callback for debugging
354            * eXosip_lock will now include read on sockets
355            * [TLS] allow to accept wildcard with a new bit in tls_verify_client_certificate
356            * [TLS] disable loading OS certifiate with a new bit in tls_verify_client_certificate
357            * [TLS] I beleive there is no reason to cut packet in 500 bytes chunks on ios
358            * [EXOSIP_OPT_SET_CONTACT_DIALOG_EXTRA_PARAMS] new option to set Contact parameters in request/answers dialogs
359            * [AMSIP_OPTION_SET_SIP_INSTANCE] allow any value inside +sip.instance instead of only urn:uuid
360            * [epoll] fix eXosip_event_wait when using epoll implementation where events are distributed in the next eXosip_event_wait call
361
362       eXosip2 (5.2.1) - 2020-05-21
363            * [ENABLE_MAIN_SOCKET] fix epoll mechanism for server socket with TCP and TLS
364            * [crash] check scheme upon processing 3xx
365            * [ssl] fix to be compatible with libressl
366            * [ssl] https://savannah.nongnu.org/patch/?10046 compatibility with openssl below 1.1.0
367            * fix when Content-Type indicates application/sdp, but there is no body
368            * [TLS] modify the code for TLS validation in order to improve logs and details on the connection
369            * use time_t instead of int for r_retry_after_delay variable [fix 1367a34ca commited on March 1st]
370            * eXosip_default_action will return OSIP_RETRY_LIMIT when limit is reached
371            * make sure to obey the Retry-After header from REGISTER reply
372            * use newer osip_timersub MACRO
373            * [bug#60024] fix openssl usage to always use callback mode for private key password, even when missing
374            * eXosip_reset_transports was not effective any more since [5.1.2] [commit 705643fa  2020-07-07] [do not use unless you understand it]
375            * [windows] a HANDLE is leaked when loading trusted certificates
376            * dp layer: handle WSAEMSGSIZE when buffer is too short for complete incoming messag
377            * cleaner code to retreive an SDP from a SIP message
378            * fix crash when ENABLE_MAIN_SOCKET is defined and epoll is used
379
380       eXosip2 (5.2.0) - 2020-11-10
381            * fix memory and socket leak [major] [affected TCP, TLS, UDP: since 5.1.2, need update asap]
382            * fix to make sure a non yet established TLS descriptor with read descriptor set will be processed when no outgoing transaction is in a state to handle it [since 5.1.2]
383            * fix SRV rotation for TLS [was rotating TCP records instead of TLS] [since 5.1.2]
384            * fix duplicate packets for TCP and TLS when several outgoing NICT are happening at the same time [since 5.1.2]
385            * add outbound proxy parameter in sip_monitor tool
386
387            * ABI update: modification of "eXosip_tls_ctx_t"
388              extend the structure to set
389              - cipher list
390              - add TLS openssl flags (to disable TLSv1, TLSv1.1, etc...)
391              - add DTLS openssl flags (to disable DTLSv1, etc...)
392
393       eXosip2 (5.1.3) - 2020-08-25
394            * EXOSIP_OPT_FORCE_CONNECTIONREUSE; new option to force reusing established socket for ACK and dialog message
395            * tls: fix building DH parameter with 5.1.2 and openssl < 1.1.0
396
397       eXosip2 (5.1.2) - 2020-08-20
398            * tls: use RFC 5114 dh param with 2048 bits size.
399            * tls: use 2048 bits for ephemeral RSA key genearation.
400            * tls: use SSL_OP_NO_COMPRESSION to make sure it's disabled.
401            * tls: use SSL_OP_NO_TICKET to disable ticket.
402            * tls: use HIGH:!COMPLEMENTOFDEFAULT:!kRSA:!PSK:!SRP cipher list for higher security and less ciphers
403            * fix possible race condition in sample code [sip_reg and sip_monitor]
404            * new format style using clang-format.
405            * reduce and rewrite logs for readability.
406            * fix broken epoll implementation. (DO NOT USE 5.1.1 with epoll)
407            * rewrite UDP/TCP/TLS (and DTLS untested) for both select and epoll mode.
408            complete rewrite of socket (c-ares and UDP/TCP/TLS) in order to accelerate
409            socket esablishement, and correctly handle socket failure. The change also
410            help to recover faster after a socket failure and to switch to the next SRV
411            record available. This last feature was previously broken.
412
413            * Fix NAPTR/SRV on windows when CARES is not used. (not advised)
414            * ACK sent out of transaction with no existing connection may be sent later. (TCP/TLS)
415            * Upon TLS loss, try to use domain or NAPTR SNI when TLS connection is not initiated by an outgoing transaction.
416            * sip_monitor: new tool to monitor sip service
417            * add support for authentication using SHA-256 (openssl required)
418            * only use first supported proposed authentication when same realm is used
419            * fix: upon UDP errors, like ICMP buffer size may reach abnormal values (avoid useless reallocation)
420
421       eXosip2 (5.1.1) - 2020-01-16
422            * new API:
423            Generate random string: (low entropy, only hexa)
424            int eXosip_hexa_generate_random(char *val, int val_size);
425            Generate random string: (high entropy when compiled with openssl)
426            int eXosip_byte_generate_random(char *val, int val_size)
427
428            * provide more entropy with eXosip_byte_generate_random (with openssl when available).
429            * fix TLS security issue reported by Alexander Traud regarding hostname validation when using NAPTR/SRV.
430            * add support for epoll (detected by configured) // becomes the default on linux platforms with autotools
431            * fix bug #56839: The cnonce should not be static -this is identified as replay attack by some services-.
432            * fix tcp and tls connection failure detection (accelerate error detection and recovery)
433            * fix: fixed a crash with DTLS
434
435       eXosip2 (5.1.0) - 2019-03-27
436            * minor API update:
437              API parameter change: eXosip_call_build_ack/eXosip_call_send_ack API to use tid instead of did as parameter.
438
439            * new API: add an API to insert one extra header in BYE:
440              int eXosip_call_terminate_with_header(struct eXosip_t *excontext, int cid, int did, const char *header_name, const char *header_value);
441              void eXosip_dnsutils_release(struct osip_naptr *naptr_record); required after usage of eXosip_dnsutils_naptr.
442
443            * new OPTION:
444            EXOSIP_OPT_SET_SESSIONTIMERS_FORCE option to force session timer to be used when remote side does not support it.
445
446            * structure change:
447            new param in eXosip_tls_credentials_t for pinning: "public_key_pinned". A file with the expected public key of server.
448            If you use eXosip_tls_ctx_t/eXosip_tls_credentials_t/EXOSIP_OPT_SET_TLS_CERTIFICATES_INFO, you need to recompile.
449
450            * fix processing response out of transaction. (avoid incorrect logs and extra work)
451            * fix https://savannah.nongnu.org/bugs/?54628 where ACK was only retransmitted for initial outgoing INVITE.
452              fix: retransmit ACK for both initial INVITE and re-INVITE.
453              fix: retransmit ACK for 2xx from forking (with a BYE) even if call does not exist.
454              ACK for "old transaction" within the established dialog won't be retransmitted because the parameter only hold the latest ACK.
455            * fix bug report: https://savannah.nongnu.org/bugs/index.php?54624
456              another patch to fix more issue related to cseq & PRACK.
457              The newer code better handle forking use-case with PRACK.
458              The newer code better handle several 1xx from same user.
459            * fix bug report: https://savannah.nongnu.org/bugs/index.php?54624 cseq wasn't increasing after a PRACK.
460            * improve portability code, detection of headers, windows compilation detection, sockaddr_storage was not correctly defined.
461            * fix udp layer: set ipbuf before using it.
462            * fix: allow socket descriptor to be 0 (posix requirement).
463            * fix: compile with any openssl version.
464            * allow compilation with OPENSSL_NO_DH, OPENSSL_NO_RSA, OPENSSL_NO_ECDH and/or OPENSSL_NO_DEPRECATED.
465            * remove old windows specific RSA obsolete code.
466            * add in eXtl_tls.c some explanations on usage of TLS with eXosip2. READ THEM.
467            * improve reliability for naptr/srv lookup (but still a short time).
468            * fix/improve _eXosip_mark_registration_expired: it was working correctly only if registration had previously failed.
469            * fix: attach call/dialog to CANCEL transaction (so EXOSIP_CALL_MESSAGE_ANSWERED will be received instead of EXOSIP_MESSAGE_ANSWERED).
470            * windows: fix DnsQuery to use UTF8 even if compiled without UNICODE (not applicable if you use c-ares).
471            * windows: add ENUM capability and improve NAPTR/SRV record (not applicable if you use c-ares).
472            * windows: you should use c-ares AND you should compile with UNICODE. (much better).
473            * add ability to define a dnsserver when doing NAPTR and SRV record (c-ares only).
474            * format of domain string for "eXosip_dnsutils_naptr" is "domain.com!+AUS|IP_DNSSERVER".
475            * fix for on android, DNS are not available any more (restricted access) (c-ares only).
476            * add support ENUM and regex for res_query API (not applicable if you use c-ares).
477            * sync with newer osip: use newer osip_naptr & osip_srv_record structures to hold ENUM sip result and
478              improvements to retreive (and release) it via eXosip_dnsutils_naptr and eXosip_dnsutils_release APIs.
479            * TLS improvments: simplify client and server config, add ECDH cipher suite if missing,
480              password for private key is optional, add support for public key pinning.
481            * improve to report EXOSIP_CALL_NOANSWER upon transport error for INVITE for faster detection.
482            * fix possible memory leak for X509 server certificate.
483            * fix crash if dialog has been already closed between 200ok and a received BYE.
484            * improve windows pipe replacement (use a free allocated port automatically).
485            * fix to optimize detection of TCP or TLS establishement, fix to optimize sending REGISTER after establishement.
486            * patch for call transfer to keep dialog after BYE, in order to be able to handle incoming/outgoing NOTIFY within calls after BYE.
487            * handle incoming UPDATE from alternative dialogs in early dialog mode.
488            * fix to reject any NOTIFY without established dialog coming later than 64 seconds after initial SUBSCRIBE.
489            * After a NAPTR query, some DNS server returns SUCCESS without NAPTR answers. In such use-case, fallback to manual SRV records.
490            * add SOCK_CLOEXEC option to sockets // add missing SO_KEEPALIVE options on TLS socket.
491            * EXOSIP_OPT_ENABLE_IPV6 now support 0(ipv4 only), 1(ipv6 only) and 2(ipv4 OR ipv6).
492              With option 2, choice is made based on DNS and the stack can fallback between IPv4 and IPv6.
493            * fix possible memory leak when using wrong tid for eXosip_insubscription_send_answer.
494            * fix possible memory leak upon allocation error.
495            * fix leak upon syntax error in parameters provided for PUBLISH.
496            * fix leak upon syntax error in parameters provided for REGISTER.
497            * increase size of proto_ifs for IPv6 local address.
498            * RFC 2617 erratum: Errata ID: 1649 (minor issue).
499            * _exosip_isipv4addr: fix checking IPv4 address (minor issue).
500            * other minor updates.
501
502       eXosip2 (5.0.0)
503            * major API update: add a new parameter to eXosip_call_build_prack in order to create the PRACK
504            for this specific response and not for the latest.
505            * major API update: removal of eX_refer.h API. REFER are now handled with subscriptions APIs.
506            eXosip_refer_build_request removed
507            eXosip_refer_send_request removed
508            * major API update: subscription now handle both SUBSCRIBE and REFER with the same APIs:
509            eXosip_subscription_build_initial_refer ADDED
510            eXosip_subscribe_build_initial_request renamed eXosip_subscription_build_initial_subscribe
511            eXosip_subscribe_send_initial_request renamed eXosip_subscription_send_initial_request
512            eXosip_subscribe_build_refresh_request renamed eXosip_subscription_build_refresh_request
513            eXosip_subscribe_send_refresh_request renamed eXosip_subscription_send_refresh_request
514            eXosip_subscribe_remove renamed eXosip_subscription_remove
515            EXOSIP_IN_SUBSCRIPTION_* and EXOSIP_SUBSCRIPTION_* events may now relate to REFER subscription.
516            * major API change: eXosip_automatic_refresh is obsolete and has been removed.
517            only use eXosip_automatic_action instead
518            * API update:
519            eXosip_options_send_request returns a positive transaction id (tid) on success.
520            eXosip_publish returns a positive transaction id (tid) on success.
521            note: eXosip_message_send_request was already returing the transaction id (tid) on success.
522            * new API options:
523            EXOSIP_OPT_REMOVE_PREROUTESET: to keep Route Set
524            EXOSIP_OPT_SET_SIP_INSTANCE: define +sip.instance parameter in Contact headers
525            EXOSIP_OPT_ENABLE_USE_EPHEMERAL_PORT: option to use/not use ephemeral port in Contact.
526            EXOSIP_OPT_ENABLE_REUSE_TCP_PORT: option to reuse port.
527            EXOSIP_OPT_AUTO_MASQUERADE_CONTACT: option to enable automatic masquerading for Contact headers.
528            EXOSIP_OPT_UDP_LEARN_PORT: obsolete and will be removed in the future.
529            EXOSIP_OPT_SET_DEFAULT_CONTACT_DISPLAYNAME: define a display name to be added in Contact headers
530            * new API options: (high load traffic use-case: DO NOT USE FOR COMMON USAGE)
531            EXOSIP_OPT_SET_MAX_MESSAGE_TO_READ: set the number of message to read at once for each network processing.
532            EXOSIP_OPT_SET_MAX_READ_TIMEOUT: set the period in nano seconds during we read for sip message.
533            EXOSIP_OPT_GET_STATISTICS: retreive numerous statistics.
534            * rewrite/update autotools and ./configure options
535              --enable-pthread=[autodetect|force]
536                autodetect POSIX threads or force -DHAVE_PTHREAD [default=autodetect]
537              --enable-semaphore=[autodetect|semaphore|sysv]
538                select your prefered semaphore [default=autodetect].
539
540            * fix selection of Contact header for 3xx (default to a tel/sip/sips one with any transport)
541            * keep to call context enough time to handle redirection.
542            * fix race condition for processing SRV results (not likely to happen)
543            * fix bug when reading sip message longuer than 8000 over UDP and TLS.
544            * improve eXosip_add_authentication_info to avoid duplicate credentials
545            * if a SUBSCRIBE is rejected, the context will be released automatically
546            * add failover after a DNS failure.
547            * fallback to SRV even if we receive a NOTFOUND reply for NAPTR.
548            * fix route set with strict router.
549            * rename usage of -DHAVE_CARES_H into -DHAVE_ARES_H real name of header.
550            * remove warnings mainly related to socket API (getnameinfo/bind/accept/recv/connect/sendto)
551            * rewrite all loop using iterator to improve performance (useful for high load traffic)
552            * rewrite Via and Contact management: both will now contains the IP of the real network interface
553              instead of the default one.
554            * improve NAPTR failover, more reliable // add failover for 503 answer
555            * improve interval to force REGISTER refresh upon network error and failover.
556            * improve TCP socket management
557            * add a callback to simplify/optimize/accelerate usage of wakelocks in android application using exosip2.
558            * improve TLS, add TLSv1.1, TLSv1.2, disable weak cipher (FREAK) and enable ECDHE cipher.
559            * add support for SNI tls extension (openssl 1.0.2)
560            * add try/except on windows to catch possible missing qwave (windows server)
561            * implement a timeout (32 seconds) for establishing a TCP and TLS connection.
562            * if a connection is failing, report the failure asap.
563            * fix memory leak in eXosip_call_get_referto
564            * remove extra connect on socket for TCP and TLS (not allowed for tcp stream)
565            * fix to correctly discard INVITE retransmission with same branch received after original INVITE was replied
566            * add WSACleanup for each WSAStartup call (windows)
567            * do not include contact in BYE and CANCEL
568            * fix to use sips when appropriate (in Contact)
569            * fix to avoid handling negative content-length
570            * do not start naptr for incoming transactions.
571            * fix bug when rseq is empty but exist
572            * add support for QOS on windows.
573            * improve connection handling/failure detection, keep alive options, in TLS, TCP, UDP.
574            * update static IDs (cid/did/rid/pid) to use range from 0 to INT_MAX to avoid possible collision
575            * other minor updates.
576
577       eXosip2 (4.1.0)
578            * improve timer and use UPDATE if advertised, INVITE otherwise.
579            * improve PRACK support.
580            * option to disable automatic BYE answer.
581            * option to enable/disable IPv6 per eXosip_t instance.
582            * option to disable DNS cache.
583            * improve network support for several eXosip_t instance.
584              keepalive setting is per instance.
585              ipv4/ipv6 setting is per instance.
586              improve network setting to avoid conflict upon transport change.
587            * fix tcp and tls connect() for slow connection.
588            * use TCP_NODELAY on more platform.
589            * use Authorization header for 401 // simplify authentication code.
590            * minor expires for REGISTER improvments.
591            * copy call-info over SUBSCRIBE refresh.
592            * allow more TLS error if verification is disabled.
593            * fix if NO NAPTR is availble.
594            * add support for Windows Phone 8.
595            * fix to use cache for TCP and TLS.
596            * fix possible leaks on implementation errors.
597            * add TSC experimental support.
598
599       eXosip2 (4.0.0)
600            * modify configuration APIs to use eXosip_set_option
601            * fix bug: do not create new PRACK if it already exist for an answer.
602            * update to latest osip // test time compensation for android.
603            * use ephemaral port in standard TCP and TLS version.
604            * return tid number so that we can match the response event.
605            * use system independant time for osip_gettimeofday on unix platform.
606            * major API update: several "struct eXosip_t" can be
607              handled at the same time. This can be used to have several
608              transport layer running at the same time.
609            * many tiny other change.
610
611       eXosip2 (3.6.0)
612            * use optionnal c-ares DNS library for non blocking DNS access
613              as well as improvments over DNS operation such as NAPTR and
614              SRV records.
615            * again, so many minor change/fix/improvments, sorry for not
616              being able to have an history here... The git on savannah
617              will bring you all details!
618
619       eXosip2 (3.5.0)
620            * iphone with TCP/TLS background support.
621            * android support.
622            * a lot of minor change/fix/improvments, sorry for not being
623              able to have an history here...
624
625       eXosip2 (3.4.0)
626            * modification to allow using "windows certificate store" for TLS.
627            * handle keep alive for TCP/TLS.
628            * fix when receiving additionnal CRLF on reliable transport.
629            * modification to allow non-blocking socket for reliable transport. (TLS/TCP)
630            * fix tag issue with application where tag is missing.
631            * fix compilation for mingw
632            * fix Contact header in request within dialog for non-udp protocol.
633            * fix some DNS issue with vista?
634            * remove 481 auto answer for unsolicited NOTIFY.
635            * fix static id range.
636            * initial code for TCP fragmentation.
637            * osip_list prototypes and warnings fix
638            * fix transport matching for redirection using other transport than udp
639
640       eXosip2 (3.3.0)
641            * Fix when 200ok include a contact with an empty line parameter.
642            * Fix for replaces header longuer than 256 char.
643            * Fix SRV record with more than 10 answers.
644            * Sort SRV record.
645            * Option to disable NAPTR requests.
646
647       eXosip2 (3.2.0)
648            * Improve TLS support and add an API for ssl information & files.
649            * return new error code for all API.
650            * remove automatic answers to PRACK. (must be done in application now)
651            * remove automatically outgoing non established susbscriptions.
652
653       eXosip2 (3.1.0)
654            * AKA authentication.
655            * improve compliance & flexibility.
656
657       eXosip2 (3.0.4)
658            * fix building SUBSCRIBE refresh.
659            * fix compliance issue with refer-to to-tag/from-tag parameters.
660            * fix bug for retransmissions or ACK with proxy that resolve
661              to several IP.
662            * handle the "expires" parameter to update registration interval.
663            * handle the "expires" parameter to update publication interval.
664            * handle automatically publish refresh, and some error codes (423).
665
666       eXosip2 (3.0.3)
667            * Add TLS support.
668            * rewrite transport layer.
669            * add line= parameter in Contact headers for registrations.
670            * a few changes related to interop. issues.
671            * add missing *_REQUESTFAILURE events on no answer.
672            * Update registration interval when Expires header is in 200ok.
673
674       eXosip2 (3.0.2)
675            * fix call transfer issue with "Replaces" header.
676            * allow build/run eXosip in non-threaded model (without -DOSIP_MT).
677            * initial support for ucos.
678            * add support for qop authentication.
679            * remove registration context immediatly upon eXosip_register_remove.
680            * TCP: fix missing Contact in INVITE sent.
681            * TCP: fix missing "transport" in Contact for answers within dialog.
682            * TCP: fix possible race conditions.
683
684       eXosip2 (3.0.1)
685            * add Windows CE support with Visual Studio 2005
686              (WM5.0,PocketPC 2003/2005, Smartphone)
687            * Update to osip2-3.0.1
688            * Add SRV record capabilities.
689            * add new OPTIONS: do not send 101, remove pre-route set from message.
690
691       eXosip2 (2.2.3)
692            * announce NOTIFY answers to application.
693            * fix authentication bugs from previous patch.
694            * fix TCP bug
695            * fix using code 699
696
697       eXosip2 (2.2.2)
698            * new version synchronized with osip2
699            * total rewrite of eXosip.
700            *   -> new API for more flexibility
701            *   ->   media negotiation must now be handled outside of eXosip2
702
703       eXosip (0.9.1)
704            * add publish support through a nice API.
705
706       eXosip (0.9.0)
707            * improve presence support (busy, away, onthephone...).
708            * new eXosip_automatic_refresh() to refresh SUBSCRIBE and REGISTER.
709            * Fix dialog establishement when receiving NOTIFYs.
710            * This ChangeLog has not been updated seriously... Many changes
711            * have been done but they don't appear here. Sorry.
712            * status of libexosip:
713            *   call transfer : OK
714            *   redirection of calls (3XX) : OK
715            *   SUB/NOTIFY for presence : nearly OK (usable)
716            *   authenthication (REGISTER and INVITE only) : ok
717
718       eXosip (0.8.0)
719            * fix processing of 180 Ringing?
720            * fix bug when BYE is processed before a 2xx for INVITE.
721
722       eXosip (0.7.7)
723            * memory leaks.
724            * tiny bugs, code clean-up.
725
726       eXosip (0.7.6)
727            * fix bug when 1st proxy is using strict routing.
728            * support for IPv4 and IPv6.
729            * do not send 180 Ringing any more on new INVITEs.
730            * close correctly rtp streams in josua.
731            * improve the eXosip_event_wait method.
732            * performance updated on win32 for event handling.
733
734       eXosip (0.7.5)
735            * small improvements for josua.
736            * patch for IPv6 (uncomplete)
737            * patch for authentication
738            * improve configure.in file
739            * allow fancy reason phrase in SIP answer.
740            * allow to NAT traversal (firewall IP in SDP packet).
741
742       eXosip (0.7.3)
743            * warning fix.
744            * support for multiple registrations.
745            * support for authentifications for REGISTER.
746
747       eXosip (0.7.2)
748            * add RTP support with common ucl library.
749            * fix some memory leak.
750            * improve facility to change the local_sdp_port.
751            * add an event when ACK for 2xx is received.
752
753       eXosip (0.7.1)
754            * rewrite of header files and new directory architecture.
755            * support for INFO and OPTIONS within calls.
756            * support for AUDIO.
757
758       eXosip (0.6.3)
759            * use of event oriented interface in josua.
760
761       eXosip (0.6.2)
762            * New Event oriented interface with applications.
763            * support for both MSN or compliant UAs.
764            * SUBSCRIBE/NOTIFY for SIMPLE support.
765            * script for adding/updating subscribers. (eXosip_addsubscriber.sh)
766
767       eXosip (0.6.1)
768            * INVITE, CANCEL, BYE, REGISTER, MESSAGE, REFER
769            * script for adding/updating contact. (eXosip_addfreind.sh)
770            * script for adding/updating identity. (eXosip_addidentity.sh)
771            * NCURSES interface.
772            * options for current session.
773
774Version 5.3.0                   Thu May 18 2023             eXosip2_license(3)
Impressum