summaryrefslogtreecommitdiffstats
path: root/doc/README.html.in
blob: 3cdd7f53889ec93d56a19a6f423bb6ef2c7402a7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
<?xml version="1.0" encoding="iso-8859-15"?> <!-- -*-html-helper-*- -->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">

<head>
<title>ivcall @PACKAGE_VERSION@</title>
<link rel="stylesheet" type="text/css" href="style.css" />
</head>

<body>
<h1><a name="top">ivcall @PACKAGE_VERSION@</a></h1>

<p><i>Copyright 2002,2003 Lennart Poettering &lt;@PACKAGE_BUGREPORT@&gt;</i></p>

<ul class="toc">
    <li><a href="#license">License</a></li>
    <li><a href="#news">News</a></li>
    <li><a href="#overview">Overview</a></li>
    <li><a href="#status">Status</a></li>
    <li><a href="#documentation">Documentation</a></li>
    <li><a href="#requirements">Requirements</a></li>
    <li><a href="#installation">Installation</a></li>
    <li><a href="#acks">Acknowledgements</a></li>
    <li><a href="#download">Download</a></li>
</ul>

<h2><a name="license">License</a></h2>

<p>This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.</p>

<p>This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.</p>

<p>You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</p>

<h2><a name="news">News</a></h2>

<div class="news-date">Sat Jan 2004: </div> <p class="news-text"><a
href="http://www.stud.uni-hamburg.de/~lennart/projects/ivcall/ivcall-0.3.tar.gz">Version
0.3</a> released, changes include: uucp locking fixes, <tt>ivcall</tt> may listen on wildcard MSNs now.</p>

<div class="news-date">Sun July 27 2003: </div> <p class="news-text"><a
href="http://www.stud.uni-hamburg.de/~lennart/projects/ivcall/ivcall-0.2.tar.gz">Version
0.2</a> released, changes include: many fixes, autoconf support</p>

<h2><a name="overview">Overview</a></h2>

<p><tt>ivcall</tt> is a small utility which may be used to make automated
telephone calls with your <i><a href="http://www.isdn4linux.de/">isdn4linux</a></i> supported ISDN
card. Outgoing calls are
supported as well as incoming calls. The audio data recieved
from the peer is written to STDOUT, audio data read from STDIN
is send to the peer. The audio data is in raw 8 bit uLaw 8 KHz format,
without any headers.</p>

 <h2><a name="status">Status</a></h2>

<p>Version @PACKAGE_VERSION@ is stable and feature complete.</p>
  
<h2><a name="documentation">Documentation</a></h2>

<p>Have a look on the man page <a href="@PACKAGE_URL@ivcall.1.xml"><tt>ivcall(1)</tt></a>. (An XSLT capable browser is required)</p>

<p>You may use <tt>ivcall</tt> as a Unix filter:

<pre>
ivcall LMSN RMSN < IFILE > OFILE
</pre>

<p>Replace <tt>LMSN</tt> by the local MSN and <tt>RMSN</tt> by the MSN
the program shall call. <tt>IFILE</tt> must be a raw uLAW 8 KHz
bytesized file, which is be played to the peer. <tt>OFILE</tT> is the
file the recorded audio data will be written to. It has the same
format as the input file. If no recording (or playback) is desired you
may pipe <tt>STDOUT</tt> (or <tt>STDIN</tt>) to <tt>/dev/null</tt>.

<p>Four detailed usage information try:</p>

<pre>
ivcall --help
</pre>

<p>If you want to create a sample playable with <tt>ivcall</tt> with your
soundcard, you'll need <tt>sox</tt>:</p>

<pre>$ rec -t raw -r 8000 -U -b FILE</pre>

<p>Don't forget to plug in a microphone and set the record volume with
<tt>aumix</tt> or something similar. However, it is recommended to create
audio samples with the telephone itself.</p>

<p>If you have a wave file you want to convert to a sample playable
with <tt>ivcall</tt> use <tt>sox</tt> as well:</p>

<pre>$ sox IFILE -t raw -r 8000 -U -b OFILE</pre>

<h2><a name="requirements">Requirements</a></h2>

<p>A newer Linux Kernel (I think 2.0 is good enough, alltough I tested it
only with 2.4) with a compatible device driver (<tt>isdn4linux</tt>).

<p><tt>ivcall</tt> was developed and tested on Debian GNU/Linux
"testing" from July 2003, it should work on most other Linux
distributions since it uses GNU autoconf for source code configuration.</p>

<h2><a name="installation">Installation</a></h2>

<p>As this package is made with the GNU autotools you should run
<tt>./configure</tt> inside the distribution directory for configuring
the source tree. After that you should run <tt>make</tt> for
compilation and <tt>make install</tt> (as root) for installation of
<tt>ivcall</tt>.</p>

<h2><a name="acks">Acknowledgements</a></h2>

<p>For the developers of <tt>awag</tt> (Stefan Szomraky), <tt>minicom</tt> (Miquel van Smoorenburg) and <tt>vbox</tt> (Michael Herold), since I looked
on their source codes for learning how to use the <tt>isdn4linux</tt> modem emulation</p>

<h2><a name="download">Download</a></h2>

<p>The newest release is always available from <a href="@PACKAGE_URL@">@PACKAGE_URL@</a></p>

<p>The current release is <a href="@PACKAGE_URL@ivcall-@PACKAGE_VERSION@.tar.gz">@PACKAGE_VERSION@</a></p>

<p>Get <tt>ivcall</tt>'s development sources from the <a href="http://subversion.tigris.org/">Subversion</a> <a href="https://seth.intheinter.net:8081/svn/ivcall/">repository</a>.</p>


<hr/>
<address class="grey">Lennart Poettering &lt;@PACKAGE_BUGREPORT@&gt;, January 2004</address>
<div class="grey"><i>$Id$</i></div>

</body>
</html>