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