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