aboutsummaryrefslogtreecommitdiffstats
path: root/galsause.1
diff options
context:
space:
mode:
authorMattias Andrée <m@maandree.se>2025-12-26 09:48:09 +0100
committerMattias Andrée <m@maandree.se>2025-12-26 10:05:39 +0100
commitfad53404f45b2e0daeda733687a41dd8e600aa57 (patch)
treef8dbd73a1e59cb8df53c7cb899c7d09ab5d74845 /galsause.1
parentFix open_tree support for when missing in libc (diff)
downloadgalsause-1.0.tar.gz
galsause-1.0.tar.bz2
galsause-1.0.tar.xz
Fork as galsauseHEAD1.0master
Signed-off-by: Mattias Andrée <m@maandree.se>
Diffstat (limited to 'galsause.1')
-rw-r--r--galsause.198
1 files changed, 98 insertions, 0 deletions
diff --git a/galsause.1 b/galsause.1
new file mode 100644
index 0000000..5a8c551
--- /dev/null
+++ b/galsause.1
@@ -0,0 +1,98 @@
+.TH GALSAUSE 1 GALSAUSE
+.SH NAME
+galsause - Set default ALSA PCM device
+.SH SYNPOSIS
+.B galsause
+.RI [ command
+.RI [ argument "] ...]"
+.SH DESCRIPTION
+The
+.B galsause
+utility is a graphical utility for setting the default
+ALSA PCM device for the user or a program it starts.
+.PP
+If
+.I command
+is specified, galsause will run that command with the default
+ALSA PCM device set only for that process and it's child processes.
+.SH OPTIONS
+The
+.B galsause
+utility conforms to the Base Definitions volume of POSIX.1-2017,
+.IR "Section 12.2" ", " "Utility Syntax Guidelines" .
+.PP
+No options are supported.
+.SH OPERANDS
+The following operands are supported:
+.TP
+.I command
+The name of the utility to be invoked.
+.TP
+.I argument
+A string to pass as an argument for the invoked utility.
+.SH STDIN
+Not used.
+.SH INPUT FILES
+None.
+.SH ENVIRONMENT VARIABLES
+The following environment variable affects the execution of
+.TP
+.I HOME
+Used to override the path to the user's home directroy.
+.TP
+.I PATH
+Determine the location of the
+.IR command ,
+as described in the Base Definitions volume of POSIX.1-2017,
+.IR "Chapter 8" ", " "Environment Variables" .
+.PP
+Additionally, environment variables that affect ALSA takes
+precedence over the default device set by the
+.B galsause
+utility.
+.SH ASYNCHRONOUS EVENTS
+Default.
+.SH STDOUT
+Not used.
+.SH STDERR
+The standard error is only used for diagnostic messages.
+.SH OUTPUT FILES
+If the the default ALSA PCM device is set, the
+.B galsause
+utility may create, modify, replace, or unlink the file
+.I .asoundrc
+placed in the user's home directory.
+.SH EXTENDED DESCRIPTION
+None.
+.SH EXIT STATUS
+If
+.I command
+is invoked, the exit status of
+.B galsause
+is the exit status of
+.IR command ;
+otherwise, the
+.B galsause
+utility exits with one of the following values.
+.TP
+0
+The
+.I galsause
+utility completed successfully.
+.TP
+125
+An error occurred in the
+.I galsause
+utility.
+.TP
+126
+The utility specified by
+.I command
+was found but could not be invoked.
+.TP
+127
+The utility specified by
+.I command
+could not be found.
+.SH SEE ALSO
+.BR alsause (1)