ChangeLog 19.4 KB
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
				
				JRTPLIB ChangeLog
				-----------------
 3.11.2 (April 2020):
 	* Taking EINTR in nanosleep, poll and select calls into account.
	  Thanks to Filippo Guerzoni (filippo.guerzoni@gmail.com) for bringing
	  this to my attention.
	* Disabled some copy constructors
	* Bugfix in RTPExternalTransmitter: a buffer could fill up causing the
	  an operation to fail to get aborted
	* Added constructor to RTPRawPacket to guess RTP/RTCP type
	* Bugfixed regarding some calles being cut short due to an EINTR

 3.11.1 (March 2017)
 	* Bugfix in rtpsources.cpp: if the RTP packet got deleted in
	  OnValidatedRTPPacket, then an illegal address would be accessed
	  when looking up the CSRC identifiers. Thanks to Lau Bakman for
	  reporting this.

 3.11.0 (March 2017)
	* In the RTPSession class, thread safety can be requested even
	  if the poll thread is not used.
	* Moved the 'abort decriptor' stuff into a separate class and 
	  made it possible for the UDPv4 transmitter to use a pre-created 
	  instance. In turn this allows a single poll thread to be set up
	  for multiple RTPSession instances. Example8 illustrates this.
	* Made an abstraction RTPSelect for the 'select' call. This can
	  use 'poll' or 'WSAPoll' depending on the availabity, which can
	  allow better scaling for a use case such as example8.
	* Added RTPRandom::CreateDefaultRandomNumberGenerator to create
	  the default random number engine for the platform in use.
	* When using gcc, warnings will be treated as error by default
	  (this can be disabled in the cmake options)
	* Added a transmission component that allows packets to be sent
	  and received over TCP.

 3.10.0 (December 2016)
	* Support for MingW compilation was added
	* Outgoing data or incoming data can be intercepted and changed
	  (useful for encryption)
	* SRTP support (using libsrtp) through the RTPSecureSession class.
	  Thanks to Vladimir V. Pavluk (vladvic_r@mail.ru) and to
	  Alexey Obergan (alex.obergan@gmail.com) for providing very helpful 
	  code.
	* RTP packets can now be processed in RTPSession's
	  OnValidatedRTPPacket virtual function.
	* Various virtual function were added to the RTPSession class to
	  get immediate notification of RTCP sender reports, receiver
	  reports, SDES data.
	* Support for RTP and RTCP multiplexing over the same port, for the
	  UDPv4 transmitter.
	* Added a member function to RTPSession to send raw data, i.e. to
	  send data directly over the RTP or RTCP channel of the transmitter.
	* Added a member function to RTPSession by which you can retrieve the
	  next RTP sequence number.
	* Specifying port 0 for the UDPv4 transmitter chooses a port pair
	  by itself.
	* The UDPv4 transmitter can be initialized using pre-created RTP
	  and RTCP sockets.
	* Modified RTPTime class to use an internal representation of a
	  double precision floating point number. Also using clock_gettime
	  if available instead of gettimeofday, to obtain times that are
	  not affected by clock adjustments.

 3.9.2 (December 2016)
 	* Major bugfix: zero length UDP packets should no longer block
	  the reception of packets.
	* Various compiler warnings were fixed. Thanks to Ruotger Skupin
	  (roddi@me.com) for supplying the patch.

 3.9.1 (November 2011)
 	* Fixed a bug in the CMake configuration: was unable to handle
	  path names with spaces.
	* Fixed bug in rtcpsdespacket.h: end namespace curly bracket
	  was in wrong place.
	* In an MS-Windows environment you can now choose to build a
	  DLL instead of a static library.

 3.9.0 (July 2011)
	* Switched to CMake build system.
	* Added the RTPByteAddress class, which can be used to describe
	  a host/port combination in a very general way.
	* Added the RTPExternalTransmitter class which can be used if
	  one would like to use a transmission mechanism other than
	  the UDP based transmitters.
	* Placed everything in namespace 'jrtplib'.

 3.8.2 (February 2011)
 	* Fixed bug in RTPRandomRand48. The uint16_t version used a
	  & 0xff instead of & 0xffff. Thanks to Alexey Kumkov
	  (crazykum@ukr.net) for bringing this to my attention.

 3.8.1 (October 2010)
 	* Initialization of the RTPRandomRandS class didn't work as
	  intended, causing the fall-back class RTPRandomRand48 always
	  being used on the Win32 platform.

 3.8.0 (September 2010)
 	* Fixed bug in RTPSources implementation. An incorrect 
	  'GotoNextElement' call was replaced by a 'GotoPreviousElement'
	  call.
	* Added functionality to send unknown RTCP packets. Patch
	  was supplied by Tom Harper (d.thomas.harper@gmail.com)
	* Fixed bug in INF_GetEstimatedTimestampUnit (possibility of
	  division by zero). Thanks to Gilson Yi (gilson.yi@gmail.com)
	  for bringing this to my attention.
	* Added some code to allow a specific SSRC to be used.
	* Fixed bug in jitter calculation code. Thanks to Uwe Andersen
	  (uandersen@mayah.com) for bringing this to my attention.
	* Added OnPollThreadStart and OnPollThreadStop to RTPSession.
	  Thanks to Daniele Barzotti (daniele.barzotti@eurocomtel.com)
	  for suggesting this.
	* Added method to RTPSessionParams to force a specific CNAME.
	  Thanks to Lars Rohwedder (L.Rohwedder@mocotec.de) for the
	  suggestion.
	* Removed old RTPRandom code and made RTPRandom an abstract
	  interface. Added a /dev/urandom implementation, a rand_s
	  implementation and a rand48 implementation. By default, 
	  /dev/urandom and rand_s are tried, and rand48 is used as a 
	  fall-back mechanism.

 3.7.1 (May 2007)
 	* Fixed bug in the CurrentTime implementation (Win32/WinCE version). 
	  Thanks to Dani Baeyens (dani@warp.es) and Eric Johnson 
	  (EJohnson@pelco.com) for helping me solve this problem.

 3.7.0 (January 2007)
 	* Send and receive socket buffer sizes can now be set in the
	  transmission parameters. Thanks to Dmitry Shandyba
	  (Dmitry.Shandyba@materialise.kiev.ua) for suggesting this.
	* Changed a 'htons' call to a 'ntohs' call in ShouldAcceptData
	  in both the IPv4 and IPv6 transmitters.
	* Fixed bug in RTPIPv6Destination. Thanks to Yi-Huan Chan
	  (yhchan@csie.nctu.edu.tw) and Franco Sinhori 
	  (francosinhori@gmail.com) for bringing this to my attention.

 3.6.0 (June 2006)
	* Added a constructor to the RTCPCompoundPacket class to be able
	  to parse a compound packet out of a byte array (and not only
	  out of an RTPRawPacket instance).
	* Added a method to RTPSession to send RTCP APP packets. Thanks
	  to Herman Bastiaens (herman.bastiaens@student.uhasselt.be)
	  for supplying the patch.
	* Fixed Win32 rand_s bug. Thanks to Jeremy Noring
	  (jnoring@wilife.com) for supplying the patch.
	* Removed the GetNumRTPPacketsSent and GetNumRTCPPacketsSent
	  functions in the transmitter. The counts were only used to
	  check if packets had been sent. Now, a flag in RTPSession is
	  used for this purpose.
	* Added memory management support.
	* Added a member function to RTPSession which allows passing an
	  RTPTransmitter instance. 
	* The instances in the destination lists now store struct
	  sockaddr variables. This makes sending data to each destination
	  more efficient.

 3.5.2 (March 2006)
 	* Fixed bug in the random number functions which are used with
	  MS Visual Studio 2005. Thanks to Jun Ohasi (jun@jnb.odn.ne.jp)
	  for bringing the incorrect use of rand_s to my attention.
	* Changed types like u_int32_t to types like uint32_t in the 
	  documentation.

 3.5.1 (March 2006)
	* Fixed bug in RTCP scheduler. Due to -= operation on an RTPTime
	  instance, an incredibly large scheduling interval could be
	  calculated.

 3.5.0 (March 2006)
 	* Now, the define RTP_SNPRINTF is used instead of snprintf,
	  _snprintf or _snprintf_s.
	* In the RTPSources member function MultipleTimeouts, I neglected
	  to call the OnRemoveSource virtual function. Thanks to Adam Love 
	  (alove@exceptionalinnovation.com) for bringing this to my attention.
	* Added a OnSendRTCPCompoundPacket member function to the RTPSession
	  class. Useful for inspecting outgoing data.
	* Modified the templates somewhat. Should cause less compiler problems
	  this way. Thanks tot Chris Hamilton (chamilton@cs.dal.ca) for 
	  providing this solution.
	* On Win32, if possible the functions rand_s and srand_s are now used.

 3.4.0 (January 2006)
 	* Changed u_int32_t like types to uint32_t like types. Thanks to
	  Panagiotis Issaris (takis.issaris@uhasselt.be) for informing me
	  that these are C99 compliant.
	* Changed sprintf functions to safer snprintf functions. Thanks to
	  Panagiotis Issaris (takis.issaris@uhasselt.be) for pointing this
	  out.
	* Fixed bug in RTPSources (counters were not reset when the source
	  table was cleared). Thanks to Justin Matthews (jmatthewsr@yahoo.com)
	  for pointing this out.
	* Fixed bug in RTPHashTable and RTPKeyHashTable. Thanks to 
	  Tom Pijsel (tom.pijsel@twelvecubes.com) for bringing this to my
	  attention.
	* Fixed bug in example3.cpp

 3.3.0 (October 2005)
 	* Now it is possible to use a user-defined transmission component.
	* Added GStreamer transmission component written by Philippe Khalaf
	  (burger@speedy.org).

 3.2.1 (September 2005)
 	* The library wouldn't compile when probation support was disabled. 
	  Thanks to Herman Bastiaens (herman.bastiaens@student.luc.ac.be) for
	  bringing this to my attention.
	* When parsed from an RTPRawPacket, the receive time is also stored
	  in the RTPPacket instance.

 3.2.0 (September 2005)
 	* Modified the routine in the RTPSession class which creates the
	  CNAME. Aparently on some systems, the 'getlogin' call returns
	  null. As an alternative, the library uses getenv("LOGNAME").
	  Thanks to Mark Schiffmann (schima@neumann-elektronik.com) for
	  mentioning this to me.
	* Added a OnBYEPacket method to the RTPSession class. Thanks to
	  Sigrid Thijs (sthijs@androme.be) for suggesting this.
	* When probation support is enabled, a probation type can be selected
	  when the session is created. Supported types are "No probation",
	  "Use probation, but store packets" and "Use probation and discard
	  packets received in probation mode". Thanks to Chris Flerackers
	  (cflerackers@androme.be) for suggesting this feature.
	* Added a parameter to WaitForIncomingData which indicates if
	  data is available when the function returns. Based on a suggestion
	  by Uwe Andersen (uandersen@mayah.com).
	* Now using getifaddrs (if possible) to obtain our own IP addresses
	  (both in IPv4 version and IPv6 version).
	* IPv6 code in Win32 version now works, but Visual Studio 2005 beta
	  has to be used. Thanks to Yi-Huan Chan (yhchan@csie.nctu.edu.tw)
	  for contributing some code.
	* Added Win32 code for GetLocalIPList_Interfaces (both IPv4 and IPv6).
	  Thanks to Ivan Makushkin (camry@pisem.net) for pointing out how
	  this could be done.
	* Added an option to use a SR packet when sending a BYE message.
	  Previously, a RR packet was always used, even if a session is
	  actually an active sender of data. Thanks to Uwe Andersen
	  (uandersen@mayah.com) for bringing this to my attention.
	* Fixed bug in CNAME creation.
	* Added WinCE support. Thanks to Maarten Daniels 
	  (maarten.daniels@uhasselt.be) for supplying patches.
	* Changed the CurrentTime implementation for the MS-Windows version.
	  Thanks to Maarten Daniels (maarten.daniels@uhasselt.be) and Chris
	  Flerackers (cflerackers@androme.be).

 3.1.0 (October 2004)
 	* Added a callback OnPollThreadStep which is called at the end of 
	  each loop of the poll thread
	* Added the examples subdirectory to the package
	* Fixed bug in rtpudpv4transmitter.cpp and rtpudpv6transmitter.cpp
	  which caused an infinite loop in LeaveAllMulticastGroups. Thanks
	  to Stijn Agten (stijn.agten@luc.ac.be) for pointing this out.
	* Added a function GetTransmissionInfo to the RTPTransmitter class
	  (and subclasses). The function will return some additional
	  information about the transmitter, like local IP addresses and
	  socket descriptors.

 3.0.2 (September 2004)
 	* Bugfix in rtpinternalsourcedata.cpp. The bug caused a crash when
	  duplicate packets were received. Thanks to Dominique Prunier
	  (dominique.prunier@micromedia-int.com) for informing me about
	  this.

 3.0.1 (September 2004)
 	* Bugfix in rtpudpv4transmitter.cpp and rtpudpv6transmitter.cpp in
	  method SetReceiveMode
	* Removed unused 'acceptownpackets' variable from
	  rtpudpv4transmitter.cpp and rtpudpv6transmitter.cpp
	* Added a 'Dump' function (for debugging) in RTPUDPv4Transmitter
	  and RTPUDPv6Transmitter
	* Now using JThread 1.1.0

 3.0.0 (August 2004)
 	* Complete rewrite of the library to provide better extensibility
	  and compliance with RFC 3550
	* Changes from the 2.x series:
		- The 2.x series was created with the idea that the user 
		  would only need to use the RTPSession class which meant 
		  that the other classes were not very useful by themselves. 
		  This version on the other hand, aims to provide many 
		  useful components to aid the user in building RTP capable 
		  applications.
		- In this version, the code which is specific for the 
		  underlying protocol by which RTP packets are transported, 
		  is bundled in a class which inherits its interface from a 
		  class called RTPTransmitter. This makes it easy for 
		  different underlying protocols to be supported. Currently 
		  there is support for UDP over IPv4 and UDP over IPv6.

 2.9 (July 2004)
 	* Fixed bug in rtpsrclist.cpp. Thanks to Lukasz Bobowiec 
	  (bobowiec@icslab.agh.edu.pl)
	* Added function in RTPSourceData which returns the IP address
	* Changed the random routines. Thanks to Jaap Keuter
	  (jaap.keuter@xs4all.nl)
	* Made the shared library link against libstdc++ if possible.
	  Thanks to Anatoly Yakovenko (aeyakovenko@yahoo.com) for the
	  suggestion.

 2.8 (January 2004)
 	* Added code to avoid a crash when receiving a malformed packet
	* Fixed a memory leak (forgot to free memory when a malformed
	  packet was discarded)
	* Changed debug routines for memory tracking

 2.7b (November 2003)
 	* Only added --enable-fpic and --enable-fPIC to the configure script

 2.7 (December 2002)
 	* Fixed important bug in rtpsources.cpp. This bug could cause
	  source information to get lost and could create a memory leak.
	* Improved support for AIX in multicasting code (uses _AIX define). 
	  Thanks to Klaus Matuschek (klaus.matuschek@infonova.com)
	* Fixed possible buffer overrun in rtpcontributingsources.cpp

 2.6 (January 2002)
	* This release only contains some minor changes
	* An 'install' target was added to the Makefile
	* Some newlines were added add the end of certain files to avoid
	  compiler warnings
	* Improved the jitter calculations somewhat 

 2.5 (December 2000)
 	* Added the possibility for the user to receive the raw RTCP packets.
	* Fixed a bug in RTPContributingSources::CreateLocalCNAME(). In this
	  routine, the wrong length was passed to 'gethostname'. Thanks to
	  Sergey V.Shpital (sergey@page.net.ru) for bringing this to my
	  attention.
	* Added a routine to set the Type of Service (ToS) field of the
	  outgoing packets (both RTP and RTCP). Thank to Philippe Cardon
	  (philippe.cardon@bt.com) for writing this code.
	* Fixed a bug in the 'packets lost' calculation. Thank to Domingo 
	  Cuevas Jr. (dcj@onebox.com) for helping me find this bug.
	* Fixed a bug in the sequence number and jitter calculation: when
	  packets were received out of order, the sequence numbers and
	  jitter got messed up. Many thanks to Mohammad Tawsheeq Russool 
	  (m.russool@eim.surrey.ac.uk) for helping me track down these
	  bugs.
	* Added the possibility to set the timestamp unit for a particular
	  source. Previously, it was assumed that their timestamp unit
	  was the same as that of the local session.

 2.4 (July 2000)
 	* Fixed a bug which caused all CSRS's except one to be incorrect.
 	* Added RTP header extension support (for both sending and receiving).
 	* Added some things (which should have been there already) to
 	  RTPPacket.
 	* Adjusted the way in which the login name is retrieved on unix-like
 	  systems. First I used a call to 'getlogin', but apparently this
 	  function messes with timers through the use of 'alarm' calls (at
 	  least on Linux). Now, I use a combination of 'geteuid' and
 	  'getpwuid' to obtain the necessary information. This does not
 	  have that problem and is a lot cleaner since it doesn't depend
 	  on login info (utmp) like 'getlogin'. Thanks to Roberto Jung Drebes
 	  (drebes@inf.ufrgs.br) for pointing out the timer-problem.
 	* Made a LaTeX version of the manual and tutorial. Looks a lot nicer.
 	* Made it possible for the user to specify the local IP address
 	  instead of letting the library figure it out itself.
 	* Fixed a bug which caused the 'fraction lost' in a RR packet to be
 	  zero all the time. Thanks to Domingo Cuevas Jr. (dcj@onebox.com) for
 	  pointing this out.
 	* Rewrote the RTCP packet sending routines. Now, they are much cleaner
 	  and much more understandable :)
 	* Added better support for RTCP 'APP' packets. You can now both send
 	  and receive APP packets.

 2.3 (April 2000)
 	* The routine which creates and sends RTCP packets is now a bit faster.
 	* Added a sample that demonstrates the round-trip time function.
 	* Added functions to RTPSourceData: now the time when the last RR or
 	  SR report was received can be retrieved. Also, the round trip time
 	  can be retrieved: this is calculated as suggested in RFC 1889.
 	* Fixed a bug: the LSR value was not calculated correctly, now it is
 	  (or should be ;-) )
 	* Instead of specifying defines on the command line, they are now
 	  defined in a config file. The unix version of this file is created
 	  by the configure script.
 	* Added a member to RTPPacket which I had forgotten (the payload type,
 	  which is obviously important :-) ).
 	* The library should now be able to work on a VxWorks platform. Thanks
 	  to Dave Osborne (dosborne@argoneng.com) for his help.
	* Added a tutorial and a small example application.
 	* Added some debugging routines (RTPDebug class) to check for memory
 	  leaks. It turned out that there weren't any, so I'm pretty pleased ;)
 	* I've added a 'configure' script to make compilation a bit easier
 	  across different platforms. Thanks to Qi Han (qh1c4@mizzou.edu) for
 	  helping me to improve the support for the Solaris platform. Also
 	  many thanks to Dario Maggiorini (dario@netdev.usr.dsi.unimi.it) for
 	  helping me test the script on several platforms.
 	* Added multicasting support.
	* A bug in rtpsourcedata.cpp was pointed out and fixed by Ramon Clout
	  (ramonc@win.tue.nl). Many thanks for this, Ramon.

 2.2 (February 2000)
 	* Extra support for Sun and HP. Thanks to Henry Lau (hlau@nuera.com)
 	  and Justin Matthews (jmatthews@nuera.com) for this information.
 	* The 'Poll' routine in rtpconnection.cpp has been altered. Now, the
 	  routine should work even if there's that ioctl bug (previously, this
 	  bug was only taken into consideration on a Windows platform).
 	  Thanks to Justin Matthews (jmatthews@nuera.com) for his bugreport.
 	* Added some routines to RTPSession to get the local IP address and the
 	  port number of the sending socket.
 	* 'install' rule added to the makefile.
 	* Added the define 'RTP_SOCKLENTYPE_UINT'. See README.TXT for more
 	  information about this.

 2.1 (December 1999)
	* First release of jrtplib.
	* Added member functions of RTPSession to retrieve the used sockets.
	* Made the destination list faster by using a hash table.

 2.0 (August 1999)
 	* First decent implementation of RTP. Entirely rewritten since 1.0.

 1.0 (August 1999)
 	* First implementation of RTP. There were a lot of things that weren't
 	  quite right and the organisation of the classes was quite nasty.
 	  However, I learned a lot about RTP making this version, and so it
 	  allowed me to make a good start on version 2.0.