rdsquery

Langue: en

Version: 366685 (MeeGo - 06/11/10)

Section: 1 (Commandes utilisateur)

NAME

rdsquery - commandline tool to query data from a Radio Data System daemon (rdsd).

This is a preliminary man page for the pre-Alpha development version of rdsquery. Not everything described in here necessarily works yet! Parameters might change before rdsquery becomes stable.

SYNTAX

rdsquery [options]

DESCRIPTION

rdsquery is a client application to read decoded Radio Data System (RDS) data from a RDS daemon (rdsd). It connects to rdsd via TCP/IP or a unix domain socket.

rdsquery uses librds for the lowlevel communication routines and therefore depends on the librds package.

OPTIONS

-c <num>
The number of data records rdsquery should retrieve. If <num> is 0, rdsquery runs in continous mode and has to be killed externally, e.g. by typing Ctrl-C. The default is -c 1, so if you don't give this option, one value of each type will be fetched before rdsquery terminates.
-s <server>
Connect to rdsd running on <server> using TCP/IP. <server> can either be an IP address like 192.168.1.1 or a hostname your system is able to resolve.
-p <port>
If your rdsd is not running on its default port 4321, you have to specify the port with this option.
-u <socketname>
Connect to rdsd running on the same computer using an unix domain socket.
-e
Get the list of sources rdsd knows about. To select a certain source, use the -n option.
-n <num>
The number of the source from which data should be retrieved. Numbering starts from 0, you can get a list of sources known by rdsd using the -e option. If you don't give this option, 0 is assumed.
-t <type1,type2,...>
The list of data types that rdsquery should retrieve. Possible types are:
rflags: Some bitwise coded flags. See librds.h for details.
picode: The Program Identifiction code.
ptype: Program type number.
pname: Program name.
locdt: Local date and time.
utcdt: UTC date and time.
rtxt: Current radio text buffer.
lrtxt: Last radio text. The last completely received radio text string. This is usually what you want if you want to read radio text.
tmc: TMC (Traffic Message Channel) message list (numerical).
aflist: List of alternative frequencies.
gstat: Statistics about received RDS groups.
-h
Output some help text.
-v
Output version information and exit.

FILES

None, rdsquery is solely configured through commandline options.

EXAMPLES

Get a list of sources rdsd knows about. Connect to rdsd running on the local computer using an unix domain socket with the default parameters. This can also be used as a quick test if rdsd is up and running:

rdsquery -e

Display the last complete radio text string. The connection is made with TCP/IP, using the default port:

rdsquery -s 192.168.1.1 -t lrtxt

Display radio text strings continously until stopped with Ctrl-C:

rdsquery -c 0 -s 192.168.1.1 -t lrtxt

Get TMC data from the second source on the local computer:

rdsquery -n 1 -t tmc

Retrieve the last date/time information. Note that this is transmitted only every full minute. You can ask for two timestamps to make sure the second one was received on the full minute (hh:mm:00). Replace utcdt by locdt to get local date/time:

rdsquery -c 2 -s 192.168.1.1 -t utcdt

AUTHORS

Hans J. Koch <hjkoch@users.berlios.de>

Project homepage: http://rdsd.berlios.de