SystemConfiguration.fproj/SCDNotifierWait.c

   1 /*
   2  * Copyright (c) 2000, 2001, 2004, 2006 Apple Computer, Inc. All rights reserved.
   3  *
   4  * @APPLE_LICENSE_HEADER_START@
   5  *
   6  * This file contains Original Code and/or Modifications of Original Code
   7  * as defined in and that are subject to the Apple Public Source License
   8  * Version 2.0 (the 'License'). You may not use this file except in
   9  * compliance with the License. Please obtain a copy of the License at
  10  * http://www.opensource.apple.com/apsl/ and read it before using this
  11  * file.
  12  *
  13  * The Original Code and all software distributed under the License are
  14  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  15  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  16  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  17  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  18  * Please see the License for the specific language governing rights and
  19  * limitations under the License.
  20  *
  21  * @APPLE_LICENSE_HEADER_END@
  22  */
  23
  24 /*
  25  * Modification History
  26  *
  27  * June 1, 2001                 Allan Nathanson <ajn@apple.com>
  28  * - public API conversion
  29  *
  30  * March 31, 2000               Allan Nathanson <ajn@apple.com>
  31  * - initial revision
  32  */
  33
  34 #include <mach/mach.h>
  35 #include <mach/mach_error.h>
  36
  37 #include <SystemConfiguration/SystemConfiguration.h>
  38 #include <SystemConfiguration/SCPrivate.h>
  39 #include "SCDynamicStoreInternal.h"
  40 #include "config.h"             /* MiG generated file */
  41
  42 static mach_msg_id_t
  43 waitForMachMessage(mach_port_t port)
  44 {
  45         union {
  46                 u_int8_t                buf[sizeof(mach_msg_empty_t) + MAX_TRAILER_SIZE];
  47                 mach_msg_empty_rcv_t    msg;
  48         } notify_msg;
  49         kern_return_t   status;
  50
  51         status = mach_msg(&notify_msg.msg.header,       /* msg */
  52                           MACH_RCV_MSG,                 /* options */
  53                           0,                            /* send_size */
  54                           sizeof(notify_msg),           /* rcv_size */
  55                           port,                         /* rcv_name */
  56                           MACH_MSG_TIMEOUT_NONE,        /* timeout */
  57                           MACH_PORT_NULL);              /* notify */
  58         if (status != KERN_SUCCESS) {
  59                 SCLog(TRUE, LOG_DEBUG, CFSTR("waitForMachMessage mach_msg(): %s"), mach_error_string(status));
  60                 return -1;
  61         }
  62
  63         return notify_msg.msg.header.msgh_id;
  64 }
  65
  66
  67 Boolean
  68 SCDynamicStoreNotifyWait(SCDynamicStoreRef store)
  69 {
  70         SCDynamicStorePrivateRef        storePrivate = (SCDynamicStorePrivateRef)store;
  71         kern_return_t                   status;
  72         mach_port_t                     port;
  73         mach_port_t                     oldNotify;
  74         int                             sc_status;
  75         mach_msg_id_t                   msgid;
  76
  77         if (store == NULL) {
  78                 /* sorry, you must provide a session */
  79                 _SCErrorSet(kSCStatusNoStoreSession);
  80                 return FALSE;
  81         }
  82
  83         if (storePrivate->server == MACH_PORT_NULL) {
  84                 /* sorry, you must have an open session to play */
  85                 _SCErrorSet(kSCStatusNoStoreServer);
  86                 return FALSE;
  87         }
  88
  89         if (storePrivate->notifyStatus != NotifierNotRegistered) {
  90                 /* sorry, you can only have one notification registered at once */
  91                 _SCErrorSet(kSCStatusNotifierActive);
  92                 return FALSE;
  93         }
  94
  95         /* Allocating port (for server response) */
  96         status = mach_port_allocate(mach_task_self(), MACH_PORT_RIGHT_RECEIVE, &port);
  97         if (status != KERN_SUCCESS) {
  98                 SCLog(TRUE, LOG_DEBUG, CFSTR("SCDynamicStoreNotifyWait mach_port_allocate(): %s"), mach_error_string(status));
  99                 _SCErrorSet(status);
 100                 return FALSE;
 101         }
 102
 103         status = mach_port_insert_right(mach_task_self(),
 104                                         port,
 105                                         port,
 106                                         MACH_MSG_TYPE_MAKE_SEND);
 107         if (status != KERN_SUCCESS) {
 108                 SCLog(TRUE, LOG_DEBUG, CFSTR("SCDynamicStoreNotifyWait mach_port_insert_right(): %s"), mach_error_string(status));
 109                 (void) mach_port_destroy(mach_task_self(), port);
 110                 _SCErrorSet(status);
 111                 return FALSE;
 112         }
 113
 114         /* Request a notification when/if the server dies */
 115         status = mach_port_request_notification(mach_task_self(),
 116                                                 port,
 117                                                 MACH_NOTIFY_NO_SENDERS,
 118                                                 1,
 119                                                 port,
 120                                                 MACH_MSG_TYPE_MAKE_SEND_ONCE,
 121                                                 &oldNotify);
 122         if (status != KERN_SUCCESS) {
 123                 SCLog(TRUE, LOG_DEBUG, CFSTR("SCDynamicStoreNotifyWait mach_port_request_notification(): %s"), mach_error_string(status));
 124                 (void) mach_port_destroy(mach_task_self(), port);
 125                 _SCErrorSet(status);
 126                 return FALSE;
 127         }
 128
 129 #ifdef  DEBUG
 130         if (oldNotify != MACH_PORT_NULL) {
 131                 SCLog(TRUE, LOG_ERR, CFSTR("SCDynamicStoreNotifyWait(): why is oldNotify != MACH_PORT_NULL?"));
 132         }
 133 #endif  /* DEBUG */
 134
 135         status = notifyviaport(storePrivate->server,
 136                                port,
 137                                0,
 138                                (int *)&sc_status);
 139
 140         if (status != KERN_SUCCESS) {
 141 #ifdef  DEBUG
 142                 if (status != MACH_SEND_INVALID_DEST)
 143                         SCLog(TRUE, LOG_DEBUG, CFSTR("SCDynamicStoreNotifyWait notifyviaport(): %s"), mach_error_string(status));
 144 #endif  /* DEBUG */
 145                 (void) mach_port_destroy(mach_task_self(), storePrivate->server);
 146                 storePrivate->server = MACH_PORT_NULL;
 147                 _SCErrorSet(status);
 148                 return FALSE;
 149         }
 150
 151         if (sc_status != kSCStatusOK) {
 152                 _SCErrorSet(sc_status);
 153                 return FALSE;
 154         }
 155
 156         /* set notifier active */
 157         storePrivate->notifyStatus = Using_NotifierWait;
 158
 159         msgid = waitForMachMessage(port);
 160
 161         /* set notifier inactive */
 162         storePrivate->notifyStatus = NotifierNotRegistered;
 163
 164         if (msgid == MACH_NOTIFY_NO_SENDERS) {
 165                 /* the server closed the notifier port */
 166 #ifdef  DEBUG
 167                 SCLog(_sc_verbose, LOG_DEBUG, CFSTR("SCDynamicStoreNotifyWait notifier port closed, destroying port %d"), port);
 168 #endif  /* DEBUG */
 169                 _SCErrorSet(kSCStatusNoStoreServer);
 170                 return FALSE;
 171         }
 172
 173         if (msgid == -1) {
 174                 /* one of the mach routines returned an error */
 175 #ifdef  DEBUG
 176                 SCLog(_sc_verbose, LOG_DEBUG, CFSTR("SCDynamicStoreNotifyWait communication with server failed, destroying port %d"), port);
 177 #endif  /* DEBUG */
 178                 (void) mach_port_destroy(mach_task_self(), port);
 179                 _SCErrorSet(kSCStatusNoStoreServer);
 180                 return FALSE;
 181         }
 182
 183         // something changed, cancelling notification request
 184         status = notifycancel(storePrivate->server,
 185                               (int *)&sc_status);
 186
 187         if (status != KERN_SUCCESS) {
 188 #ifdef  DEBUG
 189                 if (status != MACH_SEND_INVALID_DEST)
 190                         SCLog(_sc_verbose, LOG_DEBUG, CFSTR("SCDynamicStoreNotifyWait notifycancel(): %s"), mach_error_string(status));
 191 #endif  /* DEBUG */
 192                 (void) mach_port_destroy(mach_task_self(), storePrivate->server);
 193                 storePrivate->server = MACH_PORT_NULL;
 194                 _SCErrorSet(status);
 195                 return FALSE;
 196         }
 197
 198         (void) mach_port_destroy(mach_task_self(), port);
 199
 200         return TRUE;
 201 }