aboutsummaryrefslogtreecommitdiffstats
path: root/libtransport/src/protocols/prod_protocol_rtc.h
blob: 7f50a250529ed43e6d127984b49a62aa33ff9245 (plain)
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
/*
 * Copyright (c) 2021 Cisco and/or its affiliates.
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at:
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#pragma once

#include <hicn/transport/core/name.h>
#include <protocols/production_protocol.h>

#include <atomic>
#include <map>
#include <mutex>

namespace transport {
namespace protocol {

class RTCProductionProtocol : public ProductionProtocol {
 public:
  RTCProductionProtocol(implementation::ProducerSocket *icn_socket);
  ~RTCProductionProtocol() override;

  using ProductionProtocol::start;
  using ProductionProtocol::stop;
  void setProducerParam() override;

  void produce(ContentObject &content_object) override;
  uint32_t produceStream(const Name &content_name,
                         std::unique_ptr<utils::MemBuf> &&buffer,
                         bool is_last = true,
                         uint32_t start_offset = 0) override;
  uint32_t produceStream(const Name &content_name, const uint8_t *buffer,
                         size_t buffer_size, bool is_last = true,
                         uint32_t start_offset = 0) override;
  uint32_t produceDatagram(const Name &content_name,
                           std::unique_ptr<utils::MemBuf> &&buffer) override;
  uint32_t produceDatagram(const Name &content_name, const uint8_t *buffer,
                           size_t buffer_size) override {
    return produceDatagram(content_name, utils::MemBuf::wrapBuffer(
                                             buffer, buffer_size, buffer_size));
  }

  void setConsumerInSyncCallback(
      interface::ProducerInterestCallback &&callback) {
    on_consumer_in_sync_ = std::move(callback);
  }

  auto shared_from_this() { return utils::shared_from(this); }

 private:
  // packet handlers
  void onInterest(Interest &interest) override;
  void onError(const std::error_code &ec) override{};
  void processInterest(uint32_t interest_seg, uint32_t lifetime);
  void producePktInternal(std::shared_ptr<ContentObject> &&content_object,
                          const Name &content_name, bool fec = false);
  void produceInternal(std::shared_ptr<ContentObject> &&content_object,
                       const Name &content_name, bool fec = false);
  void sendNack(uint32_t sequence);
  void sendContentObject(std::shared_ptr<ContentObject> content_object,
                         bool nac = false, bool fec = false);

  // manifests
  void sendManifestProbe(uint32_t sequence);
  void sendManifest(const Name &content_name);
  std::shared_ptr<core::ContentObjectManifest> createManifest(
      const Name &name) const;

  // stats
  void updateStats();
  void scheduleRoundTimer();

  // pending intersts functions
  void addToInterestQueue(uint32_t interest_seg, uint64_t expiration);
  void sendNacksForPendingInterests();
  void removeFromInterestQueue(uint32_t interest_seg);
  void scheduleQueueTimer(uint64_t wait);
  void interestQueueTimer();

  // FEC functions
  void onFecPackets(fec::BufferArray &packets);
  fec::buffer getBuffer(std::size_t size);
  void postponeFecPacket();
  void dispatchFecPacket();
  void flushFecPkts(uint32_t current_seq_num);
  // aggregated data functions
  void emptyQueue();
  void addPacketToQueue(std::unique_ptr<utils::MemBuf> &&buffer);

  core::Name flow_name_;

  std::pair<core::Packet::Format, size_t> data_header_format_;
  std::pair<core::Packet::Format, size_t> manifest_header_format_;
  std::pair<core::Packet::Format, size_t> fec_header_format_;
  std::pair<core::Packet::Format, size_t> nack_header_format_;

  uint32_t current_seg_;  // seq id of the next packet produced
  uint32_t prod_label_;   // path label of the producer
  uint32_t cache_label_;  // path label for content from the producer cache

  uint32_t produced_bytes_;        // bytes produced in the last round
  uint32_t produced_packets_;      // packet produed in the last round
  uint32_t produced_fec_packets_;  // fec packets produced last round

  uint32_t max_packet_production_;  // never exceed this number of packets
                                    // without update stats

  uint32_t bytes_production_rate_;        // bytes per sec
  uint32_t packets_production_rate_;      // pps
  uint32_t fec_packets_production_rate_;  // pps

  uint64_t last_produced_data_ts_;  // ms

  std::unique_ptr<asio::steady_timer> round_timer_;
  std::unique_ptr<asio::steady_timer> fec_pacing_timer_;

  uint64_t last_round_;

  // delayed nacks are used by the producer to avoid to send too
  // many nacks we the producer rate is 0. however, if the producer moves
  // from a production rate higher than 0 to 0 the first round the dealyed
  // should be avoided in order to notify the consumer as fast as possible
  // of the new rate.
  bool allow_delayed_nacks_;

  // queue for the received interests
  // this map maps the expiration time of an interest to
  // its sequence number. the map is sorted by timeouts
  // the same timeout may be used for multiple sequence numbers
  // but for each sequence number we store only the smallest
  // expiry time. In this way the mapping from seqs_map_ to
  // timers_map_ is unique
  std::multimap<uint64_t, uint32_t> timers_map_;

  // this map does the opposite, this map is not ordered
  std::unordered_map<uint32_t, uint64_t> seqs_map_;
  bool queue_timer_on_;
  std::unique_ptr<asio::steady_timer> interests_queue_timer_;

  // this callback is called when the remote consumer is in sync with high
  // probability. it is called only the first time that the switch happen.
  // XXX this makes sense only in P2P mode, while in standard mode is
  // impossible to know the state of the consumers so it should not be used.
  bool consumer_in_sync_;
  interface::ProducerInterestCallback on_consumer_in_sync_;

  // Save FEC packets here before sending them
  std::queue<ContentObject::Ptr> pending_fec_packets_;
  std::queue<std::pair<uint64_t, ContentObject::Ptr>> paced_fec_packets_;
  bool pending_fec_pace_;

  // Save application packets if they are small
  std::queue<std::unique_ptr<utils::MemBuf>> waiting_app_packets_;
  uint16_t max_len_;       // len of the largest packet
  uint16_t queue_len_;     // total size of all packet in the queue
  bool data_aggregation_;  // turns on/off data aggregation
  // timer to check the queue len
  std::unique_ptr<asio::steady_timer> app_packets_timer_;
  bool data_aggregation_timer_switch_;  // bool to check if the timer is on

  // Manifest
  std::queue<std::pair<uint32_t, auth::CryptoHash>>
      manifest_entries_;  // map a packet suffix to a packet hash
};

}  // namespace protocol

}  // end namespace transport