summaryrefslogtreecommitdiff
path: root/README
blob: 3d563395fa8913a4b22669b7b1a68a7b45693df5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
llmnrd - Link-Local Multicast Resolution Daemon
===============================================

llmnrd is a daemon implementing the Link-Local Multicast Name Resolution (LLMNR)
protocol according to RFC 4795. It currently only supports Linux, as it uses the
netlink kernel interface.

llmnrd will respond to name resolution queries sent by Windows clients in
networks where no DNS server is available. It supports both IPv4 and IPv6.

Installation
------------

To build and install llmnrd use the following commands:

  $ make
  $ sudo make install

By default, the llmnrd binary will be installed to /usr/local/sbin. To install
the binary to a different installation path, use:

  $ make
  $ sudo make prefix=<path> install

Cross-Compilation
-----------------

To cross-compile llmnrd for a different architecture, use the CROSS_COMPILE make
variable. To e.g. build it using the arm-linux-gnueabihf toolchain use:

  $ make CROSS_COMPILE=arm-linux-gnueabihf-

When cross-compiling, you usually don't want to install the generated binary to
your root filesystem, but to the sysroot of a cross-compiled system. Use the
DESTDIR variable to change the installation destination path, e.g.

  $ make DESTDIR=$HOME/sysroot/ prefix=/usr install

License
-------

llmnrd is free software: you can redistribute it and/or modify it under the
terms of the GNU General Public License as published by the Free Software
Foundation, version 2 of the License.

llmnrd is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.  See the GNU General Public License for more details.

Author
------

llmnrd is authored and maintained by Tobias Klauser <tklauser@distanz.ch>

References
----------

RFC 4795
  https://tools.ietf.org/html/rfc4795

Microsoft TechNet article about LLMNR
  https://technet.microsoft.com/en-us/library/bb878128.aspx

xllmnrd: An IPv6-only LLMNR responder daemon
  http://www.vx68k.org/xllmnrd
  https://bitbucket.org/kazssym/xllmnrd/