mDNSShared/mDNSResponder.8

   1 .\" Copyright (c) 2003-2004 Apple Computer, Inc. All Rights Reserved.
   2 .\"
   3 .\" @APPLE_LICENSE_HEADER_START@
   4 .\"
   5 .\" This file contains Original Code and/or Modifications of Original Code
   6 .\" as defined in and that are subject to the Apple Public Source License
   7 .\" Version 2.0 (the 'License'). You may not use this file except in
   8 .\" compliance with the License. Please obtain a copy of the License at
   9 .\" http://www.opensource.apple.com/apsl/ and read it before using this
  10 .\" file.
  11 .\"
  12 .\" The Original Code and all software distributed under the License are
  13 .\" distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  14 .\" EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  15 .\" INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  16 .\" FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  17 .\" Please see the License for the specific language governing rights and
  18 .\" limitations under the License.
  19 .\"
  20 .\" @APPLE_LICENSE_HEADER_END@
  21 .\"
  22 .\" $Log: mDNSResponder.8,v $
  23 .\" Revision 1.6  2005/02/10 22:35:28  cheshire
  24 .\" <rdar://problem/3727944> Update name
  25 .\"
  26 .\" Revision 1.5  2004/06/29 02:41:38  cheshire
  27 .\" Add note that mDNSResponder is called mdnsd on some systems
  28 .\"
  29 .\" Revision 1.4  2004/05/18 18:14:36  cheshire
  30 .\" Minor wording update
  31 .\"
  32 .\" Revision 1.3  2004/04/22 02:56:08  cheshire
  33 .\" <rdar://problem/3619494>: mDNSResponder man page format error
  34 .\"
  35 .\" Revision 1.2  2004/04/12 18:03:24  ksekar
  36 .\" <rdar://problem/3619494>: mDNSResponder man page format error
  37 .\"
  38 .\" Revision 1.1  2003/11/13 03:21:38  cheshire
  39 .\" <rdar://problem/3086886>: No man page for mDNSResponder
  40 .\"
  41 .\"
  42 .\"
  43 .Dd April 2004              \" Date
  44 .Dt mDNSResponder 8         \" Document Title
  45 .Os Darwin                  \" Operating System
  46 .\"
  47 .Sh NAME
  48 .Nm mDNSResponder
  49 .Nd Multicast DNS daemon    \" Name Description for whatis database
  50 .\"
  51 .Sh SYNOPSIS
  52 .Nm
  53 .\"
  54 .Sh DESCRIPTION
  55 .Nm
  56 (also known as
  57 .Nm mdnsd
  58 on some systems)
  59 is a daemon invoked at boot time to implement Multicast DNS
  60 and DNS Service Discovery.
  61 .Pp
  62 .Nm
  63 listens UDP port 5353 for Multicast DNS Query packets.
  64 When it receives a query for which it knows an answer,
  65 .Nm
  66 issues the appropriate Multicast DNS Reply packet.
  67 .Pp
  68 .Nm
  69 also performs Multicast DNS Queries on behalf of client processes,
  70 and maintains a cache of the replies.
  71 .Pp
  72 .Nm
  73 has no user-specifiable command-line argument, and users should not run
  74 .Nm
  75 manually.
  76 .Pp
  77 To examine
  78 .Nm Ns 's internal state, for debugging and disagnostic purposes,
  79 send it a SIGINFO signal, and it will then dump a snapshot summary
  80 of its internal state to
  81 .Pa /var/log/system.log Ns , e.g.
  82 .Pp
  83 .Dl sudo killall -INFO mDNSResponder
  84 .Sh FILES
  85 .Pa /usr/sbin/mDNSResponder \" Pathname
  86 .\"
  87 .Sh SEE ALSO
  88 .Xr mDNS 1
  89 .Pp
  90 For information on Multicast DNS, see
  91 .Pa http://www.multicastdns.org/
  92 .Pp
  93 For information on DNS Service Discovery, see
  94 .Pa http://www.dns-sd.org/
  95 .Pp
  96 For information on how to use the Multicast DNS and the
  97 DNS Service Discovery APIs on Mac OS X and other platforms, see
  98 .Pa http://developer.apple.com/bonjour/
  99 .Pp
 100 For the source code to
 101 .Nm , see
 102 .Pa http://developer.apple.com/darwin/projects/bonjour/
 103 .\"
 104 .Sh BUGS
 105 .Nm
 106 bugs are tracked in Apple Radar component "mDNSResponder".
 107 .\"
 108 .Sh HISTORY
 109 The
 110 .Nm
 111 daemon first appeared in Mac OS X 10.2 (Jaguar).
 112 .Pp
 113 Also available from the Darwin open source repository
 114 (though not officially supported by Apple) are
 115 .Nm
 116 daemons for other platforms, including Mac OS 9, Microsoft Windows,
 117 Linux, FreeBSD, NetBSD, Solaris, and other POSIX systems.