mDNSPosix/mDNSPosix.h

   1 /* -*- Mode: C; tab-width: 4 -*-
   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 #define uDNS_SERVERS_FILE "/etc/resolv.conf"
  61 extern int ParseDNSServers(mDNS *m, const char *filePath);
  62 extern mStatus mDNSPlatformPosixRefreshInterfaceList(mDNS *const m);
  63 // See comment in implementation.
  64
  65 // Call mDNSPosixGetFDSet before calling select(), to update the parameters
  66 // as may be necessary to meet the needs of the mDNSCore code.
  67 // The timeout pointer MUST NOT be NULL.
  68 // Set timeout->tv_sec to 0x3FFFFFFF if you want to have effectively no timeout
  69 // After calling mDNSPosixGetFDSet(), call select(nfds, &readfds, NULL, NULL, &timeout); as usual
  70 // After select() returns, call mDNSPosixProcessFDSet() to let mDNSCore do its work
  71 extern void mDNSPosixGetFDSet(mDNS *m, int *nfds, fd_set *readfds, struct timeval *timeout);
  72 extern void mDNSPosixProcessFDSet(mDNS *const m, fd_set *readfds);
  73
  74 typedef void (*mDNSPosixEventCallback)(int fd, short filter, void *context);
  75
  76 extern mStatus mDNSPosixAddFDToEventLoop( int fd, mDNSPosixEventCallback callback, void *context);
  77 extern mStatus mDNSPosixRemoveFDFromEventLoop( int fd);
  78 extern mStatus mDNSPosixListenForSignalInEventLoop( int signum);
  79 extern mStatus mDNSPosixIgnoreSignalInEventLoop( int signum);
  80 extern mStatus mDNSPosixRunEventLoopOnce( mDNS *m, const struct timeval *pTimeout, sigset_t *pSignalsReceived, mDNSBool *pDataDispatched);
  81
  82 #ifdef  __cplusplus
  83 }
  84 #endif
  85
  86 #endif