Defines | |
| #define | ALSA_CONFIG_PATH_VAR "ALSA_CONFIG_PATH" |
| #define | ALSA_CONFIG_PATH_DEFAULT ALSA_CONFIG_DIR "/alsa.conf" |
Functions | |
| int | snd_config_substitute (snd_config_t *dst, snd_config_t *src) |
| Substitutes one configuration node to another. | |
| int | snd_config_get_type_ascii (const char *ascii, snd_config_type_t *type) |
| Converts an ASCII string to a configuration node type. | |
| snd_config_type_t | snd_config_get_type (const snd_config_t *config) |
| Returns the type of a configuration node. | |
| int | snd_config_get_id (const snd_config_t *config, const char **id) |
| Returns the id of a configuration node. | |
| int | snd_config_set_id (snd_config_t *config, const char *id) |
| Sets the id of a configuration node. | |
| int | snd_config_top (snd_config_t **config) |
| Creates a top level configuration node. | |
| int | snd_config_load (snd_config_t *config, snd_input_t *in) |
| Loads a configuration tree. | |
| int | snd_config_load_override (snd_config_t *config, snd_input_t *in) |
| Loads a configuration tree and overrides existing configuration nodes. | |
| int | snd_config_add (snd_config_t *father, snd_config_t *leaf) |
| Adds a child to a compound configuration node. | |
| int | snd_config_remove (snd_config_t *config) |
| Removes a configuration node from its tree. | |
| int | snd_config_delete (snd_config_t *config) |
| Deletes a configuration node (freeing all its related resources). | |
| int | snd_config_delete_compound_members (const snd_config_t *config) |
| Deletes the children of a compound configuration node (freeing all its related resources). | |
| int | snd_config_make (snd_config_t **config, const char *id, snd_config_type_t type) |
| Creates a configuration node. | |
| int | snd_config_make_integer (snd_config_t **config, const char *id) |
| Creates an integer configuration node. | |
| int | snd_config_make_integer64 (snd_config_t **config, const char *id) |
| Creates an integer64 configuration node. | |
| int | snd_config_make_real (snd_config_t **config, const char *id) |
| Creates a real configuration node. | |
| int | snd_config_make_string (snd_config_t **config, const char *id) |
| Creates a string configuration node. | |
| int | snd_config_make_pointer (snd_config_t **config, const char *id) |
| Creates a pointer configuration node. | |
| int | snd_config_make_compound (snd_config_t **config, const char *id, int join) |
| Creates an empty compound configuration node. | |
| int | snd_config_imake_integer (snd_config_t **config, const char *id, const long value) |
| Creates an integer configuration node with the given initial value. | |
| int | snd_config_imake_integer64 (snd_config_t **config, const char *id, const long long value) |
| Creates an integer configuration node with the given initial value. | |
| int | snd_config_imake_real (snd_config_t **config, const char *id, const double value) |
| Creates a real configuration node with the given initial value. | |
| int | snd_config_imake_string (snd_config_t **config, const char *id, const char *value) |
| Creates a string configuration node with the given initial value. | |
| int | snd_config_imake_pointer (snd_config_t **config, const char *id, const void *value) |
| Creates a pointer configuration node with the given initial value. | |
| int | snd_config_set_integer (snd_config_t *config, long value) |
| Changes the value of an integer configuration node. | |
| int | snd_config_set_integer64 (snd_config_t *config, long long value) |
| Changes the value of an integer64 configuration node. | |
| int | snd_config_set_real (snd_config_t *config, double value) |
| Changes the value of a real configuration node. | |
| int | snd_config_set_string (snd_config_t *config, const char *value) |
| Changes the value of a string configuration node. | |
| int | snd_config_set_pointer (snd_config_t *config, const void *value) |
| Changes the value of a pointer configuration node. | |
| int | snd_config_set_ascii (snd_config_t *config, const char *ascii) |
| Changes the value of a configuration node. | |
| int | snd_config_get_integer (const snd_config_t *config, long *ptr) |
| Returns the value of an integer configuration node. | |
| int | snd_config_get_integer64 (const snd_config_t *config, long long *ptr) |
| Returns the value of an integer64 configuration node. | |
| int | snd_config_get_real (const snd_config_t *config, double *ptr) |
| Returns the value of a real configuration node. | |
| int | snd_config_get_ireal (const snd_config_t *config, double *ptr) |
| Returns the value of a real or integer configuration node. | |
| int | snd_config_get_string (const snd_config_t *config, const char **ptr) |
| Returns the value of a string configuration node. | |
| int | snd_config_get_pointer (const snd_config_t *config, const void **ptr) |
| Returns the value of a pointer configuration node. | |
| int | snd_config_get_ascii (const snd_config_t *config, char **ascii) |
| Returns the value of a configuration node as a string. | |
| int | snd_config_test_id (const snd_config_t *config, const char *id) |
| Compares the id of a configuration node to a given string. | |
| int | snd_config_save (snd_config_t *config, snd_output_t *out) |
| Dumps the contents of a configuration node or tree. | |
| int | snd_config_search (snd_config_t *config, const char *key, snd_config_t **result) |
| Searches for a node in a configuration tree. | |
| int | snd_config_searcha (snd_config_t *root, snd_config_t *config, const char *key, snd_config_t **result) |
| Searches for a node in a configuration tree, expanding aliases. | |
| int | snd_config_searchv (snd_config_t *config, snd_config_t **result,...) |
| Searches for a node in a configuration tree. | |
| int | snd_config_searchva (snd_config_t *root, snd_config_t *config, snd_config_t **result,...) |
| Searches for a node in a configuration tree, expanding aliases. | |
| int | snd_config_search_alias (snd_config_t *config, const char *base, const char *key, snd_config_t **result) |
| Searches for a node in a configuration tree, using an alias. | |
| int | snd_config_search_hooks (snd_config_t *config, const char *key, snd_config_t **result) |
| Searches for a node in a configuration tree and expands hooks. | |
| int | snd_config_searcha_hooks (snd_config_t *root, snd_config_t *config, const char *key, snd_config_t **result) |
| Searches for a node in a configuration tree, expanding aliases and hooks. | |
| int | snd_config_searchva_hooks (snd_config_t *root, snd_config_t *config, snd_config_t **result,...) |
| Searches for a node in a configuration tree, expanding aliases and hooks. | |
| int | snd_config_search_alias_hooks (snd_config_t *config, const char *base, const char *key, snd_config_t **result) |
| Searches for a node in a configuration tree, using an alias and expanding hooks. | |
| int | snd_config_hook_load (snd_config_t *root, snd_config_t *config, snd_config_t **dst, snd_config_t *private_data) |
| Loads and parses the given configurations files. | |
| int | snd_config_hook_load_for_all_cards (snd_config_t *root, snd_config_t *config, snd_config_t **dst, snd_config_t *private_data) |
| Loads and parses the given configurations files for each installed sound card. | |
| int | snd_config_update_r (snd_config_t **_top, snd_config_update_t **_update, const char *cfgs) |
| Updates a configuration tree by rereading the configuration files (if needed). | |
| int | snd_config_update (void) |
| Updates snd_config by rereading the global configuration files (if needed). | |
| int | snd_config_update_free (snd_config_update_t *update) |
| Frees a private update structure. | |
| int | snd_config_update_free_global (void) |
| Frees the global configuration tree in snd_config. | |
| snd_config_iterator_t | snd_config_iterator_first (const snd_config_t *node) |
| Returns an iterator pointing to the first child of a compound configuration node. | |
| snd_config_iterator_t | snd_config_iterator_next (const snd_config_iterator_t iterator) |
| Returns an iterator pointing to the next sibling. | |
| snd_config_iterator_t | snd_config_iterator_end (const snd_config_t *node) |
| Returns an iterator pointing past the last child of a compound configuration node. | |
| snd_config_t * | snd_config_iterator_entry (const snd_config_iterator_t iterator) |
| Returns the configuration node handle pointed to by an iterator. | |
| int | snd_config_copy (snd_config_t **dst, snd_config_t *src) |
| Creates a copy of a configuration node. | |
| int | snd_config_evaluate (snd_config_t *config, snd_config_t *root, snd_config_t *private_data, snd_config_t **result) |
| Evaluates a configuration node at runtime. | |
| int | snd_config_expand (snd_config_t *config, snd_config_t *root, const char *args, snd_config_t *private_data, snd_config_t **result) |
| Expands a configuration node applying arguments and functions. | |
| int | snd_config_search_definition (snd_config_t *config, const char *base, const char *name, snd_config_t **result) |
| Searches for a definition in a configuration tree, using aliases and expanding hooks and arguments. | |
Variables | |
| snd_config_t * | snd_config = NULL |
See the Configuration files page for more details.
| #define ALSA_CONFIG_PATH_DEFAULT ALSA_CONFIG_DIR "/alsa.conf" |
The name of the default files used by snd_config_update.
| #define ALSA_CONFIG_PATH_VAR "ALSA_CONFIG_PATH" |
The name of the environment variable containing the files list for snd_config_update.
| int snd_config_get_type_ascii | ( | const char * | ascii, | |
| snd_config_type_t * | type | |||
| ) |
Converts an ASCII string to a configuration node type.
| ascii | A string containing a configuration node type. | |
| type | The function puts the node type at the address specified by type. |
| int snd_config_hook_load | ( | snd_config_t * | root, | |
| snd_config_t * | config, | |||
| snd_config_t ** | dst, | |||
| snd_config_t * | private_data | |||
| ) |
Loads and parses the given configurations files.
| root | Handle to the root configuration node. | |
| config | Handle to the configuration node for this hook. | |
| dst | The function puts the handle to the configuration node loaded from the file(s) at the address specified by dst. | |
| private_data | Handle to the private data configuration node. |
| int snd_config_hook_load_for_all_cards | ( | snd_config_t * | root, | |
| snd_config_t * | config, | |||
| snd_config_t ** | dst, | |||
| snd_config_t * | private_data | |||
| ) |
Loads and parses the given configurations files for each installed sound card.
| root | Handle to the root configuration node. | |
| config | Handle to the configuration node for this hook. | |
| dst | The function puts the handle to the configuration node loaded from the file(s) at the address specified by dst. | |
| private_data | Handle to the private data configuration node. |
| int snd_config_remove | ( | snd_config_t * | config | ) |
Removes a configuration node from its tree.
| config | Handle to the configuration node to be removed. |
| int snd_config_search_alias | ( | snd_config_t * | config, | |
| const char * | base, | |||
| const char * | key, | |||
| snd_config_t ** | result | |||
| ) |
Searches for a node in a configuration tree, using an alias.
| config | Handle to the root of the configuration (sub)tree to search. | |
| base | Search key base, or NULL. | |
| key | Search key suffix. | |
| result | The function puts the handle to the node found at the address specified by result. |
key is tried, then, if nothing is found, base.key is tried. If the value found is a string, this is recursively tried in the same way.
| int snd_config_search_alias_hooks | ( | snd_config_t * | config, | |
| const char * | base, | |||
| const char * | key, | |||
| snd_config_t ** | result | |||
| ) |
Searches for a node in a configuration tree, using an alias and expanding hooks.
| config | Handle to the root of the configuration (sub)tree to search. | |
| base | Search key base, or NULL. | |
| key | Search key suffix. | |
| result | The function puts the handle to the node found at the address specified by result. |
key is tried, then, if nothing is found, base.key is tried. If the value found is a string, this is recursively tried in the same way.
| int snd_config_search_hooks | ( | snd_config_t * | config, | |
| const char * | key, | |||
| snd_config_t ** | result | |||
| ) |
Searches for a node in a configuration tree and expands hooks.
| config | Handle to the root of the configuration (sub)tree to search. | |
| key | Search key: one or more node keys, separated with dots. | |
| result | The function puts the handle to the node found at the address specified by result. |
| int snd_config_searcha | ( | snd_config_t * | root, | |
| snd_config_t * | config, | |||
| const char * | key, | |||
| snd_config_t ** | result | |||
| ) |
Searches for a node in a configuration tree, expanding aliases.
| root | Handle to the root configuration node containing alias definitions. | |
| config | Handle to the root of the configuration (sub)tree to search. | |
| key | Search key: one or more node keys, separated with dots. | |
| result | The function puts the handle to the node found at the address specified by result. |
| int snd_config_searcha_hooks | ( | snd_config_t * | root, | |
| snd_config_t * | config, | |||
| const char * | key, | |||
| snd_config_t ** | result | |||
| ) |
Searches for a node in a configuration tree, expanding aliases and hooks.
| root | Handle to the root configuration node containing alias definitions. | |
| config | Handle to the root of the configuration (sub)tree to search. | |
| key | Search key: one or more node keys, separated with dots. | |
| result | The function puts the handle to the node found at the address specified by result. |
| int snd_config_searchva | ( | snd_config_t * | root, | |
| snd_config_t * | config, | |||
| snd_config_t ** | result, | |||
| ... | ||||
| ) |
Searches for a node in a configuration tree, expanding aliases.
| root | Handle to the root configuration node containing alias definitions. | |
| config | Handle to the root of the configuration (sub)tree to search. | |
| result | The function puts the handle to the node found at the address specified by result. | |
| ... | One or more concatenated dot separated search keys, terminated with NULL. |
| int snd_config_searchva_hooks | ( | snd_config_t * | root, | |
| snd_config_t * | config, | |||
| snd_config_t ** | result, | |||
| ... | ||||
| ) |
Searches for a node in a configuration tree, expanding aliases and hooks.
| root | Handle to the root configuration node containing alias definitions. | |
| config | Handle to the root of the configuration (sub)tree to search. | |
| result | The function puts the handle to the node found at the address specified by result. | |
| ... | One or more concatenated dot separated search keys, terminated with NULL. |
| int snd_config_substitute | ( | snd_config_t * | dst, | |
| snd_config_t * | src | |||
| ) |
Substitutes one configuration node to another.
| dst | Handle to the destination node. | |
| src | Handle to the source node. Must not be the same as dst. |
If the destination node is a compound and the source node is an ordinary type, the compound members are deleted (including their contents).
A successful call to this function invalidates the source node.
1.5.8