UCM: Deprecate index on Section{Device, Modifier}
PATCH 1/5 UCM: Deprecate index on Section{Device, Modifier}
The previous supported "legacy" syntax was:
SectionDevice."Speaker".0 {
SectionModifier."Capture Voice".0 {
This change supports new syntax:
SectionDevice."Speaker" {
SectionModifier."Capture Voice" {
... but also allows the old syntax, iff the index is exactly "0". If an index is present, but not exactly "0", parsing will appear to succeed, but produce an empty device or modifier.
When naming devices and modifiers, even if the legacy format is used, any index is not included in the name; i.e. both sets of syntax above name the device just "Speaker".
The SupportedDevice list syntax still also accepts either "x" or "x.0", but internally strips ".0" from the tail of any device name. Any other name including "." is disallowed.
Finally, when comparing device or modifier names, a simple exact string compare is now used, since no index data is ever present in device or modifier names.
The one functional change introduced here is that a SupportedDevice entry of just "x" will now only ever match a single device. It previously acted as a wildcard for any device named "x.foo".
--- src/ucm/main.c | 43 ++++----------- src/ucm/parser.c | 156 ++++++++++++++++++++++++++++++++++++------------------ 2 files changed, 114 insertions(+), 85 deletions(-)
src/ucm/main.c +10 -33
@@ -484,33 +484,18 @@ static int is_modifier_supported(snd_use_case_mgr_t *uc_mgr,struct dev_list *device;struct use_case_device *adev;struct list_head *pos, *pos1; -char *cpos; -int dlen, len;list_for_each (pos, &modifier->dev_list) { device = list_entry(pos, struct dev_list, list); - cpos =strchr (device->name,'.' ); -if (cpos) { -if (find (&uc_mgr->active_devices, - struct use_case_device, active_list, - name, device->name)) -return 1 ; - }else { - dlen =strlen (device->name); -list_for_each (pos1, &uc_mgr->active_devices) { - adev = list_entry(pos1, struct use_case_device, - active_list); - cpos =strchr (adev->name,'.' ); -if (cpos) - len = cpos - adev->name; -else - len =strlen (adev->name); -if (len != dlen) -continue ; -if (memcmp (adev->name, device->name, len)) -continue ; -return 1 ; - } + +list_for_each (pos1, &uc_mgr->active_devices) { + adev = list_entry(pos1, struct use_case_device, + active_list); + +if (strcmp (adev->name, device->name)) +continue ; + +return 1 ; } }return 0 ;
@@ -528,19 +513,11 @@ static struct use_case_modifier *struct use_case_modifier *modifier;struct use_case_verb *verb = uc_mgr->active_verb;struct list_head *pos; -char name[64 ], *cpos;list_for_each (pos, &verb->modifier_list) { modifier = list_entry(pos, struct use_case_modifier, list); -strncpy (name, modifier->name,sizeof (name)); - name[sizeof (name)-1 ] ='\0' ; - cpos =strchr (name,'.' ); -if (!cpos) -continue ; - *cpos='\0' ; - -if (strcmp (name, modifier_name)) +if (strcmp (modifier->name, modifier_name))continue ;if (is_modifier_supported (uc_mgr, modifier))
src/ucm/parser.c +104 -52
254 lines not on this page · raw message
Signature · 1 line
1.7.0.4
PATCH 2/5 UCM: Implement ConflictingDevices, add device list to devices
Wherever SupportedDevice can appear, also allow ConflictingDevice. Only one or the other (or neither) may be specified. When neither is specified, allow anything. Sometimes, listing ConflictingDevices may result in a shorter list than explicitly listing all SupportedDevices.
Add support for SupportedDevice and ConflictingDevice to SectionDevice. This allows representing devices which are mutually exclusive, e.g. due to a mux that switches between capturing from two different microphones, without the possibility of mixing.
Enhance is_modifier_supported to allow ignoring SupportedDevice and ConflictingDevice. This is useful when querying values from a SectionModifier; there's no reason we shouldn't be able to query values just because the current configuration would prevent enabling that device. The new is_device_supported is implemented similarly.
Enhance switch_device to remove the old device from the current device list before querying for the new device, and add it back immediately afterwards. This allows the query for the new device to ignore any conflicts caused solely by the old device.
--- src/ucm/main.c | 110 +++++++++++++++++++++++++++++++++++---------------- src/ucm/parser.c | 84 ++++++++++++++++++++++++++++++++------ src/ucm/ucm_local.h | 19 +++++++- src/ucm/utils.c | 9 ++-- 4 files changed, 167 insertions(+), 55 deletions(-)
src/ucm/main.c +76 -34
@@ -463,6 +463,51 @@ static inline struct use_case_verb *find_verb(snd_use_case_mgr_t *uc_mgr, verb_name); } +static int is_devlist_supported (snd_use_case_mgr_t *uc_mgr, +struct dev_list *dev_list) +{ +struct dev_list_node *device; +struct use_case_device *adev; +struct list_head *pos, *pos1; +int found_ret; + +switch (dev_list->type) { +case DEVLIST_NONE : +default : +return 1 ; +case DEVLIST_SUPPORTED : + found_ret =1 ; +break ; +case DEVLIST_CONFLICTING : + found_ret =0 ; +break ; + } + +list_for_each (pos, &dev_list->list) { + device = list_entry(pos, struct dev_list_node, list); + +list_for_each (pos1, &uc_mgr->active_devices) { + adev = list_entry(pos1, struct use_case_device, + active_list); +if (!strcmp (device->name, adev->name)) +return found_ret; + } + } +return 1 - found_ret; +} + +static inline int is_modifier_supported (snd_use_case_mgr_t *uc_mgr, +struct use_case_modifier *modifier) +{ +return is_devlist_supported (uc_mgr, &modifier->dev_list); +} + +static inline int is_device_supported (snd_use_case_mgr_t *uc_mgr, +struct use_case_device *device) +{ +return is_devlist_supported (uc_mgr, &device->dev_list); +} +/** * \brief Find device * \param verb Use case verb
@@ -470,35 +515,26 @@ static inline struct use_case_verb *find_verb(snd_use_case_mgr_t *uc_mgr,* \return structure on success, otherwise a NULL (not found) */ static inline struct use_case_device * -find_device (struct use_case_verb *verb, -const char *device_name) -{ -return find (&verb->device_list, - struct use_case_device, list, name, - device_name); -} - -static int is_modifier_supported (snd_use_case_mgr_t *uc_mgr, -struct use_case_modifier *modifier) +find_device (snd_use_case_mgr_t *uc_mgr,const char *device_name, +int check_supported) { -struct dev_list *device; -struct use_case_device *adev; -struct list_head *pos, *pos1; +struct use_case_device *device; +struct use_case_verb *verb = uc_mgr->active_verb; +struct list_head *pos; -list_for_each (pos, &modifier->dev_list) { - device = list_entry(pos, struct dev_list, list); +list_for_each (pos, &verb->device_list) { + device = list_entry(pos, struct use_case_device, list); -list_for_each (pos1, &uc_mgr->active_devices) { - adev = list_entry(pos1, struct use_case_device, - active_list); +if (strcmp (device_name, device->name)) +continue ; -if (strcmp (adev->name, device->name)) -continue ; +if (check_supported && + !is_device_supported (uc_mgr, device)) +continue ; -return 1 ; - } +return device; } -return 0 ; +return NULL ; }/**
@@ -508,7 +544,8 @@ static int is_modifier_supported(snd_use_case_mgr_t *uc_mgr,* \return structure on success, otherwise a NULL (not found) */ static struct use_case_modifier * -find_modifier (snd_use_case_mgr_t *uc_mgr,const char *modifier_name) +find_modifier (snd_use_case_mgr_t *uc_mgr,const char *modifier_name, +int check_supported) {struct use_case_modifier *modifier;struct use_case_verb *verb = uc_mgr->active_verb;
@@ -520,8 +557,11 @@ static struct use_case_modifier *if (strcmp (modifier->name, modifier_name))continue ; -if (is_modifier_supported (uc_mgr, modifier)) -return modifier; +if (check_supported && + !is_modifier_supported (uc_mgr, modifier)) +continue ; + +return modifier; }return NULL ; }
@@ -1061,13 +1101,13 @@ static int get_value(snd_use_case_mgr_t *uc_mgr,int err;if (item !=NULL ) { - mod =find_modifier (uc_mgr, item); + mod =find_modifier (uc_mgr, item,0 );if (mod !=NULL ) { err =get_value1 (value, &mod->value_list, identifier);if (err >=0 || err != -ENOENT )return err; } - dev =find_device (uc_mgr->active_verb, item); + dev =find_device (uc_mgr, item,0 );if (dev !=NULL ) { err =get_value1 (value, &dev->value_list, identifier);if (err >=0 || err != -ENOENT )
@@ -1286,7 +1326,7 @@ static int set_device_user(snd_use_case_mgr_t *uc_mgr,if (uc_mgr->active_verb ==NULL )return -ENOENT ; - device =find_device (uc_mgr->active_verb, device_name); + device =find_device (uc_mgr, device_name,1 );if (device ==NULL )return -ENOENT ;return set_device (uc_mgr, device, enable);
@@ -1301,7 +1341,7 @@ static int set_modifier_user(snd_use_case_mgr_t *uc_mgr,if (uc_mgr->active_verb ==NULL )return -ENOENT ; - modifier =find_modifier (uc_mgr, modifier_name); + modifier =find_modifier (uc_mgr, modifier_name,1 );if (modifier ==NULL )return -ENOENT ;return set_modifier (uc_mgr, modifier, enable);
@@ -1326,10 +1366,12 @@ static int switch_device(snd_use_case_mgr_t *uc_mgr,uc_error ("error: device %s already enabled" , new_device);return -EINVAL ; } - xold =find_device (uc_mgr->active_verb, old_device); + xold =find_device (uc_mgr, old_device,1 );if (xold ==NULL )return -ENOENT ; - xnew =find_device (uc_mgr->active_verb, new_device); +list_del (&xold->active_list); + xnew =find_device (uc_mgr, new_device,1 ); +list_add_tail (&xold->active_list, &uc_mgr->active_devices);if (xnew ==NULL )return -ENOENT ; err =0 ;
@@ -1378,10 +1420,10 @@ static int switch_modifier(snd_use_case_mgr_t *uc_mgr,uc_error ("error: modifier %s already enabled" , new_modifier);return -EINVAL ; } - xold =find_modifier (uc_mgr, old_modifier); + xold =find_modifier (uc_mgr, old_modifier,1 );if (xold ==NULL )return -ENOENT ; - xnew =find_modifier (uc_mgr, new_modifier); + xnew =find_modifier (uc_mgr, new_modifier,1 );if (xnew ==NULL )return -ENOENT ; err =0 ;
src/ucm/parser.c +70 -14
169 lines not on this page · raw message
src/ucm/ucm_local.h +16 -3
@@ -76,11 +76,21 @@ struct transition_sequence {/* * Modifier Supported Devices. */ -struct dev_list { +enum dev_list_type { +DEVLIST_NONE , +DEVLIST_SUPPORTED , +DEVLIST_CONFLICTING +}; + +struct dev_list_node {struct list_head list;char *name; }; +struct dev_list { +enum dev_list_type type; +struct list_head list; +};/* * Describes a Use Case Modifier and it's enable and disable sequences.
@@ -100,8 +110,8 @@ struct use_case_modifier {/* modifier transition list */ struct list_head transition_list; -/* list of supported devices per modifier */ -struct list_head dev_list; +/* list of devices supported or conflicting */ +struct dev_list dev_list;/* values */ struct list_head value_list;
@@ -125,6 +135,9 @@ struct use_case_device {/* device transition list */ struct list_head transition_list; +/* list of devices supported or conflicting */ +struct dev_list dev_list; +/* value list */ struct list_head value_list; };
src/ucm/utils.c +5 -4
@@ -99,13 +99,13 @@ void uc_mgr_free_value(struct list_head *base) } } -void uc_mgr_free_dev_list (struct list_head *base) +void uc_mgr_free_dev_list (struct dev_list *dev_list) {struct list_head *pos, *npos; -struct dev_list *dlist; +struct dev_list_node *dlist; -list_for_each_safe (pos, npos, base) { - dlist = list_entry(pos, struct dev_list, list); +list_for_each_safe (pos, npos, &dev_list->list) { + dlist = list_entry(pos, struct dev_list_node, list);free (dlist->name);list_del (&dlist->list);free (dlist);
@@ -189,6 +189,7 @@ void uc_mgr_free_device(struct list_head *base)uc_mgr_free_sequence (&dev->enable_list);uc_mgr_free_sequence (&dev->disable_list);uc_mgr_free_transition (&dev->transition_list); +uc_mgr_free_dev_list (&dev->dev_list);uc_mgr_free_value (&dev->value_list);list_del (&dev->list);free (dev);
Signature · 1 line
1.7.0.4
PATCH 3/5 UCM: Disallow gets of undefined system properties
In reply to Stephen WarrenIn UCM, there are various system-defined properties whose names start with "_". Explicitly prevent any gets from falling back to properties defined in a config file if the property name starts with "_", in order to reserve the entire "_" namespace for system-defined properties.
--- src/ucm/main.c | 15 ++++++++++++++- 1 files changed, 14 insertions(+), 1 deletions(-)
src/ucm/main.c +14 -1
@@ -1032,6 +1032,8 @@ int snd_use_case_get_list(snd_use_case_mgr_t *uc_mgr, err =get_device_list (uc_mgr, list, str); else if (check_identifier(identifier, "_modifiers")) err =get_modifier_list (uc_mgr, list, str); + else if (identifier[0] == '_') + err = -ENOENT ; else err =get_value_list (uc_mgr, identifier, list, str);if (str)
@@ -1159,6 +1161,9 @@ int snd_use_case_get(snd_use_case_mgr_t *uc_mgr, goto __end; } err =0 ; + }else if (identifier[0 ] =='_' ) { + err = -ENOENT ; + goto __end; }else { str1 =strchr (identifier,'/' );if (str1) {
@@ -1247,8 +1252,16 @@ int snd_use_case_geti(snd_use_case_mgr_t *uc_mgr, *value = err; err =0 ; } +#if 0 +/* +* enable this block if the else clause below is expanded to query +* user-supplied values + */ + }else if (identifier[0 ] =='_' ) + err = -ENOENT ; +#endif }else - err = -EINVAL ; + err = -ENOENT ;if (str)free (str); }
Signature · 1 line
1.7.0.4
PATCH 4/5 UCM: Allow querying of {Supported, Conflicting}Devices
In reply to Stephen WarrenAt any time, one can query:
_supporteddevs/<modifier>|<device>/<verb>
_conflictingdevs/<modifier>|<device>/<verb>
If a verb is current, one can query:
_supporteddevs/<modifier>|<device>
_conflictingdevs/<modifier>|<device>
Note that at most one of the supported/conflicting devs lists has any entries, and when neither is present, all devices are supported.
--- include/use-case.h | 5 ++ src/ucm/main.c | 106 +++++++++++++++++++++++++++++++++++++++++++++------- 2 files changed, 97 insertions(+), 14 deletions(-)
include/use-case.h +5 -0
@@ -205,6 +205,11 @@ int snd_use_case_free_list(const char *list[], int items);* _enadevs - get list of enabled devices * _enamods - get list of enabled modifiers * +* _supporteddevs/<modifier>|<device>[/<verb>] - list of supported devices +* _conflictingdevs/<modifier>|<device>[/<verb>] - list of conflicting devices +* Note that at most one of the supported/conflicting devs lists has +* any entries, and when neither is present, all devices are supported. +* */ int snd_use_case_get_list(snd_use_case_mgr_t *uc_mgr, const char *identifier,
src/ucm/main.c +92 -14
174 lines not on this page · raw message
Signature · 1 line
1.7.0.4
PATCH 5/5 UCM: snd_use_case_get: Don't segfault when no current verb
In reply to Stephen Warrenget_value, called by snd_use_case_get, uses uc_mgr->active_verb without checking there is one, and hence can segfault. Fix this.
--- src/ucm/main.c | 3 +++ 1 files changed, 3 insertions(+), 0 deletions(-)
src/ucm/main.c +3 -0
@@ -1180,6 +1180,9 @@ static int get_value(snd_use_case_mgr_t *uc_mgr,struct use_case_device *dev;int err; +if (!uc_mgr->active_verb) +return -ENOENT ; +if (item !=NULL ) { mod =find_modifier (uc_mgr, uc_mgr->active_verb, item,0 );if (mod !=NULL ) {
Signature · 1 line
1.7.0.4
Quoted 26 lines · Stephen Warren
The previous supported "legacy" syntax was:
SectionDevice."Speaker".0 {
SectionModifier."Capture Voice".0 {This change supports new syntax:
SectionDevice."Speaker" {
SectionModifier."Capture Voice" {... but also allows the old syntax, iff the index is exactly "0". If an index is present, but not exactly "0", parsing will appear to succeed, but produce an empty device or modifier.
When naming devices and modifiers, even if the legacy format is used, any index is not included in the name; i.e. both sets of syntax above name the device just "Speaker".
The SupportedDevice list syntax still also accepts either "x" or "x.0", but internally strips ".0" from the tail of any device name. Any other name including "." is disallowed.
Finally, when comparing device or modifier names, a simple exact string compare is now used, since no index data is ever present in device or modifier names.
Quoted 5 lines
The one functional change introduced here is that a SupportedDevice entry of just "x" will now only ever match a single device. It previously acted as a wildcard for any device named "x.foo".
Signed-off-by Stephen Warren <[email protected]>
All