1 /* -*- Mode: C; tab-width: 4; c-file-style: "bsd"; c-basic-offset: 4; fill-column: 108; indent-tabs-mode: nil; -*- 2 * 3 * Copyright (c) 2002-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 18 #ifndef __mDNSPlatformPosix_h 19 #define __mDNSPlatformPosix_h 20 21 #include <signal.h> 22 #include <sys/time.h> 23 24 #ifdef __cplusplus 25 extern "C" { 26 #endif 27 28 // PosixNetworkInterface is a record extension of the core NetworkInterfaceInfo 29 // type that supports extra fields needed by the Posix platform. 30 // 31 // IMPORTANT: coreIntf must be the first field in the structure because 32 // we cast between pointers to the two different types regularly. 33 34 typedef struct PosixNetworkInterface PosixNetworkInterface; 35 36 struct PosixNetworkInterface 37 { 38 NetworkInterfaceInfo coreIntf; // MUST be the first element in this structure 39 mDNSs32 LastSeen; 40 const char * intfName; 41 PosixNetworkInterface * aliasIntf; 42 int index; 43 int multicastSocket4; 44 #if HAVE_IPV6 45 int multicastSocket6; 46 #endif 47 }; 48 49 // This is a global because debugf_() needs to be able to check its value 50 extern int gMDNSPlatformPosixVerboseLevel; 51 52 struct mDNS_PlatformSupport_struct 53 { 54 int unicastSocket4; 55 #if HAVE_IPV6 56 int unicastSocket6; 57 #endif 58 }; 59 60 // We keep a list of client-supplied event sources in PosixEventSource records 61 // Add a file descriptor to the set that mDNSPosixRunEventLoopOnce() listens to. 62 #define PosixEventFlag_OnList 1 63 #define PosixEventFlag_Read 2 64 #define PosixEventFlag_Write 4 65 66 typedef void (*mDNSPosixEventCallback)(int fd, void *context); 67 struct PosixEventSource 68 { 69 struct PosixEventSource *next; 70 mDNSPosixEventCallback readCallback; 71 mDNSPosixEventCallback writeCallback; 72 const char *readTaskName; 73 const char *writeTaskName; 74 void *readContext; 75 void *writeContext; 76 int fd; 77 unsigned flags; 78 }; 79 typedef struct PosixEventSource PosixEventSource; 80 81 struct TCPSocket_struct 82 { 83 mDNSIPPort port; // MUST BE FIRST FIELD -- mDNSCore expects every TCPSocket_struct to begin with mDNSIPPort 84 TCPSocketFlags flags; // MUST BE SECOND FIELD -- mDNSCore expects every TCPSocket_struct have TCPSocketFlags flags after mDNSIPPort 85 TCPConnectionCallback callback; 86 PosixEventSource events; 87 // SSL context goes here. 88 domainname *hostname; 89 mDNSAddr remoteAddress; 90 mDNSIPPort remotePort; 91 void *context; 92 mDNSBool setup; 93 mDNSBool connected; 94 mStatus err; 95 }; 96 97 struct TCPListener_struct 98 { 99 TCPAcceptedCallback callback; 100 PosixEventSource events; 101 void *context; 102 mDNSAddr_Type addressType; 103 TCPSocketFlags socketFlags; 104 }; 105 106 #define uDNS_SERVERS_FILE "/etc/resolv.conf" 107 extern int ParseDNSServers(mDNS *m, const char *filePath); 108 extern mStatus mDNSPlatformPosixRefreshInterfaceList(mDNS *const m); 109 // See comment in implementation. 110 111 // Get the next upcoming mDNS (or DNS) event time as a posix timeval that can be passed to select. 112 // This will only update timeout if the next mDNS event is sooner than the value that was passed. 113 // Therefore, use { FutureTime, 0 } as an initializer if no other timer events are being managed. 114 extern void mDNSPosixGetNextDNSEventTime(mDNS *m, struct timeval *timeout); 115 116 // Returns all the FDs that the posix I/O event system expects to be passed to select. 117 extern void mDNSPosixGetFDSetForSelect(mDNS *m, int *nfds, fd_set *readfds, fd_set *writefds); 118 119 // Call mDNSPosixGetFDSet before calling select(), to update the parameters 120 // as may be necessary to meet the needs of the mDNSCore code. 121 // The timeout pointer MUST NOT be NULL. 122 // Set timeout->tv_sec to FutureTime if you want to have effectively no timeout 123 // After calling mDNSPosixGetFDSet(), call select(nfds, &readfds, NULL, NULL, &timeout); as usual 124 // After select() returns, call mDNSPosixProcessFDSet() to let mDNSCore do its work 125 // mDNSPosixGetFDSet simply calls mDNSPosixGetNextDNSEventTime and then mDNSPosixGetFDSetForSelect. 126 extern void mDNSPosixGetFDSet(mDNS *m, int *nfds, fd_set *readfds, fd_set *writefds, struct timeval *timeout); 127 128 129 extern void mDNSPosixProcessFDSet(mDNS *const m, fd_set *readfds, fd_set *writefds); 130 131 extern mStatus mDNSPosixAddFDToEventLoop( int fd, mDNSPosixEventCallback callback, void *context); 132 extern mStatus mDNSPosixRemoveFDFromEventLoop( int fd); 133 extern mStatus mDNSPosixListenForSignalInEventLoop( int signum); 134 extern mStatus mDNSPosixIgnoreSignalInEventLoop( int signum); 135 extern mStatus mDNSPosixRunEventLoopOnce( mDNS *m, const struct timeval *pTimeout, sigset_t *pSignalsReceived, mDNSBool *pDataDispatched); 136 137 extern mStatus mDNSPosixListenForSignalInEventLoop( int signum); 138 extern mStatus mDNSPosixIgnoreSignalInEventLoop( int signum); 139 extern mStatus mDNSPosixRunEventLoopOnce( mDNS *m, const struct timeval *pTimeout, sigset_t *pSignalsReceived, mDNSBool *pDataDispatched); 140 141 #ifdef __cplusplus 142 } 143 #endif 144 145 #endif 146