                        Network toolbox lcrzoex

              -------------------------------------------
              |              KNOWN PROBLEMS             |
              -------------------------------------------

This file describes known problems (incompatibilities, unsupported
functionnalities, errors, etc.).
If you seek help (usage help, examples, etc.), it's better to read 
lcrzo-4.xx-doc_html.tgz or lcrzoex-4.xx-doc_html.tgz. You 
can also use "man lcrzo" or "man lcrzoex".

Problems described in this file are (if you encounter an unknown problem,
thanks for contacting me, as explained in ./doc/problemreport_en.txt) :

WHILE EXECUTING ./GENEMAKE
 1: ./genemake : Permission denied.

WHILE EXECUTING
 2: Segmentation fault while converting from IP address to ethernet
    address. [problem in /etc/nsswitch.conf]
 3: Segmentation fault while converting from IP address to ethernet
    address. [problem in /etc/ethers]
 4: Why running 'lcrzoex 157' ?
 5: Several tools do not work.

Currently, there is nothing to say.



-------------------------------------------------------------------------------
Problem 1 :
  Problem synthesis :
    ./genemake : Permission denied.
  Environment affected by the problem :
    All
  What's causing the problem :
    lcrzo-4.xx-src.tgz wasn't uncompressed with a good program.
  Solution :
    Use :
         tar -zxvf lcrzo-4.xx-src.tgz
    or
         gunzip lcrzo-4.xx-src.tgz ; tar -xvf lcrzo-4.xx-src.tar

-------------------------------------------------------------------------------
Problem 2 :
  Problem synthesis :
    Segmentation fault while converting from IP address to ethernet
    address. [problem in /etc/nsswitch.conf]
  Environment affected by the problem :
    Glibc-2.?? (<2.2.1) with "nisplus" or "db" in /etc/nsswitch.conf
  What's causing the problem :
    The problem arises when calling the function ether_hostton, and when
    the entry "nisplus" or "db" is in /etc/nsswitch.conf.
    Indeed, there is an error in glibc source (glibc-2.1.3) :
      nis/nss_nisplus/nisplus-ethers.c, line 234 : 
        there is "if (name != NULL)" instead of "if (name == NULL)"
    Note : an email was sent to glibc developers. They applied a patch
           in glibc 2.2.1.
  Solution 1 :
    Edit /etc/nsswitch.conf to replace the line :
         ethers: _here_nisplus_or_nis_or_db_is_written_ files
    by :
         ethers: files
    Indeed, the problems disappears when removing "nis", "nisplus" or "db".
    You should then execute "genemake" again (and compile and install)
    to ensure that lcrzo will use ether_hostton.
  Solution 2 :
    Install glibc > 2.2.1.

-------------------------------------------------------------------------------
Problem 3 :
  Problem synthesis :
    Segmentation fault while converting from IP address to ethernet
    address. [problem in /etc/ethers]
  Environment affected by the problem :
    /etc/ethers empty
  What's causing the problem :
    The problem arises when /etc/ethers exists, but is empty.
    Indeed, there is an error in glibc source (glibc-2.1.3) :
      inet/ether_hton.c, line 76 :
        fct has only four parameters, instead of five
    Note : an email was sent to glibc developers. They applied a patch
           in glibc 2.2.1.
  Solution 1 :
    Remove the file /etc/ethers if it doesn't contain any line.
  Solution 2 :
    Install glibc > 2.2.1.

-------------------------------------------------------------------------------
Problem 4 :
  Problem synthesis :
    Why running 'lcrzoex 157' ?
  Environment affected by the problem :
    All
  What's causing the problem :
    Obtaining the configuration (device, arp cache, routes) of the 
    local computer is an important step of lcrzo. Several tools need
    this configuration to be accurate.
    Different kinds of network cards, modems, operating systems, etc.
    exist. So, it's possible that your computer contains unrecognized
    hardware. In this case, several lcrzoex tools would be 
    unusables.
    For these reasons, the first tool to use is 'lcrzoex 157' to
    ensure correct configuration setting.
    Here is a correct example (taken on Linux) :
     Devices
      device  ethernet          ip          /netmask        mtu
      lo      00:00:00:00:00:00 127.0.0.1   /255.0.0.0      3924 up
      eth0    00:00:33:AC:C2:24 192.168.1.1 /255.255.255.0  1500 up
      eth0:1  00:00:33:AC:C2:24 192.168.2.1 /255.255.255.0  1500 up,alias
      eth1    00:00:43:BC:D2:34 192.168.3.1 /255.255.255.0  1500 up
     Arp
      lo      00:00:00:00:00:00 127.0.0.1     (permanent)
      eth0    00:00:33:AC:C2:24 192.168.1.1   (permanent)
      eth0:1  00:00:33:AC:C2:24 192.168.2.1   (permanent)
      eth1    00:00:43:BC:D2:34 192.168.3.1   (permanent)
      eth0    12:34:56:78:90:ab 192.168.1.254 (-1s)
     Routes
      device  destination  /netmask         ip_source     gateway
      lo      127.0.0.1    /255.255.255.255 local_device                 0,up
      eth0    192.168.1.1  /255.255.255.255 local_device                 0,up
      eth0:1  192.168.2.1  /255.255.255.255 local_device                 0,up
      eth1    192.168.3.1  /255.255.255.255 local_device                 0,up
      eth0    192.168.1.0  /255.255.255.0   192.168.1.1                  0,up
      eth0:1  192.168.2.0  /255.255.255.0   192.168.2.1                  0,up
      eth1    192.168.3.0  /255.255.255.0   192.168.3.1                  0,up
      lo      127.0.0.0    /255.0.0.0       127.0.0.1                    0,up
      eth0    0.0.0.0      /0.0.0.0         192.168.1.1   192.168.1.254  0,up
    In this example, we see the loopback device (lo), and two network cards
    (eth0 and eth1). Card eth0 has an alias.
    The arp table contains permanent entries, and the dynamic entry for
    the router 192.168.1.254.
    The routing table first contains entries to access local devices, then
    network connected to the local devices, and finally the default router
    192.168.1.254.
  Solution :
    As I cannot have access to your hardware, you have to send me information
    about your configuration in order to help lcrzo's improvements.
    Run :
      lcrzoex 278 > resultfile
    Then, send me the file 'resultfile', along with configuration information
    (ifconfig, ipconfig /all, arp -a, route print, netstat -rn, 
    winipcfg /all /batch file.out, winipcfg, network card type, modem type,
    etc.). Thanks.

-------------------------------------------------------------------------------
Problem 5 :
  Problem synthesis :
    Several tools do not work.
  Environment affected by the problem :
    All
  What's causing the problem :
    Obtaining the configuration (device, arp cache, routes) of the 
    local computer is an important step of lcrzo. Several tools need
    this configuration to be accurate.
    Different kinds of network cards, modems, operating systems, etc.
    exist. So, it's possible that your computer contains unrecognized
    hardware. In this case, several lcrzoex tools would be 
    unusables.
    For these reasons, the first tool to use is 'lcrzoex 157' to
    ensure correct configuration setting.
    Here is a correct example (taken on Linux) :
     Devices
      device  ethernet          ip          /netmask        mtu
      lo      00:00:00:00:00:00 127.0.0.1   /255.0.0.0      3924 up
      eth0    00:00:33:AC:C2:24 192.168.1.1 /255.255.255.0  1500 up
      eth0:1  00:00:33:AC:C2:24 192.168.2.1 /255.255.255.0  1500 up,alias
      eth1    00:00:43:BC:D2:34 192.168.3.1 /255.255.255.0  1500 up
     Arp
      lo      00:00:00:00:00:00 127.0.0.1     (permanent)
      eth0    00:00:33:AC:C2:24 192.168.1.1   (permanent)
      eth0:1  00:00:33:AC:C2:24 192.168.2.1   (permanent)
      eth1    00:00:43:BC:D2:34 192.168.3.1   (permanent)
      eth0    12:34:56:78:90:ab 192.168.1.254 (-1s)
     Routes
      device  destination  /netmask         ip_source     gateway
      lo      127.0.0.1    /255.255.255.255 local_device                 0,up
      eth0    192.168.1.1  /255.255.255.255 local_device                 0,up
      eth0:1  192.168.2.1  /255.255.255.255 local_device                 0,up
      eth1    192.168.3.1  /255.255.255.255 local_device                 0,up
      eth0    192.168.1.0  /255.255.255.0   192.168.1.1                  0,up
      eth0:1  192.168.2.0  /255.255.255.0   192.168.2.1                  0,up
      eth1    192.168.3.0  /255.255.255.0   192.168.3.1                  0,up
      lo      127.0.0.0    /255.0.0.0       127.0.0.1                    0,up
      eth0    0.0.0.0      /0.0.0.0         192.168.1.1   192.168.1.254  0,up
    In this example, we see the loopback device (lo), and two network cards
    (eth0 and eth1). Card eth0 has an alias.
    The arp table contains permanent entries, and the dynamic entry for
    the router 192.168.1.254.
    The routing table first contains entries to access local devices, then
    network connected to the local devices, and finally the default router
    192.168.1.254.
  Solution :
    As I cannot have access to your hardware, you have to send me information
    about your configuration in order to help lcrzo's improvements.
    Run :
      lcrzoex 278 > resultfile
    Then, send me the file 'resultfile', along with configuration information
    (ifconfig, ipconfig /all, arp -a, route print, netstat -rn, 
    winipcfg /all /batch file.out, winipcfg, network card type, modem type,
    etc.). Thanks.
