xref: /illumos-gate/usr/src/man/man8/mdnsd.8 (revision bbf21555)
15ffb0c9bSToomas Soome.\" -*- tab-width: 4 -*-
2a5934736SYuri Pankov.\"
35ffb0c9bSToomas Soome.\" Copyright (c) 2003-2004 Apple Computer, Inc. All Rights Reserved.
4a5934736SYuri Pankov.\"
55ffb0c9bSToomas Soome.\" Licensed under the Apache License, Version 2.0 (the "License");
65ffb0c9bSToomas Soome.\" you may not use this file except in compliance with the License.
75ffb0c9bSToomas Soome.\" You may obtain a copy of the License at
8a5934736SYuri Pankov.\"
95ffb0c9bSToomas Soome.\"     http://www.apache.org/licenses/LICENSE-2.0
10a5934736SYuri Pankov.\"
115ffb0c9bSToomas Soome.\" Unless required by applicable law or agreed to in writing, software
125ffb0c9bSToomas Soome.\" distributed under the License is distributed on an "AS IS" BASIS,
135ffb0c9bSToomas Soome.\" WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
145ffb0c9bSToomas Soome.\" See the License for the specific language governing permissions and
155ffb0c9bSToomas Soome.\" limitations under the License.
165ffb0c9bSToomas Soome.\"
175ffb0c9bSToomas Soome.\" Copyright 2016 Toomas Soome <tsoome@me.com>
185ffb0c9bSToomas Soome.\"
195ffb0c9bSToomas Soome.Dd Jan 28, 2016        \" Date
20*bbf21555SRichard Lowe.Dt MDNSD 8            \" Document Title
215ffb0c9bSToomas Soome.Os illumos             \" Operating System
225ffb0c9bSToomas Soome.\"
235ffb0c9bSToomas Soome.Sh NAME
245ffb0c9bSToomas Soome.Nm mdnsd
255ffb0c9bSToomas Soome.Nd Multicast and Unicast DNS daemon    \" Name Description for whatis database
26a5934736SYuri Pankov.\"
275ffb0c9bSToomas Soome.Sh SYNOPSIS
285ffb0c9bSToomas Soome.Nm
295ffb0c9bSToomas Soome.\"
305ffb0c9bSToomas Soome.Sh DESCRIPTION
315ffb0c9bSToomas Soome.Nm
325ffb0c9bSToomas Soome(also known as
335ffb0c9bSToomas Soome.Nm mDNSResponder
345ffb0c9bSToomas Soomeon some systems)
355ffb0c9bSToomas Soomeis a daemon invoked at boot time to implement Multicast DNS and DNS Service Discovery.
365ffb0c9bSToomas Soome.Pp
375ffb0c9bSToomas Soome.Nm
385ffb0c9bSToomas Soomelistens on UDP port 5353 for Multicast DNS Query packets.
395ffb0c9bSToomas SoomeWhen it receives a query for which it knows an answer,
405ffb0c9bSToomas Soome.Nm
415ffb0c9bSToomas Soomeissues the appropriate Multicast DNS Reply packet.
425ffb0c9bSToomas Soome.Pp
435ffb0c9bSToomas Soome.Nm
445ffb0c9bSToomas Soomealso performs Unicast and Multicast DNS Queries on behalf of client processes, and
455ffb0c9bSToomas Soomemaintains a cache of the replies.
465ffb0c9bSToomas Soome.Pp
475ffb0c9bSToomas Soome.Nm
485ffb0c9bSToomas Soomehas no user-specifiable command-line argument, and users should not run
495ffb0c9bSToomas Soome.Nm
505ffb0c9bSToomas Soomemanually.
515ffb0c9bSToomas Soome.Sh LOGGING
525ffb0c9bSToomas SoomeThere are several methods with which to examine
535ffb0c9bSToomas Soome.Nm Ns 's internal state for debugging and diagnostic purposes. The syslog(3C)
545ffb0c9bSToomas Soomelogging levels map as follows:
555ffb0c9bSToomas Soome.Pp
565ffb0c9bSToomas Soome.Dl Error - Error messages
575ffb0c9bSToomas Soome.Dl Warning - Client-initiated operations
585ffb0c9bSToomas Soome.Dl Notice - Sleep proxy operations
595ffb0c9bSToomas Soome.Dl Info - Informational messages
605ffb0c9bSToomas Soome.Pp
615ffb0c9bSToomas SoomeBy default, only log level Error is logged.
625ffb0c9bSToomas Soome.Pp
635ffb0c9bSToomas SoomeA SIGUSR1 signal toggles additional logging, with Warning and Notice
645ffb0c9bSToomas Soomeenabled by default:
655ffb0c9bSToomas Soome.Pp
665ffb0c9bSToomas Soome.Dl % sudo pkill -USR1 mdnsd
675ffb0c9bSToomas Soome.Pp
685ffb0c9bSToomas SoomeA SIGUSR2 signal toggles packet logging:
695ffb0c9bSToomas Soome.Pp
705ffb0c9bSToomas Soome.Dl % sudo pkill -USR2 mdnsd
715ffb0c9bSToomas Soome.Pp
725ffb0c9bSToomas SoomeA SIGINFO signal will dump a snapshot summary of the internal state:
735ffb0c9bSToomas Soome.Pp
745ffb0c9bSToomas Soome.Dl % sudo pkill -INFO mdnsd
755ffb0c9bSToomas Soome.Sh FILES
765ffb0c9bSToomas Soome.Pa /usr/lib/inet/mdnsd \" Pathname
775ffb0c9bSToomas Soome.\"
785ffb0c9bSToomas Soome.Sh INFO
795ffb0c9bSToomas SoomeFor information on Multicast DNS, see
805ffb0c9bSToomas Soome.Pa http://www.multicastdns.org/
815ffb0c9bSToomas Soome.Pp
825ffb0c9bSToomas SoomeFor information on DNS Service Discovery, see
835ffb0c9bSToomas Soome.Pa http://www.dns-sd.org/
845ffb0c9bSToomas Soome.Pp
855ffb0c9bSToomas SoomeFor information on how to use the Multicast DNS and the
865ffb0c9bSToomas SoomeDNS Service Discovery APIs on Mac OS X and other platforms, see
875ffb0c9bSToomas Soome.Pa http://developer.apple.com/bonjour/
885ffb0c9bSToomas Soome.Pp
895ffb0c9bSToomas SoomeFor the source code to
905ffb0c9bSToomas Soome.Nm , see
915ffb0c9bSToomas Soome.Pa http://developer.apple.com/darwin/projects/bonjour/
925ffb0c9bSToomas Soome.\"
935ffb0c9bSToomas Soome.Sh INTERFACE STABILITY
945ffb0c9bSToomas Soome.Sy Volatile .
955ffb0c9bSToomas Soome.Sh SEE ALSO
96*bbf21555SRichard Lowe.Xr dns-sd 8
975ffb0c9bSToomas Soome.\"
985ffb0c9bSToomas Soome.Sh NOTES
995ffb0c9bSToomas SoomeThe
1005ffb0c9bSToomas Soome.Nm
1015ffb0c9bSToomas Soomeservice is managed by the service management facility,
102*bbf21555SRichard Lowe\fBsmf\fR(7), under the service identifier:
1035ffb0c9bSToomas Soome.sp
1045ffb0c9bSToomas Soome.Dl svc:/network/dns/multicast:default
1055ffb0c9bSToomas Soome.sp
1065ffb0c9bSToomas SoomeAdministrative actions on this service, such as enabling, disabling, or
107*bbf21555SRichard Lowerequesting restart, can be performed using \fBsvcadm\fR(8). The service's
1085ffb0c9bSToomas Soomestatus can be queried using the \fBsvcs\fR(1) command.
109