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
|
/*
* SRT - Secure, Reliable, Transport
* Copyright (c) 2019 Haivision Systems Inc.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
*/
#include "platform_sys.h"
#include <string>
#include <map>
#include <vector>
#include <deque>
#include <iterator>
#include "packetfilter.h"
#include "packetfilter_builtin.h"
#include "core.h"
#include "packet.h"
#include "logging.h"
using namespace std;
using namespace srt_logging;
using namespace srt::sync;
bool srt::ParseFilterConfig(const string& s, SrtFilterConfig& w_config, PacketFilter::Factory** ppf)
{
if (!SrtParseConfig(s, (w_config)))
return false;
PacketFilter::Factory* fac = PacketFilter::find(w_config.type);
if (!fac)
return false;
if (ppf)
*ppf = fac;
// Extract characteristic data
w_config.extra_size = fac->ExtraSize();
return true;
}
bool srt::ParseFilterConfig(const string& s, SrtFilterConfig& w_config)
{
return ParseFilterConfig(s, (w_config), NULL);
}
// Parameters are passed by value because they need to be potentially modicied inside.
bool srt::CheckFilterCompat(SrtFilterConfig& w_agent, SrtFilterConfig peer)
{
PacketFilter::Factory* fac = PacketFilter::find(w_agent.type);
if (!fac)
return false;
SrtFilterConfig defaults;
if (!ParseFilterConfig(fac->defaultConfig(), (defaults)))
{
return false;
}
set<string> keys;
// Extract all keys to identify also unspecified parameters on both sides
// Note that theoretically for FEC it could simply check for the "cols" parameter
// that is the only mandatory one, but this is a procedure for packet filters in
// general and every filter may define its own set of parameters and mandatory rules.
for (map<string, string>::iterator x = w_agent.parameters.begin(); x != w_agent.parameters.end(); ++x)
{
keys.insert(x->first);
if (peer.parameters.count(x->first) == 0)
peer.parameters[x->first] = x->second;
}
for (map<string, string>::iterator x = peer.parameters.begin(); x != peer.parameters.end(); ++x)
{
keys.insert(x->first);
if (w_agent.parameters.count(x->first) == 0)
w_agent.parameters[x->first] = x->second;
}
HLOGC(cnlog.Debug, log << "CheckFilterCompat: re-filled: AGENT:" << Printable(w_agent.parameters)
<< " PEER:" << Printable(peer.parameters));
// Complete nonexistent keys with default values
for (map<string, string>::iterator x = defaults.parameters.begin(); x != defaults.parameters.end(); ++x)
{
if (!w_agent.parameters.count(x->first))
w_agent.parameters[x->first] = x->second;
if (!peer.parameters.count(x->first))
peer.parameters[x->first] = x->second;
}
for (set<string>::iterator x = keys.begin(); x != keys.end(); ++x)
{
// Note: operator[] will insert an element with default value
// if it doesn't exist. This will inject the empty string as value,
// which is acceptable.
if (w_agent.parameters[*x] != peer.parameters[*x])
{
LOGC(cnlog.Error, log << "Packet Filter (" << defaults.type << "): collision on '" << (*x)
<< "' parameter (agent:" << w_agent.parameters[*x] << " peer:" << (peer.parameters[*x]) << ")");
return false;
}
}
// Mandatory parameters will be checked when trying to create the filter object.
return true;
}
namespace srt {
struct SortBySequence
{
bool operator()(const CUnit* u1, const CUnit* u2)
{
int32_t s1 = u1->m_Packet.getSeqNo();
int32_t s2 = u2->m_Packet.getSeqNo();
return CSeqNo::seqcmp(s1, s2) < 0;
}
};
} // namespace srt
void srt::PacketFilter::receive(CUnit* unit, std::vector<CUnit*>& w_incoming, loss_seqs_t& w_loss_seqs)
{
const CPacket& rpkt = unit->m_Packet;
if (m_filter->receive(rpkt, w_loss_seqs))
{
// For the sake of rebuilding MARK THIS UNIT GOOD, otherwise the
// unit factory will supply it from getNextAvailUnit() as if it were not in use.
unit->m_bTaken = true;
HLOGC(pflog.Debug, log << "FILTER: PASSTHRU current packet %" << unit->m_Packet.getSeqNo());
w_incoming.push_back(unit);
}
else
{
// Packet not to be passthru, update stats
ScopedLock lg(m_parent->m_StatsLock);
m_parent->m_stats.rcvr.recvdFilterExtra.count(1);
}
// w_loss_seqs enters empty into this function and can be only filled here. XXX ASSERT?
for (loss_seqs_t::iterator i = w_loss_seqs.begin();
i != w_loss_seqs.end(); ++i)
{
// Sequences here are low-high, if there happens any negative distance
// here, simply skip and report IPE.
int dist = CSeqNo::seqoff(i->first, i->second) + 1;
if (dist > 0)
{
ScopedLock lg(m_parent->m_StatsLock);
m_parent->m_stats.rcvr.lossFilter.count(dist);
}
else
{
LOGC(pflog.Error, log << "FILTER: IPE: loss record: invalid loss: %"
<< i->first << " - %" << i->second);
}
}
// Pack first recovered packets, if any.
if (!m_provided.empty())
{
HLOGC(pflog.Debug, log << "FILTER: inserting REBUILT packets (" << m_provided.size() << "):");
size_t nsupply = m_provided.size();
InsertRebuilt(w_incoming, m_unitq);
ScopedLock lg(m_parent->m_StatsLock);
m_parent->m_stats.rcvr.suppliedByFilter.count((uint32_t)nsupply);
}
// Now that all units have been filled as they should be,
// SET THEM ALL FREE. This is because now it's up to the
// buffer to decide as to whether it wants them or not.
// Wanted units will be set GOOD flag, unwanted will remain
// with FREE and therefore will be returned at the next
// call to getNextAvailUnit().
unit->m_bTaken = false;
for (vector<CUnit*>::iterator i = w_incoming.begin(); i != w_incoming.end(); ++i)
{
CUnit* u = *i;
u->m_bTaken = false;
}
// Packets must be sorted by sequence number, ascending, in order
// not to challenge the SRT's contiguity checker.
sort(w_incoming.begin(), w_incoming.end(), SortBySequence());
// For now, report immediately the irrecoverable packets
// from the row.
// Later, the `irrecover_row` or `irrecover_col` will be
// reported only, depending on level settings. For example,
// with default LATELY level, packets will be reported as
// irrecoverable only when they are irrecoverable in the
// vertical group.
// With "always", do not report any losses, SRT will simply check
// them itself.
return;
}
bool srt::PacketFilter::packControlPacket(int32_t seq, int kflg, CPacket& w_packet)
{
bool have = m_filter->packControlPacket(m_sndctlpkt, seq);
if (!have)
return false;
// Now this should be repacked back to CPacket.
// The header must be copied, it's always part of CPacket.
uint32_t* hdr = w_packet.getHeader();
memcpy((hdr), m_sndctlpkt.hdr, SRT_PH_E_SIZE * sizeof(*hdr));
// The buffer can be assigned.
w_packet.m_pcData = m_sndctlpkt.buffer;
w_packet.setLength(m_sndctlpkt.length);
// This sets only the Packet Boundary flags, while all other things:
// - Order
// - Rexmit
// - Crypto
// - Message Number
// will be set to 0/false
w_packet.set_msgflags(SRT_MSGNO_CONTROL | MSGNO_PACKET_BOUNDARY::wrap(PB_SOLO));
// ... and then fix only the Crypto flags
w_packet.setMsgCryptoFlags(EncryptionKeySpec(kflg));
// Don't set the ID, it will be later set for any kind of packet.
// Write the timestamp clip into the timestamp field.
return true;
}
void srt::PacketFilter::InsertRebuilt(vector<CUnit*>& incoming, CUnitQueue* uq)
{
if (m_provided.empty())
return;
for (vector<SrtPacket>::iterator i = m_provided.begin(); i != m_provided.end(); ++i)
{
CUnit* u = uq->getNextAvailUnit();
if (!u)
{
LOGC(pflog.Error, log << "FILTER: LOCAL STORAGE DEPLETED. Can't return rebuilt packets.");
break;
}
// LOCK the unit as taken because otherwise the next
// call to getNextAvailUnit will return THE SAME UNIT.
u->m_bTaken = true;
// After returning from this function, all units will be
// set back to FREE so that the buffer can decide whether
// it wants them or not.
CPacket& packet = u->m_Packet;
memcpy((packet.getHeader()), i->hdr, CPacket::HDR_SIZE);
memcpy((packet.m_pcData), i->buffer, i->length);
packet.setLength(i->length);
HLOGC(pflog.Debug, log << "FILTER: PROVIDING rebuilt packet %" << packet.getSeqNo());
incoming.push_back(u);
}
m_provided.clear();
}
bool srt::PacketFilter::IsBuiltin(const string& s)
{
return builtin_filters.count(s);
}
namespace srt {
std::set<std::string> PacketFilter::builtin_filters;
PacketFilter::filters_map_t PacketFilter::filters;
}
srt::PacketFilter::Factory::~Factory()
{
}
void srt::PacketFilter::globalInit()
{
// Add here builtin packet filters and mark them
// as builtin. This will disallow users to register
// external filters with the same name.
filters["fec"] = new Creator<FECFilterBuiltin>;
builtin_filters.insert("fec");
}
bool srt::PacketFilter::configure(CUDT* parent, CUnitQueue* uq, const std::string& confstr)
{
m_parent = parent;
SrtFilterConfig cfg;
if (!ParseFilterConfig(confstr, (cfg)))
return false;
// Extract the "type" key from parameters, or use
// builtin if lacking.
filters_map_t::iterator selector = filters.find(cfg.type);
if (selector == filters.end())
return false;
SrtFilterInitializer init;
init.socket_id = parent->socketID();
init.snd_isn = parent->sndSeqNo();
init.rcv_isn = parent->rcvSeqNo();
// XXX This is a formula for a full "SRT payload" part that undergoes transmission,
// might be nice to have this formula as something more general.
init.payload_size = parent->OPT_PayloadSize() + parent->getAuthTagSize();
init.rcvbuf_size = parent->m_config.iRcvBufSize;
HLOGC(pflog.Debug, log << "PFILTER: @" << init.socket_id << " payload size="
<< init.payload_size << " rcvbuf size=" << init.rcvbuf_size);
// Found a filter, so call the creation function
m_filter = selector->second->Create(init, m_provided, confstr);
if (!m_filter)
return false;
m_unitq = uq;
// The filter should have pinned in all events
// that are of its interest. It's stated that
// it's ready after creation.
return true;
}
bool srt::PacketFilter::correctConfig(const SrtFilterConfig& conf)
{
const string* pname = map_getp(conf.parameters, "type");
if (!pname)
return true; // default, parameters ignored
if (*pname == "adaptive")
return true;
filters_map_t::iterator x = filters.find(*pname);
if (x == filters.end())
return false;
return true;
}
srt::PacketFilter::~PacketFilter()
{
delete m_filter;
}
|