CHANGELOG revision ad08470c
12019-10-11
2    - 2.4.6
3    - Minor code cleanup and logging improvements.
4    - Server and client programs: include library version (e.g. 2.4.6)
5      into `server' and `user-agent' headers.
6
72019-10-08
8    - 2.4.5
9    - [OPTIMIZATION]: flush encoder stream only when necessary.
10    - [BUGFIX] Use ls-qpack v0.10.2 for new API -- and for a bug fix.
11    - [BUGFIX] Typo in IETF conn SETTINGS writer.
12    - Use latest BoringSSL.
13
142019-10-08
15    - 2.4.4
16    - [API] Add lsquic_alpn2ver() to aid parsing Alt-Svc header.
17    - [BUGFIX] NULL dereference when H3 frame header would be split.
18    - [BUGFIX] Do not close fixed-size H3 frame prematurely.
19    - [BUGFIX] Allow PING frames in IETF mini conn.
20    - [BUGFIX] Mini conns: don't send any packets after receiving
21      CONNECTION_CLOSE.
22    - [BUGFIX] Client migration: reserve slot for DCID from transport params.
23    - [BUGFIX] Allow max_early_data_size=0 -- early_data might not be there.
24    - [BUGFIX] Use an invalid stream number to reset BPT cache (zero is now a
25      valid stream number).
26    - [SPEC] Use FINAL_SIZE_ERROR when FIN mismatch is detected.
27    - [OPTIMIZATION] Closed connection only gets one chance to send packets.
28    - [OPTIMIZATION] Flush headers stream before packetizing stream data.
29    - [OPTIMIZATION] process QPACK encoder STREAM frames immediately.
30    - Update ls-qpack to v0.10.1.
31
322019-09-30
33    - 2.4.3
34    - Add GQUIC versions to the list of h3 ALPNs for Alt-Svc header.
35      For example, h3-Q043.  Chrome will switch to using this format at
36      some point in the future.
37    - [BUGFIX] Send correct value in max_streams_uni transport param
38    - [SPEC] Abort IETF QUIC connection if max_early_data_size is not set
39      to 0xFFFFFFFF
40
412019-09-23
42    - 2.4.2
43    - [BUGFIX] H3 framing: fix zero-byte write when space is available
44    - [BUGFIX] Don't send STREAM frame when incoming unidirectgional stream
45      is closed
46    - [BUGFIX] Cancel all pending writes by stream reset by a GOAWAY
47    - [BUGFIX] Fix use-after-free in IETF full conn
48    - [OPTIMIZATION] Wait for session tickets for two seconds and then drop
49      SSL object and crypto streams.
50
512019-09-18
52    - 2.4.0
53    - [FEATURE] QUIC and HTTP/3 Internet Draft 23 support
54
552019-09-13
56    - 2.3.1
57    - [BUGFIX] Fix memory leaks
58    - [BUGFIX] Fix unit tests
59
602019-09-12
61    - 2.3.0
62    - [FEATURE] BBR congestion control is on by default
63    - [BUGFIX] BBR app-limited logic
64    - [BUGFIX] Fix uninitialized warnings in IETF
65    - [BUGFIX] Update ls-qpack to v0.9.14
66    - [CLEANUP] Code cleanup
67
682019-09-11
69    - 2.2.0
70    - [FEATURE] Server code is included in the library
71    - [FEATURE] IETF QUIC and HTTP/3 Support (ID-22)
72
732019-05-13
74    - 1.21.2
75    - [OPTIMIZATION] HPACK: use history to improve compression performance
76
772019-05-06
78    - 1.21.1
79    - [BUGFIX] If FIN or RST not received, don't delay stream destruction.
80    - [OPTIMIZATION] Speed up HPACK encoder by using same hash value to
81      search static and dynamic tables.
82
832019-04-12
84    - 1.21.0
85    - [FEATURE] Add qlog log module.
86
872019-04-01
88    - 1.20.0
89    - [FEATURE] Add support for Q046.
90
912019-03-19
92    - 1.19.6
93    - [BUGFIX] Ensure that Largest Observed does not decrease in ACKs we
94      send.  ACK frames placed in packets in buffered queues (optimization
95      introduced in 1.17.15) can be preceded by an ACK frame generated later.
96      In this case, the older ACK frame should not be sent out, as Chromium-
97      based servers flags decrease in the ACK frame's Largest Observed value
98      as an error.
99
1002019-03-05
101    - 1.19.5
102    - [BUGFIX] Use correct public key from PUBS based on KEXS index.
103    - [BUGFIX] Check flags before dispatching writes, avoiding assert.
104    - [BUGFIX] Set :scheme to "https" (instead of "HTTP").
105
1062019-02-25
107    - 1.19.4
108    - [BUGFIX] Check buffer bounds when looking up version in 0-RTT blob.
109    - [BUGFIX] http_client: don't fetch 0-rtt info if handshake failed.
110    - Log number of pacer calls at DEBUG, rather than NOTICE, level.
111
1122019-02-18
113    - 1.19.3
114    - [BUGFIX] Q044: don't encode packet number in 6 bytes.  Six-byte
115      packet number encoding does not exist in Q044.  This fixes a
116      regression introduced in '[BUGFIX] Buffered packets can contain
117      ACK frames' -- we need to keep QUIC version in mind when selecting
118      the longest possible packet number encoding used for the buffered
119      packet that carries the ACK.
120    - [BUGFIX] Do not increase CWND when timeout occurs.
121    - http_client: support setting handshake timeout on command line.
122      Use -o handshake_to=timeout.
123    - http_client: use -k to connect UDP socket to pick up ICMP errors.
124    - http_client: allow pathless mode, when only handshake is performed
125      without issuing any requests.  This can be done by simply not
126      specifying a -p flag on the command line.
127
1282019-02-11
129    - 1.19.2
130    - [BUGFIX] Begin negotiation with version provided in 0-RTT info.
131    - [BUGFIX] Version checking in zero_rtt deserialize function.
132
1332019-02-04
134    - 1.19.1
135    - [BUGFIX] Fix Windows build.
136
1372019-02-04
138    - 1.19.0
139    - [FEATURE, API Change] 0-RTT support.  Add function to export 0-RTT
140      information; it can be supplied to a subsequent connect() call.
141    - [FEATURE] Add -0 flag to http_client to exercise 0-RTT support.
142    - [BUGFIX] Resuscitate the Windows build.
143    - [BUGFIX] Send HTTP settings (max header list size) if necessary.
144    - [BUGFIX] Buffered packets can contain ACK frames.
145    - [BUGFIX] Make packet writeable once all STREAM frames are elided.
146    - [BUGFIX] Fix potential null dereference when realloc fails.
147    - cmake: simplify build configuration.
148
1492019-01-28
150    - 1.18.0
151    - [API Change] Can specify clock granularity in engine settings.
152    - [BUGFIX] Pacer uses fixed clock granularity.  Since the change on
153      2018-04-09, it is not necessary to try to approximate the next tick
154      time in the pacer: it can use fix clock granularity specified by
155      the user.
156    - [BUGFIX] Do not tick constantly before handshake is done.
157    - [BUGFIX] Do not exit tick prematurely: reuse packet with ACK.  Even
158      if we cannot allocate *more* packets, we could still be able to write
159      to one already allocated.
160    - [BUGFIX] Do not schedule pacer if there are no lost packets.
161
1622019-01-17
163    - 1.17.15
164    - [BUGFIX] http_client: make sure only one read per on_read() callback
165      is performed in the header conversion bypass (-B) mode.
166    - http_client: with -E, assign random priority when stream is created.
167    - [OPTIMIZATION] On immediate write, place an ACK frame into the first
168      buffered packet if an ACK is queued.  This reduces the number of
169      standalone ACK packets.
170    - [OPTIMIZATION] Allow placing more than one STREAM frame from the same
171      stream into an outgoing packet.  This change minimizes the number of
172      buffered packets required to store several small HTTP messages by
173      virtue of allowing more than one STREAM frame from HEADERS stream in
174      the same packet.
175    - [OPTIMIZATION] Flush headers when writing to buffered packets.  This
176      causes the headers to be written to the same buffered packet queue,
177      thereby improving packet utilization, especially for small HTTP
178      messages.
179
1802019-01-16
181    - 1.17.14
182    - [FEATURE] http_client can now collect stats: time to connect, TTFB,
183      time to download, requests per seconds, and bandwidth.  See -t flag.
184    - [BUGFIX] http_client: -B, -K, and -r can be used at the same time.
185    - [BUGFIX] http_client: do not display cert chain before each request.
186      Now this is only done once per connection, if the handshake is
187      successful and -a option is given.
188    - [BUGFIX] Do not wait to dispatch on_close() after reading.  If a
189      stream is scheduled to be closed after on_read() callback returns,
190      close it immediately instead of waiting until the end of the tick.
191      If client creates new request from on_close() event, they will be
192      processed in the same tick instead of waiting for the next one.
193    - [BUGFIX] HEADERS stream is critical: always treat it with highest
194      priority.
195
1962019-01-10
197    - 1.17.12
198    - [FEATURE] http_client can now issue parallel requests in the context
199      of a single connection.  See -w option.
200
2012019-01-03
202    - 1.17.11
203    - Fix strict aliasing warning in optimized compilation.
204
2052018-12-27
206    - 1.17.10
207    - Fix the example program to be able to use parallel connections
208      again.  (See the -n argument.)
209
2102018-12-18
211    - 1.17.9
212    - [BUGFIX] Engine: reduce minimum batch size from 256 to 4
213
2142018-12-10
215    - 1.17.8
216    - [BUGFIX] Fix compilation on FreeBSD and 32-bit Linux
217
2182018-12-03
219    - 1.17.7
220    - [BUGFIX] Do not unset PING alarm before ringing expired alarms.
221      This prevented PING from ever being sent.
222
2232018-11-29
224    - 1.17.6
225    - Add failsafe: resume sending packets after some time
226
227      The change puts a 1-second limit on the amount of time the engine
228      will not send packets after some packets are delayed.  This makes
229      the library robust in case the user does not unblock the engine
230      explicitly using lsquic_engine_send_unsent_packets() call.
231
232    - [BUGFIX] Handle corner cases in send controller when packets are
233      a) delayed or b) dropped during repackaging.
234    - [BUGFIX] Memory leak: destroy buffered packets during controller
235      cleanup.
236
2372018-11-16
238    - 1.17.3
239    - [BUGFIX] Do not send STOP_WAITING frames when using Q044
240
2412018-10-19
242    - 1.17.2
243    - [BUGFIX] Memory leak in test_frame_rw unit test.
244    - [BUGFIX] Parsing packets with short IETF header: do not overwrite
245      flags.  (Only a problem in unit tests -- benign otherwise.)
246
2472018-10-16
248    - 1.17.0
249    - [API Change] Packet out Memory Interface (PMI) update:
250      - Split PMI pool return into pmi_release and pmi_return
251      - PMI callbacks take peer_ctx and is_ipv6 arguments
252    - [BUGFIX] Fix use-after-free when certificate is updated
253    - Silence gcc warning in optimized mode by performing useless
254      initialization
255    - cmake: use the standard variable CMAKE_BUILD_TYPE instead of
256      DEVEL_MODE
257
2582018-10-03
259    - 1.16.0
260    - [API Change] Add lsquic_conn_n_avail_streams()
261    - [BUGFIX] only dispatch crypto stream read events if WANT_READ is on
262
2632018-09-27
264    - 1.15.0
265    - [API Change] Add LSCONN_ST_PEER_GOING_AWAY to the list of conn statuses
266    - [BUGFIX] free uncompressed headers correctly when error occurs
267
2682018-09-12
269    - 1.14.3
270    - [BUGFIX] Do not abort conn on STREAM frame for a reset stream
271    - [BUGFIX] Drop packets that would become empty due to repackaging.
272      Packets on the scheduled queue may be marked for repackaging.
273      Frames such as ACK frame that are never resent are removed from
274      repackaged packets.  We must check that the newly repackaged packet
275      would not be empty.  If it would be, it is destroyed instead and
276      the next packet on the scheduled queue is used.  Note that this
277      change only affects the logic to return the next packet to be sent.
278      Lost packets that are being rescheduled are already processed in
279      this fashion.
280    - Byteswap CID before logging it - this makes it match Chrome CIDs.
281      (Except Q035, which is the last little-endian GQUIC version we
282      support.)
283
2842018-09-06
285    - 1.14.0
286    - [API Change] Disable packet sending if full batch cannot be sent
287      If lsquic_packets_out_f() cannot send the whole batch, disable
288      packet sending until lsquic_engine_send_unsent_packets() is called.
289    - [BUGFIX] Handle case when STREAM frame does not fit.
290    - [BUGFIX] Always allow incoming STREAM frames to overlap.  Peers
291      may send overlapping STREAM frames even if using versions older
292      than Q043.
293    - Custom header set fixes:
294      - set "FIN reached" flag when custom header with FIN flag is
295        claimed;
296      - do not return custom header set for a reset stream.
297
2982018-08-27
299
300    - 1.13.0
301    - [FEATURE, API Change] Add ability to create custom header set
302      objects via callbacks.  This avoids reading and re-parsing
303      headers from the stream.
304
3052018-08-27
306
307    - 1.12.4
308    - Fix memory leak when engine is destroyed
309    - Fix memory leak in http_client
310    - Fix gcc warning in unit tests
311
3122018-08-22
313
314    - 1.12.3
315    - [BUGFIX] Fix duplicate STREAM frame detection
316
3172018-08-20
318
319    - 1.12.2
320    - [BUGFIX] Update count of scheduled bytes when adjusting size of
321      an already-scheduled packet.
322    - Emit info instead of warning messages when stream is used in
323      unexpected ways.
324
3252018-08-17
326
327    - 1.12.0
328    - [FEATURE, API Change] Add support for certificate verification
329
3302018-08-16
331
332    - 1.11.1
333    - [BUGFIX] Fix STOP_WAITING frame processing in the new Q044 code
334
3352018-08-15
336
337    - 1.11.0
338    - [FEATURE] Add support for Q044.
339
3402018-08-09
341
342    - 1.10.2
343    - [BUGFIX] Don't go over limit when creating delayed streams
344
3452018-07-10
346
347    - 1.10.1
348    - [BUGFIX]  process connections after each batch of packets is read
349      This avoids a problem of accumulating a very large list of packets
350      (possible when speeds are high and socket's receive buffer is large)
351      and processing it all at once.
352    - If glibc is older than 2.17, link with rt.  This is necessary for
353      clock_getres(2).
354    - Add version macros to lsquic.h; remove unnecessary includes.
355
3562018-06-13
357
358    - [BUGFIX] allow multiple parallel connections by default
359
360      Use the original method of tracking connections by CIDs by default.
361      If zero-sized CID support is turned on, connections are tracked by
362      the address.  A new connection is not created if another connection
363      is using the same network address
364
3652018-05-30
366
367    - [FEATURE, API CHANGE] Support zero-sized CIDs in received packets
368
3692018-05-24
370
371    - Close connection properly when packet encryption fails
372
3732018-05-23
374
375    - [BUGFIX] Do not produce packet sequence gaps due to delayed packets
376
3772018-05-21
378
379    - [API Change] Add optional callback to call when handshake is done
380    - [API Change, BUGFIX] After send failure, wait until transport available
381
3822018-05-18
383
384    - [API] Expose useful lsquic_ver2str[] in lsquic.h
385    - [BUGFIX] Do not produce packet sequence gaps due to STREAM frame elision
386    - Improve checks of number of incoming streams limit and associated
387      error reporting.
388    - [BUGFIX] Command-line option `-6` now works correctly.
389
3902018-05-16
391
392    - [FEATURE] DNS resolution
393    - [BUGFIX] Frame insertion mis-ID as overlap instead of dup
394    - http_client: fix priority range generated by -E flag
395
3962018-05-09
397
398    - [FEATURE] Add support for Q043.
399    - Support for versions Q037, Q038, Q041, and Q042 has been removed.
400    - Fix typo in debug message.
401    - Fix code indentation.
402    - Add /* fallthru */ comment to stop newer gcc from complaining.
403    - Logger: fix compilation of optimized Windows build.
404
4052018-05-04
406
407    - [FEATURE] Add support for Q042.
408    - Remove comment: MSPC is obsolete (no code changes)
409    - Prog: use lsquic_str2ver() when processing -o version flag
410    - Remove unused CTIM and SRBF transport parameters
411    - Disable QUIC versions Q037 and Q038 by default
412    - Fix Windows compilation by including compat header file in
413      lshpack.c
414    - Address warnings produced by newer versions of gcc
415    - Future-proof: turn off -Werror
416
4172018-05-02
418
419    - [BUGFIX] Make lsquic_conn_quic_version() available
420    - Switch to using ls-hpack 1.1
421    - [BUGFIX] Do not ignore stream resets after receiving FIN
422
4232018-04-27
424
425    - HPACK: do not allow header block to end with table size update.
426
4272018-04-25
428
429    - [BUGFIX] Do not create gap in sent packnos when squeezing delayed
430      packets.
431    - [BUGFIX] sendctl checks for all unacked bytes, not just retx bytes.
432    - [BUGFIX] connections with blocked scheduled packets are not tickable
433      for sending.
434    - [BUGFIX] Conn is tickable if it wants to send a connection-level
435      frame.
436
4372018-04-23
438
439    - Fix busy loop: tickable must make progress.  When connection is
440      self-reporting as tickable, it must make progress when ticked.  There
441      are two issues:
442        1. If there are buffered packets, the connection is only tickable if
443           they can be sent out.
444        2. A connection is tickable if there are streams on the servicing
445           queue.  When the tick occurs, we must service the stream
446           independent of whether any packets are sent.
447    - Fix assertion in pacer which can be incorrect under some
448      conditions.
449    - cmake: do not turn on address sanitizer if in Travis.
450
4512018-04-20
452
453    - [BUGFIX] Fix bug in lsquic_engine_connect() exposed by yesterday's
454      changes.
455
4562018-04-19
457
458    - [BUGFIX] Add connection to Tickable Queue on stream write
459    - cmake: use MSVC variable instead of trying to detect
460    - engine: improve connection incref/decref logging
461    - stream: don't ignore errors that may occur on triggered flush
462    - connection: remove obsolete method
463    - engine: indicate connection as tickable if previous call went
464      over threshold
465
4662018-04-09
467
468    [API Change, OPTIMIZATION] Only process conns that need to be processed
469
470    The API is simplified: do not expose the user code to several
471    queues.  A "connection queue" is now an internal concept.
472    The user processes connections using the single function
473    lsquic_engine_process_conns().  When this function is called,
474    only those connections are processed that need to be processed.
475    A connection needs to be processed when:
476
477        1. New incoming packets have been fed to the connection.
478        2. User wants to read from a stream that is readable.
479        3. User wants to write to a stream that is writeable.
480        4. There are buffered packets that can be sent out.  (This
481           means that the user wrote to a stream outside of the
482           lsquic library callback.)
483        5. A control frame (such as BLOCKED) needs to be sent out.
484        6. A stream needs to be serviced or delayed stream needs to
485           be created.
486        7. An alarm rings.
487        8. Pacer timer expires.
488
489    To achieve this, the library places the connections into two
490    priority queues (min heaps):
491
492        1. Tickable Queue; and
493        2. Advisory Tick Time queue (ATTQ).
494
495    Each time lsquic_engine_process_conns() is called, the Tickable
496    Queue is emptied.  After the connections have been ticked, they are
497    queried again: if a connection is not being closed, it is placed
498    either in the Tickable Queue if it is ready to be ticked again or
499    it is placed in the Advisory Tick Time Queue.  It is assumed that
500    a connection always has at least one timer set (the idle alarm).
501
502    The connections in the Tickable Queue are arranged in the least
503    recently ticked order.  This lets connections that have been quiet
504    longer to get their packets scheduled first.
505
506    This change means that the library no longer needs to be ticked
507    periodically.  The user code can query the library when is the
508    next tick event and schedule it exactly.  When connections are
509    processed, only the tickable connections are processed, not *all*
510    the connections.  When there are no tick events, it means that no
511    timer event is necessary -- only the file descriptor READ event
512    is active.
513
514    The following are improvements and simplifications that have
515    been triggered:
516
517        - Queue of connections with incoming packets is gone.
518        - "Pending Read/Write Events" Queue is gone (along with its
519          history and progress checks).  This queue has become the
520          Tickable Queue.
521        - The connection hash no longer needs to track the connection
522          insertion order.
523
5242018-04-02
525
526    - [FEATURE] Windows support
527
528    - Reduce stack use -- outgoing packet batch is now allocated on the heap.
529
5302018-03-09
531
532    - [OPTIMIZATION] Merge series of ACKs if possible
533
534      Parsed single-range ACK frames (that is the majority of frames) are
535      saved in the connection and their processing is deferred until the
536      connection is ticked.  If several ACKs come in a series between
537      adjacent ticks, we check whether the latest ACK is a strict superset
538      of the saved ACK.  If it is, the older ACK is not processed.
539
540      If ACK frames can be merged, they are merged and only one of them is
541      either processed or saved.
542
543    - [OPTIMIZATION] Speed up ACK verification by simplifying send history.
544
545      Never generate a gap in the sent packet number sequence.  This reduces
546      the send history to a single number instead of potentially a series of
547      packet ranges and thereby speeds up ACK verification.
548
549      By default, detecting a gap in the send history is not fatal: only a
550      single warning is generated per connection.  The connection can continue
551      to operate even if the ACK verification code is not able to detect some
552      inconsistencies.
553
554    - [OPTIMIZATION] Rearrange the lsquic_send_ctl struct
555
556      The first part of struct lsquic_send_ctl now consists of members that
557      are used in lsquic_send_ctl_got_ack() (in the absense of packet loss,
558      which is the normal case).  To speed up reads and writes, we no longer
559      try to save space by using 8- and 16-bit integers.  Use regular integer
560      width for everything.
561
562    - [OPTIMIZATION] Cache size of sent packet.
563
564    - [OPTIMIZATION] Keep track of the largest ACKed in packet_out
565
566      Instead of parsing our own ACK frames when packet has been acked,
567      use the value saved in the packet_out structure when the ACK frame
568      was generated.
569
570    - [OPTIMIZATION] Take RTT sampling conditional out of ACK loop
571
572    - [OPTIMIZATION] ACK processing: only call clock_gettime() if needed
573
574    - [OPTIMIZATION] Several code-level optimizations to ACK processing.
575
576    - Fix: http_client: fix -I flag; switch assert() to abort()
577
5782018-02-26
579    - [API Change] lsquic_engine_connect() returns pointer to the connection
580      object.
581    - [API Change] Add lsquic_conn_get_engine() to get engine object from
582      connection object.
583    - [API Change] Add lsquic_conn_status() to query connection status.
584    - [API Change] Add add lsquic_conn_set_ctx().
585    - [API Change] Add new timestamp format, e.g. 2017-03-21 13:43:46.671345
586    - [OPTIMIZATION] Process handshake STREAM frames as soon as packet
587      arrives.
588    - [OPTIMIZATION] Do not compile expensive send controller sanity check
589      by default.
590    - [OPTIMIZATION] Add fast path to gquic_be_gen_reg_pkt_header.
591    - [OPTIMIZATION] Only make squeeze function call if necessary.
592    - [OPTIMIZATION] Speed up Q039 ACK frame parsing.
593    - [OPTIMIZATION] Fit most used elements of packet_out into first 64 bytes.
594    - [OPTIMIZATION] Keep track of scheduled bytes instead of calculating.
595    - [OPTIMIZATION] Prefetch next unacked packet when processing ACK.
596    - [OPTIMIZATION] Leverage fact that ACK ranges and unacked list are.
597      ordered.
598    - [OPTIMIZATION] Reduce function pointer use for STREAM frame generation
599    - Fix: reset incoming streams that arrive after we send GOAWAY.
600    - Fix: delay client on_new_conn() call until connection is fully set up.
601    - Fixes to buffered packets logic: splitting, STREAM frame elision.
602    - Fix: do not dispatch on_write callback if no packets are available.
603    - Fix WINDOW_UPDATE send and resend logic.
604    - Fix STREAM frame extension code.
605    - Fix: Drop unflushed data when stream is reset.
606    - Switch to tracking CWND using bytes rather than packets.
607    - Fix TCP friendly adjustment in cubic.
608    - Fix: do not generate invalid STOP_WAITING frames during high packet
609      loss.
610    - Pacer fixes.
611
6122017-12-18
613
614    - Fix: better follow cubic curve after idle period
615    - Fix: add missing parts to outgoing packet splitting code
616    - Fix: compilation using gcc 4.8.4
617
6182017-10-31
619
620    - Add APIs.txt -- describes LSQUIC APIs
621
6222017-10-31
623
624    - [API Change] Sendfile-like functionality is gone.  The stream no
625      longer opens files and deals with file descriptors.  (Among other
626      things, this makes the code more portable.)  Three writing functions
627      are provided:
628
629        lsquic_stream_write
630        lsquic_stream_writev
631        lsquic_stream_writef    (NEW)
632
633      lsquic_stream_writef() is given an abstract reader that has function
634      pointers for size() and read() functions which the user can implement.
635      This is the most flexible way.  lsquic_stream_write() and
636      lsquic_stream_writev() are now both implemented as wrappers around
637      lsquic_stream_writef().
638
639    - [OPTIMIZATION] When writing to stream, be it within or without the
640      on_write() callback, place data directly into packet buffer,
641      bypassing auxiliary data structures.  This reduces amount of memory
642      required, for the amount of data that can be written is limited
643      by the congestion window.
644
645      To support writes outside the on_write() callback, we keep N
646      outgoing packet buffers per connection which can be written to
647      by any stream.  One half of these are reserved for the highest
648      priority stream(s), the other half for all other streams.  This way,
649      low-priority streams cannot write instead of high-priority streams
650      and, on the other hand, low-priority streams get a chance to send
651      their packets out.
652
653      The algorithm is as follows:
654
655      - When user writes to stream outside of the callback:
656        - If this is the highest priority stream, place it onto the
657          reserved N/2 queue or fail.
658            (The actual size of this queue is dynamic -- MAX(N/2, CWND) --
659             rather than N/2, allowing high-priority streams to write as
660             much as can be sent.)
661        - If the stream is not the highest priority, try to place the
662          data onto the reserved N/2 queue or fail.
663      - When tick occurs *and* more packets can be scheduled:
664        - Transfer packets from the high N/2 queue to the scheduled
665          queue.
666        - If more scheduling is allowed:
667          - Call on_write callbacks for highest-priority streams,
668            placing resulting packets directly onto the scheduled queue.
669        - If more scheduling is allowed:
670          - Transfer packets from the low N/2 queue to the scheduled
671            queue.
672        - If more scheduling is allowed:
673          - Call on_write callbacks for non-highest-priority streams,
674            placing resulting packets directly onto the scheduled queue
675
676      The number N is currently 20, but it could be varied based on
677      resource usage.
678
679    - If stream is created due to incoming headers, make headers readable
680      from on_new.
681
682    - Outgoing packets are no longer marked non-writeable to prevent placing
683      more than one STREAM frame from the same stream into a single packet.
684      This property is maintained via code flow and an explicit check.
685      Packets for stream data are allocated using a special function.
686
687    - STREAM frame elision is cheaper, as we only perform it if a reset
688      stream has outgoing packets referencing it.
689
690    - lsquic_packet_out_t is smaller, as stream_rec elements are now
691      inside a union.
692
6932017-10-12
694
695    - Do not send RST_STREAM when stream is closed for reading
696    - Raise maximum header size from 4K to 64K
697    - Check header name and value lengths against maximum imposed by HPACK
698    - Fix NULL dereference in stream flow controller
699
7002017-10-09
701
702    - Hide handshake implementation behind a set of function pointers
703    - Use monotonically increasing clock
704    - Make sure that retx delay is not larger than the max of 60 seconds
705
7062017-09-29
707
708    - A few fixes to code and README
709
7102017-09-28
711
712    - Add support for Q041; drop support for Q040
713
7142017-09-27
715
716    - Fix CMakeLists.txt: BoringSSL include and lib was mixed up
717
7182017-09-26
719
720    - Add support for Mac OS
721    - Add support for Raspberry Pi
722    - Fix BoringSSL compilation: include <openssl/hmac.h> explicitly
723
7242017-09-22
725
726    - Initial release
727