mDNSPosix/nss_ReadMe.txt

   1 # Readme for libnss_mdns
   2
   3 Andrew White <Andrew.White@nicta.com.au>
   4 June 2004
   5
   6 Before using this software, see "Licensing" at bottom of this file.
   7
   8
   9 # Introduction
  10
  11 This code implements a module for the Name Service Switch to perform
  12 hostname lookups using the Darwin mDNSResponder / mdnsd.  This code has
  13 been tested on Debian and Redhat Linux.  It may work on other platforms.
  14 It *will not* work on Darwin or Mac OS X - the necessary functionality is
  15 already built into the operation system.
  16
  17
  18 # Building and Installing:
  19
  20 See "ReadMe.txt" for instructions on building and installing.
  21
  22 When you run "make install" as described in that file:
  23 o libnss_mdns-0.2.so and libnss_mdns.so.2 are installed in /lib,
  24 o manual pages libnss_mdns(8) and nss_mdns.conf(5) are installed,
  25 o nss_mdns.conf is installed in /etc, and
  26 o /etc/nsswitch.conf is modified to add "mdns" on the "hosts:" line
  27
  28 This will cause dns lookups to be passed via mdnsd before trying the dns.
  29
  30
  31 # Testing
  32
  33 For most purposes, 'ping myhostname.local' will tell you if mdns is
  34 working.  If MDNS_VERBOSE was set in nss_mdns.c during compilation then
  35 lots of chatty debug messages will be dumped to LOG_DEBUG in syslog.
  36 Otherwise, nss_mdns will only log if something isn't behaving quite right.
  37
  38
  39 # Implementation details
  40
  41 libnss_mdns provides alternative back-end implementations of the libc
  42 functions gethostbyname, gethostbyname2 and gethostbyaddr, using the Name
  43 Service Switch mechanism.  More information on writing nsswitch modules
  44 can be found via 'info libc "Name Service Switch"', if installed.
  45
  46
  47 # Licensing
  48
  49 This software is licensed under the NICTA Public Software License, version
  50 1.0, printed below:
  51
  52 NICTA Public Software Licence
  53 Version 1.0
  54
  55 Copyright © 2004 National ICT Australia Ltd
  56
  57 All rights reserved.
  58
  59 By this licence, National ICT Australia Ltd (NICTA) grants permission,
  60 free of charge, to any person who obtains a copy of this software
  61 and any associated documentation files ("the Software") to use and
  62 deal with the Software in source code and binary forms without
  63 restriction, with or without modification, and to permit persons
  64 to whom the Software is furnished to do so, provided that the
  65 following conditions are met:
  66
  67 - Redistributions of source code must retain the above copyright
  68   notice, this list of conditions and the following disclaimers.
  69 - Redistributions in binary form must reproduce the above copyright
  70   notice, this list of conditions and the following disclaimers in
  71   the documentation and/or other materials provided with the
  72   distribution.
  73 - The name of NICTA may not be used to endorse or promote products
  74   derived from this Software without specific prior written permission.
  75
  76 EXCEPT AS EXPRESSLY STATED IN THIS LICENCE AND TO THE FULL EXTENT
  77 PERMITTED BY APPLICABLE LAW, THE SOFTWARE IS PROVIDED "AS-IS" AND
  78 NICTA MAKES NO REPRESENTATIONS, WARRANTIES OR CONDITIONS OF ANY
  79 KIND, EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, ANY
  80 REPRESENTATIONS, WARRANTIES OR CONDITIONS REGARDING THE CONTENTS
  81 OR ACCURACY OF THE SOFTWARE, OR OF TITLE, MERCHANTABILITY, FITNESS
  82 FOR A PARTICULAR PURPOSE, NONINFRINGEMENT, THE ABSENCE OF LATENT
  83 OR OTHER DEFECTS, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR
  84 NOT DISCOVERABLE.
  85
  86 TO THE FULL EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT WILL
  87 NICTA BE LIABLE ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
  88 NEGLIGENCE) FOR ANY LOSS OR DAMAGE WHATSOEVER, INCLUDING (WITHOUT
  89 LIMITATION) LOSS OF PRODUCTION OR OPERATION TIME, LOSS, DAMAGE OR
  90 CORRUPTION OF DATA OR RECORDS; OR LOSS OF ANTICIPATED SAVINGS,
  91 OPPORTUNITY, REVENUE, PROFIT OR GOODWILL, OR OTHER ECONOMIC LOSS;
  92 OR ANY SPECIAL, INCIDENTAL, INDIRECT, CONSEQUENTIAL, PUNITIVE OR
  93 EXEMPLARY DAMAGES ARISING OUT OF OR IN CONNECTION WITH THIS LICENCE,
  94 THE SOFTWARE OR THE USE OF THE SOFTWARE, EVEN IF NICTA HAS BEEN
  95 ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  96
  97 If applicable legislation implies warranties or conditions, or
  98 imposes obligations or liability on NICTA in respect of the Software
  99 that cannot be wholly or partly excluded, restricted or modified,
 100 NICTA's liability is limited, to the full extent permitted by the
 101 applicable legislation, at its option, to:
 102
 103 a. in the case of goods, any one or more of the following:
 104   i.   the replacement of the goods or the supply of equivalent goods;
 105   ii.  the repair of the goods;
 106   iii. the payment of the cost of replacing the goods or of acquiring
 107        equivalent goods;
 108   iv.  the payment of the cost of having the goods repaired; or
 109 b. in the case of services:
 110   i.   the supplying of the services again; or
 111   ii.  the payment of the cost of having the services supplied
 112        again.
 113
 114
 115 # Links:
 116
 117 NICTA
 118         http://www.nicta.com.au/
 119 Darwin
 120         http://developer.apple.com/darwin/
 121 DNS service discovery and link-local
 122         http://http://zeroconf.org/
 123         http://http://multicastdns.org/
 124         http://http://dns-sd.org/
 125         http://http://dotlocal.org/