mDNSShared/mDNSResponder.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 .\" $Log: mDNSResponder.8,v $
  18 .\" Revision 1.8  2006/10/06 17:31:33  mkrochma
  19 .\" <rdar://problem/4769407> Typo in man page for mDNSResponder(8)
  20 .\"
  21 .\" Revision 1.7  2006/08/14 23:24:56  cheshire
  22 .\" Re-licensed mDNSResponder daemon source code under Apache License, Version 2.0
  23 .\"
  24 .\" Revision 1.6  2005/02/10 22:35:28  cheshire
  25 .\" <rdar://problem/3727944> Update name
  26 .\"
  27 .\" Revision 1.5  2004/06/29 02:41:38  cheshire
  28 .\" Add note that mDNSResponder is called mdnsd on some systems
  29 .\"
  30 .\" Revision 1.4  2004/05/18 18:14:36  cheshire
  31 .\" Minor wording update
  32 .\"
  33 .\" Revision 1.3  2004/04/22 02:56:08  cheshire
  34 .\" <rdar://problem/3619494>: mDNSResponder man page format error
  35 .\"
  36 .\" Revision 1.2  2004/04/12 18:03:24  ksekar
  37 .\" <rdar://problem/3619494>: mDNSResponder man page format error
  38 .\"
  39 .\" Revision 1.1  2003/11/13 03:21:38  cheshire
  40 .\" <rdar://problem/3086886>: No man page for mDNSResponder
  41 .\"
  42 .\"
  43 .\"
  44 .Dd April 2004              \" Date
  45 .Dt mDNSResponder 8         \" Document Title
  46 .Os Darwin                  \" Operating System
  47 .\"
  48 .Sh NAME
  49 .Nm mDNSResponder
  50 .Nd Multicast DNS daemon    \" Name Description for whatis database
  51 .\"
  52 .Sh SYNOPSIS
  53 .Nm
  54 .\"
  55 .Sh DESCRIPTION
  56 .Nm
  57 (also known as
  58 .Nm mdnsd
  59 on some systems)
  60 is a daemon invoked at boot time to implement Multicast DNS
  61 and DNS Service Discovery.
  62 .Pp
  63 .Nm
  64 listens UDP port 5353 for Multicast DNS Query packets.
  65 When it receives a query for which it knows an answer,
  66 .Nm
  67 issues the appropriate Multicast DNS Reply packet.
  68 .Pp
  69 .Nm
  70 also performs Multicast DNS Queries on behalf of client processes,
  71 and maintains a cache of the replies.
  72 .Pp
  73 .Nm
  74 has no user-specifiable command-line argument, and users should not run
  75 .Nm
  76 manually.
  77 .Pp
  78 To examine
  79 .Nm Ns 's internal state, for debugging and diagnostic purposes,
  80 send it a SIGINFO signal, and it will then dump a snapshot summary
  81 of its internal state to
  82 .Pa /var/log/system.log Ns , e.g.
  83 .Pp
  84 .Dl sudo killall -INFO mDNSResponder
  85 .Sh FILES
  86 .Pa /usr/sbin/mDNSResponder \" Pathname
  87 .\"
  88 .Sh SEE ALSO
  89 .Xr mDNS 1
  90 .Pp
  91 For information on Multicast DNS, see
  92 .Pa http://www.multicastdns.org/
  93 .Pp
  94 For information on DNS Service Discovery, see
  95 .Pa http://www.dns-sd.org/
  96 .Pp
  97 For information on how to use the Multicast DNS and the
  98 DNS Service Discovery APIs on Mac OS X and other platforms, see
  99 .Pa http://developer.apple.com/bonjour/
 100 .Pp
 101 For the source code to
 102 .Nm , see
 103 .Pa http://developer.apple.com/darwin/projects/bonjour/
 104 .\"
 105 .Sh BUGS
 106 .Nm
 107 bugs are tracked in Apple Radar component "mDNSResponder".
 108 .\"
 109 .Sh HISTORY
 110 The
 111 .Nm
 112 daemon first appeared in Mac OS X 10.2 (Jaguar).
 113 .Pp
 114 Also available from the Darwin open source repository
 115 (though not officially supported by Apple) are
 116 .Nm
 117 daemons for other platforms, including Mac OS 9, Microsoft Windows,
 118 Linux, FreeBSD, NetBSD, Solaris, and other POSIX systems.