NAME    [Toc]    [Back]

     radioctl - control radio tuners

SYNOPSIS    [Toc]    [Back]

     radioctl [-f file] [-n] -a
     radioctl [-f file] [-n] name
     radioctl [-f file] [-n] name=value

DESCRIPTION    [Toc]    [Back]

     The radioctl command displays or sets various variables that
affect the
     radio  tuner  behavior. If a variable is present on the command line,
     radioctl prints the current value of this variable  for  the
specified device.
   By  default, radioctl operates on the /dev/radio device.

     The options are as follows:

     -a      Print all device variables and their current values.

     -f file
             Specify an alternative radio tuner device.

     -n      Suppress printing of the variable name.

     name=value
             Attempt to set the specified variable name to value.

     Values may be  specified  in  either  absolute  or  relative
forms.  The relative
  form  is indicated by a prefix of `+' or `-' to denote
an increase or
     decrease, respectively.

     The exact set of controls that can be manipulated depends on
the tuner.
     The general format (in both getting and setting a value) is

           name=value

     The  name  indicates  what part of the tuner the control affects.

     Write only controls:

     search  Only for cards that allow hardware  search.  Can  be
`up' or `down'.

     Read-write controls:

     frequency
             Float value from 87.5 to 108.0.

     volume  Integer value from 0 to 255.

     mute     Mutes  the  card  (volume is not affected), `on' or
`off'.

     mono    Forces card output to mono, `on' or `off'.  Only for
cards that
             allow forced mono.

     reference
             Reference  frequency.  Can be 25 kHz, 50 kHz and 100
kHz. Not all
             cards allow the reference frequency to be changed.

     sensitivity
             Station locking sensitivity. Can be 5 mkV,  10  mkV,
30 mkV and 150
             mkV.  Not all cards allow the station locking sensitivity to be
             changed.

     All the remaining controls (signal, stereo and card capabilities) are
     read-only and can be viewed using option -a.

ENVIRONMENT    [Toc]    [Back]

     The  following environment variable affects the execution of
radioctl:

     RADIODEVICE  The radio tuner device to use.

FILES    [Toc]    [Back]

     /dev/radio  radio tuner device

EXAMPLES    [Toc]    [Back]

     The command

           $ radioctl -a

     can produce

     volume=255
     frequency=106.30MHz
     mute=off
     reference=50kHz
     signal=on
     stereo=on
     card capabilities:
             manageable mono/stereo

SEE ALSO    [Toc]    [Back]

     radio(4)

HISTORY    [Toc]    [Back]

     radioctl command first appeared in OpenBSD 3.0.

OpenBSD     3.6                       September     16,      2001