The Configuration File
Now an example config file:

PingAddresses = 192.168.100.0/255.255.255.0;192.168.100.10-192.168.199.19;192.168.200.1;192-192.168-168.100-199.0-9;
PingNames = bb_mail;
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 hundredth seconds
SecondWait = -1                         #only one try
#SecondWait = 60                         #try twice, and the second time wait 0.6 seconds
UpdatePeriod = 300                      #update after 300 secs
DeliverUnnamedHosts = 0                 #don't publish hosts without name
MaxPingsAtOnce = 256                    #send up to 256 ICMP echo requests at once

PingAddresses
This is probably the most important entry.
Here you say which addresses will be pinged. You can specify multiple ranges, they are divided by semicolons.
There are four possible ways to define addresses:
net address/network mask 	 192.168.100.0/255.255.255.0, an IP address and the assigned network mask.
This doesn't have to be the network address and netmask of your machine. For example, if you have 10.0.0.0/255.0.0.0 as your own address, you could specify 10.1.2.0/255.255.255.0 if you are only interested in these addresses. The combination IP address-network mask must be divided by a slash / and the address does not have to be a real network address, it can also be a host address of the desired network, 10.12.34.67/255.0.0.0 is the same as 10.0.0.0/255.0.0.0 .
a range of IP addresses 	 For example: 192.168.100.10-192.168.199.19
An IP-address where pinging will start and an IP-address where pinging will end.
Both addresses must be divided by a -.
In this example this would produce 199-100+1=100, 100*256=25.600, 25.600+(19-10+1)=25.590 addresses
An IP address, as represented by ranges of each of the four decimal numbers 	 An IP address can be represented by its four decimal numbers, and you can specify ranges four each of these four numbers: 192-192.169-171.100-199.0-9
In this example all IP addresses with first number 192, second number from 168 to 168, third number from 100 up to 199 and last number from 0 up to 9 will be pinged. This would give 1*1*100*10=1.000 addresses.
This is probably only useful in very seldom cases. Here you have to provide ranges for every four numbers, always divided by -.
Single IP addresses or host names 	 The IP address or host name of any machine you are particularly interested in.
It is also valid to leave this entry empty.

PingNames
Here you can additionally specify hosts to ping using their names. The names have to be divided by semicolons.
It is also valid to leave this entry empty.

AllowedAddresses
This is also very important. LISa will only ping addresses, accept clients and answer broadcasts from addresses, which are covered by the addresses given in this line. You can add up to 32 network addresses/network masks or single addresses. Divide them by ; and don't put empty space between the addresses!
For example, 192.168.0.0/255.255.0.0;192.169.0.0
A complete network and a single address are valid. Always make this as strict as possible, usually your network address/subnetmask is a good choice.

BroadcastNetwork
This entry contains exactly one network address/subnet mask. To this network broadcasts will be sent. Usually this should be your own network address/subnetmask, for example: 192.168.0.0/255.255.0.0

SearchUsingNmblookup
Here you can give 0 or 1. 1 means that LISa will execute nmblookup "*" and parse the output from this command. This produces less network traffic than the pinging, but you will only get hosts which have a SMB service running ( machines or machines running samba).
If you enable this option and also give IP addresses to ping, then nmblookup will be executed first and then the pinging will start. Then only addresses will be pinged, which were not already delivered from nmblookup. This should slightly decrease the network load.

FirstWait
If LISa pings, if it sends the ICMP echo requests, it sends a bunch of requests at once, and the it will wait for the number of hundredth seconds you specify here. Usually values from 5 to 50 should be good, the maximum is 99 (gives 0.99 seconds, a very long time). Try to make this value as small as possible while still finding all running hosts.

SecondWait
After LISa has sent the echo requests the first time, it can be possible that some hosts were not found. To improve the results, LISa can ping a second time. This time it will only ping hosts, from which it didn't receive answers. If you have good results with pinging only once, you can disable the second time with setting SecondWait to -1.
Otherwise it might be a good idea to make this value a little bit bigger than the value for FirstWait, since the hosts which were not found on the first try, are probably slower or further away so they might take some milliseconds longer to answer. Usually values from 5 to 50 should be good or -1 to disable the second scan. The maximum is 99 (gives 0.99 seconds, a very long time).

UpdatePeriod
This is the interval after which LISa will update. After this time LISa will again ping or nmblookup or get the list of hosts from the LISa server which actually does the pinging.
Valid values are between 30 seconds and 1800 seconds (half an hour). If you have a big network, don't make the interval too small (to keep network load low). Values from 300 to 900 seconds (5 to 15 minutes) might be a good idea.
Keep in mind that the update period is doubled if nobody accesses the server, up to 4 times, so the interval will become 16 times the value given here and will be reseted to the value given here if somebody accesses the server.

DeliverUnnamedHosts
If an answer to an echo request from an IP address was received, were LISa could not determine a name, it will be only delivered over the port if you set this to 1.
I am not really sure if this is a useful feature, but maybe there are some infrastructure devices in your network without assigned names, so they don't have to be published. Set this to 0 if you want to keep them secret ;-) If unsure, say 0.

MaxPingsAtOnce
When sending the pings (echo requests), LISa sends a bunch of these at once and then waits for the answers. By default there are 256 pings sent at once, usually you should not need the change this value. If you make it much bigger, the internal receive buffers for the answers to the echo requests may become to small, if you make it to small, the updating will be slower.

Three more example files

FIXME
You are member of a small network with 24 bit network mask, up to 256 hosts:

PingAddresses = 192.168.100.0/255.255.255.0
AllowedAddresses = 192.168.100.0/255.255.255.0
BroadcastNetwork = 192.168.100.0/255.255.255.0
SearchUsingNmblookup = 0                         #don't use nmblookup
FirstWait = 20                                   #20 hundredth seconds
SecondWait = 30                                  #30 hundredth seconds on the seconds try
UpdatePeriod = 300                               #update after 300 secs
DeliverUnnamedHosts = 0                          #don't publish hosts without name

Configuration file for hosts running SMB only
You are only interested in hosts running SMB services and you don't have routers in your network:

AllowedAddresses = 192.168.100.0/255.255.255.0
BroadcastNetwork = 192.168.100.0/255.255.255.0
SearchUsingNmblookup = 1                #use nmblookup
UpdatePeriod = 300                      #update after 300 secs
DeliverUnnamedHosts = 0                 #don't publish hosts without name

Configuration file using both nmblookup and pinging
The same network, but here both nmblookup and pinging is used.

PingAddresses = 192.168.100.0/255.255.255.0
PingNames = bb_mail
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 hundredth seconds
SecondWait = -1                         #only one try
#SecondWait = 60                         #try twice, and the second time wait 0.6 seconds
UpdatePeriod = 300                      #update after 300 secs
DeliverUnnamedHosts = 0                 #don't publish hosts without name
MaxPingsAtOnce = 256                    #send up to 256 ICMP echo requests at once

Configuration file for resLISa
And now a configuration file for resLISa, PingAddresses is not used by resLISa, neither is BroadcastNetwork.

PingNames = bb_mail;some_host;some_other_host
AllowedAddresses = 192.168.0.0/255.255.0.0
SearchUsingNmblookup = 1                # use nmblookup
FirstWait = 30                          #30 hundredth seconds
SecondWait = -1                         #only one try
#SecondWait = 60                         #try twice, and the second time wait 0.6 seconds
UpdatePeriod = 300                      #update after 300 secs
DeliverUnnamedHosts = 1                 #also publish hosts without name
MaxPingsAtOnce = 256                    #send up to 256 ICMP echo requests at once