path: root/README

NAME
	alsause - Set default ALSA PCM device

SYNPOSIS
	alsause [(-r | name | card:device) [command [argument] ...]]

DESCRIPTION
	The alsause utility lists all ALSA PCM devices or sets, either for the
	user or for a program it starts, the default ALSA PCM device.

	No options or operands are specified, alsause will list all ALSA PCM
	devices, otherwise it will set the default ALSA PCM device.

	If command is specified, alsause will run that command with the default
	ALSA PCM device set only for that process and it's child processes.

OPTIONS
	The alsause utility conforms to the Base Definitions volume of
	POSIX.1-2017, Section 12.2, Utility Syntax Guidelines.

	The following option is supported:

	-r	Remove the user-specified default ALSA PCM device, falling back
		to the system-wide default ALSA PCM device.

OPERANDS
	The following operands shall be supported:

	card:device
		The card number and device number to use as the default ALSA PCM
		device.

	name
		The card and device, by name, to use as the default ALSA PCM
		device. This string is on the form output by the alsause
		utility itself: "%s - %s", <card name>, <device name>.

	command
		The name of the utility to be invoked.

	argument
		A string to pass as an argument for the invoked utility.

EXIT STATUS
	If command is invoked, the exit status of alsause is the exit status of
	command; otherwise, the alsause utility exits with one of the following
	values.

	0      The alsause utility completed successfully.

	125    An error occurred in the alsause utility.

	126    The utility specified by command was found but could not be invoked.

	127    The utility specified by command could not be found.

SEE ALSO
	None.