xref: /xnu-12377.81.4/osfmk/ipc/ipc_service_port.h (revision 043036a2b3718f7f0be807e2870f8f47d3fa0796)
1 /*
2  * Copyright (c) 2000-2019 Apple Computer, Inc. All rights reserved.
3  *
4  * @APPLE_OSREFERENCE_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. The rights granted to you under the License
10  * may not be used to create, or enable the creation or redistribution of,
11  * unlawful or unlicensed copies of an Apple operating system, or to
12  * circumvent, violate, or enable the circumvention or violation of, any
13  * terms of an Apple operating system software license agreement.
14  *
15  * Please obtain a copy of the License at
16  * http://www.opensource.apple.com/apsl/ and read it before using this file.
17  *
18  * The Original Code and all software distributed under the License are
19  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23  * Please see the License for the specific language governing rights and
24  * limitations under the License.
25  *
26  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
27  */
28 
29 #ifndef _IPC_IPC_SERVICE_PORT_H_
30 #define _IPC_IPC_SERVICE_PORT_H_
31 
32 #include <ipc/ipc_types.h>
33 #include <ipc/ipc_port.h>
34 
35 #ifdef MACH_KERNEL_PRIVATE
36 
37 #define XPC_DOMAIN_PORT 7 /* This value should match what is in <xpc/launch_private.h> */
38 
39 struct ipc_service_port_label {
40 	/* points to the Sandbox's message filtering data structure */
41 	struct ipc_conn_port_label *XNU_PTRAUTH_SIGNED_PTR_AUTH_NULL("ipc_service_port_label.ispl_sblabel") ispl_sblabel;
42 	mach_port_context_t     ispl_launchd_context;     /* context used to guard the port, specific to launchd */
43 	mach_port_name_t        ispl_launchd_name;        /* port name in launchd's ipc space */
44 	uint8_t                 ispl_throttled : 1;       /* service throttled by launchd */
45 	uint8_t                 __ispl_unused : 7;
46 #if CONFIG_SERVICE_PORT_INFO
47 	uint8_t                 ispl_domain;             /* launchd domain */
48 	char                   *ispl_service_name;       /* string name used to identify the service port */
49 #endif /* CONFIG_SERVICE_PORT_INFO */
50 };
51 
52 typedef struct ipc_service_port_label *ipc_service_port_label_t;
53 
54 /* Function declarations */
55 extern kern_return_t ipc_service_port_label_alloc(
56 	mach_service_port_info_t sp_info,
57 	ipc_object_label_t     *label);
58 
59 extern void ipc_connection_port_label_dealloc(
60 	ipc_object_label_t      label);
61 
62 extern void ipc_service_port_label_dealloc(
63 	ipc_object_label_t      label);
64 
65 extern kern_return_t ipc_service_port_derive_sblabel(
66 	mach_port_name_t        service_port_name,
67 	bool                    force,
68 	ipc_object_label_t     *label);
69 
70 extern void ipc_service_port_label_set_attr(
71 	ipc_service_port_label_t port_splabel,
72 	mach_port_name_t        name,
73 	mach_port_context_t     context);
74 
75 #if CONFIG_SERVICE_PORT_INFO
76 
77 extern void ipc_service_port_label_get_info(
78 	ipc_service_port_label_t port_splabel,
79 	mach_service_port_info_t info);
80 
81 #endif /* CONFIG_SERVICE_PORT_INFO */
82 #endif /* MACH_KERNEL_PRIVATE */
83 #endif /* _IPC_IPC_SERVICE_PORT_H_ */
84