tests: add example for injecting MPEG-TS sections

basetsmux: preserve user-specified sections across resets

As sections can be provided by the user through send_event
when the element state is NULL, their lifetime is expected
to match that of the muxer, and they must be preserved when
the state changes

atscmux: send empty RRT / MGT / STT tables

These are mandated by A/65, their absence gets flagged by
stream analyzers. Users can of course provide filled up
versions through the send_event API.

tsmux: maintain packet counters in a global array

We can have multiple TsMuxPacketInfo objects for the same PID
with user-provided sections, for example ATSC requires multiple
tables with the same PID.

mpegts: extend support for ATSC tables

Adds constructors for the following sections:

STT: System Time Table
MGT: Master Guide Table
RRT: Rating Region Table

Also adds parsing code for RRT

webrtc: only set sctp ports if they are different

SCTPassociation will complain if we do that while running and resetting
is not something we support at the moment

tests/webrtc: wait until the SDP has been set before continuing

If we renegotiate, then it is currently possible for an added stream to
be added to webrtcbin before the SDP is complete.  This causes an
internal inconsistency as there is a 'pending sink transceiver' without
a corresponding media section in the sdp.  It also does not have an
associated transport stream and will fail in _connect_input_stream().

tests/webrtc: fix racy test with a prenegotiated data channel

If both data channels become ready simultaneously, then the two integer
read-add-update cycles can execute concurrently and only ever increment
once instead of the required twice.  Use an atomic add instead.

webrtc/dc: move some code from webrtcbin into the datachannel

webrtc: hold onto any unknown ICE candidates until the next SDP set

It is very possible for badly behaving signalling or peers to send
us ICE candidates before we receive an SDP.  While we had consideration
for that on the first set SDP, subsequent SDP's could result in
misconfigured ICE transports.  Expand the previous code to also take
into account reconfigurations.

webrtc: Initial support for stream addition/removal

Limitations:
- No transport changes at all (ICE, DTLS)
- Codec changes are untested and probably don't work
- Stream removal doesn't remove transports (i.e. non-bundled transports
  will stay around until webrtcbin is shutdown)
- Unified Plan SDP only. No Plan-B support.

tests/webrtc: a couple of debug/error string fixes

tests/webrtc: rewrite bundle checks for separate validate_sdp passes

Improves reusability

tests/webrtc: add helper for getting the offer/answer element

tests/webrtc: only check audio/video for direction attributes

webrtcbin: expose the transceiver as a pad property

webrtc/transceiver: add a set_direction function

Matches the setDirection() from the W3C spec and allows changing the
transceiver direction at the next negotiation cycle.

webrtc: track and log more rtpbin state

like bye's timeouts, validation, activation, etc

webrtc: add support for intersecting inactive transceiver directions

webrtc: mark remote/local-description as readonly

webrtc: don't reuse stopped transceivers at all

webrtc: also check for a null mid to signify an unassociated transceiver

We always give our transceivers an mline on creation so that check is
not useful by itself

webrtc: only check sink pads for a 'sink pads have caps' check

webrtc: fix answer creation with multiple streams and similar caps

tests/webrtc: factor out sdp validation into a single function

tests/webrtc: validate number of sdp media using validate_sdp

tests/webrtc: allow multiple validation functions

tests/webrtc: test that duplicate negotiations succeed

webrtcbin: Expose current and pending local/remote description properties

They are already handled in the property getter and setter functions but were
not formally declared in the GObject class.

doc: remove xml from comments

ext/hls/meson.build: fix dependency logic

Currently, if one was to set -Dhls-crypto to either libgcrypt or openssl
instead of auto, the following lines would fail because hls_crypto_dep is not
yet set:

if not hls_crypto_dep.found() and ['auto', 'libgcrypt'].contains(hls_crypto)
if not hls_crypto_dep.found() and ['auto', 'openssl'].contains(hls_crypto)

Instead, change "if not hls_crypto_dep.found()" to "if not have_hls_crypto"
which fixes the error.

