1eXosip2_license(3) libeXosip2 eXosip2_license(3)
2
3
4
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)