Rechercher une page de manuel
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
Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre