runtime/doc/userguide/networking-with-windows.docbook

   1 <sect1 id="networking-with-windows">
   2 <sect1info>
   3 <authorgroup>
   4 <author>
   5 <firstname>Gardner</firstname>
   6 <surname>Bell</surname>
   7 </author>
   8 </authorgroup>
   9 </sect1info>
  10
  11
  12 <title>Networking With Windows</title>
  13
  14 <para> This section is borrowed and modified from Alexander Neundorf's
  15 README file on LISa.</para>
  16
  17 <para>&kde; features two powerful servers called the Lan Information
  18 Server (<application>LISa</application>) and Restricted Lan
  19 Information Server (<application>resLISa</application>) which are used
  20 to identify CIFS and other servers on your local network providing a
  21 function similar to <quote>Network Neighbourhood</quote> in
  22 &Microsoft; &Windows;.</para>
  23
  24 <sect2 id="How-It-Works">
  25 <title>How It Works</title>
  26
  27 <para>&lisa; only depends on the TCP/IP stack so samba configuration is not
  28 required to make it work but the <ulink
  29 url="http://www.samba.org">samba</ulink> package is a dependency.  To find
  30 hosts on your local network you set a range of IP-Addresses in your
  31 configuration file that &lisa; will check.  When you start the &lisa; daemon
  32 it will send a <ulink url="http://www.ietf.org/rfc/rfc792.txt">ICMP</ulink>,
  33 echo request message to all the IP addresses given in the configuration file
  34 and await a response.</para>
  35
  36 <note><para>The &lisa; daemon requires root privileges to open the socket,
  37 but once the socket has been established root privileges are immediately
  38 dropped.</para></note>
  39
  40 <para>You can also execute &lisa; using <command>nmblookup
  41 <option>"*"</option></command>.<note><para>If you do not have the
  42 <command>nmblookup</command> program it can be found at <ulink
  43 url="http://www.samba.org">http://www.samba.org</ulink> or through packages
  44 provided by your distribution</para></note>.  The samba command
  45 <command>nmblookup <option>"*"</option></command> will send a broadcast
  46 message to the attached network and any host that is running the
  47 smb-services will send a reply stating that it is accepting
  48 connections.</para>
  49 </sect2>
  50
  51 <sect2 id="resLISa">
  52 <title><application>resLISa</application></title>
  53
  54 <para>If your company network has very strict guidelines governing what
  55 ports can and cannot be opened you will have to use &reslisa; to communicate
  56 with other hosts on your network.  Because &reslisa; cannot ping entire
  57 networks or address ranges you will have to add each host by name to your
  58 confiuration file.  Currently you are able to add up to 64 hosts, and these
  59 addresses are pingable.</para>
  60
  61 <note><para>&reslisa; will only provide the information over a &UNIX; domain
  62 socket, &ie; not over the network.  The name of the socket is
  63 <filename>/tmp/resLISa-<replaceable>YourLoginName</replaceable></filename>,
  64 so &reslisa; can be safely run on the same machine by more than one
  65 user.</para></note>
  66 </sect2>
  67
  68 <sect2 id="configuration">
  69 <title>Configuration</title>
  70
  71 <para>At startup &lisa; first parses the configuration file in the users
  72 home directory under <filename>$<envar>HOME</envar>/.lisarc</filename>.  If
  73 this file does not exist &lisa; will then look for a system wide
  74 confiuration located at <filename>/etc/lisarc</filename>.  Now for a sample
  75 example configuration file:</para>
  76
  77 <programlisting>
  78 PingAddresses = 192.168.100.0/255.255.255.0;192.168.100.10-192.168.199.19;192.168.200.1;
  79 PingNames = my_host1;my_host2    #Hosts by name (required for <application>resLISa</application>)
  80 AllowedAddresses = 192.168.0.0/255.255.0.0
  81 BroadcastNetwork = 192.168.100.0/255.255.255.0
  82 SearchUsingNmblookup = 1         #also try nmblookup
  83 FirstWait = 30                   #30 one-hundredth's of a second
  84 SecondWait = -1                  #Only try once
  85 #SecondWait = 60                 #Try twice and wait 0.6 seconds
  86 UpdatePeriod = 300               #Update every 300 sec's
  87 DeliverUnnamedHosts = 0          #Don't publish unnamed hosts
  88 MaxPingsAtOnce = 256             #Send up to 256 ICMP echo requests at once
  89 </programlisting>
  90
  91 <para>&lisa; can also be configured graphically in the
  92 <menuchoice><guimenuitem>&kcontrolcenter;</guimenuitem><guisubmenu>Internet
  93 &amp; Network</guisubmenu><guimenuitem>Local Network Browsing</guimenuitem>
  94 </menuchoice> item in the &kmenu;.  However, to use this option &lisa; must
  95 be started with the <option>-K</option> command line switch.</para>
  96
  97 <!--TODO add a section explaining graphical configuration? -->
  98
  99 <!-- Add links to "further reading" here -->
 100 <itemizedlist>
 101 <title>Related Information</title>
 102 <listitem><para>For a full list of command line switches and further
 103 examples see the entire &lisa; manual by entering
 104 <userinput>help:/lisa</userinput> in &konqueror;.</para>
 105 </listitem>
 106 </itemizedlist>
 107
 108
 109 </sect2>
 110 </sect1>
 111
 112 <!-- Keep this comment at the end of the file
 113 Local variables:
 114 mode: xml
 115 sgml-omittag:nil
 116 sgml-shorttag:nil
 117 sgml-namecase-general:nil
 118 sgml-general-insert-case:lower
 119 sgml-minimize-attributes:nil
 120 sgml-always-quote-attributes:t
 121 sgml-indent-step:0
 122 sgml-indent-data:true
 123 sgml-parent-document:("index.docbook" "book" "sect1")
 124 sgml-exposed-tags:nil
 125 sgml-local-catalogs:nil
 126 sgml-local-ecat-files:nil
 127 End:
 128 -->