docs: remove stale plugins from docs plugin cache

gtk plugin has moved to -good, schroedinger has been removed.

waylandsink: Workaround gnome-shell bug

Use a timeout to limit that amount of time we wait after the compositor
for the initial configure event. Compositor are support to emit a
configure event before any wl_buffer can be attached. The problem is
that Weston strongly enforce this, while gnome-shell simply does not
emit such an event.

kmssink: Fixup all errno tracing

All DRM ioctl uses errno to report the error and simply returns -1
when some error occured. This patch fixes all usage of the return
value instead of errno to trace the error type and moves to g_strerror
instead of string.h strerror in order to be consistent with the rest
of GStreamer.

doc: update plugin cache

docs: Updated plugins cache file

This was done so that the duplicated rist element would go way.

doc: fix element section documentations

Element sections were not rendered anymore after the hotdoc
port, fixing this revealed a few incorrect links.

codecparsers: fix debug category initialisation

Make thread-safe.

avwait: Protect properties and some other code with the mutex

These variables are all accessed from multiple threads.

Also fix some minor leaks in error code paths.

avwait: Insert some empty lines to give the code some space to breath

avwait: Allow setting start timecode after end timecode and the other way around

This might be necessary temporarily for changing the previous settings.
Make it an actual error if the settings are like this while processing a
buffer.

wayland/wlbuffer: just return if used_by_compositor is true when attach

When buffer is used by compositor, we don't need attach it and hold one
more reference. Just check used_by_compositor, just return if it is true.
Assert error log is not need, this is normal behavior.

proxy: Forward queries/events sent directly to the element correctly

proxy: Set SOURCE flag on the source and SINK flag on the sink

So that they are properly recognized as such.

ivfparse: Check the data size against IVF_FRAME_HEADER_SIZE

It is parsing frame data and so should check the data size against the
frame header size instead of the file header size. If don't, it is
possible to drop the last frame because IVF_FILE_HEADER_SIZE is greater
than IVF_FRAME_HEADER_SIZE

doc: Add rist plugin to hotdoc

rist: Add combined bonding-method support

This patchs add support for configuring the bonding method used. There is
two method specified

 - redundant: All the RTP packets are replicated
 - combined: RTP packet are evenly distributed over each links

Additionally, an application can set the "dispatcher" property in order
to implement custom dispatching method. Whenever the "dispatcher"
property is set, "bonding-method" property will be ignored.

ristsrc: Implement per session stats

As we can now have multiple sessions, stats need to be implemented per
session. This follow RTPSession model with sources. The stats are now:

    dropped: 0
    received: 0
    recovered: 0
    permanently-lost: 0
    duplicates: 0
    retransmission-requests-sent: 0
    rtx-roundtrip-time: 0
    session-stats:
        session-id=0
            rtp-from=""
            rtcp-from=""
            dropped=0
            received=0
        session-id=1
            rtp-from=""
            rtcp-from=""
            dropped=0
            received=0
        . . .

session-stats is a GValueArray as there is no better alternatives.

ristsrc: Cleanup unused include

ristsink: Implement per session stats

As we can now have multiple sessions, stats need to be implemented per
session. This follow RTPSession model with sources. The stats are now:

  sent-original-packets: 0
  sent-retransmitted-packets: 0
       session-stats:
            session-id=0
              sent-original-packets=0
              sent-retransmitted-packets=0
              round-trip-time=0
            session-id=1
              sent-original-packets=0
              sent-retransmitted-packets=0
              round-trip-time=0
            . . .

session-stats is a GValueArray as there is no better alternatives.

ristsrc: rtxbin may be null in finalize

ristsrc: Add bonding support

This add support for receiving and aggregating the same stream
over multiple addresses.

ristsink: Implement bonding support

rist: spell and grammar corrects in top comments

docs: Update cache and mark some rist prop as 'show-default'

doc: Add proxysink/proxysrc

webrtc: Add various Since markers to new types after 1.14.0

mpegtsmux: Fix build warning error

