mDNSPosix/libnss_mdns.8

   1 .\"     $Id: libnss_mdns.8,v 1.1 2004/06/29 03:34:28 cheshire Exp $
   2 .\"
   3 .\" See section LICENSE for license information.
   4 .\"
   5 .Dd June 15, 2004
   6 .Dt LIBNSS_MDNS 8
   7 .Os
   8 .Sh NAME
   9 .Nm libnss_mdns
  10 .Nd name service switch module to support Apple mdnsd
  11 .Sh DESCRIPTION
  12 The
  13 .Nm
  14 shared library implements a name service switch module to interface with Apple
  15 mdnsd.  It is enabled by adding
  16 .Ql mdns
  17 to the
  18 .Ql hosts:
  19 line of
  20 .Xr nsswitch.conf 5 .
  21 This will cause calls to
  22 .Xr gethostbyname 3 ,
  23 .Xr gethostbyname2 3
  24 and
  25 .Xr gethostbyaddr 3
  26 to include mdnsd in their lookup path.
  27 .Pp
  28 The
  29 .Nm
  30 shared library should be installed in the system library paths, typically in
  31 .Pa /lib .
  32 .Sh FILES
  33 .Bl -tag -width Pa -compact
  34 .It Pa /etc/nss_mdns.conf
  35 configuration options
  36 .El
  37 .Sh EXAMPLES
  38 In
  39 .Pa /etc/nsswitch.conf :
  40 .Dl hosts: files mdns dns
  41 .Pp
  42 This will cause the name service switch to lookup hostnames first using
  43 .Pa /etc/hosts ,
  44 then mdns and finally via DNS.
  45 .Sh DIAGNOSTICS
  46 .Nm
  47 dumps status information via
  48 .Xr syslog 3 .
  49 .Sh SEE ALSO
  50 .\" Cross-references should be ordered by section (low to high), then in
  51 .\"     alphabetical order.
  52 .Xr nsswitch.conf 5 ,
  53 .Xr nss_mdns.conf 5 ,
  54 .Xr ldconfig 8
  55 .Pp
  56 .Li info libc Qq Name Service Switch
  57 .\" .Sh STANDARDS
  58 .Sh HISTORY
  59 .Nm
  60 was originally written for
  61 .An NICTA Bq http://www.nicta.com.au/ .
  62 .Sh AUTHORS
  63 .An "Andrew White" Bq Andrew.White@nicta.com.au
  64 .Sh BUGS
  65 Return values for obscure error conditions may not match those expected by nsswitch code.
  66 .Pp
  67 Version 0.62 of mdnsd does not support an option to force link-local multicast lookups.
  68 .Ql PTR
  69 reverse lookups for non-link-local domains will not function correctly.
  70 .Sh LICENSE
  71 This software is licensed under the NICTA Public Source License version 1.0
  72 .Ss NICTA Public Software Licence
  73 Version 1.0
  74 .Pp
  75 Copyright 2004 National ICT Australia Ltd
  76 .Pp
  77 All rights reserved.
  78 .Pp
  79 By this licence, National ICT Australia Ltd (NICTA) grants permission,
  80 free of charge, to any person who obtains a copy of this software
  81 and any associated documentation files ("the Software") to use and
  82 deal with the Software in source code and binary forms without
  83 restriction, with or without modification, and to permit persons
  84 to whom the Software is furnished to do so, provided that the
  85 following conditions are met:
  86 .Bl -bullet
  87 .It
  88 Redistributions of source code must retain the above copyright
  89 notice, this list of conditions and the following disclaimers.
  90 .It
  91 Redistributions in binary form must reproduce the above copyright
  92 notice, this list of conditions and the following disclaimers in
  93 the documentation and/or other materials provided with the
  94 distribution.
  95 .It
  96 The name of NICTA may not be used to endorse or promote products
  97 derived from this Software without specific prior written permission.
  98 .El
  99 .Pp
 100 EXCEPT AS EXPRESSLY STATED IN THIS LICENCE AND TO THE FULL EXTENT
 101 PERMITTED BY APPLICABLE LAW, THE SOFTWARE IS PROVIDED "AS-IS" AND
 102 NICTA MAKES NO REPRESENTATIONS, WARRANTIES OR CONDITIONS OF ANY
 103 KIND, EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, ANY
 104 REPRESENTATIONS, WARRANTIES OR CONDITIONS REGARDING THE CONTENTS
 105 OR ACCURACY OF THE SOFTWARE, OR OF TITLE, MERCHANTABILITY, FITNESS
 106 FOR A PARTICULAR PURPOSE, NONINFRINGEMENT, THE ABSENCE OF LATENT
 107 OR OTHER DEFECTS, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR
 108 NOT DISCOVERABLE.
 109 .Pp
 110 TO THE FULL EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT WILL
 111 NICTA BE LIABLE ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
 112 NEGLIGENCE) FOR ANY LOSS OR DAMAGE WHATSOEVER, INCLUDING (WITHOUT
 113 LIMITATION) LOSS OF PRODUCTION OR OPERATION TIME, LOSS, DAMAGE OR
 114 CORRUPTION OF DATA OR RECORDS; OR LOSS OF ANTICIPATED SAVINGS,
 115 OPPORTUNITY, REVENUE, PROFIT OR GOODWILL, OR OTHER ECONOMIC LOSS;
 116 OR ANY SPECIAL, INCIDENTAL, INDIRECT, CONSEQUENTIAL, PUNITIVE OR
 117 EXEMPLARY DAMAGES ARISING OUT OF OR IN CONNECTION WITH THIS LICENCE,
 118 THE SOFTWARE OR THE USE OF THE SOFTWARE, EVEN IF NICTA HAS BEEN
 119 ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
 120 .Pp
 121 If applicable legislation implies warranties or conditions, or
 122 imposes obligations or liability on NICTA in respect of the Software
 123 that cannot be wholly or partly excluded, restricted or modified,
 124 NICTA's liability is limited, to the full extent permitted by the
 125 applicable legislation, at its option, to:
 126 .Pp
 127 .Bl -tag -width "a." -compact
 128 .It a.
 129 in the case of goods, any one or more of the following:
 130 .Bl -tag -width "iii." -compact
 131 .It i.
 132 the replacement of the goods or the supply of equivalent goods;
 133 .It ii.
 134 the repair of the goods;
 135 .It iii.
 136 the payment of the cost of replacing the goods or of acquiring
 137 equivalent goods;
 138 .It iv.
 139 the payment of the cost of having the goods repaired; or
 140 .El
 141 .It b.
 142 in the case of services:
 143 .Bl -tag -width "iii." -compact
 144 .It i.
 145 the supplying of the services again; or
 146 .It ii.
 147 the payment of the cost of having the services supplied again.
 148 .El
 149 .El