From 4aed2c8219774f5d797760606b8489a92ddc5163 Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdebase@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/userguide/networking-with-windows.docbook | 128 ++++++++++++++++++++++++++ 1 file changed, 128 insertions(+) create mode 100644 doc/userguide/networking-with-windows.docbook (limited to 'doc/userguide/networking-with-windows.docbook') diff --git a/doc/userguide/networking-with-windows.docbook b/doc/userguide/networking-with-windows.docbook new file mode 100644 index 000000000..ba8ef0596 --- /dev/null +++ b/doc/userguide/networking-with-windows.docbook @@ -0,0 +1,128 @@ + + + + +Gardner +Bell + + + + + +Networking With Windows + + This section is borrowed and modified from Alexander Neundorf's +README file on LISa. + +&kde; features two powerful servers called the Lan Information +Server (LISa) and Restricted Lan +Information Server (resLISa) which are used +to identify CIFS and other servers on your local network providing a +function similar to Network Neighbourhood in +&Microsoft; &Windows;. + + +How It Works + +&lisa; only depends on the TCP/IP stack so samba configuration is not +required to make it work but the samba package is a dependency. To find +hosts on your local network you set a range of IP-Addresses in your +configuration file that &lisa; will check. When you start the &lisa; daemon +it will send a ICMP, +echo request message to all the IP addresses given in the configuration file +and await a response. + +The &lisa; daemon requires root privileges to open the socket, +but once the socket has been established root privileges are immediately +dropped. + +You can also execute &lisa; using nmblookup +.If you do not have the +nmblookup program it can be found at http://www.samba.org or through packages +provided by your distribution. The samba command +nmblookup will send a broadcast +message to the attached network and any host that is running the +smb-services will send a reply stating that it is accepting +connections. + + + +<application>resLISa</application> + +If your company network has very strict guidelines governing what +ports can and cannot be opened you will have to use &reslisa; to communicate +with other hosts on your network. Because &reslisa; cannot ping entire +networks or address ranges you will have to add each host by name to your +confiuration file. Currently you are able to add up to 64 hosts, and these +addresses are pingable. + +&reslisa; will only provide the information over a &UNIX; domain +socket, &ie; not over the network. The name of the socket is +/tmp/resLISa-YourLoginName, +so &reslisa; can be safely run on the same machine by more than one +user. + + + +Configuration + +At startup &lisa; first parses the configuration file in the users +home directory under $HOME/.lisarc. If +this file does not exist &lisa; will then look for a system wide +confiuration located at /etc/lisarc. Now for a sample +example configuration file: + + +PingAddresses = 192.168.100.0/255.255.255.0;192.168.100.10-192.168.199.19;192.168.200.1; +PingNames = my_host1;my_host2 #Hosts by name (required for resLISa) +AllowedAddresses = 192.168.0.0/255.255.0.0 +BroadcastNetwork = 192.168.100.0/255.255.255.0 +SearchUsingNmblookup = 1 #also try nmblookup +FirstWait = 30 #30 one-hundredth's of a second +SecondWait = -1 #Only try once +#SecondWait = 60 #Try twice and wait 0.6 seconds +UpdatePeriod = 300 #Update every 300 sec's +DeliverUnnamedHosts = 0 #Don't publish unnamed hosts +MaxPingsAtOnce = 256 #Send up to 256 ICMP echo requests at once + + +&lisa; can also be configured graphically in the +&kcontrolcenter;Internet +& NetworkLocal Network Browsing + item in the &kmenu;. However, to use this option &lisa; must +be started with the command line switch. + + + + + +Related Information +For a full list of command line switches and further +examples see the entire &lisa; manual by entering +help:/lisa in &konqueror;. + + + + + + + + -- cgit v1.2.1