mDNSShared/uds_daemon.h

   1 /* -*- Mode: C; tab-width: 4 -*-
   2  *
   3  * Copyright (c) 2002-2003 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         File:           uds_daemon.h
  18
  19         Contains:       Interfaces necessary to talk to uds_daemon.c.
  20
  21         Version:        1.0
  22
  23     Change History (most recent first):
  24
  25 $Log: uds_daemon.h,v $
  26 Revision 1.24  2007/09/19 20:25:17  cheshire
  27 Deleted outdated comment
  28
  29 Revision 1.23  2007/07/24 17:23:02  cheshire
  30 Rename DefRegList as AutoRegistrationDomains
  31
  32 Revision 1.22  2007/07/11 02:58:04  cheshire
  33 <rdar://problem/5303807> Register IPv6-only hostname and don't create port mappings for AutoTunnel services
  34
  35 Revision 1.21  2007/04/21 21:47:47  cheshire
  36 <rdar://problem/4376383> Daemon: Add watchdog timer
  37
  38 Revision 1.20  2007/02/14 01:58:19  cheshire
  39 <rdar://problem/4995831> Don't delete Unix Domain Socket on exit if we didn't create it on startup
  40
  41 Revision 1.19  2007/02/07 19:32:00  cheshire
  42 <rdar://problem/4980353> All mDNSResponder components should contain version strings in SCCS-compatible format
  43
  44 Revision 1.18  2007/02/06 19:06:49  cheshire
  45 <rdar://problem/3956518> Need to go native with launchd
  46
  47 Revision 1.17  2007/01/05 05:46:07  cheshire
  48 Add mDNS *const m parameter to udsserver_handle_configchange()
  49
  50 Revision 1.16  2007/01/04 23:11:15  cheshire
  51 <rdar://problem/4720673> uDNS: Need to start caching unicast records
  52 When an automatic browsing domain is removed, generate appropriate "remove" events for legacy queries
  53
  54 Revision 1.15  2006/08/14 23:24:57  cheshire
  55 Re-licensed mDNSResponder daemon source code under Apache License, Version 2.0
  56
  57 Revision 1.14  2005/01/27 17:48:39  cheshire
  58 Added comment about CFSocketInvalidate closing the underlying socket
  59
  60 Revision 1.13  2004/12/10 05:27:26  cheshire
  61 <rdar://problem/3909147> Guard against multiple autoname services of the same type on the same machine
  62
  63 Revision 1.12  2004/12/10 04:28:28  cheshire
  64 <rdar://problem/3914406> User not notified of name changes for services using new UDS API
  65
  66 Revision 1.11  2004/12/06 21:15:23  ksekar
  67 <rdar://problem/3884386> mDNSResponder crashed in CheckServiceRegistrations
  68
  69 Revision 1.10  2004/10/26 04:31:44  cheshire
  70 Rename CountSubTypes() as ChopSubTypes()
  71
  72 Revision 1.9  2004/09/30 00:25:00  ksekar
  73 <rdar://problem/3695802> Dynamically update default registration domains on config change
  74
  75 Revision 1.8  2004/09/21 21:05:11  cheshire
  76 Move duplicate code out of mDNSMacOSX/daemon.c and mDNSPosix/PosixDaemon.c,
  77 into mDNSShared/uds_daemon.c
  78
  79 Revision 1.7  2004/09/17 01:08:55  cheshire
  80 Renamed mDNSClientAPI.h to mDNSEmbeddedAPI.h
  81   The name "mDNSClientAPI.h" is misleading to new developers looking at this code. The interfaces
  82   declared in that file are ONLY appropriate to single-address-space embedded applications.
  83   For clients on general-purpose computers, the interfaces defined in dns_sd.h should be used.
  84
  85 Revision 1.6  2004/08/11 01:58:49  cheshire
  86 Remove "mDNS *globalInstance" parameter from udsserver_init()
  87
  88 Revision 1.5  2004/06/18 04:44:58  rpantos
  89 Use platform layer for socket types
  90
  91 Revision 1.4  2004/06/12 00:51:58  cheshire
  92 Changes for Windows compatibility
  93
  94 Revision 1.3  2004/01/25 00:03:21  cheshire
  95 Change to use mDNSVal16() instead of private PORT_AS_NUM() macro
  96
  97 Revision 1.2  2004/01/24 08:46:26  bradley
  98 Added InterfaceID<->Index platform interfaces since they are now used by all platforms for the DNS-SD APIs.
  99
 100 Revision 1.1  2003/12/08 21:11:42  rpantos;
 101 Changes necessary to support mDNSResponder on Linux.
 102
 103 */
 104
 105 #include "mDNSEmbeddedAPI.h"
 106 #include "dnssd_ipc.h"
 107
 108 /* Client interface: */
 109
 110 #define SRS_PORT(S) mDNSVal16((S)->RR_SRV.resrec.rdata->u.srv.port)
 111
 112 extern int udsserver_init(dnssd_sock_t skt);
 113 extern mDNSs32 udsserver_idle(mDNSs32 nextevent);
 114 extern void udsserver_info(mDNS *const m);      // print out info about current state
 115 extern void udsserver_handle_configchange(mDNS *const m);
 116 extern int udsserver_exit(dnssd_sock_t skt);    // should be called prior to app exit
 117
 118 /* Routines that uds_daemon expects to link against: */
 119
 120 typedef void (*udsEventCallback)(int fd, short filter, void *context);
 121 extern mStatus udsSupportAddFDToEventLoop(dnssd_sock_t fd, udsEventCallback callback, void *context);
 122 extern mStatus udsSupportRemoveFDFromEventLoop(dnssd_sock_t fd); // Note: This also CLOSES the file descriptor as well
 123
 124 extern void RecordUpdatedNiceLabel(mDNS *const m, mDNSs32 delay);
 125
 126 // Globals and functions defined in uds_daemon.c and also shared with the old "daemon.c" on OS X
 127
 128 extern mDNS mDNSStorage;
 129 extern DNameListElem *AutoRegistrationDomains;
 130 extern DNameListElem *AutoBrowseDomains;
 131
 132 extern mDNSs32 ChopSubTypes(char *regtype);
 133 extern AuthRecord *AllocateSubTypes(mDNSs32 NumSubTypes, char *p);
 134 extern int CountExistingRegistrations(domainname *srv, mDNSIPPort port);
 135 extern void FreeExtraRR(mDNS *const m, AuthRecord *const rr, mStatus result);
 136 extern int CountPeerRegistrations(mDNS *const m, ServiceRecordSet *const srs);
 137
 138 #if APPLE_OSX_mDNSResponder
 139 extern void machserver_automatic_browse_domain_changed(const domainname *d, mDNSBool add);
 140 extern void machserver_automatic_registration_domain_changed(const domainname *d, mDNSBool add);
 141 #endif
 142
 143 extern const char mDNSResponderVersionString_SCCS[];
 144 #define mDNSResponderVersionString (mDNSResponderVersionString_SCCS+5)