/**************************************************************************** ** ** Copyright (C) 2016 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of the QtCore module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 3 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL3 included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 3 requirements ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 2.0 or (at your option) the GNU General ** Public license version 3 or any later version approved by the KDE Free ** Qt Foundation. The licenses are as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-2.0.html and ** https://www.gnu.org/licenses/gpl-3.0.html. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #include "qcfsocketnotifier_p.h" #include #include #include QT_BEGIN_NAMESPACE /************************************************************************** Socket Notifiers *************************************************************************/ void qt_mac_socket_callback(CFSocketRef s, CFSocketCallBackType callbackType, CFDataRef, const void *, void *info) { QCFSocketNotifier *cfSocketNotifier = static_cast(info); int nativeSocket = CFSocketGetNative(s); MacSocketInfo *socketInfo = cfSocketNotifier->macSockets.value(nativeSocket); QEvent notifierEvent(QEvent::SockAct); // There is a race condition that happen where we disable the notifier and // the kernel still has a notification to pass on. We then get this // notification after we've successfully disabled the CFSocket, but our Qt // notifier is now gone. The upshot is we have to check the notifier // every time. if (callbackType == kCFSocketReadCallBack) { if (socketInfo->readNotifier && socketInfo->readEnabled) { socketInfo->readEnabled = false; QCoreApplication::sendEvent(socketInfo->readNotifier, ¬ifierEvent); } } else if (callbackType == kCFSocketWriteCallBack) { if (socketInfo->writeNotifier && socketInfo->writeEnabled) { socketInfo->writeEnabled = false; QCoreApplication::sendEvent(socketInfo->writeNotifier, ¬ifierEvent); } } if (cfSocketNotifier->maybeCancelWaitForMoreEvents) cfSocketNotifier->maybeCancelWaitForMoreEvents(cfSocketNotifier->eventDispatcher); } /* Adds a loop source for the given socket to the current run loop. */ CFRunLoopSourceRef qt_mac_add_socket_to_runloop(const CFSocketRef socket) { CFRunLoopSourceRef loopSource = CFSocketCreateRunLoopSource(kCFAllocatorDefault, socket, 0); if (!loopSource) return 0; CFRunLoopAddSource(CFRunLoopGetMain(), loopSource, kCFRunLoopCommonModes); return loopSource; } /* Removes the loop source for the given socket from the current run loop. */ void qt_mac_remove_socket_from_runloop(const CFSocketRef socket, CFRunLoopSourceRef runloop) { Q_ASSERT(runloop); CFRunLoopRemoveSource(CFRunLoopGetMain(), runloop, kCFRunLoopCommonModes); CFSocketDisableCallBacks(socket, kCFSocketReadCallBack); CFSocketDisableCallBacks(socket, kCFSocketWriteCallBack); } QCFSocketNotifier::QCFSocketNotifier() : eventDispatcher(0) , maybeCancelWaitForMoreEvents(0) , enableNotifiersObserver(0) { } QCFSocketNotifier::~QCFSocketNotifier() { } void QCFSocketNotifier::setHostEventDispatcher(QAbstractEventDispatcher *hostEventDispacher) { eventDispatcher = hostEventDispacher; } void QCFSocketNotifier::setMaybeCancelWaitForMoreEventsCallback(MaybeCancelWaitForMoreEventsFn callBack) { maybeCancelWaitForMoreEvents = callBack; } void QCFSocketNotifier::registerSocketNotifier(QSocketNotifier *notifier) { Q_ASSERT(notifier); int nativeSocket = notifier->socket(); int type = notifier->type(); #ifndef QT_NO_DEBUG if (nativeSocket < 0 || nativeSocket > FD_SETSIZE) { qWarning("QSocketNotifier: Internal error"); return; } else if (notifier->thread() != eventDispatcher->thread() || eventDispatcher->thread() != QThread::currentThread()) { qWarning("QSocketNotifier: socket notifiers cannot be enabled from another thread"); return; } #endif if (type == QSocketNotifier::Exception) { qWarning("QSocketNotifier::Exception is not supported on iOS"); return; } // Check if we have a CFSocket for the native socket, create one if not. MacSocketInfo *socketInfo = macSockets.value(nativeSocket); if (!socketInfo) { socketInfo = new MacSocketInfo(); // Create CFSocket, specify that we want both read and write callbacks (the callbacks // are enabled/disabled later on). const int callbackTypes = kCFSocketReadCallBack | kCFSocketWriteCallBack; CFSocketContext context = {0, this, 0, 0, 0}; socketInfo->socket = CFSocketCreateWithNative(kCFAllocatorDefault, nativeSocket, callbackTypes, qt_mac_socket_callback, &context); if (CFSocketIsValid(socketInfo->socket) == false) { qWarning("QEventDispatcherMac::registerSocketNotifier: Failed to create CFSocket"); return; } CFOptionFlags flags = CFSocketGetSocketFlags(socketInfo->socket); // QSocketNotifier doesn't close the socket upon destruction/invalidation flags &= ~kCFSocketCloseOnInvalidate; // Expicitly disable automatic re-enable, as we do that manually on each runloop pass flags &= ~(kCFSocketAutomaticallyReenableWriteCallBack | kCFSocketAutomaticallyReenableReadCallBack); CFSocketSetSocketFlags(socketInfo->socket, flags); macSockets.insert(nativeSocket, socketInfo); } if (type == QSocketNotifier::Read) { Q_ASSERT(socketInfo->readNotifier == 0); socketInfo->readNotifier = notifier; socketInfo->readEnabled = false; } else if (type == QSocketNotifier::Write) { Q_ASSERT(socketInfo->writeNotifier == 0); socketInfo->writeNotifier = notifier; socketInfo->writeEnabled = false; } if (!enableNotifiersObserver) { // Create a run loop observer which enables the socket notifiers on each // pass of the run loop, before any sources are processed. CFRunLoopObserverContext context = {}; context.info = this; enableNotifiersObserver = CFRunLoopObserverCreate(kCFAllocatorDefault, kCFRunLoopBeforeSources, true, 0, enableSocketNotifiers, &context); Q_ASSERT(enableNotifiersObserver); CFRunLoopAddObserver(CFRunLoopGetMain(), enableNotifiersObserver, kCFRunLoopCommonModes); } } void QCFSocketNotifier::unregisterSocketNotifier(QSocketNotifier *notifier) { Q_ASSERT(notifier); int nativeSocket = notifier->socket(); int type = notifier->type(); #ifndef QT_NO_DEBUG if (nativeSocket < 0 || nativeSocket > FD_SETSIZE) { qWarning("QSocketNotifier: Internal error"); return; } else if (notifier->thread() != eventDispatcher->thread() || eventDispatcher->thread() != QThread::currentThread()) { qWarning("QSocketNotifier: socket notifiers cannot be disabled from another thread"); return; } #endif if (type == QSocketNotifier::Exception) { qWarning("QSocketNotifier::Exception is not supported on iOS"); return; } MacSocketInfo *socketInfo = macSockets.value(nativeSocket); if (!socketInfo) { qWarning("QEventDispatcherMac::unregisterSocketNotifier: Tried to unregister a not registered notifier"); return; } // Decrement read/write counters and disable callbacks if necessary. if (type == QSocketNotifier::Read) { Q_ASSERT(notifier == socketInfo->readNotifier); socketInfo->readNotifier = 0; socketInfo->readEnabled = false; CFSocketDisableCallBacks(socketInfo->socket, kCFSocketReadCallBack); } else if (type == QSocketNotifier::Write) { Q_ASSERT(notifier == socketInfo->writeNotifier); socketInfo->writeNotifier = 0; socketInfo->writeEnabled = false; CFSocketDisableCallBacks(socketInfo->socket, kCFSocketWriteCallBack); } // Remove CFSocket from runloop if this was the last QSocketNotifier. if (socketInfo->readNotifier == 0 && socketInfo->writeNotifier == 0) { unregisterSocketInfo(socketInfo); delete socketInfo; macSockets.remove(nativeSocket); } } void QCFSocketNotifier::removeSocketNotifiers() { // Remove CFSockets from the runloop. for (MacSocketInfo *socketInfo : qAsConst(macSockets)) { unregisterSocketInfo(socketInfo); delete socketInfo; } macSockets.clear(); destroyRunLoopObserver(); } void QCFSocketNotifier::destroyRunLoopObserver() { if (!enableNotifiersObserver) return; CFRunLoopObserverInvalidate(enableNotifiersObserver); CFRelease(enableNotifiersObserver); enableNotifiersObserver = 0; } void QCFSocketNotifier::unregisterSocketInfo(MacSocketInfo *socketInfo) { if (socketInfo->runloop) { if (CFSocketIsValid(socketInfo->socket)) qt_mac_remove_socket_from_runloop(socketInfo->socket, socketInfo->runloop); CFRunLoopSourceInvalidate(socketInfo->runloop); CFRelease(socketInfo->runloop); } CFSocketInvalidate(socketInfo->socket); CFRelease(socketInfo->socket); } void QCFSocketNotifier::enableSocketNotifiers(CFRunLoopObserverRef ref, CFRunLoopActivity activity, void *info) { Q_UNUSED(ref); Q_UNUSED(activity); const QCFSocketNotifier *that = static_cast(info); for (MacSocketInfo *socketInfo : that->macSockets) { if (!CFSocketIsValid(socketInfo->socket)) continue; if (!socketInfo->runloop) { // Add CFSocket to runloop. if (!(socketInfo->runloop = qt_mac_add_socket_to_runloop(socketInfo->socket))) { qWarning("QEventDispatcherMac::registerSocketNotifier: Failed to add CFSocket to runloop"); CFSocketInvalidate(socketInfo->socket); continue; } // Apple docs say: "If a callback is automatically re-enabled, // it is called every time the condition becomes true ... If a // callback is not automatically re-enabled, then it gets called // exactly once, and is not called again until you manually // re-enable that callback by calling CFSocketEnableCallBacks()". // So, we don't need to enable callbacks on registering. socketInfo->readEnabled = (socketInfo->readNotifier != nullptr); if (!socketInfo->readEnabled) CFSocketDisableCallBacks(socketInfo->socket, kCFSocketReadCallBack); socketInfo->writeEnabled = (socketInfo->writeNotifier != nullptr); if (!socketInfo->writeEnabled) CFSocketDisableCallBacks(socketInfo->socket, kCFSocketWriteCallBack); continue; } if (socketInfo->readNotifier && !socketInfo->readEnabled) { socketInfo->readEnabled = true; CFSocketEnableCallBacks(socketInfo->socket, kCFSocketReadCallBack); } if (socketInfo->writeNotifier && !socketInfo->writeEnabled) { socketInfo->writeEnabled = true; CFSocketEnableCallBacks(socketInfo->socket, kCFSocketWriteCallBack); } } } QT_END_NAMESPACE