configd.tproj/session.h

   1 /*
   2  * Copyright (c) 2000, 2001, 2005-2007, 2009-2011 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  * June 1, 2001                 Allan Nathanson <ajn@apple.com>
  28  * - public API conversion
  29  *
  30  * March 24, 2000               Allan Nathanson <ajn@apple.com>
  31  * - initial revision
  32  */
  33
  34 #ifndef _S_SESSION_H
  35 #define _S_SESSION_H
  36
  37 #include <sys/cdefs.h>
  38 #include <Availability.h>
  39 #include <TargetConditionals.h>
  40
  41
  42 #if     TARGET_OS_IPHONE || (__MAC_OS_X_VERSION_MIN_REQUIRED >= 1070)
  43 #define kSCWriteEntitlementName CFSTR("com.apple.SystemConfiguration.SCDynamicStore-write-access")
  44 #endif  // TARGET_OS_IPHONE || (__MAC_OS_X_VERSION_MIN_REQUIRED >= 1070)
  45
  46
  47 typedef enum { NO = 0, YES, UNKNOWN } lazyBoolean;
  48
  49
  50 /* Per client server state */
  51 typedef struct {
  52
  53         /* mach port used as the key to this session */
  54         mach_port_t             key;
  55
  56         /* mach port associated with this session */
  57         CFMachPortRef           serverPort;
  58         CFRunLoopSourceRef      serverRunLoopSource;
  59
  60         /* data associated with this "open" session */
  61         SCDynamicStoreRef       store;
  62
  63         /* credentials associated with this "open" session */
  64         uid_t                   callerEUID;
  65
  66         /* Mach security audit trailer for evaluating credentials */
  67         audit_token_t           auditToken;
  68
  69         /* root access credential associated with this "open" session */
  70         lazyBoolean             callerRootAccess;
  71
  72         /* write access entitlement associated with this "open" session */
  73         lazyBoolean             callerWriteAccess;
  74
  75 } serverSession, *serverSessionRef;
  76
  77 __BEGIN_DECLS
  78
  79 serverSessionRef        getSession      (mach_port_t    server);
  80
  81 serverSessionRef        tempSession     (mach_port_t    server,
  82                                          CFStringRef    name,
  83                                          audit_token_t  auditToken);
  84
  85 serverSessionRef        addSession      (mach_port_t    server,
  86                                          CFStringRef    (*copyDescription)(const void *info));
  87
  88 void                    cleanupSession  (mach_port_t    server);
  89
  90 void                    listSessions    (FILE           *f);
  91
  92 Boolean                 hasRootAccess   (serverSessionRef       session);
  93
  94 Boolean                 hasWriteAccess  (serverSessionRef       session);
  95
  96 Boolean                 hasPathAccess   (serverSessionRef       session,
  97                                          const char             *path);
  98
  99 __END_DECLS
 100
 101 #endif /* !_S_SESSION_H */