README
1Net::Libdnet
2============
3
4DESCRIPTION
5
6This is a Perl interface for libdnet.
7
8INSTALLATION
9
10To install this module type the following:
11
12 perl Makefile.PL
13 make
14 make test
15 make install
16
17Note that "make tests" fakes running the tests. Running them for
18real is dangerous: you should do this only if you know what you
19are doing.
20
21The real tests require having a configured and connected ethernet
22interface, with a default route over its (primary, not cloned) IP
23address. They reversibly modify interface configurations, the ARP
24table and the routing table.
25
26WARNING! WARNING! WARNING! WARNING! WARNING! WARNING! WARNING! WARNING!
27
28Do not run the real tests unless you are sure you do not harm your
29configuration or other people! I decline any responsibility whatsoever
30for what damage you make by running these tests.
31
32WARNING! WARNING! WARNING! WARNING! WARNING! WARNING! WARNING! WARNING!
33
34This being said, you need to set the environment variable REAL_TESTS
35and have root privileges to run the non-faked tests.
36
37UBUNTU/DEBIAN USERS
38
39You will have to apply ubuntu-new.patch like the following:
40
41 $ cd Net-Libdnet-X.YY
42 $ patch -p0 < ubuntu-new.patch
43
44To revert back to standard configuration:
45
46 $ patch -p0 < standard-new.patch
47
48If you use an old version of Ubuntu/Debian (don't know which version),
49you'll have to use ubuntu-old.patch and standard-old.patch files instead.
50
51DEPENDENCIES
52
53This module requires these other modules and libraries:
54
55 Perl v5.6.1
56 libdnet
57 Class::Gomor
58
59libdnet may be obtained from http://libdnet.sourceforge.net/.
60
61COPYRIGHT AND LICENSE
62
63You may distribute this module under the terms of the BSD license.
64See LICENSE file in the source distribution archive.
65
66Copyright (c) 2004, Vlad Manilici
67Copyright (c) 2008-2012, Patrice <GomoR> Auffret
68
69