Return to README CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / dhcp / tests / DHCPv6

Annotation of embedaddon/dhcp/tests/DHCPv6/README, revision 1.1

1.1     ! misho       1: In order to test the DHCPv6 server, we have a configuration file with
        !             2: known values, and some Perl scripts designed to send and receive
        !             3: DHCPv6 packets to check various code paths.
        !             4: 
        !             5: It is not complete test converage by any means, but it should be
        !             6: fairly easy to add additional tests as needed.
        !             7: 
        !             8: The scripts themselves are not very well written. There is a lot of
        !             9: copied code, poor error handling, and so on. These should be rewritten
        !            10: at some point.
        !            11: 
        !            12: To use, the DHCPv6 server must be running in test mode to send back to
        !            13: the originating port. (The scripts can be changed to bind to the
        !            14: appropriate client port, but they don't now, and have to run as root
        !            15: to do this). In server/dhcpv6.c, look for this comment:
        !            16: 
        !            17: /* For testing, we reply to the sending port, so we don't need a root */
        !            18: /* client */
        !            19:                to_addr.sin6_port = remote_port;
        !            20: /*             to_addr.sin6_port = packet->client_port;*/
        !            21: 
        !            22: And change the code to use the client_port value.
        !            23: 
        !            24: You will need to modify one of the test configuration files to use one 
        !            25: of the physical subnets that your machine uses, in the subnet6 
        !            26: statement.
        !            27: 
        !            28: Then run the server as root, in debug mode:
        !            29: 
        !            30: # touch /tmp/test.leases
        !            31: # dhcpd -cf test-a.conf -lf /tmp/test.leases -d
        !            32: 
        !            33: You can invoke the scripts then:
        !            34: 
        !            35: $ perl 000-badmsgtype.pl
        !            36: 
        !            37: The expected results vary per script, depending on the behavior that
        !            38: is being tested.
        !            39: 
        !            40: 
        !            41: Notes about scripts:
        !            42: 
        !            43: In order to manipulate IPv6 addresses, we need the Socket6 library,
        !            44: available from CPAN:
        !            45: 
        !            46: http://search.cpan.org/~umemoto/Socket6-0.19/Socket6.pm
        !            47: 
        !            48: The Perl that Sun issues for Solaris 10 is compiled with the Sun
        !            49: compiler. If you have the Sun compiler, then this will work fine.
        !            50: Otherwise you may need to install Perl from source.
        !            51: 
        !            52: We need to get the hardware address in order to build DUID properly.
        !            53: The IO::Interface module reports hardware address, but not on Solaris
        !            54: 10 it seems. Rather than do this the "right way", we do it the "Perl
        !            55: way", and hack it. "ifconfig" does return the Ethernet address, but
        !            56: only to the root user. However, we can look for files of the name
        !            57: /etc/hostname.*, get the IP address from "ifconfig", and then check
        !            58: for those addresses in the ARP table.
        !            59: 
        !            60: Client DUID is supposed to be an opaque value to the server, but we go
        !            61: ahead and make a "real" type 1 or type 3 DUID.
        !            62: