Main Page | Modules | Data Structures | File List | Data Fields | Globals | Related Pages | Examples

confmisc.c File Reference

Configuration helper functions. More...


Functions

int snd_config_get_bool_ascii (const char *ascii)
 Gets the boolean value from the given ASCII string.

int snd_config_get_bool (const snd_config_t *conf)
 Gets the boolean value from a configuration node.

int snd_config_get_ctl_iface_ascii (const char *ascii)
 Gets the control interface index from the given ASCII string.

int snd_config_get_ctl_iface (const snd_config_t *conf)
 Gets the control interface index from a configuration node.

int snd_func_getenv (snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)
 Returns an environment value.

int snd_func_igetenv (snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)
 Returns an integer environment value.

int snd_func_concat (snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)
 Merges the given strings.

int snd_func_datadir (snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)
 Returns the ALSA data directory.

int snd_func_private_string (snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)
 Returns the string from private_data.

int snd_func_private_card_driver (snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)
 Returns the driver identification from private_data.

int snd_func_card_driver (snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)
 Returns the driver identification for a card.

int snd_func_card_id (snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)
 Returns the identification of a card.

int snd_func_pcm_id (snd_config_t **dst, snd_config_t *root, snd_config_t *src, void *private_data)
 Returns the pcm identification of a device.

int snd_func_private_pcm_subdevice (snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)
 Returns the PCM subdevice from private_data.

int snd_func_refer (snd_config_t **dst, snd_config_t *root, snd_config_t *src, snd_config_t *private_data)
 Copies the specified configuration node.


Detailed Description

Configuration helper functions.

Author:
Abramo Bagnara <abramo@alsa-project.org>

Jaroslav Kysela <perex@suse.cz>

Date:
2000-2001
Configuration helper functions.

See the Runtime functions in configuration files page for more details.


Function Documentation

int snd_func_card_driver snd_config_t **  dst,
snd_config_t root,
snd_config_t src,
snd_config_t private_data
 

Returns the driver identification for a card.

Parameters:
dst The function puts the handle to the result configuration node (with type string) at the address specified by dst.
root Handle to the root source node.
src Handle to the source node, with a card definition.
private_data Handle to the private_data node.
Returns:
A non-negative value if successful, otherwise a negative error code.
Example:
{ @func card_driver card 0 }

int snd_func_card_id snd_config_t **  dst,
snd_config_t root,
snd_config_t src,
snd_config_t private_data
 

Returns the identification of a card.

Parameters:
dst The function puts the handle to the result configuration node (with type string) at the address specified by dst.
root Handle to the root source node.
src Handle to the source node, with a card definition.
private_data Handle to the private_data node.
Returns:
A non-negative value if successful, otherwise a negative error code.
Example:
{ @func card_id card 0 }

int snd_func_concat snd_config_t **  dst,
snd_config_t root,
snd_config_t src,
snd_config_t private_data
 

Merges the given strings.

Parameters:
dst The function puts the handle to the result configuration node (with type string) at the address specified by dst.
root Handle to the root source node.
src Handle to the source node, with a definition for strings.
private_data Handle to the private_data node.
Returns:
A non-negative value if successful, otherwise a negative error code.
Example (result is "a1b2c3"):
{ @func concat strings [ "a1" "b2" "c3" ] }

int snd_func_datadir snd_config_t **  dst,
snd_config_t root,
snd_config_t src,
snd_config_t private_data
 

Returns the ALSA data directory.

Parameters:
dst The function puts the handle to the result configuration node (with type string) at the address specified by dst.
root Handle to the root source node.
src Handle to the source node.
private_data Handle to the private_data node. Not used.
Returns:
A non-negative value if successful, otherwise a negative error code.
Example (result is "/usr/share/alsa" using the default paths):
{ @func datadir }

int snd_func_getenv snd_config_t **  dst,
snd_config_t root,
snd_config_t src,
snd_config_t private_data
 

Returns an environment value.

Parameters:
dst The function puts the handle to the result configuration node (with type string) at the address specified by dst.
root Handle to the root source node.
src Handle to the source node, with definitions for vars and default.
private_data Handle to the private_data node.
Returns:
Zero if successful, otherwise a negative error code.
Example:
{ @func getenv vars [ MY_CARD CARD C ] default 0 }

int snd_func_igetenv snd_config_t **  dst,
snd_config_t root,
snd_config_t src,
snd_config_t private_data
 

Returns an integer environment value.

Parameters:
dst The function puts the handle to the result configuration node (with type integer) at the address specified by dst.
root Handle to the root source node.
src Handle to the source node, with definitions for vars and default.
private_data Handle to the private_data node.
Returns:
Zero if successful, otherwise a negative error code.
Example:
{ @func igetenv vars [ MY_DEVICE DEVICE D ] default 0 }

int snd_func_pcm_id snd_config_t **  dst,
snd_config_t root,
snd_config_t src,
void *  private_data
 

Returns the pcm identification of a device.

Parameters:
dst The function puts the handle to the result configuration node (with type string) at the address specified by dst.
root Handle to the root source node.
src Handle to the source node, with definitions for card, device and (optionally) subdevice.
private_data Handle to the private_data node.
Returns:
A non-negative value if successful, otherwise a negative error code.
Example:
{ @func pcm_id card 0 device 0 subdevice 0 # optional }

int snd_func_private_card_driver snd_config_t **  dst,
snd_config_t root,
snd_config_t src,
snd_config_t private_data
 

Returns the driver identification from private_data.

Parameters:
dst The function puts the handle to the result configuration node (with type string) at the address specified by dst.
root Handle to the root source node.
src Handle to the source node.
private_data Handle to the private_data node (type integer, id "card").
Returns:
A non-negative value if successful, otherwise a negative error code.
Example:
{ @func private_card_driver }

int snd_func_private_pcm_subdevice snd_config_t **  dst,
snd_config_t root,
snd_config_t src,
snd_config_t private_data
 

Returns the PCM subdevice from private_data.

Parameters:
dst The function puts the handle to the result configuration node (with type integer) at the address specified by dst.
root Handle to the root source node.
src Handle to the source node.
private_data Handle to the private_data node (type pointer, id "pcm_handle").
Returns:
A non-negative value if successful, otherwise a negative error code.
Example:
{ @func private_pcm_subdevice }

int snd_func_private_string snd_config_t **  dst,
snd_config_t root,
snd_config_t src,
snd_config_t private_data
 

Returns the string from private_data.

Parameters:
dst The function puts the handle to the result configuration node (with type string) at the address specified by dst.
root Handle to the root source node.
src Handle to the source node.
private_data Handle to the private_data node (type string, id "string").
Returns:
A non-negative value if successful, otherwise a negative error code.
Example:
{ @func private_string }

int snd_func_refer snd_config_t **  dst,
snd_config_t root,
snd_config_t src,
snd_config_t private_data
 

Copies the specified configuration node.

Parameters:
dst The function puts the handle to the result configuration node (with the same type as the specified node) at the address specified by dst.
root Handle to the root source node.
src Handle to the source node, with definitions for name and (optionally) file.
private_data Handle to the private_data node.
Returns:
A non-negative value if successful, otherwise a negative error code.
Note:
The root source node can be modified!
Example:
{ @func refer file "/etc/myconf.conf" # optional name "id1.id2.id3" }


Generated on Mon May 3 16:15:22 2004 for ALSA project - the C library reference by doxygen 1.3.6