Annotation of src/usr.bin/mixerctl/mixerctl.1, Revision 1.1
1.1 ! provos 1: .\" $NetBSD: mixerctl.1,v 1.4 1997/10/19 05:09:35 lukem Exp $
! 2: .\" Copyright (c) 1997 The NetBSD Foundation, Inc.
! 3: .\" All rights reserved.
! 4: .\"
! 5: .\" Author: Lennart Augustsson
! 6: .\"
! 7: .\" Redistribution and use in source and binary forms, with or without
! 8: .\" modification, are permitted provided that the following conditions
! 9: .\" are met:
! 10: .\" 1. Redistributions of source code must retain the above copyright
! 11: .\" notice, this list of conditions and the following disclaimer.
! 12: .\" 2. Redistributions in binary form must reproduce the above copyright
! 13: .\" notice, this list of conditions and the following disclaimer in the
! 14: .\" documentation and/or other materials provided with the distribution.
! 15: .\" 3. All advertising materials mentioning features or use of this software
! 16: .\" must display the following acknowledgement:
! 17: .\" This product includes software developed by the NetBSD
! 18: .\" Foundation, Inc. and its contributors.
! 19: .\" 4. Neither the name of The NetBSD Foundation nor the names of its
! 20: .\" contributors may be used to endorse or promote products derived
! 21: .\" from this software without specific prior written permission.
! 22: .\"
! 23: .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
! 24: .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
! 25: .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
! 26: .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
! 27: .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
! 28: .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
! 29: .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
! 30: .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
! 31: .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
! 32: .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
! 33: .\" POSSIBILITY OF SUCH DAMAGE.
! 34: .\"
! 35: .Dd May 4, 1997
! 36: .Dt MIXERCTL 1
! 37: .Os
! 38: .Sh NAME
! 39: .Nm mixerctl
! 40: .Nd control audio mixing
! 41: .Sh SYNOPSIS
! 42: .Nm
! 43: .Op Fl f Ar file
! 44: .Op Fl n
! 45: .Op Fl v
! 46: .Fl a
! 47: .Nm ""
! 48: .Op Fl f Ar file
! 49: .Op Fl n
! 50: .Op Fl v
! 51: .Ar name ...
! 52: .Nm ""
! 53: .Op Fl f Ar file
! 54: .Op Fl n
! 55: .Fl w
! 56: .Ar name=value ...
! 57: .Sh DESCRIPTION
! 58: The
! 59: .Nm
! 60: command displays or sets various audio system mixing variables.
! 61: If a list of variables is present on the command line, then
! 62: .Nm
! 63: prints the current value of those variables for the specified device.
! 64: If the
! 65: .Fl a
! 66: flag is specified, all variables for the device are printed.
! 67: If the
! 68: .Fl w
! 69: flag is specified
! 70: .Nm
! 71: attempts to set the specified variables to the given values.
! 72: .Pp
! 73: The
! 74: .Fl f
! 75: flag can be used to give an alternative mixer device, the default is
! 76: .Pa /dev/mixer.
! 77: .Pp
! 78: The
! 79: .Fl n
! 80: flag suppresses printing of the variable name.
! 81: .Pp
! 82: The
! 83: .Fl v
! 84: flag shows the possible values of enumeration and set valued
! 85: variables. Enumerated values are shown in [] and set values
! 86: are shown in {}.
! 87: .Sh FILES
! 88: .Bl -tag -width /dev/mixer
! 89: .It Pa /dev/mixer
! 90: mixer audio device
! 91: .El
! 92: .Sh SEE ALSO
! 93: .Xr audioctl 1 ,
! 94: .Xr audio 4 ,
! 95: .Xr sysctl 8
! 96: .Sh HISTORY
! 97: The
! 98: .Nm
! 99: command first appeared in
! 100: .Nx 1.3 .
! 101: