SystemConfiguration.fproj/SCNetworkProtocol.c

   1 /*
   2  * Copyright (c) 2004-2008, 2016, 2017 Apple 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  * May 13, 2004         Allan Nathanson <ajn@apple.com>
  28  * - initial revision
  29  */
  30
  31
  32 #include <CoreFoundation/CoreFoundation.h>
  33 #include <CoreFoundation/CFRuntime.h>
  34 #include "SCNetworkConfigurationInternal.h"
  35
  36 #include <pthread.h>
  37
  38
  39 static CFStringRef      __SCNetworkProtocolCopyDescription      (CFTypeRef cf);
  40 static void             __SCNetworkProtocolDeallocate           (CFTypeRef cf);
  41 static Boolean          __SCNetworkProtocolEqual                (CFTypeRef cf1, CFTypeRef cf2);
  42 static CFHashCode       __SCNetworkProtocolHash                 (CFTypeRef cf);
  43
  44
  45 const CFStringRef kSCNetworkProtocolTypeDNS             = CFSTR("DNS");
  46 const CFStringRef kSCNetworkProtocolTypeIPv4            = CFSTR("IPv4");
  47 const CFStringRef kSCNetworkProtocolTypeIPv6            = CFSTR("IPv6");
  48 const CFStringRef kSCNetworkProtocolTypeProxies         = CFSTR("Proxies");
  49 #if     !TARGET_OS_IPHONE
  50 const CFStringRef kSCNetworkProtocolTypeSMB             = CFSTR("SMB");
  51 #endif  // !TARGET_OS_IPHONE
  52
  53
  54 static CFTypeID __kSCNetworkProtocolTypeID      = _kCFRuntimeNotATypeID;
  55
  56
  57 static const CFRuntimeClass __SCNetworkProtocolClass = {
  58         0,                                      // version
  59         "SCNetworkProtocol",                    // className
  60         NULL,                                   // init
  61         NULL,                                   // copy
  62         __SCNetworkProtocolDeallocate,          // dealloc
  63         __SCNetworkProtocolEqual,               // equal
  64         __SCNetworkProtocolHash,                // hash
  65         NULL,                                   // copyFormattingDesc
  66         __SCNetworkProtocolCopyDescription      // copyDebugDesc
  67 };
  68
  69
  70 static pthread_once_t           initialized     = PTHREAD_ONCE_INIT;
  71
  72
  73 static CFStringRef
  74 __SCNetworkProtocolCopyDescription(CFTypeRef cf)
  75 {
  76         CFAllocatorRef                  allocator       = CFGetAllocator(cf);
  77         CFMutableStringRef              result;
  78         SCNetworkProtocolPrivateRef     protocolPrivate = (SCNetworkProtocolPrivateRef)cf;
  79
  80         result = CFStringCreateMutable(allocator, 0);
  81         CFStringAppendFormat(result, NULL, CFSTR("<SCNetworkProtocol %p [%p]> {"), cf, allocator);
  82         CFStringAppendFormat(result, NULL, CFSTR("id = %@"), protocolPrivate->entityID);
  83         CFStringAppendFormat(result, NULL, CFSTR(", service = %p"), protocolPrivate->service);
  84         CFStringAppendFormat(result, NULL,
  85                              CFSTR(", prefs = %p"),
  86                              ((SCNetworkServicePrivateRef)protocolPrivate->service)->prefs);
  87         CFStringAppendFormat(result, NULL, CFSTR("}"));
  88
  89         return result;
  90 }
  91
  92
  93 static void
  94 __SCNetworkProtocolDeallocate(CFTypeRef cf)
  95 {
  96         SCNetworkProtocolPrivateRef     protocolPrivate = (SCNetworkProtocolPrivateRef)cf;
  97
  98         /* release resources */
  99         CFRelease(protocolPrivate->entityID);
 100         CFRelease(protocolPrivate->service);
 101
 102         return;
 103 }
 104
 105
 106 static Boolean
 107 __SCNetworkProtocolEqual(CFTypeRef cf1, CFTypeRef cf2)
 108 {
 109         SCNetworkProtocolPrivateRef     p1      = (SCNetworkProtocolPrivateRef)cf1;
 110         SCNetworkProtocolPrivateRef     p2      = (SCNetworkProtocolPrivateRef)cf2;
 111
 112         if (p1 == p2)
 113                 return TRUE;
 114
 115         if (!CFEqual(p1->entityID, p2->entityID))
 116                 return FALSE;   // if not the same protocol type
 117
 118         if (p1->service == p2->service)
 119                 return TRUE;    // if both point to the same service
 120
 121         if ((p1->service != NULL) && (p2->service != NULL) && CFEqual(p1->service, p2->service))
 122                 return TRUE;    // if both effectively point to the same service
 123
 124         return FALSE;
 125 }
 126
 127
 128 static CFHashCode
 129 __SCNetworkProtocolHash(CFTypeRef cf)
 130 {
 131         SCNetworkProtocolPrivateRef     protocolPrivate = (SCNetworkProtocolPrivateRef)cf;
 132
 133         return CFHash(protocolPrivate->entityID);
 134 }
 135
 136
 137 static void
 138 __SCNetworkProtocolInitialize(void)
 139 {
 140         __kSCNetworkProtocolTypeID = _CFRuntimeRegisterClass(&__SCNetworkProtocolClass);
 141         return;
 142 }
 143
 144
 145 __private_extern__ SCNetworkProtocolPrivateRef
 146 __SCNetworkProtocolCreatePrivate(CFAllocatorRef         allocator,
 147                                  CFStringRef            entityID,
 148                                  SCNetworkServiceRef    service)
 149 {
 150         SCNetworkProtocolPrivateRef             protocolPrivate;
 151         uint32_t                                size;
 152
 153         /* initialize runtime */
 154         pthread_once(&initialized, __SCNetworkProtocolInitialize);
 155
 156         /* allocate target */
 157         size            = sizeof(SCNetworkProtocolPrivate) - sizeof(CFRuntimeBase);
 158         protocolPrivate = (SCNetworkProtocolPrivateRef)_CFRuntimeCreateInstance(allocator,
 159                                                                                 __kSCNetworkProtocolTypeID,
 160                                                                                 size,
 161                                                                                 NULL);
 162         if (protocolPrivate == NULL) {
 163                 return NULL;
 164         }
 165
 166         /* initialize non-zero/NULL members */
 167         protocolPrivate->entityID       = CFStringCreateCopy(NULL, entityID);
 168         protocolPrivate->service        = CFRetain(service);
 169
 170         return protocolPrivate;
 171 }
 172
 173
 174 __private_extern__ Boolean
 175 __SCNetworkProtocolIsValidType(CFStringRef protocolType)
 176 {
 177         static const CFStringRef        *valid_types[]  = {
 178                 &kSCNetworkProtocolTypeDNS,
 179                 &kSCNetworkProtocolTypeIPv4,
 180                 &kSCNetworkProtocolTypeIPv6,
 181                 &kSCNetworkProtocolTypeProxies,
 182 #if     !TARGET_OS_IPHONE
 183                 &kSCNetworkProtocolTypeSMB,
 184 #endif  // !TARGET_OS_IPHONE
 185         };
 186
 187         for (size_t i = 0; i < sizeof(valid_types)/sizeof(valid_types[0]); i++) {
 188                 if (CFEqual(protocolType, *valid_types[i])) {
 189                         // if known/valid protocol type
 190                         return TRUE;
 191                 }
 192         }
 193
 194         if (CFStringFindWithOptions(protocolType,
 195                                     CFSTR("."),
 196                                     CFRangeMake(0, CFStringGetLength(protocolType)),
 197                                     0,
 198                                     NULL)) {
 199                 // if user-defined protocol type (e.g. com.apple.myProtocol)
 200                 return TRUE;
 201         }
 202
 203         return FALSE;
 204 }
 205
 206
 207 static CFStringRef
 208 copyProtocolConfigurationPath(SCNetworkProtocolPrivateRef protocolPrivate)
 209 {
 210         CFStringRef                     path;
 211         SCNetworkServicePrivateRef      servicePrivate;
 212
 213         servicePrivate = (SCNetworkServicePrivateRef)protocolPrivate->service;
 214         path = SCPreferencesPathKeyCreateNetworkServiceEntity(NULL,                             // allocator
 215                                                               servicePrivate->serviceID,        // service
 216                                                               protocolPrivate->entityID);       // entity
 217         return path;
 218 }
 219
 220
 221 #pragma mark -
 222 #pragma mark SCNetworkProtocol APIs
 223
 224
 225 CFComparisonResult
 226 _SCNetworkProtocolCompare(const void *val1, const void *val2, void *context)
 227 {
 228 #pragma unused(context)
 229         SCNetworkProtocolRef    p1      = (SCNetworkProtocolRef)val1;
 230         SCNetworkProtocolRef    p2      = (SCNetworkProtocolRef)val2;
 231         CFStringRef             type1;
 232         CFStringRef             type2;
 233
 234         type1 = SCNetworkProtocolGetProtocolType(p1);
 235         type2 = SCNetworkProtocolGetProtocolType(p2);
 236
 237         return CFStringCompare(type1, type2, 0);
 238 }
 239
 240
 241 CFTypeID
 242 SCNetworkProtocolGetTypeID()
 243 {
 244         pthread_once(&initialized, __SCNetworkProtocolInitialize);      /* initialize runtime */
 245         return __kSCNetworkProtocolTypeID;
 246 }
 247
 248
 249 CFDictionaryRef
 250 SCNetworkProtocolGetConfiguration(SCNetworkProtocolRef protocol)
 251 {
 252         CFDictionaryRef                 config;
 253         CFStringRef                     path;
 254         SCNetworkProtocolPrivateRef     protocolPrivate = (SCNetworkProtocolPrivateRef)protocol;
 255         SCNetworkServicePrivateRef      servicePrivate;
 256
 257         if (!isA_SCNetworkProtocol(protocol)) {
 258                 _SCErrorSet(kSCStatusInvalidArgument);
 259                 return NULL;
 260         }
 261
 262         servicePrivate = (SCNetworkServicePrivateRef)protocolPrivate->service;
 263         path = copyProtocolConfigurationPath(protocolPrivate);
 264         config = __getPrefsConfiguration(servicePrivate->prefs, path);
 265         CFRelease(path);
 266
 267         return config;
 268 }
 269
 270
 271 Boolean
 272 SCNetworkProtocolGetEnabled(SCNetworkProtocolRef protocol)
 273 {
 274         Boolean                         enabled;
 275         CFStringRef                     path;
 276         SCNetworkProtocolPrivateRef     protocolPrivate = (SCNetworkProtocolPrivateRef)protocol;
 277         SCNetworkServicePrivateRef      servicePrivate;
 278
 279         if (!isA_SCNetworkProtocol(protocol)) {
 280                 _SCErrorSet(kSCStatusInvalidArgument);
 281                 return FALSE;
 282         }
 283
 284         servicePrivate = (SCNetworkServicePrivateRef)protocolPrivate->service;
 285         path = copyProtocolConfigurationPath(protocolPrivate);
 286         enabled = __getPrefsEnabled(servicePrivate->prefs, path);
 287         CFRelease(path);
 288
 289         return enabled;
 290 }
 291
 292
 293 CFStringRef
 294 SCNetworkProtocolGetProtocolType(SCNetworkProtocolRef protocol)
 295 {
 296         SCNetworkProtocolPrivateRef     protocolPrivate = (SCNetworkProtocolPrivateRef)protocol;
 297
 298         if (!isA_SCNetworkProtocol(protocol)) {
 299                 _SCErrorSet(kSCStatusInvalidArgument);
 300                 return NULL;
 301         }
 302
 303         return protocolPrivate->entityID;
 304 }
 305
 306
 307 Boolean
 308 SCNetworkProtocolSetConfiguration(SCNetworkProtocolRef protocol, CFDictionaryRef config)
 309 {
 310         Boolean                         ok;
 311         CFStringRef                     path;
 312         SCNetworkProtocolPrivateRef     protocolPrivate = (SCNetworkProtocolPrivateRef)protocol;
 313         SCNetworkServicePrivateRef      servicePrivate;
 314
 315         if (!isA_SCNetworkProtocol(protocol)) {
 316                 _SCErrorSet(kSCStatusInvalidArgument);
 317                 return FALSE;
 318         }
 319
 320         servicePrivate = (SCNetworkServicePrivateRef)protocolPrivate->service;
 321         path = copyProtocolConfigurationPath(protocolPrivate);
 322         ok = __setPrefsConfiguration(servicePrivate->prefs, path, config, TRUE);
 323         CFRelease(path);
 324
 325         if (ok) {
 326                 SC_log(LOG_DEBUG, "SCNetworkProtocolSetConfiguration(): %@ --> %@",
 327                        protocol,
 328                        config != NULL ? config : (CFDictionaryRef)CFSTR("NULL"));
 329         }
 330
 331         return ok;
 332 }
 333
 334
 335 Boolean
 336 SCNetworkProtocolSetEnabled(SCNetworkProtocolRef protocol, Boolean enabled)
 337 {
 338         Boolean                         ok;
 339         CFStringRef                     path;
 340         SCNetworkProtocolPrivateRef     protocolPrivate = (SCNetworkProtocolPrivateRef)protocol;
 341         SCNetworkServicePrivateRef      servicePrivate;
 342
 343         if (!isA_SCNetworkProtocol(protocol)) {
 344                 _SCErrorSet(kSCStatusInvalidArgument);
 345                 return FALSE;
 346         }
 347
 348         servicePrivate = (SCNetworkServicePrivateRef)protocolPrivate->service;
 349         path = copyProtocolConfigurationPath(protocolPrivate);
 350         ok = __setPrefsEnabled(servicePrivate->prefs, path, enabled);
 351         CFRelease(path);
 352
 353         if (ok) {
 354                 SC_log(LOG_DEBUG, "SCNetworkProtocolSetEnabled(): %@ -> %s",
 355                        protocol,
 356                        enabled ? "Enabled" : "Disabled");
 357         }
 358
 359         return ok;
 360 }