Changeset View
Changeset View
Standalone View
Standalone View
usr.sbin/beep/beep.8
- This file was added.
.\"- | |||||
.\" Copyright (c) 2021 Hans Petter Selasky <hselasky@FreeBSD.org> | |||||
.\" | |||||
.\" Redistribution and use in source and binary forms, with or without | |||||
pstef: Aren't we dropping this from wherever we can legally? | |||||
Not Done Inline ActionsYeah the standard copyright template for new code no longer has this. It's not a big deal but serves no purpose so if there's no other reason to include it (e.g. your employer requires it) then I'd leave it out. emaste: Yeah the standard copyright template for new code no longer has this. It's not a big deal but… | |||||
Done Inline ActionsFixed. hselasky: Fixed. | |||||
.\" modification, are permitted provided that the following conditions | |||||
.\" are met: | |||||
.\" 1. Redistributions of source code must retain the above copyright | |||||
.\" notice, this list of conditions and the following disclaimer. | |||||
.\" 2. Redistributions in binary form must reproduce the above copyright | |||||
.\" notice, this list of conditions and the following disclaimer in the | |||||
.\" documentation and/or other materials provided with the distribution. | |||||
.\" | |||||
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR | |||||
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES | |||||
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. | |||||
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, | |||||
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT | |||||
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | |||||
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | |||||
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |||||
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | |||||
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |||||
.\" | |||||
.\" $FreeBSD$ | |||||
.\" | |||||
.Dd October 26, 2021 | |||||
.Dt beep 8 | |||||
.Os | |||||
.Sh NAME | |||||
.Nm beep | |||||
.Nd send beep to soundcard | |||||
.Sh SYNOPSIS | |||||
.Nm | |||||
.Op Fl F Ar frequency | |||||
.Op Fl D Ar duration_ms | |||||
.Op Fl r Ar sample_rate_hz | |||||
.Op Fl d Ar oss_device | |||||
.Op Fl g Ar gain | |||||
.Op Fl B | |||||
.Op Fl h | |||||
.Sh DESCRIPTION | |||||
The | |||||
.Nm | |||||
utility is used to playback a beep to the soundcard. | |||||
.Pp | |||||
The options are as follows: | |||||
.Bl -tag -width "-f device" | |||||
.It Fl F | |||||
Sets the center frequency of the beep in Hz. | |||||
The default is 440Hz . | |||||
.It Fl D | |||||
Sets the duration of the beep in milliseconds. | |||||
The default is 150ms . | |||||
.It Fl D | |||||
Sets the soundcard to use. | |||||
The default is /dev/dsp . | |||||
.It Fl r | |||||
Sets the soundcard samplerate in Hz. | |||||
The default is 48000Hz. | |||||
.It Fl g | |||||
Sets the waveform gain, between 0 and 100 inclusivly. | |||||
The default is 75. | |||||
.It Fl B | |||||
Runs the | |||||
.Nm | |||||
utility in the background. | |||||
.It Fl h | |||||
Display summary of options. | |||||
.El | |||||
.Sh EXAMPLES | |||||
.Pp | |||||
Playback default beep sound using /dev/dsp . | |||||
.Bl -tag -width Ds -offset indent | |||||
.It $ beep | |||||
.El | |||||
.Sh SEE ALSO | |||||
.Xr mixer 3 , | |||||
.Xr sound 4 , | |||||
.Sh HISTORY | |||||
The | |||||
.Nm | |||||
utility first appeared in FreeBSD 14.0. | |||||
.Sh AUTHORS | |||||
.An Hans Petter Selasky Aq Mt hselasky@FreeBSD.org |
Aren't we dropping this from wherever we can legally?