gstmpegtsmux.c:291:3: error: implicit declaration of function ‘memmove’ [-Werror=implicit-function-declaration]
   memmove (map.data + 4, map.data, map.size - 4);
   ^
gstmpegtsmux.c:291:3: error: incompatible implicit declaration of built-in function ‘memmove’ [-Werror]
gstmpegtsmux.c:291:3: note: include ‘<string.h>’ or provide a declaration of ‘memmove’

basetsmux: improve bitrate property documentation

tsmux: refactor logic for when to (re)transmit tables

In order to output them at regular intervals in the bitstream
when a bitrate is specified.

basetsmux: fix PCR stream selection

Fix compile after aggregator rewrite and base class refactor

tsmux: fix continuity counter for packets with no payload

mpegtsmux: aggregator port

mpegtsmux: spring cleanup, no functional change

basetsmux: extract m2ts-mode to mpegtsmux

mpegtsmux: extract an actual base class

mpegtsmux: expose the vmethods necessary for ATSC E-AC-3 handling

mpegtsmux: provide API for subclasses to override stream creation

mpegtsmux: add an ATSC subclass

tsmux: Calculate PCR from number of bytes written in CBR mode

mpegtsmux: Expose bitrate property

This allows outputting a Transport Stream with a constant bitrate,
by inserting null packets.

tsmux: actually respect the PCR frequency we target

tsmux: Use DTS over PTS

meson: Keep track of the aom plugin

Otherwise it doesn't appear in the GstPluginsPath.json and thus is not listed in
gst-build's uninstalled shell's $GST_PLUGIN_PATH.

docs: Update plugins cache for nvdec/nvenc

meson: Add nvenc and nvdec to plugin list when available

rist: Fix typo

webrtc: Fix some signals' GIR annotations

This will lead to wrong bindings otherwise (and creates more correct
expectations for developers).

docs: Add infos about windows specific plugins

docs: Stop building the doc cache by default

And update the cache

Fixes https://gitlab.freedesktop.org/gstreamer/gst-docs/issues/36

docs: Add gstrist to the documentation

msdk: fix the typo for gst_msdkvp9dec_debug

configure: fix autotools build after gtk-doc removal

Were using a gtk-doc specific file to check if we can
find the srcdir, so configure would fail.

docs: Make sure frei0r plugins properties default are stable

frei0r returns 'random' values as default and it makes the cache
often change for no good reason

docs: Remove stereo and openglmixer from the cache

Thus were moved, respectively, to -good and -base

dtlsagent: Do not overwrite openssl locking callbacks

docs: Update plugins documentation cache

docs: Build documentation with hotdoc

Mark some properties as DOC_SHOW_DEFAULT

Minor documentation fixes

directfb: Fixup plugin name to match plugin filename

Has required by the new PLUGIN_DEFINE macro

meson: Fix missing GSM_HEADER_IN_SUBDIR logic

Until now, this hadn't been translated from autoconf yet.

meson: Fix typo in gsm header file name

This was wrong since commit c360ceea4deb5d56c94126e31b9614734e8c1a7e.

Also fix incorrect indentation (tab instead of spaces).

Found using hermetic builds with Nix:

    https://github.com/NixOS/nixpkgs/pull/54398#discussion_r280125735

srt: set cancellation in locked section

... to avoid race with wait which uses it with 'flushing' flag state semantics.

srt: avoid srtsrc segfault upon downward state change

... when it has not yet been connected to.

Also, a condition variable is not a semaphore, so a lock/wait/unlock
sequence is inherently racy without any state checking.  So switch to
a different lock and check the intended state.

srt: initialize list access within locked region

webrtc: Fix signals documentation

Some GIR annotations were incorrect or even missing. The former isn't
good for bindings, while the latter is especially annoying for signal
handlers, as that means your arguments will get the wrong names in the
rendered documentation.

nvenc: Respect display aspect ratio and set to encoding parameter

It should be written in VUI parameter for proper rendering

webrtc: Add g_autoptr() support for public types