xref: /illumos-gate/usr/src/man/man8/mdnsd.8 (revision 20a7641f9918de8574b8b3b47dbe35c4bfc78df1)
1.\" -*- tab-width: 4 -*-
2.\"
3.\" Copyright (c) 2003-2004 Apple Computer, Inc. All Rights Reserved.
4.\"
5.\" Licensed under the Apache License, Version 2.0 (the "License");
6.\" you may not use this file except in compliance with the License.
7.\" You may obtain a copy of the License at
8.\"
9.\"     http://www.apache.org/licenses/LICENSE-2.0
10.\"
11.\" Unless required by applicable law or agreed to in writing, software
12.\" distributed under the License is distributed on an "AS IS" BASIS,
13.\" WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14.\" See the License for the specific language governing permissions and
15.\" limitations under the License.
16.\"
17.\" Copyright 2016 Toomas Soome <tsoome@me.com>
18.\"
19.Dd Jan 28, 2016        \" Date
20.Dt MDNSD 8            \" Document Title
21.Os illumos             \" Operating System
22.\"
23.Sh NAME
24.Nm mdnsd
25.Nd Multicast and Unicast DNS daemon    \" Name Description for whatis database
26.\"
27.Sh SYNOPSIS
28.Nm
29.\"
30.Sh DESCRIPTION
31.Nm
32(also known as
33.Nm mDNSResponder
34on some systems)
35is a daemon invoked at boot time to implement Multicast DNS and DNS Service Discovery.
36.Pp
37.Nm
38listens on UDP port 5353 for Multicast DNS Query packets.
39When it receives a query for which it knows an answer,
40.Nm
41issues the appropriate Multicast DNS Reply packet.
42.Pp
43.Nm
44also performs Unicast and Multicast DNS Queries on behalf of client processes, and
45maintains a cache of the replies.
46.Pp
47.Nm
48has no user-specifiable command-line argument, and users should not run
49.Nm
50manually.
51.Sh LOGGING
52There are several methods with which to examine
53.Nm Ns 's internal state for debugging and diagnostic purposes. The syslog(3C)
54logging levels map as follows:
55.Pp
56.Dl Error - Error messages
57.Dl Warning - Client-initiated operations
58.Dl Notice - Sleep proxy operations
59.Dl Info - Informational messages
60.Pp
61By default, only log level Error is logged.
62.Pp
63A SIGUSR1 signal toggles additional logging, with Warning and Notice
64enabled by default:
65.Pp
66.Dl % sudo pkill -USR1 mdnsd
67.Pp
68A SIGUSR2 signal toggles packet logging:
69.Pp
70.Dl % sudo pkill -USR2 mdnsd
71.Pp
72A SIGINFO signal will dump a snapshot summary of the internal state:
73.Pp
74.Dl % sudo pkill -INFO mdnsd
75.Sh FILES
76.Pa /usr/lib/inet/mdnsd \" Pathname
77.\"
78.Sh INFO
79For information on Multicast DNS, see
80.Pa http://www.multicastdns.org/
81.Pp
82For information on DNS Service Discovery, see
83.Pa http://www.dns-sd.org/
84.Pp
85For information on how to use the Multicast DNS and the
86DNS Service Discovery APIs on Mac OS X and other platforms, see
87.Pa http://developer.apple.com/bonjour/
88.Pp
89For the source code to
90.Nm , see
91.Pa http://developer.apple.com/darwin/projects/bonjour/
92.\"
93.Sh INTERFACE STABILITY
94.Sy Volatile .
95.Sh SEE ALSO
96.Xr dns-sd 8
97.\"
98.Sh NOTES
99The
100.Nm
101service is managed by the service management facility,
102\fBsmf\fR(7), under the service identifier:
103.sp
104.Dl svc:/network/dns/multicast:default
105.sp
106Administrative actions on this service, such as enabling, disabling, or
107requesting restart, can be performed using \fBsvcadm\fR(8). The service's
108status can be queried using the \fBsvcs\fR(1) command.
109