<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<article class="whitepaper" id="Modem-Sharing-HOWTO">

<!-- Written using guidance provided in the LDP Author Guide. aeg -->

<artheader>
  <title>Modem Sharing mini-HOWTO</title>

  <author>
    <firstname>Friedemann</firstname>
    <surname>Baitinger</surname>
    <affiliation>
      <address>
        <email>fb@baiti.net</email>
      </address>
    </affiliation>
  </author>

  <editor>
    <firstname>Anthony</firstname>
    <othername>E.</othername>
    <surname>Greene</surname>
    <affiliation>
      <address>
        <email>agreene@pobox.com</email>
      </address>
    </affiliation>
  </editor>
  
  <author>
    <firstname>Vertaald door: Ellen</firstname>
    <surname>Bokhorst</surname>
    <affiliation>
      <address>
        <email>bokkie@nl.linux.org</email>
      </address>
    </affiliation>
  </author>

  <pubdate>22-08-2001</pubdate>

  <revhistory>
    <revision>
      <revnumber>v1.12</revnumber>
      <date>22-08-2001</date>
      <authorinitials>gjf</authorinitials>
      <revremark>E-mail van de auteur gecorrigeerd</revremark>
    </revision>

    <revision>
      <revnumber>v1.11</revnumber>
      <date>12-07-2001</date>
      <authorinitials>aeg</authorinitials>
      <revremark>Naar DocBook SGML geconverteerd</revremark>
    </revision>

    <revision>
      <revnumber>v1.10</revnumber>
      <date>11-09-1999</date>
      <authorinitials>fb</authorinitials>
      <revremark>Sectie "Feedback van Gebruikers" toegevoegd</revremark>
    </revision>

    <revision>
      <revnumber>v1.01</revnumber>
      <date>12-06-1997</date>
      <authorinitials>fb</authorinitials>
      <revremark>Source naar HTML geconverteerd</revremark>
    </revision>
  </revhistory>

  <abstract>
    <para>Hierin wordt beschreven hoe een Linux systeem zodanig in te
    stellen dat een modem kan worden gedeeld met anderen systemen over
    een TPC/IP netwerk.</para>
  </abstract>

  <keywordset>
    <keyword>modem</keyword>
    <keyword>share</keyword>
    <keyword>dialup</keyword>
    <keyword>ppp</keyword>
    <keyword>masquerade</keyword>
    <keyword>Masqdialer</keyword>
  </keywordset>

</artheader>

<sect1 id="legalnotice">
<title>Legal Notice</title>

    <para>
     Copyright &copy; 1997 Friedemann Baitinger. Dit document mag alleen
     worden gedistribueerd onder de voorwaarden en condities uiteengezet
     in de GNU Free Documentation License te vinden op
     &lt;<ulink url="http://www.gnu.org/copyleft/fdl.html">
     http://www.gnu.org/copyleft/fdl.html</ulink>&gt;. 
    </para>
    
</sect1>

<!-- This should generate a page break in the print versions. aeg -->

<sect1 id="the-server-side">
<title>De Server Side</title>

<para>Er wordt verondersteld dat de server een Linux systeem is met:</para>

  <itemizedlist>
    <listitem><para>een modem gekoppeld aan een <filename>/dev/ttySx</filename> device</para></listitem>
    <listitem><para>of een ge&euml;muleerd 'isdn4linux' modem ingedeeld als een
    <filename>/dev/ttyIx</filename> device</para></listitem>
  </itemizedlist>

<para>De makkelijkste setup die ik kan bedenken maakt gebruik van een 
vijfregelig perlscript om een modem daemon in
<filename>/usr/sbin/modemd</filename> te implementeren:</para>

