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