mdnsd.1m revision 5ffb0c9b03b5149ff4f5821a62be4a52408ada2a
-*- tab-width: 4 -*-

Copyright (c) 2003-2004 Apple Computer, Inc. All Rights Reserved.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Copyright 2016 Toomas Soome <tsoome@me.com>

.Dd Jan 28, 2016 \" Date .Dt MDNSD 1M \" Document Title .Os illumos \" Operating System
.Sh NAME .Nm mdnsd .Nd Multicast and Unicast DNS daemon \" Name Description for whatis database
.Sh SYNOPSIS .Nm
.Sh DESCRIPTION .Nm (also known as .Nm mDNSResponder on some systems) is a daemon invoked at boot time to implement Multicast DNS and DNS Service Discovery.

p .Nm listens on UDP port 5353 for Multicast DNS Query packets. When it receives a query for which it knows an answer, .Nm issues the appropriate Multicast DNS Reply packet.

p .Nm also performs Unicast and Multicast DNS Queries on behalf of client processes, and maintains a cache of the replies.

p .Nm has no user-specifiable command-line argument, and users should not run .Nm manually. .Sh LOGGING There are several methods with which to examine .Nm Ns 's internal state for debugging and diagnostic purposes. The syslog(3C) logging levels map as follows:

p .Dl Error - Error messages .Dl Warning - Client-initiated operations .Dl Notice - Sleep proxy operations .Dl Info - Informational messages

p By default, only log level Error is logged.

p A SIGUSR1 signal toggles additional logging, with Warning and Notice enabled by default:

p .Dl % sudo pkill -USR1 mdnsd

p A SIGUSR2 signal toggles packet logging:

p .Dl % sudo pkill -USR2 mdnsd

p A SIGINFO signal will dump a snapshot summary of the internal state:

p .Dl % sudo pkill -INFO mdnsd .Sh FILES

a /usr/lib/inet/mdnsd \" Pathname
.Sh INFO For information on Multicast DNS, see

a http://www.multicastdns.org/

p For information on DNS Service Discovery, see

a http://www.dns-sd.org/

p For information on how to use the Multicast DNS and the DNS Service Discovery APIs on Mac OS X and other platforms, see

a http://developer.apple.com/bonjour/

p For the source code to .Nm , see

a http://developer.apple.com/darwin/projects/bonjour/
.Sh INTERFACE STABILITY .Sy Volatile . .Sh SEE ALSO .Xr dns-sd 1M
.Sh NOTES The .Nm service is managed by the service management facility, smf(5), under the service identifier: .Dl svc:/network/dns/multicast:default Administrative actions on this service, such as enabling, disabling, or requesting restart, can be performed using svcadm(1M). The service's status can be queried using the svcs(1) command.