ALSA: pcm: anonymous dup implementation
Jaroslav Kysela
maintainerv6 cover ALSA: pcm: anonymous dup implementation
This patchset contains the anonymous dup implementation with permissions checking for the ALSA's PCM interface in kernel to enable the restricted DMA sound buffer sharing for the restricted tasks.
The code was tested through qemu and it seems to be pretty stable.
The initial tinyalsa implementation can be found here:
https://github.com/perexg/tinyalsa/commits/anondup
The filtering might be refined. It depends on the real requirements. Perhaps, we may create more ioctl groups. Any comments are more than welcome.
v2 of the patches:
- change clone parameter to subdevice number for the pcm attach
- change SNDRV_PCM_PERM_MAX to SNDRV_PCM_PERM_MASK
- the tinyalsa implementation was a little updated (restructured)
v3 of the patches:
- group integer declarations in snd_pcm_anonymous_dup()
- replaced substream->pcm with pcm in snd_pcm_anonymous_dup()
- added SNDRV_PCM_PERM_RW check for read/write/readv/writev syscalls
v4 of the patches:
- more simple restriction control (only two modes - full/buffer)
- the tinyalsa implementation follows this change
v5 of the patches:
- merge pcm_..._mmap_allowed fcns to the snd_pcm_mmap_... fcns
v6:
- add proper open_mutex protection for snd_pcm_open_file()
Jaroslav Kysela (3):
ALSA: pcm: implement the anonymous dup (inode file descriptor)
ALSA: pcm: merge pcm_..._mmap_allowed fcns to the snd_pcm_mmap_...
fcns
ALSA: pcm: implement the mmap buffer mode for the anonymous dup
include/sound/pcm.h | 10 +-- include/uapi/sound/asound.h | 6 +- sound/core/oss/pcm_oss.c | 2 +- sound/core/pcm.c | 13 ++-- sound/core/pcm_compat.c | 1 + sound/core/pcm_native.c | 154 +++++++++++++++++++++++++++++++++----------- 6 files changed, 133 insertions(+), 53 deletions(-)
Signature · 1 line
2.13.6
Jaroslav Kysela
maintainerPATCH v6 1/3 ALSA: pcm: implement the anonymous dup (inode file descriptor)
This patch implements new SNDRV_PCM_IOCTL_ANONYMOUS_DUP ioctl which returns the new duplicated anonymous inode file descriptor (anon_inode:snd-pcm) which can be passed to the restricted clients.
This patch is meant to be the alternative for the dma-buf interface. Both implementation have some pros and cons:
anon_inode:dmabuf
- a bit standard export API for the DMA buffers
- fencing for the concurrent access [1]
- driver/kernel interface for the DMA buffer [1]
- multiple attach/detach scheme [1]
[1] the real usage for the sound PCM is unknown at the moment for this feature
anon_inode:snd-pcm
- simple (no problem with ref-counting, non-standard mmap implementation etc.)
- allow to use more sound interfaces for the file descriptor like status ioctls
- more fine grained security policies (another anon_inode name unshared with other drivers)
--- include/sound/pcm.h | 8 +++--- include/uapi/sound/asound.h | 3 +- sound/core/oss/pcm_oss.c | 2 +- sound/core/pcm.c | 13 ++++----- sound/core/pcm_compat.c | 1 + sound/core/pcm_native.c | 69 +++++++++++++++++++++++++++++++++++++++++---- 6 files changed, 77 insertions(+), 19 deletions(-)
include/sound/pcm.h +4 -4
@@ -579,11 +579,11 @@ static inline int snd_pcm_suspend_all(struct snd_pcm *pcm) }#endif int snd_pcm_kernel_ioctl (struct snd_pcm_substream *substream,unsigned int cmd,void *arg); -int snd_pcm_open_substream (struct snd_pcm *pcm,int stream,struct file *file, -struct snd_pcm_substream **rsubstream); +int snd_pcm_open_substream (struct snd_pcm *pcm,int stream,int subdevice, +struct file *file,struct snd_pcm_substream **rsubstream);void snd_pcm_release_substream (struct snd_pcm_substream *substream); -int snd_pcm_attach_substream (struct snd_pcm *pcm,int stream,struct file *file, -struct snd_pcm_substream **rsubstream); +int snd_pcm_attach_substream (struct snd_pcm *pcm,int stream,int subdevice, +struct file *file,struct snd_pcm_substream **rsubstream);void snd_pcm_detach_substream (struct snd_pcm_substream *substream);int snd_pcm_mmap_data (struct snd_pcm_substream *substream,struct file *file,struct vm_area_struct *area);
include/uapi/sound/asound.h +2 -1
@@ -153,7 +153,7 @@ struct snd_hwdep_dsp_image {* * *****************************************************************************/ -#define SNDRV_PCM_VERSION SNDRV_PROTOCOL_VERSION(2, 0, 14) +#define SNDRV_PCM_VERSION SNDRV_PROTOCOL_VERSION(2, 0, 15)typedef unsigned long snd_pcm_uframes_t ;typedef signed long snd_pcm_sframes_t ;
@@ -576,6 +576,7 @@ enum {#define SNDRV_PCM_IOCTL_TSTAMP _IOW('A', 0x02, int)#define SNDRV_PCM_IOCTL_TTSTAMP _IOW('A', 0x03, int)#define SNDRV_PCM_IOCTL_USER_PVERSION _IOW('A', 0x04, int) +#define SNDRV_PCM_IOCTL_ANONYMOUS_DUP _IOWR('A', 0x05, int)#define SNDRV_PCM_IOCTL_HW_REFINE _IOWR('A', 0x10, struct snd_pcm_hw_params)#define SNDRV_PCM_IOCTL_HW_PARAMS _IOWR('A', 0x11, struct snd_pcm_hw_params)#define SNDRV_PCM_IOCTL_HW_FREE _IO('A', 0x12)
sound/core/oss/pcm_oss.c +1 -1
@@ -2420,7 +2420,7 @@ static int snd_pcm_oss_open_file(struct file *file,if (! (f_mode &FMODE_READ ))continue ; } - err =snd_pcm_open_substream (pcm, idx, file, &substream); + err =snd_pcm_open_substream (pcm, idx,-1 , file, &substream);if (err <0 ) {snd_pcm_oss_release_file (pcm_oss_file);return err;
sound/core/pcm.c +5 -8
@@ -918,15 +918,14 @@ static int snd_pcm_dev_free(struct snd_device *device)return snd_pcm_free (pcm); } -int snd_pcm_attach_substream (struct snd_pcm *pcm,int stream, -struct file *file, +int snd_pcm_attach_substream (struct snd_pcm *pcm, +int stream,int subdevice,struct file *file,struct snd_pcm_substream **rsubstream) {struct snd_pcm_str * pstr;struct snd_pcm_substream *substream;struct snd_pcm_runtime *runtime;struct snd_card *card; -int prefer_subdevice;size_t size;if (snd_BUG_ON (!pcm || !rsubstream))
@@ -940,7 +939,6 @@ int snd_pcm_attach_substream(struct snd_pcm *pcm, int stream,return -ENODEV ; card = pcm->card; - prefer_subdevice =snd_ctl_get_preferred_subdevice (card,SND_CTL_SUBDEV_PCM );if (pcm->info_flags &SNDRV_PCM_INFO_HALF_DUPLEX ) {int opposite = !stream;
@@ -953,14 +951,14 @@ int snd_pcm_attach_substream(struct snd_pcm *pcm, int stream, }if (file->f_flags &O_APPEND ) { -if (prefer_subdevice <0 ) { +if (subdevice <0 ) {if (pstr->substream_count >1 )return -EINVAL ;/* must be unique */ substream = pstr->substream; }else {for (substream = pstr->substream; substream; substream = substream->next) -if (substream->number == prefer_subdevice) +if (substream->number == subdevice)break ; }if (! substream)
@@ -974,8 +972,7 @@ int snd_pcm_attach_substream(struct snd_pcm *pcm, int stream,for (substream = pstr->substream; substream; substream = substream->next) {if (!SUBSTREAM_BUSY (substream) && - (prefer_subdevice ==-1 || - substream->number == prefer_subdevice)) + (subdevice ==-1 || substream->number == subdevice))break ; }if (substream ==NULL )
sound/core/pcm_compat.c +1 -0
@@ -675,6 +675,7 @@ static long snd_pcm_ioctl_compat(struct file *file, unsigned int cmd, unsigned lcase SNDRV_PCM_IOCTL_TSTAMP :case SNDRV_PCM_IOCTL_TTSTAMP :case SNDRV_PCM_IOCTL_USER_PVERSION : +case SNDRV_PCM_IOCTL_ANONYMOUS_DUP :case SNDRV_PCM_IOCTL_HWSYNC :case SNDRV_PCM_IOCTL_PREPARE :case SNDRV_PCM_IOCTL_RESET :
sound/core/pcm_native.c +64 -5
122 lines not on this page · raw message
Signature · 1 line
2.13.6
Jaroslav Kysela
maintainerPATCH v6 2/3 ALSA: pcm: merge pcm_..._mmap_allowed fcns to the snd_pcm_mmap_... fcns
In reply to Jaroslav KyselaThere is no benefit to have this code separate. The result code is even smaller and simplier for the review. No functional change.
diffstat: 23 insertions(+), 34 deletions(-)
--- sound/core/pcm_native.c | 56 +++++++++++++++++++------------------------------ 1 file changed, 22 insertions(+), 34 deletions(-)
sound/core/pcm_native.c +22 -34
@@ -3297,6 +3297,16 @@ static int snd_pcm_mmap_status(struct snd_pcm_substream *substream, struct file struct vm_area_struct *area) {long size; +struct snd_pcm_file *pcm_file = file->private_data; +if (pcm_file->no_compat_mmap) +return -ENXIO ; +/* See snd_pcm_mmap_control() below. +* Since older alsa-lib requires both status and control mmaps to be +* coupled, we have to disable the status mmap for old alsa-lib, too. +*/ +if (pcm_file->user_pversion <SNDRV_PROTOCOL_VERSION (2 ,0 ,14 ) && + (pcm_file->substream->runtime->hw.info &SNDRV_PCM_INFO_SYNC_APPLPTR )) +return -ENXIO ;if (!(area->vm_flags &VM_READ ))return -EINVAL ; size = area->vm_end - area->vm_start;
@@ -3333,6 +3343,15 @@ static int snd_pcm_mmap_control(struct snd_pcm_substream *substream, struct file struct vm_area_struct *area) {long size; +struct snd_pcm_file *pcm_file = file->private_data; +if (pcm_file->no_compat_mmap) +return -ENXIO ; +/* Disallow the control mmap when SYNC_APPLPTR flag is set; +* it enforces the user-space to fall back to snd_pcm_sync_ptr(), +* thus it effectively assures the manual update of appl_ptr. +*/ +if (pcm_file->substream->runtime->hw.info &SNDRV_PCM_INFO_SYNC_APPLPTR ) +return -ENXIO ;if (!(area->vm_flags &VM_READ ))return -EINVAL ; size = area->vm_end - area->vm_start;
@@ -3344,50 +3363,23 @@ static int snd_pcm_mmap_control(struct snd_pcm_substream *substream, struct filereturn 0 ; } -static bool pcm_status_mmap_allowed (struct snd_pcm_file *pcm_file) -{ -if (pcm_file->no_compat_mmap) -return false; -/* See pcm_control_mmap_allowed() below. -* Since older alsa-lib requires both status and control mmaps to be -* coupled, we have to disable the status mmap for old alsa-lib, too. -*/ -if (pcm_file->user_pversion <SNDRV_PROTOCOL_VERSION (2 ,0 ,14 ) && - (pcm_file->substream->runtime->hw.info &SNDRV_PCM_INFO_SYNC_APPLPTR )) -return false; -return true; -} - -static bool pcm_control_mmap_allowed (struct snd_pcm_file *pcm_file) -{ -if (pcm_file->no_compat_mmap) -return false; -/* Disallow the control mmap when SYNC_APPLPTR flag is set; -* it enforces the user-space to fall back to snd_pcm_sync_ptr(), -* thus it effectively assures the manual update of appl_ptr. -*/ -if (pcm_file->substream->runtime->hw.info &SNDRV_PCM_INFO_SYNC_APPLPTR ) -return false; -return true; -} -#else /* ! coherent mmap */ +/* * don't support mmap for status and control records. */ -#define pcm_status_mmap_allowed (pcm_file) false -#define pcm_control_mmap_allowed (pcm_file) false -static int snd_pcm_mmap_status (struct snd_pcm_substream *substream,struct file *file,struct vm_area_struct *area) {return -ENXIO ; } +static int snd_pcm_mmap_control (struct snd_pcm_substream *substream,struct file *file,struct vm_area_struct *area) {return -ENXIO ; } +#endif /* coherent mmap */ static inline struct page *
@@ -3561,12 +3553,8 @@ static int snd_pcm_mmap(struct file *file, struct vm_area_struct *area) offset = area->vm_pgoff <<PAGE_SHIFT ;switch (offset) {case SNDRV_PCM_MMAP_OFFSET_STATUS : -if (!pcm_status_mmap_allowed (pcm_file)) -return -ENXIO ;return snd_pcm_mmap_status (substream, file, area);case SNDRV_PCM_MMAP_OFFSET_CONTROL : -if (!pcm_control_mmap_allowed (pcm_file)) -return -ENXIO ;return snd_pcm_mmap_control (substream, file, area);default :return snd_pcm_mmap_data (substream, file, area);
Signature · 1 line
2.13.6
Jaroslav Kysela
maintainerPATCH v6 3/3 ALSA: pcm: implement the mmap buffer mode for the anonymous dup
In reply to Jaroslav KyselaAndroid requires to allow the passing an anonymous inode file descriptor with the restricted functionality - only the mmap operation for the DMA sound buffer (anon_inode:snd-pcm-buffer). Android uses this access mode for the direct EXCLUSIVE sound device access by applications.
This requirement is for the proper SELinux audit.
--- include/sound/pcm.h | 2 ++ include/uapi/sound/asound.h | 3 +++ sound/core/pcm_native.c | 37 +++++++++++++++++++++++++++++++++---- 3 files changed, 38 insertions(+), 4 deletions(-)
include/sound/pcm.h +2 -0
@@ -227,6 +227,7 @@ struct snd_pcm_ops {struct snd_pcm_file {struct snd_pcm_substream *substream;int no_compat_mmap; +unsigned int perm;/* file descriptor permissions */ unsigned int user_pversion;/* supported protocol version */ };
@@ -537,6 +538,7 @@ struct snd_pcm {* Registering */ +extern const struct file_operations snd_pcm_f_op_buffer;extern const struct file_operations snd_pcm_f_ops[2 ]; int snd_pcm_new(struct snd_card *card, const char *id, int device,
include/uapi/sound/asound.h +3 -0
@@ -571,6 +571,9 @@ enum {#define SNDRV_CHMAP_PHASE_INVERSE (0x01 << 16)#define SNDRV_CHMAP_DRIVER_SPEC (0x02 << 16) +#define SNDRV_PCM_PERM_MODE_FULL 0/* full access - no restrictions */ +#define SNDRV_PCM_PERM_MODE_BUFFER 1/* allow to export only sound buffer through mmap */ +#define SNDRV_PCM_IOCTL_PVERSION _IOR('A', 0x00, int)#define SNDRV_PCM_IOCTL_INFO _IOR('A', 0x01, struct snd_pcm_info)#define SNDRV_PCM_IOCTL_TSTAMP _IOW('A', 0x02, int)
sound/core/pcm_native.c +33 -4
@@ -2502,6 +2502,7 @@ static int snd_pcm_open_file(struct file *file,return -ENOMEM ; } pcm_file->substream = substream; + pcm_file->perm =0 ;if (substream->ref_count ==1 ) substream->pcm_release = pcm_release_private; file->private_data = pcm_file;
@@ -2894,17 +2895,30 @@ static int snd_pcm_anonymous_dup(struct file *file,int fd, err, perm, flags;struct file *nfile;struct snd_pcm *pcm = substream->pcm; +struct snd_pcm_file *pcm_file; +const char *aname; +const struct file_operations *f_op;if (get_user (perm, arg))return -EFAULT ; -if (perm <0 ) -return -EPERM ; +switch (perm) { +case SNDRV_PCM_PERM_MODE_FULL : + aname ="snd-pcm" ; + f_op = file->f_op; +break ; +case SNDRV_PCM_PERM_MODE_BUFFER : + aname ="snd-pcm-buf" ; + f_op = &snd_pcm_f_op_buffer; +break ; +default : +return -EINVAL ; + } flags = file->f_flags & (O_ACCMODE |O_NONBLOCK ); flags |=O_APPEND |O_CLOEXEC ; fd =get_unused_fd_flags (flags);if (fd <0 )return fd; - nfile =anon_inode_getfile ("snd-pcm" , file->f_op,NULL , flags); + nfile =anon_inode_getfile (aname, f_op,NULL , flags);if (IS_ERR (nfile)) {put_unused_fd (fd);return PTR_ERR (nfile);
@@ -2922,11 +2936,14 @@ static int snd_pcm_anonymous_dup(struct file *file,mutex_lock (&pcm->open_mutex); err =snd_pcm_open_file (nfile, substream->pcm, substream->stream, substream->number); -mutex_unlock (&pcm->open_mutex);if (err >=0 ) { + pcm_file = nfile->private_data; + pcm_file->perm = perm; +mutex_unlock (&pcm->open_mutex);put_user (fd, arg);return 0 ; } +mutex_unlock (&pcm->open_mutex);snd_card_file_remove (pcm->card, nfile); __error2:module_put (pcm->card->module);
@@ -3307,6 +3324,8 @@ static int snd_pcm_mmap_status(struct snd_pcm_substream *substream, struct fileif (pcm_file->user_pversion <SNDRV_PROTOCOL_VERSION (2 ,0 ,14 ) && (pcm_file->substream->runtime->hw.info &SNDRV_PCM_INFO_SYNC_APPLPTR ))return -ENXIO ; +if (pcm_file->perm !=SNDRV_PCM_PERM_MODE_FULL ) +return -EPERM ;if (!(area->vm_flags &VM_READ ))return -EINVAL ; size = area->vm_end - area->vm_start;
@@ -3352,6 +3371,8 @@ static int snd_pcm_mmap_control(struct snd_pcm_substream *substream, struct file*/ if (pcm_file->substream->runtime->hw.info &SNDRV_PCM_INFO_SYNC_APPLPTR )return -ENXIO ; +if (pcm_file->perm !=SNDRV_PCM_PERM_MODE_FULL ) +return -EPERM ;if (!(area->vm_flags &VM_READ ))return -EINVAL ; size = area->vm_end - area->vm_start;
@@ -3728,6 +3749,14 @@ static unsigned long snd_pcm_get_unmapped_area(struct file *file,* Register section */ +const struct file_operations snd_pcm_f_op_buffer = { + .owner =THIS_MODULE , + .release = snd_pcm_release, + .llseek = no_llseek, + .mmap = snd_pcm_mmap, + .get_unmapped_area = snd_pcm_get_unmapped_area +}; +const struct file_operations snd_pcm_f_ops[2 ] = { { .owner =THIS_MODULE ,
Signature · 1 line
2.13.6
Quoted 3 lines · Jaroslav Kysela
This patchset contains the anonymous dup implementation with permissions checking for the ALSA's PCM interface in kernel to enable the restricted DMA sound buffer sharing for the restricted tasks.
Quoted 7 lines · Jaroslav Kysela
This patchset contains the anonymous dup implementation with permissions checking for the ALSA's PCM interface in kernel to enable the restricted DMA sound buffer sharing for the restricted tasks.
The code was tested through qemu and it seems to be pretty stable.
Quoted 7 lines
The initial tinyalsa implementation can be found here:
https://github.com/perexg/tinyalsa/commits/anondup
The filtering might be refined. It depends on the real requirements. Perhaps, we may create more ioctl groups. Any comments are more than welcome.
Is this patchset targeted for 5.1 merge?
I hesitate to merge it for now, as the new API hasn't been tested much yet... If it's for 5.1, we need test coverage and more reviews quickly.
thanks,
Takashi
Quoted 49 lines
v2 of the patches:
- change clone parameter to subdevice number for the pcm attach
- changeSNDRV_PCM_PERM_MAXtoSNDRV_PCM_PERM_MASK
- the tinyalsa implementation was a little updated (restructured)v3 of the patches:
- group integer declarations in
snd_pcm_anonymous_dup()
- replacedsubstream->pcmwith pcm insnd_pcm_anonymous_dup()
- addedSNDRV_PCM_PERM_RWcheck for read/write/readv/writev syscallsv4 of the patches:
- more simple restriction control (only two modes - full/buffer)
- the tinyalsa implementation follows this changev5 of the patches:
- merge pcm_..._mmap_allowed fcns to the
snd_pcm_mmap_... fcnsv6:
- add proper
open_mutexprotection forsnd_pcm_open_file()Cc Phil Burk <[email protected]>Cc Zach Riggle <[email protected]>Cc Mark Brown <[email protected]>Cc Leo Yan <[email protected]>Cc Baolin Wang <[email protected]>Jaroslav Kysela (3):
ALSA: pcm: implement the anonymous dup (inode file descriptor)
ALSA: pcm: merge pcm_..._mmap_allowed fcns to thesnd_pcm_mmap_...
fcns
ALSA: pcm: implement the mmap buffer mode for the anonymous dupinclude/sound/pcm.h | 10 +-- include/uapi/sound/asound.h | 6 +- sound/core/oss/pcm_oss.c | 2 +- sound/core/pcm.c | 13 ++-- sound/core/pcm_compat.c | 1 + sound/core/pcm_native.c | 154 +++++++++++++++++++++++++++++++++----------- 6 files changed, 133 insertions(+), 53 deletions(-)Signature · 1 line
2.13.6