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