File: bplay.1

package info (click to toggle)
bplay 0.991-5
  • links: PTS
  • area: main
  • in suites: woody
  • size: 120 kB
  • ctags: 118
  • sloc: ansic: 1,020; makefile: 44
file content (92 lines) | stat: -rw-r--r-- 2,642 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
.TH BPLAY 1 "20 September 1999"
.SH NAME
bplay, brec \- buffered sound recording/playing
.SH SYNOPSIS
.B bplay
[\-d device] [\-B buffersize] [\-S] [\-s speed] [\-b bits] [[\-t secs] | [\-T samples]]
[[\-j secs] | [\-J samples]] [\-D level] [file]
.sp
.B brec
[\-d device] [\-B buffersize] [\-S] [\-s speed] [\-b bits] [[\-t secs]
| [\-T samples]] [\-r|\-v|\-w] [\-D level] [file]
.SH DESCRIPTION
.B bplay
copies data from the named sound file (or the standard input if no filename
is given) to the audio device.
.PP
.B brec
copies data from the audio device to the named sound file (or the
standard output if no filename is present).
.PP
These programs are intended to be drop\-in replacements for the
.B vplay
and
.B vrec
programs by Michael Beck (beck@informatik.hu-berlin.de).
.SS OPTIONS
.TP
.I "\-B buffersize"
Use the supplied audio buffer size instead of the default.
.TP
.I "\-d device"
Use the supplied audio device instead of the default.
.TP
.I "\-S"
Sound file is stereo.
.TP
.I "\-s speed"
The speed in samples per second.
.TP
.I "\-b bits"
The number of bits per sample. Only 8 and 16 are currently supported.
.TP
.I "\-t secs"
The number of seconds to be played or recorded.
.TP
.I "\-T samples"
The number of samples to be played or recorded.
.TP
.I "\-j secs"
When playing, the number of seconds to skip at the beginning of the input before
playing.
.TP
.I "\-J samples"
When playing, the number of samples to skip at the beginning of the input before
playing.
.TP
.I "\-r"
When recording, write raw sound file.
.TP
.I "\-v"
When recording, write Creative Labs VOC sound file.
.TP
.I "\-w"
When recording write Microsoft Wave sound file.
.TP
.I "\-D level"
Print debug information to stderr. Debug level ranges from 0 to 2,
where 0 is no debug information.
.SH FILES
.I /dev/dsp
The audio device.
.SH BUGS
.PP
The \-t, \-T, \-j and \-J options may do strange things when playing VOC
files.
.PP
There are limitations on recording VOC format files - specifically VOC
files are only recorded in the 1.20 version of the format, which some
player programs may choke on. There is also currently a limit of around
16M on the size of a VOC file which will be recorded. This is probably
not a problem since I don't think anybody really uses VOC files anymore.
.PP
This program prefers to run setuid root. This is because it wants to use
setpriority() to run at the highest possible priority, and also locks
down the buffers it uses to avoid them being swapped out.
.SH AUTHOR
David Monro (davidm@amberdata.demon.co.uk or davidm@cs.usyd.edu.au)
.PP
The option parsing code was originally taken from
.B vplay
to maintain
compatability.