share/man/man8/mdnsd.8

   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
  34 on some systems)
  35 is a daemon invoked at boot time to implement Multicast DNS and DNS Service Discovery.
  36 .Pp
  37 .Nm
  38 listens on UDP port 5353 for Multicast DNS Query packets.
  39 When it receives a query for which it knows an answer,
  40 .Nm
  41 issues the appropriate Multicast DNS Reply packet.
  42 .Pp
  43 .Nm
  44 also performs Unicast and Multicast DNS Queries on behalf of client processes, and
  45 maintains a cache of the replies.
  46 .Pp
  47 .Nm
  48 has no user-specifiable command-line argument, and users should not run
  49 .Nm
  50 manually.
  51 .Sh LOGGING
  52 There are several methods with which to examine
  53 .Nm Ns 's internal state for debugging and diagnostic purposes. The syslog(3C)
  54 logging 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
  61 By default, only log level Error is logged.
  62 .Pp
  63 A SIGUSR1 signal toggles additional logging, with Warning and Notice
  64 enabled by default:
  65 .Pp
  66 .Dl % sudo pkill -USR1 mdnsd
  67 .Pp
  68 A SIGUSR2 signal toggles packet logging:
  69 .Pp
  70 .Dl % sudo pkill -USR2 mdnsd
  71 .Pp
  72 A 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
  79 For information on Multicast DNS, see
  80 .Pa http://www.multicastdns.org/
  81 .Pp
  82 For information on DNS Service Discovery, see
  83 .Pa http://www.dns-sd.org/
  84 .Pp
  85 For information on how to use the Multicast DNS and the
  86 DNS Service Discovery APIs on Mac OS X and other platforms, see
  87 .Pa http://developer.apple.com/bonjour/
  88 .Pp
  89 For 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
  99 The
 100 .Nm
 101 service is managed by the service management facility,
 102 \fBsmf\fR(5), under the service identifier:
 103 .sp
 104 .Dl svc:/network/dns/multicast:default
 105 .sp
 106 Administrative actions on this service, such as enabling, disabling, or
 107 requesting restart, can be performed using \fBsvcadm\fR(8). The service's
 108 status can be queried using the \fBsvcs\fR(1) command.