audial.1x - Man Page

generate or recognize touch tones for North American telephones

Synopsis

audial [-audio servername] [-volume 0-100]  [-spacing milliseconds] [-pause milliseconds]  [-duration milliseconds] dialstring

audial -recognize [-microphone] [-gain 0-100] [-time seconds]

Description

The audial program generates touch tones suitable for dialing a  North American telephone.  audial can also recognize touch tones and produce the corresponding string.

General Options

The following options may be used in either dial or recognition mode:

-audio servername

This option specifies the Network Audio System server on which the files should be played.

Dial Options

The following options may be used in dial mode:

-volume 0-100

This option specifies the volume at which the data should be played as a  percentage of the maximum possible volume.  The default is 100 percent.

-spacing milliseconds

This option specifies the number of milliseconds to wait in between each digit. The default is 100.

-pause milliseconds

This option specifies the number of milliseconds to wait whenever a comma (,) is used in a dial string.  The default is 400.

-duration milliseconds

This option specifies the duration of each tone in milliseconds. The default is 100.

Dialing String

The following characters may be used in a dialing string:

0123456789*#

The corresponding touch tone is generated.

abcd

Tones representing the 4 "function" keys often found on a keypad are generated.

,

A blank tone whose length is specified by the -pause option is generated.

Any other characters are ignored.

Recognition Options

-recognize

Enables recognition mode.  audial will attempt to recognize touch tones from the input device and output the corresponding character.

-microphone

Use microphone gain levels on the audio input device.  If a microphone is plugged into the audio input jack, this option should be used.

-gain 0-100

This option specifies the input gain level.  The default is 95.

-time seconds

This option specifies how long to attempt the recognition.  The default is forever.

Environment Variables

The following environment variables are used by audial:

AUDIOSERVER

This specifies the name of default audio server to contact if no name is  explicitly given on the command line.

DISPLAY

This specifies the name of an X Window System display that should be assumed to also have a corresponding Network Audio System server.

See Also

nas(1)

Authors

Greg Renda, Network Computing Devices, Inc.
Kevin Martin, Network Computing Devices, Inc.

Referenced By

auctl.1x(1), nas.1x(1).

1.9.5