X-Git-Url: https://git.sesse.net/?p=cubemap;a=blobdiff_plain;f=stream.h;h=6c757a19ff29224f1049c2fc8554d4c24f36af0a;hp=d762869e281572278c3603afc0bbd70d657ceb19;hb=f0621e41fdb96ce1bd58e7561e0aa76345072ba3;hpb=9abb89bcf7940e2ada9d708f86a218a56334f68d diff --git a/stream.h b/stream.h index d762869..6c757a1 100644 --- a/stream.h +++ b/stream.h @@ -8,10 +8,10 @@ #include #include #include +#include #include #include -class MarkPool; class StreamProto; struct Client; @@ -19,7 +19,7 @@ struct Stream { // Must be in sync with StreamConfig::Encoding. enum Encoding { STREAM_ENCODING_RAW = 0, STREAM_ENCODING_METACUBE }; - Stream(const std::string &stream_id, size_t backlog_size, Encoding encoding); + Stream(const std::string &stream_id, size_t backlog_size, size_t prebuffering_bytes, Encoding encoding, Encoding src_encoding); ~Stream(); // Serialization/deserialization. @@ -29,6 +29,11 @@ struct Stream { // Changes the backlog size, restructuring the data as needed. void set_backlog_size(size_t new_size); + // Mutex protecting and . + // Note that if you want to hold both this and the owning server's + // you will need to take before this one. + mutable pthread_mutex_t queued_data_mutex; + std::string url; // The HTTP response header, without the trailing double newline. @@ -41,6 +46,9 @@ struct Stream { // be Metacube, for reflecting to another Cubemap instance). Encoding encoding; + // What encoding we expect the incoming data to be in (usually Metacube). + Encoding src_encoding; + // The stream data itself, stored in a circular buffer. // // We store our data in a file, so that we can send the data to the @@ -54,9 +62,21 @@ struct Stream { // How many bytes can hold (the buffer size). size_t backlog_size; + // How many bytes we need to have in the backlog before we start + // sending (in practice, we will then send all of them at once, + // and then start sending at the normal rate thereafter). + // This is basically to force a buffer on the client, which can help + // if the client expects us to be able to fill up the buffer much + // faster than realtime (ie., it expects a static file). + size_t prebuffering_bytes; + // How many bytes this stream have received. Can very well be larger // than , since the buffer wraps. - size_t bytes_received; + size_t bytes_received = 0; + + // A list of points in the stream that is suitable to start new clients at + // (after having sent the header). Empty if no such point exists yet. + std::deque suitable_starting_points; // Clients that are in SENDING_DATA, but that we don't listen on, // because we currently don't have any data for them. @@ -67,12 +87,16 @@ struct Stream { // ). std::vector to_process; - // What pool to fetch marks from, or NULL. - MarkPool *mark_pool; + // Maximum pacing rate for the stream. + uint32_t pacing_rate = ~0U; - // Queued data, if any. Protected by the owning Server's . + // Queued data, if any. Protected by . // The data pointers in the iovec are owned by us. - std::vector queued_data; + struct DataElement { + iovec data; + uint16_t metacube_flags; + }; + std::vector queued_data; // Put client to sleep, since there is no more data for it; we will on // longer listen on POLLOUT until we get more data. Also, it will be put @@ -81,11 +105,10 @@ struct Stream { // Add more data to , adding Metacube headers if needed. // Does not take ownership of . - // You should hold the owning Server's . - void add_data_deferred(const char *data, size_t bytes); + void add_data_deferred(const char *data, size_t bytes, uint16_t metacube_flags); // Add queued data to the stream, if any. - // You should hold the owning Server's _and_ . + // You should hold the owning Server's . void process_queued_data(); private: @@ -93,8 +116,14 @@ private: // Adds data directly to the stream file descriptor, without adding headers or // going through . + // You should hold the owning Server's , and probably call + // remove_obsolete_starting_points() afterwards. + void add_data_raw(const std::vector &data); + + // Remove points from that are no longer + // in the backlog. // You should hold the owning Server's . - void add_data_raw(const std::vector &data); + void remove_obsolete_starting_points(); }; #endif // !defined(_STREAM_H)