[apple/mdnsresponder.git] / mDNSPosix / libnss_mdns.8

.\"	$Id: libnss_mdns.8,v 1.1 2004/06/29 03:34:28 cheshire Exp $
.\"
.\" See section LICENSE for license information.
.\"
.Dd June 15, 2004
.Dt LIBNSS_MDNS 8
.Os
.Sh NAME
.Nm libnss_mdns
.Nd name service switch module to support Apple mdnsd
.Sh DESCRIPTION
The
.Nm
shared library implements a name service switch module to interface with Apple
mdnsd.  It is enabled by adding
.Ql mdns
to the
.Ql hosts:
line of
.Xr nsswitch.conf 5 .
This will cause calls to
.Xr gethostbyname 3 ,
.Xr gethostbyname2 3
and
.Xr gethostbyaddr 3
to include mdnsd in their lookup path.
.Pp
The
.Nm
shared library should be installed in the system library paths, typically in
.Pa /lib .
.Sh FILES
.Bl -tag -width Pa -compact
.It Pa /etc/nss_mdns.conf
configuration options
.El
.Sh EXAMPLES
In
.Pa /etc/nsswitch.conf :
.Dl hosts: files mdns dns
.Pp
This will cause the name service switch to lookup hostnames first using
.Pa /etc/hosts ,
then mdns and finally via DNS.
.Sh DIAGNOSTICS
.Nm
dumps status information via
.Xr syslog 3 .
.Sh SEE ALSO
.\" Cross-references should be ordered by section (low to high), then in
.\"     alphabetical order.
.Xr nsswitch.conf 5 ,
.Xr nss_mdns.conf 5 ,
.Xr ldconfig 8
.Pp
.Li info libc Qq Name Service Switch
.\" .Sh STANDARDS
.Sh HISTORY
.Nm
was originally written for
.An NICTA Bq http://www.nicta.com.au/ .
.Sh AUTHORS
.An "Andrew White" Bq Andrew.White@nicta.com.au
.Sh BUGS
Return values for obscure error conditions may not match those expected by nsswitch code.
.Pp
Version 0.62 of mdnsd does not support an option to force link-local multicast lookups.
.Ql PTR
reverse lookups for non-link-local domains will not function correctly.
.Sh LICENSE
This software is licensed under the NICTA Public Source License version 1.0
.Ss NICTA Public Software Licence
Version 1.0
.Pp
Copyright 2004 National ICT Australia Ltd
.Pp
All rights reserved.
.Pp
By this licence, National ICT Australia Ltd (NICTA) grants permission,
free of charge, to any person who obtains a copy of this software
and any associated documentation files ("the Software") to use and
deal with the Software in source code and binary forms without
restriction, with or without modification, and to permit persons
to whom the Software is furnished to do so, provided that the
following conditions are met:
.Bl -bullet
.It
Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimers.
.It
Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimers in
the documentation and/or other materials provided with the
distribution.
.It
The name of NICTA may not be used to endorse or promote products
derived from this Software without specific prior written permission.
.El
.Pp
EXCEPT AS EXPRESSLY STATED IN THIS LICENCE AND TO THE FULL EXTENT
PERMITTED BY APPLICABLE LAW, THE SOFTWARE IS PROVIDED "AS-IS" AND
NICTA MAKES NO REPRESENTATIONS, WARRANTIES OR CONDITIONS OF ANY
KIND, EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, ANY
REPRESENTATIONS, WARRANTIES OR CONDITIONS REGARDING THE CONTENTS
OR ACCURACY OF THE SOFTWARE, OR OF TITLE, MERCHANTABILITY, FITNESS
FOR A PARTICULAR PURPOSE, NONINFRINGEMENT, THE ABSENCE OF LATENT
OR OTHER DEFECTS, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR
NOT DISCOVERABLE.
.Pp
TO THE FULL EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT WILL
NICTA BE LIABLE ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
NEGLIGENCE) FOR ANY LOSS OR DAMAGE WHATSOEVER, INCLUDING (WITHOUT
LIMITATION) LOSS OF PRODUCTION OR OPERATION TIME, LOSS, DAMAGE OR
CORRUPTION OF DATA OR RECORDS; OR LOSS OF ANTICIPATED SAVINGS,
OPPORTUNITY, REVENUE, PROFIT OR GOODWILL, OR OTHER ECONOMIC LOSS;
OR ANY SPECIAL, INCIDENTAL, INDIRECT, CONSEQUENTIAL, PUNITIVE OR
EXEMPLARY DAMAGES ARISING OUT OF OR IN CONNECTION WITH THIS LICENCE,
THE SOFTWARE OR THE USE OF THE SOFTWARE, EVEN IF NICTA HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
.Pp
If applicable legislation implies warranties or conditions, or
imposes obligations or liability on NICTA in respect of the Software
that cannot be wholly or partly excluded, restricted or modified,
NICTA's liability is limited, to the full extent permitted by the
applicable legislation, at its option, to:
.Pp
.Bl -tag -width "a." -compact
.It a.
in the case of goods, any one or more of the following:
.Bl -tag -width "iii." -compact
.It i.
the replacement of the goods or the supply of equivalent goods;
.It ii.
the repair of the goods;
.It iii.
the payment of the cost of replacing the goods or of acquiring
equivalent goods;
.It iv.
the payment of the cost of having the goods repaired; or
.El
.It b.
in the case of services:
.Bl -tag -width "iii." -compact
.It i.
the supplying of the services again; or 
.It ii.
the payment of the cost of having the services supplied again.
.El
.El
Commit	Line	Data
7f0064bd A	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