Print this page
12287 errors in audio utility man pages
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1/audiorecord.1.man.txt
+++ new/usr/src/man/man1/audiorecord.1.man.txt
1 1 AUDIORECORD(1) User Commands AUDIORECORD(1)
2 2
3 3
4 4
5 5 NAME
6 6 audiorecord - record an audio file
7 7
8 8 SYNOPSIS
9 9 audiorecord [-af] [-v vol] [-c channels] [-s rate]
10 10 [-e encoding] [-t time] [-i info] [-d dev]
11 - [-T au | aif[f] | wav] [file[.au|.aif[f]]|.wav]
11 + [-T au|aif[f]|wav] [file[.au|.aif[f]|.wav]]
12 12
13 13
14 14 DESCRIPTION
15 15 The audiorecord utility copies audio data from the audio device to a
16 16 named audio file, or to the standard output if no filename is present.
17 17 If no output file is specified and standard output is a tty, the
18 18 program exits with an error message.
19 19
20 20
21 - By default, monaural audio data is recorded at 8 kHz and encoded in
22 - -law format. If the audio device supports additional configurations,
23 - the -c, -s, and -e options may be used to specify the data format. The
21 + By default, monaural audio data is recorded at 8 kHz and encoded in u-
22 + law format. If the audio device supports additional configurations, the
23 + -c, -s, and -e options may be used to specify the data format. The
24 24 output file is prefixed by an audio file header that identifies the
25 25 format of the data encoded in the file.
26 26
27 27
28 28 Recording begins immediately and continues until a SIGINT signal (for
29 29 example, Control-c) is received. If the -t option is specified,
30 30 audiorecord stops when the specified quantity of data has been
31 31 recorded.
32 32
33 33
34 34 If the audio device is unavailable, that is, if another process
35 35 currently has read access, audiorecord prints an error message and
36 36 exits immediately.
37 37
38 38 OPTIONS
39 39 The following options are supported:
40 40
41 - -\?
41 + -?
42 42 Help: Prints a command line usage message.
43 43
44 44
45 45 -a
46 46 Append: Appends the data on the end of the
47 47 named audio file. The audio device must support
48 48 the audio data format of the existing file.
49 49
50 50
51 51 -c channels
52 52 Channels: Specifies the number of audio
53 53 channels (1 or 2). The value may be specified
54 54 as an integer or as the string mono or stereo.
55 55 The default value is mono.
56 56
57 57
58 58 -d dev
59 59 Device: The dev argument specifies an alternate
60 60 audio device from which input should be taken.
61 61 If the -d option is not specified, the AUDIODEV
62 62 environment variable is consulted (see below).
63 63 Otherwise, /dev/audio is used as the default
64 64 audio device.
65 65
66 66
67 67 -e encoding
68 68 Encoding: Specifies the audio data encoding.
69 69 This value may be one of ulaw, alaw, or linear.
70 70 The default encoding is ulaw.
71 71
72 72
73 73 -f
74 74 Force: When the -a flag is specified, the
75 75 sample rate of the audio device must match the
76 76 sample rate at which the original file was
77 77 recorded. If the -f flag is also specified,
78 78 sample rate differences are ignored, with a
79 79 warning message printed on the standard error.
80 80
81 81
82 82 -i info
83 83 Information: The `information' field of the
84 84 output file header is set to the string
85 85 specified by the info argument. This option
86 86 cannot be specified in conjunction with the -a
87 87 argument.
88 88
89 89
90 90 -s rate
91 91 Sample Rate: Specifies the sample rate, in
92 92 samples per second. If a number is followed by
93 93 the letter k, it is multiplied by 1000 (for
94 94 example, 44.1k = 44100). The default sample
95 95 rate is 8 kHz.
96 96
97 97
98 98 -t time
99 99 Time: The time argument specifies the maximum
100 100 length of time to record. Time can be specified
101 101 as a floating-point value, indicating the
102 102 number of seconds, or in the form: hh:mm:ss.dd,
103 103 where the hour and minute specifications are
104 104 optional.
105 105
106 106
107 107 -T au | aif[f] | wav
108 108 Specifies the audio file type to create. If the
109 109 -a option is used, the file type must match the
110 110 file to which it is being appended. Regardless
111 111 of the file suffix, the type is set as
112 112 specified in this option. If this option is not
113 113 specified, the file suffix determines the type.
114 114
115 115
116 116 -v vol
|
↓ open down ↓ |
65 lines elided |
↑ open up ↑ |
117 117 Volume: The recording gain is set to the
118 118 specified value before recording begins, and is
119 119 reset to its previous level when audiorecord
120 120 exits. The vol argument is an integer value
121 121 between 0 and 100, inclusive. If this argument
122 122 is not specified, the input volume remains at
123 123 the level most recently set by any process.
124 124
125 125
126 126 OPERANDS
127 - file[.au|.aif[f]]|.wav
127 + file[.au|.aif[f]|.wav]
128 128
129 129 File Specification: The named audio file is rewritten, or appended.
130 130 If no filename is present, and standard output is not a tty, or if
131 131 the special filename "-" is specified, output is directed to the
132 132 standard output.
133 133
134 134 If the -T option is not specified, the file suffix determines the
135 135 type of file. If the suffix is not recognized, the default is .au.
136 136 If the -T option is specified, that file type is used regardless of
137 137 the file suffix.
138 138
139 139
140 140 USAGE
141 141 See largefile(5) for the description of the behavior of audiorecord
142 - when encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).
142 + when encountering files greater than or equal to 2 Gbyte (2^31 bytes).
143 143
144 144 ENVIRONMENT VARIABLES
145 145 AUDIODEV
146 146 The full path name of the audio device to record from, if
147 147 no -d argument is supplied. If the AUDIODEV variable is not
148 148 set, /dev/audio is used.
149 149
150 150
151 -ATTRIBUTES
152 - See attributes(5) for descriptions of the following attributes:
153 -
154 -
155 -
156 -
157 - +--------------------+-----------------+
158 - | ATTRIBUTE TYPE | ATTRIBUTE VALUE |
159 - +--------------------+-----------------+
160 - |Architecture | SPARC, x86 |
161 - +--------------------+-----------------+
162 - |Interface Stability | Committed |
163 - +--------------------+-----------------+
164 -
165 151 SEE ALSO
166 - audioconvert(1), audioplay(1), attributes(5), largefile(5), audio(7I)
152 + audioconvert(1), audioplay(1), largefile(5), audio(7I)
167 153
168 154
169 155
170 - May 13, 2017 AUDIORECORD(1)
156 + February 8, 2020 AUDIORECORD(1)
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX