dibbler-server(8)

1dibbler-server(8)                   Dibbler                  dibbler-server(8)
2
3
4

NAME

6       dibbler-server - a portable DHCPv6 server
7
8

DESCRIPTION

10       dibbler-server  is  a  portable implementation of the DHCPv6 server. It
11       supports both stateful (i.e. IPv6 address granting) and stateless (i.e.
12       options  granting)  autoconfiguration.  There  are  ports available for
13       Linux 2.4/2.6 systems as well as MS  Windows  XP  and  2003.  They  are
14       freely available under GNU GPL version 2 (or later) license.
15
16

SYNOPSIS

18       dibbler-server [ run | start | stop | status | install | uninstall ]
19
20

OPTIONS

22       run - starts server in the console. Server can be closed using ctrl-c.
23
24       start - starts server in daemon mode.
25
26       stop - stops running server.
27
28       status - shows status of the server.
29
30       install - installs server as a service. This is not implemented yet.
31
32       uninstall - uninstall server service. This is not implemented yet.
33
34

EXAMPLES

36       Let's  assume simple case: server should provide clients located on the
37       eth1 link with IPv6 addresses from range 2000::100/120 and should  have
38       preference set to 7:
39
40       iface eth0
41       {
42         preference 7
43         class
44         {
45           pool 2000::100-2000::1ff
46         }
47       }
48
49       Here  is exmaple of server configured to work in a stateless mode (i.e.
50       only options, not addresses  are  served).  If  client  support  option
51       renewal, it should do so once in a 500 seconds:
52
53       log-level 7
54       log-mode short
55       stateless
56       iface eth0 {
57         option dns-server 2000::100,2000::101
58         option domain example.com, test1.example.com
59         option ntp-server 2000::200,2000::201,2000::202
60         option time-zone  CET
61         option sip-server 2000::300,2000::302,2000::303,2000::304
62         option sip-domain sip1.example.com,sip2.example.com
63         option nis-server 2000::400,2000::401,2000::404,2000::405,2000::405
64         option nis-domain nis.example.com
65         option nis+-server 2000::501,2000::502
66         option nis+-domain nisplus.example.com
67         option lifetime 500
68       }
69
70       More examples can be found in the User's Guide.
71
72

FILES

74       All files are created in the /var/lib/dibbler directory. Dibbler server
75       reads  /var/lib/dibbler/server.conf  file.  During  operation,  Dibbler
76       saves various file in that directory.  Log file is named client.log.
77
78

STANDARDS

80       This implementation aims at conformance to the following standards:
81
82       RFC 3315 DHCP for IPv6
83
84       RFC 3319 SIP options for DHCPv6
85
86       RFC 3646 DNS server options for DHCPv6
87
88       RFC 3736 Stateless DHCPv6
89
90       RFC 3898 NIS options for DHCPv6
91
92       Also options specified in following drafts are implemented:
93
94       draft-ietf-dhc-dhcpv6-opt-timeconfig-03.txt NTP and timezone options.
95
96       draft-ietf-dhc-dhcpv6-opt-lifetime-00.txt Option renewal.
97
98

BUGS

100       Bugs      are      tracked      with     bugzilla,     available     at
101       http://klub.com.pl/bugzilla/. If you belive you have found a bug, don't
102       hesitate to report it.
103
104

AUTHOR

106       Dibbler  was  developed as master thesis on the Technical University of
107       Gdansk by Tomasz Mrugalski and Marek Senderski. Currently Marek has not
108       enough  free time, so this project is being developed by Tomasz Mrugal‐
109       ski. Authors can be reached at thomson@klub.com.pl and msend@o2.pl
110
111