<programlisting>   
#!/usr/bin/perl
select((select(STDOUT), $| = 1)[$[]);
select((select(STDIN), $| = 1)[$[]);
exec 'cu -s 115200 -l /dev/ttyS1';
die '$0: Cant exec cu: $!\n';
</programlisting>

<para>De modem daemon wordt gestart door het <command>inetd</command> proces 
als een client een verbinding maakt met de van toepassing zijnde poort zoals
hieronder beschreven. De <command>modemd</command> verbindt simpelweg
de socket handle met STDIN en STDOUT van de opdracht
<command>cu</command> en laat <command>cu</command> het feitelijke
modemdevice afhandelen.</para>

<para>Het bestaan van de modemdaemon moet bekend worden gemaakt aan
het <command>inetd</command> proces door zijn configuratiebestand bij te
werken, gewoonlijk <filename>/etc/inetd.conf</filename>:</para>

<screen>
#
# modem daemon
#
modem stream tcp nowait root /usr/sbin/tcpd /usr/sbin/modemd /dev/ttyS1
</screen>

<para>Om dit werkend te krijgen, moet in <filename>/etc/services</filename>
een regel toegevoegd worden:</para>

<screen>   
modem           2006/tcp        modemd
</screen>

<para>Dit verbindt een symbolische naam aan een expliciete poort, in dit
voorbeeld 2006. Het poortnummer kan elk nummer zijn zolang het nog niet is 
toegekend aan een bestaande service. Nadat deze wijzigingen zijn aangebracht,
moet een signaal naar het inetd proces worden gezonden waardoor
<command>inetd</command> zijn configuratiebestand opnieuw inleest en
het verwerkt:</para>

<screen>   
<prompt>bash#</prompt> ps | grep inetd
194  ?  S     0:00 /usr/sbin/inetd

<prompt>bash#</prompt> kill -HUP 194
</screen>

<para>Nu is de server zover dat het verzoeken van clients accepteert.
Het correcte functioneren kan worden geverifieerd met:</para>

<screen>
<prompt>bash$</prompt> telnet localhost modem

Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
</screen>

<para>Je hebt nu een verbinding met de modem tot stand gebracht. Je kunt
nu <command>AT</command> opdrachten uitvoeren om de setup te verifi&uml;ren:
</para>

<screen>   
atz
atz
OK

ati1
ati1
Linux ISDN
OK

^]
telnet&gt;quit
<prompt>bash$</prompt>
</screen>

<para>Als vervanging van het Perlscript als modemserver, kan ook een
programma genaamd <productname>Masqdialer</productname> worden gebruikt,
wat beschikbaar is op
<ulink url="http://w3.cpwright.com/mserver/">http://w3.cpwright.com/mserver/</ulink>.</para>

<para>Met <productname>Masqdialer</productname> kun je elk aantal
modems verbonden met je server exporteren naar elke host die een verbinding
met de server kan maken via TCP/IP op een gegeven poort met een binaire
gegevensstroom.</para>

<sect2 id="masqdialer-installation">
<title>Masqdialer installatie</title>

<para>Controleer voor de compilatie de opties in config.h:</para>

<itemizedlist>
  <listitem><para>stel naar wens het pad in voor het configuratiebestand
  </para></listitem>
  <listitem><para>stel naar wens het pad in voor het lockbestand
  </para></listitem>
</itemizedlist>

<para>Voer uit: <command>make all</command>.</para>

<para>Kopieer de binaire bestanden (<filename>mserver</filename> en 
<filename>tcpconn</filename>) naar een geschikte directory, zoals
<systemitem>/usr/local/sbin/</systemitem>. Kopieer 
<filename>mserver.conf</filename> naar de lokatie die je hebt opgegeven in
<filename>config.h</filename>.</para>

<para><productname>Masqdialer</productname> zou kunnen worden opgestart
vanuit &eacute;&eacute;n van de systeemopstartscripts.
Een eenvoudig
<command>/usr/local/sbin/mserver</command> zal het als een daemon
uitvoeren.</para>
</sect2>

<sect2 id="masqdialer-configuration">
<title>Masqdialer configuratie</title>

<para>Een regel in <filename>mserver.conf</filename> zou er zo uit
kunnen zien:
</para>

<screen>
5800 /dev/ttyS1      115200,8,N,1    *.foo.org,192.168.2.1
</screen>

<para>wat zou betekenen dat een moden aangesloten op
<filename>/dev/ttyS1</filename> via poort 5800 overal vandaan in het
domein foo.org en vanaf host 192.168.2.1 een verbinding kan maken.
Alle andere hosts worden geweigerd. Valkuil: Als je geen hosts opgeeft dan
zal <emphasis>ELKE</emphasis> host een verbinding tot stand kunnen
brengen. De instellingen van de seri&euml;le lijn zijn vast en deze
kunnen vanaf de client niet worden gewijzigd. Je kunt op een enkele poort
verscheidene modems exporteren. <productname>Masqdialer</productname> 
plaats alleen een lock op modemdevices via lockbestanden in de stijl
van UUCP wanneer ze werkelijk in gebruik zijn, dus andere programma's
de mogelijkheid bieden er gebruik van te maken.</para>

</sect2>
</sect1>


<sect1 id="the-client-side">
<title>De Client Side</title>

<para>Thans wordt hier alleen de setup van Windows clients beschreven.
Op de client PC, is een COM-poort redirector voor TCP/IP nodig.
Het beste programma dat ik vond voor dit doel is
<productname>DialOut/IP</productname> van Tactical Software voor 
<productname>Windows 3.1</productname> en 
<productname>Windows 95</productname>.  (De <productname>Windows 
3.1</productname> versie kan onder <productname>Windows NT</productname>
alleen voor 16-bit applicaties worden gebruikt.
Een 32-bit versie voor <productname>Windows NT</productname> is eind van
de zomer van 1997 te verwachten.)
</para>

<para><productname>DialOut/IP</productname> presenteert de gedeelde modem
op een nieuwe virtuele COM-poort dat het toevoegt aan
<productname>Windows</productname>.  
Deze virtuele COM-poort kan worden gebruikt door 
<productname>Windows</productname>  programma's alsof de gedeelde modem
direct is verbonden. De meeste client
applicaties (waaronder <productname>Windows 95</productname> dial-up 
networking) accepteren dit en werken alsof er een echte COM-poort en
modem aanwezig is, met als uitzondering de fax applicaties of enige andere
programma's die toegang tot de UART control lines nodig hebben.
<productname>DialOut/IP</productname> kan zo worden geconfigureerd
dat het voorziet in verwerking van het telnetprotocol, maar die feature
is van toepassing op bepaalde modem poolproducten, en niet op de Linux
setup die in dit bestand wordt beschreven.
<productname>DialOut/IP</productname> kan, ondanks zijn naam, ook worden 
gebruikt door applicaties die op inkomende aanroepen wachten.</para>

<para>Op 
<ulink url="http://www.tactical-sw.com/">http://www.tactical-sw.com/</ulink> 
bevindt zich een pagina voor het downloaden van een volledig functionele
evaluatieversie welke na 1-2 weken verloopt. De installatie en configuratie
wordt door een setupprogramma afgehandeld en de installatiedetails
zijn te vinden in het <filename>README.TXT</filename> bestand.  
Wanneer je <productname>DialOut/IP</productname> opstart, 
geef je het IP-adres en het poortnummer van de gedeelde modem op.</para>

<para><productname>DialOut/IP</productname> is een commercieel product dat
is gelicentieerd op een per-modem basis, dat wil zeggen dat de prijs
afhankelijk is van het aantal modems dat je deelt. In de licentie staat
dat je de software op elk willekeurig aantal PC's kunt installeren die
de gedeelde modems benaderen.
</para>

</sect1>



<sect1 id="security-considerations">
<title>Beveiligingsoverwegingen</title>

<para>Als je slechts &eacute;&eacute;n modem hebt in je local area
network, dan is er waarschijnlijk geen reden je zorgen te maken om
de beveiliging. Als er echter &eacute;&eacute;n of meer hosts in je LAN
met het Internet zijn verbonden via andere middelen dan de modem die we
zojuist hebben ingesteld als modemserver, dan moet enige mate van
beveiliging worden overwogen, anders kan iedereen een
<command>telnet je_host modem</command> uitvoeren en naar wens
lange afstands of zelfs internationale aanroepen uitvoeren.
</para>

<para>Ik raad je aan tcp-wrappers te installeren en configureren om 
de modemserver tegen ongeautoriseerde toegang te beschermen.
</para>

</sect1>



<sect1 id="examples">
<title>Voorbeelden</title>

<para>Ik gebruik de setup zoals beschreven in
<link linkend="the-server-side">De Server Side</link> en 
<link linkend="the-client-side">De Client Side</link> om op
mijn <productname>Windows 95</productname> <productname>ThinkPad</productname>
<productname>Quicken</productname> uit te voeren en thuis te bankieren
met de modem aangesloten op mijn Linux machine. De "modem" in mijn geval
is zelfs geen echt modem, het is een ge&euml;muleerd modem op een ISDN-So
kaart. <productname>Quicken</productname> ziet slechts een COM-poort,
het weet niet dat het device aangesloten op de COM-poort zich in werkelijkheid
aan het andere einde van mijn Ethernet LAN bevindt, noch weet het niet dat
het geen standaard analoog modem is, maar een ISDN-device welk
<command>AT</command> opdrachten begrijpt.</para>
</sect1>

<sect1 id="feedback-from-users">
<title>Feedback van gebruikers</title>

<para>Sinds de eerste uitgave van dit document in juni 1997 heb ik
heel wat e-mailberichten gerelateerd aan dit onderwerp ontvangen.
In de meeste berichten waren mensen op zoek naar meer hulp om 
het delen van de modem geconfigureerd en draaiend te krijgen.
</para>

<para>Onlangs ontving ik een interessante feedback van
<ulink url="mailto:Karsten%20Hilbert%20%3CKarsten.Hilbert@gmx.net%3E?subject=Masqdialer%20client">Karsten.Hilbert@gmx.net</ulink>. Karsten wees me erop dat
ondanks dat <productname>DialOut/IP</productname> dan een goede clientprogramma
kan zijn, hij graag een client onder 
<ulink url="http://www.gnu.org/">GPL</ulink> zou willen hebben.
Karsten vermeldde de Software Bazaar 
&lt;<ulink url="http://visar.csustan.edu/bazaar/">http://visar.csustan.edu/bazaar/</ulink>&gt; 
deed vrijwillig een schenking. Karsen schreef het volgende:</para>

<screen>
     Date: Fri, 27 Aug 1999 17:46:39 +0200 (CEST)
     From: Karsten Hilbert &lt;med94ecz@studserv.uni-leipzig.de&gt;
     Reply-To: Karsten Hilbert &lt;Karsten.Hilbert@gmx.net&gt;
     To: fb@baiti.net
     Subject: Windows-Modemsharing-Howto

     Hi !

     De howto benoemd DialOut/IP als een goed hulpmiddel om Windows clients
     te verbinden met een linux server door het delen van een modem.

     Ik ben het daarmee eens. Het zou echter aantrekkelijker zijn als
     er een client onder GPL zou zijn, nietwaar? Hier dacht ik aan en
     ik besloot wat geld te schenken voor de implementatie van een
     dergelijke client op de Software Bazaar. Als iemand het project
     oppakt zal ik hem een bepaald bedrag betalen als het voltooid
     is en functioneel. Daarna zou de client onder de GPL vallen.

     Nu kan ik slechts een beetje geld schenken :) Maar andere mensen
     zouden mee kunnen doen en ook wat kunnen schenken, om meer te motiveren.
     Zou je howto geen perfecte plaats zijn om deze mogelijkheid
     te noemen?

     De Bazaar is te vinden op:

      http://visar.csustan.edu/bazaar/

     Dit is wat ik je wilde melden.

     Karsten
</screen>

</sect1>

</article>