ALSA: Add PCM USER_PVERSION ioctl
v3 cover ALSA: Add PCM USER_PVERSION ioctl
Hi,
this is a revised patchset that is applied on top of the current for-next branch, in order to optimize the appl_ptr sync on x86-64, adapting the alsa-lib side change by Sakamoto-san's patchset.
Basically it adds a new ioctl for receiving the supported PCM protocol version from user-space side, and change the mmap code to allow only disabling the PCM status record depending on the supported protocol version. The former patch is identical with the previous version, only the latter one differs.
The corresponding alsa-lib patch will follow.
thanks,
Takashi
===
Takashi Iwai (2):
ALSA: pcm: Add an ioctl to specify the supported protocol version
ALSA: pcm: Disable only control mmap for explicit appl_ptr sync
include/sound/pcm.h | 1 + include/uapi/sound/asound.h | 3 ++- sound/core/pcm_compat.c | 1 + sound/core/pcm_native.c | 29 ++++++++++++++++++++++++----- 4 files changed, 28 insertions(+), 6 deletions(-)
Signature · 1 line
2.13.2
PATCH v3 1/2 ALSA: pcm: Add an ioctl to specify the supported protocol version
We have an ioctl to inform the PCM protocol version the running kernel supports, but there is no way to know which protocol version the user-space can understand. This lack of information caused headaches in the past when we tried to extend the ABI. For example, because we couldn't guarantee the validity of the reserved bytes, we had to introduce a new ioctl SNDRV_PCM_IOCTL_STATUS_EXT for assigning a few new fields in the formerly reserved bits. If we could know that it's a new alsa-lib, we could assume the availability of the new fields, thus we could have reused the existing SNDRV_PCM_IOCTL_STATUS.
In order to improve the ABI extensibility, this patch adds a new ioctl for user-space to inform its supporting protocol version to the kernel. By reporting the supported protocol from user-space, the kernel can judge which feature should be provided and which not.
With the addition of the new ioctl, the PCM protocol version is bumped to 2.0.14, too. User-space checks the kernel protocol version via SNDRV_PCM_INFO_PVERSION, then it sets the supported version back via SNDRV_PCM_INFO_USER_PVERSION.
--- include/sound/pcm.h | 1 + include/uapi/sound/asound.h | 3 ++- sound/core/pcm_compat.c | 1 + sound/core/pcm_native.c | 7 +++++++ 4 files changed, 11 insertions(+), 1 deletion(-)
include/sound/pcm.h +1 -0
@@ -218,6 +218,7 @@ struct snd_pcm_ops {struct snd_pcm_file {struct snd_pcm_substream *substream;int no_compat_mmap; +unsigned int user_pversion;/* supported protocol version */ };struct snd_pcm_hw_rule ;
include/uapi/sound/asound.h +2 -1
@@ -152,7 +152,7 @@ struct snd_hwdep_dsp_image {* * *****************************************************************************/ -#define SNDRV_PCM_VERSION SNDRV_PROTOCOL_VERSION(2, 0, 13) +#define SNDRV_PCM_VERSION SNDRV_PROTOCOL_VERSION(2, 0, 14)typedef unsigned long snd_pcm_uframes_t ;typedef signed long snd_pcm_sframes_t ;
@@ -564,6 +564,7 @@ enum {#define SNDRV_PCM_IOCTL_INFO _IOR('A', 0x01, struct snd_pcm_info)#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_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/pcm_compat.c +1 -0
@@ -676,6 +676,7 @@ static long snd_pcm_ioctl_compat(struct file *file, unsigned int cmd, unsigned lcase SNDRV_PCM_IOCTL_INFO :case SNDRV_PCM_IOCTL_TSTAMP :case SNDRV_PCM_IOCTL_TTSTAMP : +case SNDRV_PCM_IOCTL_USER_PVERSION :case SNDRV_PCM_IOCTL_HWSYNC :case SNDRV_PCM_IOCTL_PREPARE :case SNDRV_PCM_IOCTL_RESET :
sound/core/pcm_native.c +7 -0
@@ -2770,6 +2770,8 @@ static int snd_pcm_common_ioctl(struct file *file,struct snd_pcm_substream *substream, unsigned int cmd, void __user *arg) { + struct snd_pcm_file *pcm_file = file->private_data; +switch (cmd) {case SNDRV_PCM_IOCTL_PVERSION :return put_user (SNDRV_PCM_VERSION , (int __user *)arg) ? -EFAULT :0 ;
@@ -2779,6 +2781,11 @@ static int snd_pcm_common_ioctl(struct file *file,return 0 ;case SNDRV_PCM_IOCTL_TTSTAMP :return snd_pcm_tstamp (substream, arg); +case SNDRV_PCM_IOCTL_USER_PVERSION : +if (get_user (pcm_file->user_pversion, + (unsigned int __user *)arg)) +return -EFAULT ; +return 0 ;case SNDRV_PCM_IOCTL_HW_REFINE :return snd_pcm_hw_refine_user (substream, arg);case SNDRV_PCM_IOCTL_HW_PARAMS :
Signature · 1 line
2.13.2
PATCH v3 2/2 ALSA: pcm: Disable only control mmap for explicit appl_ptr sync
In reply to Takashi IwaiNow that user-space (typically alsa-lib) can specify which protocol version it supports, we can optimize the kernel code depending on the reported protocol version.
In this patch, we change the previous hack for enforcing the appl_ptr sync by disabling status/control mmap. Instead of forcibly disabling both mmaps, we disable only the control mmap when user-space declares the supported protocol version new enough. For older user-space, still both PCM status and control mmaps are disabled when requested by the driver due to the compatibility reason.
--- sound/core/pcm_native.c | 22 +++++++++++++++++----- 1 file changed, 17 insertions(+), 5 deletions(-)
sound/core/pcm_native.c +17 -5
@@ -3388,12 +3388,23 @@ static bool pcm_status_mmap_allowed(struct snd_pcm_file *pcm_file) {if (pcm_file->no_compat_mmap)return false; -/* Disallow the status/control mmap when SYNC_APPLPTR flag is set; +/* 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. -* In theory, it should be enough to disallow only PCM control mmap, -* but since the current alsa-lib implementation requires both status -* and control mmaps always paired, we have to disable both of them. */ if (pcm_file->substream->runtime->hw.info &SNDRV_PCM_INFO_SYNC_APPLPTR )return false;
@@ -3405,6 +3416,7 @@ static bool pcm_status_mmap_allowed(struct snd_pcm_file *pcm_file)* don't support mmap for status and control records. */ #define pcm_status_mmap_allowed (pcm_file) false +#define pcm_control_mmap_allowed (pcm_file) falsestatic int snd_pcm_mmap_status (struct snd_pcm_substream *substream,struct file *file,struct vm_area_struct *area)
@@ -3593,7 +3605,7 @@ static int snd_pcm_mmap(struct file *file, struct vm_area_struct *area)return -ENXIO ;return snd_pcm_mmap_status (substream, file, area);case SNDRV_PCM_MMAP_OFFSET_CONTROL : -if (!pcm_status_mmap_allowed (pcm_file)) +if (!pcm_control_mmap_allowed (pcm_file))return -ENXIO ;return snd_pcm_mmap_control (substream, file, area);default :
Signature · 1 line
2.13.2
Hi,
Quoted 25 lines · Takashi Iwai
Hi,
this is a revised patchset that is applied on top of the current for-next branch, in order to optimize the
appl_ptrsync on x86-64, adapting the alsa-lib side change by Sakamoto-san's patchset.Basically it adds a new ioctl for receiving the supported PCM protocol version from user-space side, and change the mmap code to allow only disabling the PCM status record depending on the supported protocol version. The former patch is identical with the previous version, only the latter one differs.
The corresponding alsa-lib patch will follow.
thanks,
Takashi
===
Takashi Iwai (2):
ALSA: pcm: Add an ioctl to specify the supported protocol version
ALSA: pcm: Disable only control mmap for explicitappl_ptrsync
Quoted 5 lines
include/sound/pcm.h | 1 + include/uapi/sound/asound.h | 3 ++- sound/core/pcm_compat.c | 1 + sound/core/pcm_native.c | 29 ++++++++++++++++++++++++----- 4 files changed, 28 insertions(+), 6 deletions(-)
I note that the idea of USER_PVERSION ioctl is itself worth for the other interfaces/protocols such as control. In the interfaces/protocols, many structures have reserved members. As Iwai-san described in the first patch, when changing them to utilize these reserved members, this idea is a solution to balance compatibility and extensibility.
Thanks
Takashi Sakamoto
Quoted 35 lines · Takashi Sakamoto
Hi,
Quoted 25 lines · Takashi Iwai
Hi,
this is a revised patchset that is applied on top of the current for-next branch, in order to optimize the
appl_ptrsync on x86-64, adapting the alsa-lib side change by Sakamoto-san's patchset.Basically it adds a new ioctl for receiving the supported PCM protocol version from user-space side, and change the mmap code to allow only disabling the PCM status record depending on the supported protocol version. The former patch is identical with the previous version, only the latter one differs.
The corresponding alsa-lib patch will follow.
thanks,
Takashi
===
Takashi Iwai (2):
ALSA: pcm: Add an ioctl to specify the supported protocol version
ALSA: pcm: Disable only control mmap for explicitappl_ptrsyncQuoted 5 lines
include/sound/pcm.h | 1 + include/uapi/sound/asound.h | 3 ++- sound/core/pcm_compat.c | 1 + sound/core/pcm_native.c | 29 ++++++++++++++++++++++++----- 4 files changed, 28 insertions(+), 6 deletions(-)
Quoted 8 lines
Reviewed-by Takashi Sakamoto <[email protected]>I note that the idea of
USER_PVERSIONioctl is itself worth for the other interfaces/protocols such as control. In the interfaces/protocols, many structures have reserved members. As Iwai-san described in the first patch, when changing them to utilize these reserved members, this idea is a solution to balance compatibility and extensibility.
OK, let's go with this. I'll merge this and also the alsa-lib patchsets.
Thanks!
Takashi
Quoted 46 lines · Takashi Iwai
Quoted 35 lines · Takashi Sakamoto
Hi,
Quoted 25 lines · Takashi Iwai
Hi,
this is a revised patchset that is applied on top of the current for-next branch, in order to optimize the
appl_ptrsync on x86-64, adapting the alsa-lib side change by Sakamoto-san's patchset.Basically it adds a new ioctl for receiving the supported PCM protocol version from user-space side, and change the mmap code to allow only disabling the PCM status record depending on the supported protocol version. The former patch is identical with the previous version, only the latter one differs.
The corresponding alsa-lib patch will follow.
thanks,
Takashi
===
Takashi Iwai (2):
ALSA: pcm: Add an ioctl to specify the supported protocol version
ALSA: pcm: Disable only control mmap for explicitappl_ptrsyncQuoted 5 lines
include/sound/pcm.h | 1 + include/uapi/sound/asound.h | 3 ++- sound/core/pcm_compat.c | 1 + sound/core/pcm_native.c | 29 ++++++++++++++++++++++++----- 4 files changed, 28 insertions(+), 6 deletions(-)Quoted 8 lines
Reviewed-by Takashi Sakamoto <[email protected]>I note that the idea of
USER_PVERSIONioctl is itself worth for the other interfaces/protocols such as control. In the interfaces/protocols, many structures have reserved members. As Iwai-san described in the first patch, when changing them to utilize these reserved members, this idea is a solution to balance compatibility and extensibility.
Quoted 2 lines
OK, let's go with this. I'll merge this and also the alsa-lib patchsets.
Good work, Takashi ;)
I have rest of my work for alsa-lib to optimize SYNC_PTR ioctl. Within a few days, I'll post it.
Thanks
Takashi Sakamoto