meta: Add `GstNetControlMessageMeta`
authorWilliam Manley <will@williammanley.net>
Thu, 30 Oct 2014 15:39:21 +0000 (15:39 +0000)
committerWim Taymans <wtaymans@redhat.com>
Sat, 14 Mar 2015 12:54:51 +0000 (13:54 +0100)
commitfc765592a14b7e10d3623ace5ba2550dde0ebb44
tree746496d9f4ce96b54ccdbdb36cd03d5b9f246fb9
parent7f6b11a5b2c508a4b2d9887c018c3bdec9c12b66
meta: Add `GstNetControlMessageMeta`

GstNetAddress can be used to store ancillary data which was received with
or is to be sent alongside the buffer data.  When used with socket sinks
and sources which understand this meta it allows sending and receiving
ancillary data such as unix credentials (See `GUnixCredentialsMessage`)
and Unix file descriptions (See `GUnixFDMessage`).

This will be useful for implementing protocols which use file-descriptor
passing in payloaders/depayloaders without having to re-implement all the
socket handling code already present in elements such as multisocketsink,
etc.  This, in turn, will be useful for implementing zero-copy video IPC.

This meta uses the platform independent `GSocketControlMessage` API
provided by GLib as a part of GIO.  As a result this new meta does not
require any new dependencies or any conditional compliation for
portablility, although it is unlikely to do anything useful on non-UNIX
platforms.
docs/libs/gstreamer-libs-sections.txt
libs/gst/net/Makefile.am
libs/gst/net/gstnetcontrolmessagemeta.c [new file with mode: 0644]
libs/gst/net/gstnetcontrolmessagemeta.h [new file with mode: 0644]