159 lines
5.6 KiB
C
159 lines
5.6 KiB
C
/*
|
|
* Spdylay - SPDY Library
|
|
*
|
|
* Copyright (c) 2012 Tatsuhiro Tsujikawa
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining
|
|
* a copy of this software and associated documentation files (the
|
|
* "Software"), to deal in the Software without restriction, including
|
|
* without limitation the rights to use, copy, modify, merge, publish,
|
|
* distribute, sublicense, and/or sell copies of the Software, and to
|
|
* permit persons to whom the Software is furnished to do so, subject to
|
|
* the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be
|
|
* included in all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
|
|
* LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
|
|
* OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
|
|
* WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
*/
|
|
#ifndef SPDYLAY_STREAM_H
|
|
#define SPDYLAY_STREAM_H
|
|
|
|
#ifdef HAVE_CONFIG_H
|
|
# include <config.h>
|
|
#endif /* HAVE_CONFIG_H */
|
|
|
|
#include <spdylay/spdylay.h>
|
|
#include "spdylay_outbound_item.h"
|
|
|
|
/*
|
|
* If local peer is stream initiator:
|
|
* SPDYLAY_STREAM_OPENING : upon sending SYN_STREAM
|
|
* SPDYLAY_STREAM_OPENED : upon receiving SYN_REPLY
|
|
* SPDYLAY_STREAM_CLOSING : upon queuing RST_STREAM
|
|
*
|
|
* If remote peer is stream initiator:
|
|
* SPDYLAY_STREAM_OPENING : upon receiving SYN_STREAM
|
|
* SPDYLAY_STREAM_OPENED : upon sending SYN_REPLY
|
|
* SPDYLAY_STREAM_CLOSING : upon queuing RST_STREAM
|
|
*/
|
|
typedef enum {
|
|
/* Initial state */
|
|
SPDYLAY_STREAM_INITIAL,
|
|
/* For stream initiator: SYN_STREAM has been sent, but SYN_REPLY is
|
|
not received yet. For receiver: SYN_STREAM has been received,
|
|
but it does not send SYN_REPLY yet. */
|
|
SPDYLAY_STREAM_OPENING,
|
|
/* For stream initiator: SYN_REPLY is received. For receiver:
|
|
SYN_REPLY is sent. */
|
|
SPDYLAY_STREAM_OPENED,
|
|
/* RST_STREAM is received, but somehow we need to keep stream in
|
|
memory. */
|
|
SPDYLAY_STREAM_CLOSING
|
|
} spdylay_stream_state;
|
|
|
|
typedef enum {
|
|
SPDYLAY_SHUT_NONE = 0,
|
|
/* Indicates further receptions will be disallowed. */
|
|
SPDYLAY_SHUT_RD = 0x01,
|
|
/* Indicates further transmissions will be disallowed. */
|
|
SPDYLAY_SHUT_WR = 0x02,
|
|
/* Indicates both further receptions and transmissions will be
|
|
disallowed. */
|
|
SPDYLAY_SHUT_RDWR = SPDYLAY_SHUT_RD | SPDYLAY_SHUT_WR
|
|
} spdylay_shut_flag;
|
|
|
|
typedef enum {
|
|
SPDYLAY_DEFERRED_NONE = 0,
|
|
/* Indicates the DATA is deferred due to flow control. */
|
|
SPDYLAY_DEFERRED_FLOW_CONTROL = 0x01
|
|
} spdylay_deferred_flag;
|
|
|
|
typedef struct {
|
|
int32_t stream_id;
|
|
spdylay_stream_state state;
|
|
/* Use same value in SYN_STREAM frame */
|
|
uint8_t flags;
|
|
/* Use same scheme in SYN_STREAM frame */
|
|
uint8_t pri;
|
|
/* Bitwise OR of zero or more spdylay_shut_flag values */
|
|
uint8_t shut_flags;
|
|
/* The array of server-pushed stream IDs which associate them to
|
|
this stream. */
|
|
int32_t *pushed_streams;
|
|
/* The number of stored pushed stream ID in |pushed_streams| */
|
|
size_t pushed_streams_length;
|
|
/* The maximum number of stream ID the |pushed_streams| can
|
|
store. */
|
|
size_t pushed_streams_capacity;
|
|
/* The arbitrary data provided by user for this stream. */
|
|
void *stream_user_data;
|
|
/* Deferred DATA frame */
|
|
spdylay_outbound_item *deferred_data;
|
|
/* The flags for defered DATA. Bitwise OR of zero or more
|
|
spdylay_deferred_flag values */
|
|
uint8_t deferred_flags;
|
|
/* Initial window size where window_size is compuated
|
|
against. Initially, window_size = initial_window_size. When N
|
|
bytes are sent, window_size -= N. After that, when the initial
|
|
window size is changed, say, new_initial_window_size, then
|
|
window_size becomes
|
|
new_initial_window_size-(initial_window_size-window_size) */
|
|
int32_t initial_window_size;
|
|
/* Current sender window size */
|
|
int32_t window_size;
|
|
/* Keep track of the number of bytes received without
|
|
WINDOW_UPDATE. */
|
|
int32_t recv_window_size;
|
|
} spdylay_stream;
|
|
|
|
void spdylay_stream_init(spdylay_stream *stream, int32_t stream_id,
|
|
uint8_t flags, uint8_t pri,
|
|
spdylay_stream_state initial_state,
|
|
int32_t initial_window_size,
|
|
void *stream_user_data);
|
|
|
|
void spdylay_stream_free(spdylay_stream *stream);
|
|
|
|
/*
|
|
* Disallow either further receptions or transmissions, or both.
|
|
* |flag| is bitwise OR of one or more of spdylay_shut_flag.
|
|
*/
|
|
void spdylay_stream_shutdown(spdylay_stream *stream, spdylay_shut_flag flag);
|
|
|
|
/*
|
|
* Add server-pushed |stream_id| to this stream. This happens when
|
|
* server-pushed stream is associated to this stream. This function
|
|
* returns 0 if it succeeds, or negative error code.
|
|
*
|
|
* RETURN VALUE
|
|
* ------------
|
|
*
|
|
* SPDYLAY_ERR_NOMEM
|
|
* Out of memory.
|
|
*/
|
|
int spdylay_stream_add_pushed_stream(spdylay_stream *stream, int32_t stream_id);
|
|
|
|
/*
|
|
* Defer DATA frame |data|. We won't call this function in the
|
|
* situation where stream->deferred_data != NULL. If |flags| is
|
|
* bitwise OR of zero or more spdylay_deferred_flag values.
|
|
*/
|
|
void spdylay_stream_defer_data(spdylay_stream *stream,
|
|
spdylay_outbound_item *data,
|
|
uint8_t flags);
|
|
|
|
/*
|
|
* Detaches deferred data from this stream. This function does not
|
|
* free deferred data.
|
|
*/
|
|
void spdylay_stream_detach_deferred_data(spdylay_stream *stream);
|
|
|
|
#endif /* SPDYLAY_STREAM */
|