Print this page
12287 errors in audio utility man pages

Split Close
Expand all
Collapse all
          --- old/usr/src/man/man1/audiorecord.1
          +++ new/usr/src/man/man1/audiorecord.1
   1    1  '\" te
   2    2  .\"  Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
        3 +.\" Copyright 2020 Peter Tribble.
   3    4  .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
   4    5  .\"  See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the
   5    6  .\" fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6      -.TH AUDIORECORD 1 "May 13, 2017"
        7 +.TH AUDIORECORD 1 "Feb 8, 2020"
   7    8  .SH NAME
   8    9  audiorecord \- record an audio file
   9   10  .SH SYNOPSIS
  10      -.LP
  11   11  .nf
  12      -\fBaudiorecord\fR [\fB-af\fR] [\fB-v\fR \fIvol\fR] [\fB-c\fR \fIchannels\fR] [\fI-s\fR \fIrate\fR]
       12 +\fBaudiorecord\fR [\fB-af\fR] [\fB-v\fR \fIvol\fR] [\fB-c\fR \fIchannels\fR] [\fB-s\fR \fIrate\fR]
  13   13       [\fB-e\fR \fIencoding\fR] [\fB-t\fR \fItime\fR] [\fB-i\fR \fIinfo\fR] [\fB-d\fR \fIdev\fR]
  14      -     [\fB-T\fR \fBau\fR | \fBaif\fR[\fBf\fR] | \fBwav\fR] [\fIfile\fR[.\fBau\fR|.\fBaif\fR[\fBf\fR]]|.\fBwav\fR]
       14 +     [\fB-T\fR \fBau\fR|\fBaif\fR[\fBf\fR]|\fBwav\fR] [\fIfile\fR[.\fBau\fR|.\fBaif\fR[\fBf\fR]|.\fBwav\fR]]
  15   15  .fi
  16   16  
  17   17  .SH DESCRIPTION
  18      -.LP
  19   18  The \fBaudiorecord\fR utility copies audio data from the audio device to a
  20   19  named audio file, or to the standard output if no filename is present. If no
  21   20  output file is specified and standard output is a tty, the program exits with
  22   21  an error message.
  23   22  .sp
  24   23  .LP
  25      -By default, monaural audio data is recorded at 8 kHz and encoded in \fB-law\fR
       24 +By default, monaural audio data is recorded at 8 kHz and encoded in \fBu-law\fR
  26   25  format. If the audio device supports additional configurations, the \fB-c\fR,
  27   26  \fB-s\fR, and \fB-e\fR options may be used to specify the data format. The
  28   27  output file is prefixed by an audio file header that identifies the format of
  29   28  the data encoded in the file.
  30   29  .sp
  31   30  .LP
  32   31  Recording begins immediately and continues until a \fBSIGINT\fR signal (for
  33   32  example, Control-c) is received. If the \fB-t\fR option is specified,
  34   33  \fBaudiorecord\fR stops when the specified quantity of data has been recorded.
  35   34  .sp
  36   35  .LP
  37   36  If the audio device is unavailable, that is, if another process currently has
  38   37  read access, \fBaudiorecord\fR prints an error message and exits immediately.
  39   38  .SH OPTIONS
  40      -.LP
  41   39  The following options are supported:
  42   40  .sp
  43   41  .ne 2
  44   42  .na
  45      -\fB\fB-\e?\fR\fR
       43 +\fB\fB-?\fR\fR
  46   44  .ad
  47   45  .RS 24n
  48   46  \fIHelp\fR: Prints a command line usage message.
  49   47  .RE
  50   48  
  51   49  .sp
  52   50  .ne 2
  53   51  .na
  54   52  \fB\fB-a\fR\fR
  55   53  .ad
↓ open down ↓ 102 lines elided ↑ open up ↑
 158  156  \fIVolume\fR: The recording gain is set to the specified value before recording
 159  157  begins, and is reset to its previous level when \fBaudiorecord\fR exits. The
 160  158  \fIvol\fR argument is an integer value between 0 and 100, inclusive. If this
 161  159  argument is not specified, the input volume remains at the level most recently
 162  160  set by any process.
 163  161  .RE
 164  162  
 165  163  .SH OPERANDS
 166  164  .ne 2
 167  165  .na
 168      -\fB\fIfile\fR[\fB\&.au\fR|\fB\&.aif\fR[\fBf\fR]]|\fB\&.wav\fR\fR
      166 +\fIfile\fR[\fB\&.au\fR|\fB\&.aif\fR[\fBf\fR]|\fB\&.wav\fR]
 169  167  .ad
 170  168  .sp .6
 171  169  .RS 4n
 172  170  \fIFile Specification\fR: The named audio file is rewritten, or appended. If no
 173  171  filename is present, and standard output is not a tty, or if the special
 174  172  filename "\fB\(mi\fR" is specified, output is directed to the standard
 175  173  output.
 176  174  .sp
 177  175  If the \fB-T\fR option is not specified, the file suffix determines the type of
 178  176  file. If the suffix is not recognized, the default is \fB\&.au\fR. If the
 179  177  \fB-T\fR option \fBis\fR specified, that file type is used regardless of the
 180  178  file suffix.
 181  179  .RE
 182  180  
 183  181  .SH USAGE
 184      -.LP
 185  182  See \fBlargefile\fR(5) for the description of the behavior of \fBaudiorecord\fR
 186      -when encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).
      183 +when encountering files greater than or equal to 2 Gbyte (2^31 bytes).
 187  184  .SH ENVIRONMENT VARIABLES
 188  185  .ne 2
 189  186  .na
 190  187  \fB\fBAUDIODEV\fR\fR
 191  188  .ad
 192  189  .RS 12n
 193  190  The full path name of the audio device to record from, if no \fB-d\fR argument
 194  191  is supplied. If the \fBAUDIODEV\fR variable is not set, \fB/dev/audio\fR is
 195  192  used.
 196  193  .RE
 197  194  
 198      -.SH ATTRIBUTES
 199      -.LP
 200      -See \fBattributes\fR(5) for descriptions of the following attributes:
 201      -.sp
 202      -
 203      -.sp
 204      -.TS
 205      -box;
 206      -c | c
 207      -l | l .
 208      -ATTRIBUTE TYPE  ATTRIBUTE VALUE
 209      -_
 210      -Architecture    SPARC, x86
 211      -_
 212      -Interface Stability     Committed
 213      -.TE
 214      -
 215  195  .SH SEE ALSO
 216      -.LP
 217  196  \fBaudioconvert\fR(1), \fBaudioplay\fR(1),
 218      -\fBattributes\fR(5), \fBlargefile\fR(5), \fBaudio\fR(7I)
      197 +\fBlargefile\fR(5), \fBaudio\fR(7I)
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX