Update manual page and command-line help.

Also remove unneded alternative code in isdn.c.
This commit is contained in:
Ivan Schreter 2007-11-25 17:18:50 +01:00
parent 94492d68e8
commit ed8d8d792e
3 changed files with 26 additions and 18 deletions

View File

@ -5,7 +5,7 @@ ant-phone \- an interactive ISDN telephone application
.B ant-phone
.RI [ options ]
.SH DESCRIPTION
ant-phone is part of ANT (ANT is Not a Telephone). It let's you make and receive telephone calls and talk via sound devices. It uses ISDN4Linux ttyI devices.
ant-phone is part of ANT (ANT is Not a Telephone). It let's you make and receive telephone calls and talk via sound devices. It uses CAPI 2.0 as ISDN interface.
.SH OPTIONS
ant-phone accepts the following options:
.TP
@ -19,15 +19,15 @@ Print version information
Remove stale socket file left by accident by a previous run of ANT. You only need this option if ANT says: "local bind: Address already in use"
.TP
.BI "\-d, \-\-debug" [ = debuglevel]
Print additional runtime debugging data to stdout, debuglevel = 1..2
Print additional runtime debugging data to stdout, debuglevel = 1..4
.TP
.BI "\-i, \-\-soundin=" device
OSS compatible device for input (recording),
default: /dev/dsp
ALSA device name for input (recording),
default: "default"
.TP
.BI "\-o, \-\-soundout=" device
OSS compatible device for output (playback),
default: /dev/dsp
ALSA device name for output (playback),
default: "default"
.TP
.BI "\-m, \-\-msn=" msn
identifying MSN (for outgoing calls), 0 for master MSN of this
@ -41,6 +41,15 @@ default: *
.BI "\-c, \-\-call=" number
Make a running instance of ANT make a call to the specified number,
useful for calling from an external address book application
.TP
.BI "\-s, \-\-sleep"
Shut down CAPI connection to prepare for removal of broken kernel modules,
which don't survive suspend/restore.
.TP
.BI "\-w, \-\-wakeup"
Restore CAPI connection after ISDN modules loaded again. The connection will
be also restored by dialing a number, but before the connection is restored,
you won't be able to accept calls.
.SH NOTES
If the used sound devices (arguments of \-\-soundin and \-\-soundout)
are equal, a full duplex sound device is needed.
@ -54,7 +63,11 @@ user specific options file
.TP
.I ~/.ant-phone/callerid
saved history of incoming and outgoing calls
.TP
.I ~/.ant-phone/recordings/*
recordings of recorded phone calls
.SH BUGS
The GTK+ main loop consumes all the system CPU time. This is due to the Linux kernel select() call consuming the time while waiting for a completed data block. This only appears with some Linux kernel OSS drivers, not with ALSA.
Caller ID stores hangup reason localized. This will break, if someone uses
letters outside of English alphabet for translation of hangup reasons.
.SH AUTHORS
ANT was developed by Roland Stigge <stigge@antcom.de>, based on ideas from IVCALL, Copyright 2002 Lennart Poettering. G.711 handling by Sun Microsystems. Contributions by Joerg Mayer <jmayer@loplof.de>, Lars Volkhardt <Lars.Volkhardt@uni-konstanz.de>.
ANT was developed by Roland Stigge <stigge@antcom.de>, based on ideas from IVCALL, Copyright 2002 Lennart Poettering. G.711 handling by Sun Microsystems. Contributions by Joerg Mayer <jmayer@loplof.de>, Lars Volkhardt <Lars.Volkhardt@uni-konstanz.de>, Ivan Schreter <schreter@gmx.net>.

View File

@ -177,11 +177,11 @@ Options:\n\
-r, --cleanup Remove stale socket file (left by accident by\n\
previous run)\n\
-d, --debug[=level] Print additional runtime debugging data to stdout\n\
level = 1..2\n\
-i, --soundin=DEVICE OSS compatible device for input (recording),\n\
default: /dev/dsp\n\
-o, --soundout=DEVICE OSS compatible device for output (playback),\n\
default: /dev/dsp\n\
level = 1..4\n\
-i, --soundin=DEVICE ALSA device name for input (recording),\n\
default: \"default\"\n\
-o, --soundout=DEVICE ALSA device name for output (playback),\n\
default: \"default\"\n\
-m, --msn=MSN identifying MSN (for outgoing calls), 0 for master\n\
MSN of this termination/port\n\
default: 0\n\

View File

@ -559,10 +559,6 @@ static void isdn_handle_indication(isdn_t *isdn, _cmsg *msg)
/* may ring now */
isdn->active_plci = plci;
#if 0
isdn->state = ISDN_RINGING;
isdn->callback->info_ring(isdn->cb_context, isdn->remote_number, isdn->local_number);
#else
/* tell the network, we are interested in the call and ring */
dbgprintf(2, "CAPI 2.0: ALERT_REQ ApplID %d msgno %d plci 0x%x\n",
isdn->appl_id, isdn->msg_no, plci);
@ -579,7 +575,6 @@ static void isdn_handle_indication(isdn_t *isdn, _cmsg *msg)
errprintf("CAPI 2.0: ALERT_REQ failed, RC=0x%x, rejecting call\n", info);
reject = 3;
}
#endif
}
if (reject) {