mirror of
https://gitlab.freedesktop.org/pulseaudio/pulseaudio.git
synced 2025-11-12 13:30:10 -05:00
27d0a3b388
Now that we have the necessary infrastructure to memexport and mempimport a memfd memblock, extend that support higher up in the chain with pstreams. A PA endpoint can now _transparently_ send a memfd memblock to the other end by simply calling pa_pstream_send_memblock() – provided the block's memfd pool was earlier registered with the pstream. If the pipe does not support memfd transfers, we fall back to sending the block's full data instead of just its reference. ** Further details: A single pstream connection usually transfers blocks from multiple pools including the server's srbchannel mempool, the client's audio data mempool, and the server's global core mempool. If these mempools are memfd-backed, we now require registering them with the pstream before sending any blocks they cover. This is done to minimize fd passing overhead and avoid fd leaks. Moreover, to support all these pools without hard-coding their number or nature in the Pulse communication protocol itself, a new REGISTER_MEMFD_SHMID command is introduced. That command can be sent _anytime_ during the pstream's lifetime and is used for creating on demand SHM ID to memfd mappings. Suggested-by: David Henningsson <david.henningsson@canonical.com> Signed-off-by: Ahmed S. Darwish <darwish.07@gmail.com>
76 lines
3.2 KiB
C
76 lines
3.2 KiB
C
#ifndef foopstreamhfoo
|
|
#define foopstreamhfoo
|
|
|
|
/***
|
|
This file is part of PulseAudio.
|
|
|
|
Copyright 2004-2006 Lennart Poettering
|
|
Copyright 2006 Pierre Ossman <ossman@cendio.se> for Cendio AB
|
|
|
|
PulseAudio is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU Lesser General Public License as
|
|
published by the Free Software Foundation; either version 2.1 of the
|
|
License, or (at your option) any later version.
|
|
|
|
PulseAudio is distributed in the hope that it will be useful, but
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
License along with PulseAudio; if not, see <http://www.gnu.org/licenses/>.
|
|
***/
|
|
|
|
#include <inttypes.h>
|
|
|
|
#include <pulse/mainloop-api.h>
|
|
#include <pulse/def.h>
|
|
|
|
#include <pulsecore/packet.h>
|
|
#include <pulsecore/memblock.h>
|
|
#include <pulsecore/iochannel.h>
|
|
#include <pulsecore/srbchannel.h>
|
|
#include <pulsecore/memchunk.h>
|
|
#include <pulsecore/creds.h>
|
|
#include <pulsecore/macro.h>
|
|
|
|
typedef struct pa_pstream pa_pstream;
|
|
|
|
typedef void (*pa_pstream_packet_cb_t)(pa_pstream *p, pa_packet *packet, pa_cmsg_ancil_data *ancil_data, void *userdata);
|
|
typedef void (*pa_pstream_memblock_cb_t)(pa_pstream *p, uint32_t channel, int64_t offset, pa_seek_mode_t seek, const pa_memchunk *chunk, void *userdata);
|
|
typedef void (*pa_pstream_notify_cb_t)(pa_pstream *p, void *userdata);
|
|
typedef void (*pa_pstream_block_id_cb_t)(pa_pstream *p, uint32_t block_id, void *userdata);
|
|
|
|
pa_pstream* pa_pstream_new(pa_mainloop_api *m, pa_iochannel *io, pa_mempool *p);
|
|
|
|
pa_pstream* pa_pstream_ref(pa_pstream*p);
|
|
void pa_pstream_unref(pa_pstream*p);
|
|
|
|
void pa_pstream_unlink(pa_pstream *p);
|
|
|
|
int pa_pstream_attach_memfd_shmid(pa_pstream *p, unsigned shm_id, int memfd_fd);
|
|
|
|
void pa_pstream_send_packet(pa_pstream*p, pa_packet *packet, pa_cmsg_ancil_data *ancil_data);
|
|
void pa_pstream_send_memblock(pa_pstream*p, uint32_t channel, int64_t offset, pa_seek_mode_t seek, const pa_memchunk *chunk);
|
|
void pa_pstream_send_release(pa_pstream *p, uint32_t block_id);
|
|
void pa_pstream_send_revoke(pa_pstream *p, uint32_t block_id);
|
|
|
|
void pa_pstream_set_receive_packet_callback(pa_pstream *p, pa_pstream_packet_cb_t cb, void *userdata);
|
|
void pa_pstream_set_receive_memblock_callback(pa_pstream *p, pa_pstream_memblock_cb_t cb, void *userdata);
|
|
void pa_pstream_set_drain_callback(pa_pstream *p, pa_pstream_notify_cb_t cb, void *userdata);
|
|
void pa_pstream_set_die_callback(pa_pstream *p, pa_pstream_notify_cb_t cb, void *userdata);
|
|
void pa_pstream_set_release_callback(pa_pstream *p, pa_pstream_block_id_cb_t cb, void *userdata);
|
|
void pa_pstream_set_revoke_callback(pa_pstream *p, pa_pstream_block_id_cb_t cb, void *userdata);
|
|
|
|
bool pa_pstream_is_pending(pa_pstream *p);
|
|
|
|
void pa_pstream_enable_shm(pa_pstream *p, bool enable);
|
|
void pa_pstream_enable_memfd(pa_pstream *p);
|
|
bool pa_pstream_get_shm(pa_pstream *p);
|
|
bool pa_pstream_get_memfd(pa_pstream *p);
|
|
|
|
/* Enables shared ringbuffer channel. Note that the srbchannel is now owned by the pstream.
|
|
Setting srb to NULL will free any existing srbchannel. */
|
|
void pa_pstream_set_srbchannel(pa_pstream *p, pa_srbchannel *srb);
|
|
|
|
#endif
|