[apple/launchd.git] / launchd / src / liblaunch_public.h

/*
 * Copyright (c) 2005 Apple Computer, Inc. All rights reserved.
 *
 * @APPLE_APACHE_LICENSE_HEADER_START@
 * 
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * 
 *     http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 * 
 * @APPLE_APACHE_LICENSE_HEADER_END@
 */
#ifndef _LAUNCH_H_
#define _LAUNCH_H_

#include <mach/mach.h>
#include <sys/cdefs.h>
#include <stddef.h>
#include <stdbool.h>

#pragma GCC visibility push(default)

__BEGIN_DECLS

#ifdef __GNUC__
#define __ld_normal __attribute__((__nothrow__))
#define __ld_setter __attribute__((__nothrow__, __nonnull__))
#define __ld_getter __attribute__((__nothrow__, __nonnull__, __pure__, __warn_unused_result__))
#define __ld_iterator(x, y) __attribute__((__nonnull__(x, y)))
#define __ld_allocator __attribute__((__nothrow__, __malloc__, __nonnull__, __warn_unused_result__))
#else
#define __ld_normal
#define __ld_setter
#define __ld_getter
#define __ld_iterator(x, y)
#define __ld_allocator
#endif


#define LAUNCH_KEY_SUBMITJOB			"SubmitJob"
#define LAUNCH_KEY_REMOVEJOB			"RemoveJob"
#define LAUNCH_KEY_STARTJOB			"StartJob"
#define LAUNCH_KEY_STOPJOB			"StopJob"
#define LAUNCH_KEY_GETJOB			"GetJob"
#define LAUNCH_KEY_GETJOBS			"GetJobs"
#define LAUNCH_KEY_CHECKIN			"CheckIn"

#define LAUNCH_JOBKEY_LABEL			"Label"
#define LAUNCH_JOBKEY_DISABLED			"Disabled"
#define LAUNCH_JOBKEY_USERNAME			"UserName"
#define LAUNCH_JOBKEY_GROUPNAME			"GroupName"
#define LAUNCH_JOBKEY_TIMEOUT			"TimeOut"
#define LAUNCH_JOBKEY_EXITTIMEOUT		"ExitTimeOut"
#define LAUNCH_JOBKEY_INITGROUPS		"InitGroups"
#define LAUNCH_JOBKEY_SOCKETS			"Sockets"
#define LAUNCH_JOBKEY_MACHSERVICES		"MachServices"
#define LAUNCH_JOBKEY_MACHSERVICELOOKUPPOLICIES	"MachServiceLookupPolicies"
#define LAUNCH_JOBKEY_INETDCOMPATIBILITY	"inetdCompatibility"
#define LAUNCH_JOBKEY_ENABLEGLOBBING		"EnableGlobbing"
#define LAUNCH_JOBKEY_PROGRAMARGUMENTS		"ProgramArguments"
#define LAUNCH_JOBKEY_PROGRAM			"Program"
#define LAUNCH_JOBKEY_ONDEMAND			"OnDemand"
#define LAUNCH_JOBKEY_KEEPALIVE			"KeepAlive"
#define LAUNCH_JOBKEY_LIMITLOADTOHOSTS		"LimitLoadToHosts"
#define LAUNCH_JOBKEY_LIMITLOADFROMHOSTS	"LimitLoadFromHosts"
#define LAUNCH_JOBKEY_LIMITLOADTOSESSIONTYPE	"LimitLoadToSessionType"
#define LAUNCH_JOBKEY_RUNATLOAD			"RunAtLoad"
#define LAUNCH_JOBKEY_ROOTDIRECTORY		"RootDirectory"
#define LAUNCH_JOBKEY_WORKINGDIRECTORY		"WorkingDirectory"
#define LAUNCH_JOBKEY_ENVIRONMENTVARIABLES	"EnvironmentVariables"
#define LAUNCH_JOBKEY_USERENVIRONMENTVARIABLES	"UserEnvironmentVariables"
#define LAUNCH_JOBKEY_UMASK			"Umask"
#define LAUNCH_JOBKEY_NICE			"Nice"
#define LAUNCH_JOBKEY_HOPEFULLYEXITSFIRST	"HopefullyExitsFirst"
#define LAUNCH_JOBKEY_HOPEFULLYEXITSLAST	"HopefullyExitsLast"
#define LAUNCH_JOBKEY_LOWPRIORITYIO		"LowPriorityIO"
#define LAUNCH_JOBKEY_SESSIONCREATE		"SessionCreate"
#define LAUNCH_JOBKEY_STARTONMOUNT		"StartOnMount"
#define LAUNCH_JOBKEY_SOFTRESOURCELIMITS	"SoftResourceLimits"
#define LAUNCH_JOBKEY_HARDRESOURCELIMITS	"HardResourceLimits"
#define LAUNCH_JOBKEY_STANDARDOUTPATH		"StandardOutPath"
#define LAUNCH_JOBKEY_STANDARDERRORPATH		"StandardErrorPath"
#define LAUNCH_JOBKEY_DEBUG			"Debug"
#define LAUNCH_JOBKEY_WAITFORDEBUGGER		"WaitForDebugger"
#define LAUNCH_JOBKEY_QUEUEDIRECTORIES		"QueueDirectories"
#define LAUNCH_JOBKEY_WATCHPATHS		"WatchPaths"
#define LAUNCH_JOBKEY_STARTINTERVAL		"StartInterval"
#define LAUNCH_JOBKEY_STARTCALENDARINTERVAL	"StartCalendarInterval"
#define LAUNCH_JOBKEY_BONJOURFDS		"BonjourFDs"
#define LAUNCH_JOBKEY_LASTEXITSTATUS		"LastExitStatus"
#define LAUNCH_JOBKEY_PID			"PID"
#define LAUNCH_JOBKEY_THROTTLEINTERVAL		"ThrottleInterval"
#define LAUNCH_JOBKEY_LAUNCHONLYONCE		"LaunchOnlyOnce"
#define LAUNCH_JOBKEY_ABANDONPROCESSGROUP	"AbandonProcessGroup"
#define LAUNCH_JOBKEY_POLICIES			"Policies"

#define LAUNCH_JOBPOLICY_DENYCREATINGOTHERJOBS	"DenyCreatingOtherJobs"

#define LAUNCH_JOBINETDCOMPATIBILITY_WAIT	"Wait"

#define LAUNCH_JOBKEY_MACH_RESETATCLOSE		"ResetAtClose"
#define LAUNCH_JOBKEY_MACH_HIDEUNTILCHECKIN	"HideUntilCheckIn"

#define LAUNCH_JOBKEY_KEEPALIVE_SUCCESSFULEXIT	"SuccessfulExit"
#define LAUNCH_JOBKEY_KEEPALIVE_NETWORKSTATE	"NetworkState"
#define LAUNCH_JOBKEY_KEEPALIVE_PATHSTATE	"PathState"
#define LAUNCH_JOBKEY_KEEPALIVE_OTHERJOBACTIVE	"OtherJobActive"
#define LAUNCH_JOBKEY_KEEPALIVE_OTHERJOBENABLED	"OtherJobEnabled"

#define LAUNCH_JOBKEY_CAL_MINUTE		"Minute"
#define LAUNCH_JOBKEY_CAL_HOUR			"Hour"
#define LAUNCH_JOBKEY_CAL_DAY			"Day"
#define LAUNCH_JOBKEY_CAL_WEEKDAY		"Weekday"
#define LAUNCH_JOBKEY_CAL_MONTH			"Month"

#define LAUNCH_JOBKEY_RESOURCELIMIT_CORE	"Core"
#define LAUNCH_JOBKEY_RESOURCELIMIT_CPU		"CPU"
#define LAUNCH_JOBKEY_RESOURCELIMIT_DATA	"Data"
#define LAUNCH_JOBKEY_RESOURCELIMIT_FSIZE	"FileSize"
#define LAUNCH_JOBKEY_RESOURCELIMIT_MEMLOCK	"MemoryLock"
#define LAUNCH_JOBKEY_RESOURCELIMIT_NOFILE	"NumberOfFiles"
#define LAUNCH_JOBKEY_RESOURCELIMIT_NPROC	"NumberOfProcesses"
#define LAUNCH_JOBKEY_RESOURCELIMIT_RSS		"ResidentSetSize"
#define LAUNCH_JOBKEY_RESOURCELIMIT_STACK	"Stack"

#define LAUNCH_JOBKEY_DISABLED_MACHINETYPE	"MachineType"
#define LAUNCH_JOBKEY_DISABLED_MODELNAME	"ModelName"

#define LAUNCH_JOBSOCKETKEY_TYPE		"SockType"
#define LAUNCH_JOBSOCKETKEY_PASSIVE		"SockPassive"
#define LAUNCH_JOBSOCKETKEY_BONJOUR		"Bonjour"
#define LAUNCH_JOBSOCKETKEY_SECUREWITHKEY	"SecureSocketWithKey"
#define LAUNCH_JOBSOCKETKEY_PATHNAME		"SockPathName"
#define LAUNCH_JOBSOCKETKEY_PATHMODE		"SockPathMode"
#define LAUNCH_JOBSOCKETKEY_NODENAME		"SockNodeName"
#define LAUNCH_JOBSOCKETKEY_SERVICENAME		"SockServiceName"
#define LAUNCH_JOBSOCKETKEY_FAMILY		"SockFamily"
#define LAUNCH_JOBSOCKETKEY_PROTOCOL		"SockProtocol"
#define LAUNCH_JOBSOCKETKEY_MULTICASTGROUP	"MulticastGroup"

typedef struct _launch_data *launch_data_t;

typedef enum {
	LAUNCH_DATA_DICTIONARY = 1,
	LAUNCH_DATA_ARRAY,
	LAUNCH_DATA_FD,
	LAUNCH_DATA_INTEGER,
	LAUNCH_DATA_REAL,
	LAUNCH_DATA_BOOL,
	LAUNCH_DATA_STRING,
	LAUNCH_DATA_OPAQUE,
	LAUNCH_DATA_ERRNO,
	LAUNCH_DATA_MACHPORT,
} launch_data_type_t;

launch_data_t		launch_data_alloc(launch_data_type_t) __ld_allocator;
launch_data_t		launch_data_copy(launch_data_t) __ld_allocator;
launch_data_type_t	launch_data_get_type(const launch_data_t) __ld_getter;
void			launch_data_free(launch_data_t) __ld_setter;

/* Generic Dictionaries */
/* the value should not be changed while iterating */
bool		launch_data_dict_insert(launch_data_t, const launch_data_t, const char *) __ld_setter;
launch_data_t	launch_data_dict_lookup(const launch_data_t, const char *) __ld_getter;
bool		launch_data_dict_remove(launch_data_t, const char *) __ld_setter;
void		launch_data_dict_iterate(const launch_data_t, void (*)(const launch_data_t, const char *, void *), void *) __ld_iterator(1, 2);
size_t		launch_data_dict_get_count(const launch_data_t) __ld_getter;

/* Generic Arrays */
bool		launch_data_array_set_index(launch_data_t, const launch_data_t, size_t) __ld_setter;
launch_data_t	launch_data_array_get_index(const launch_data_t, size_t) __ld_getter;
size_t		launch_data_array_get_count(const launch_data_t) __ld_getter;

launch_data_t	launch_data_new_fd(int) __ld_allocator;
launch_data_t	launch_data_new_machport(mach_port_t) __ld_allocator;
launch_data_t	launch_data_new_integer(long long) __ld_allocator;
launch_data_t	launch_data_new_bool(bool) __ld_allocator;
launch_data_t	launch_data_new_real(double) __ld_allocator;
launch_data_t	launch_data_new_string(const char *) __ld_allocator;
launch_data_t	launch_data_new_opaque(const void *, size_t) __ld_allocator;

bool		launch_data_set_fd(launch_data_t, int) __ld_setter;
bool		launch_data_set_machport(launch_data_t, mach_port_t) __ld_setter;
bool		launch_data_set_integer(launch_data_t, long long) __ld_setter;
bool		launch_data_set_bool(launch_data_t, bool) __ld_setter;
bool		launch_data_set_real(launch_data_t, double) __ld_setter;
bool		launch_data_set_string(launch_data_t, const char *) __ld_setter;
bool		launch_data_set_opaque(launch_data_t, const void *, size_t) __ld_setter;

int		launch_data_get_fd(const launch_data_t) __ld_getter;
mach_port_t	launch_data_get_machport(const launch_data_t) __ld_getter;
long long	launch_data_get_integer(const launch_data_t) __ld_getter;
bool		launch_data_get_bool(const launch_data_t) __ld_getter;
double		launch_data_get_real(const launch_data_t) __ld_getter;
const char *	launch_data_get_string(const launch_data_t) __ld_getter;
void *		launch_data_get_opaque(const launch_data_t) __ld_getter;
size_t		launch_data_get_opaque_size(const launch_data_t) __ld_getter;
int		launch_data_get_errno(const launch_data_t) __ld_getter;


/* launch_get_fd()
 *
 * Use this to get the FD if you're doing asynchronous I/O with select(),
 * poll() or kevent().
 */
int launch_get_fd(void) __ld_normal;

/* launch_msg()
 *
 * Use this API to send and receive messages.
 * Calling launch_msg() with no message to send is a valid way to get
 * asynchronously received messages.
 *
 * If a message was to be sent, it returns NULL and errno on failure.
 *
 * If no messages were to be sent, it returns NULL and errno is set to zero if
 * no more asynchronous messages are available.
 */
launch_data_t launch_msg(const launch_data_t) __ld_normal;

__END_DECLS

#pragma GCC visibility pop

#endif
Commit	Line	Data
e91b9f68 A	1	/*
	2	* Copyright (c) 2005 Apple Computer, Inc. All rights reserved.
	3	*
ed34e3c3	4	* @APPLE_APACHE_LICENSE_HEADER_START@
e91b9f68	5	*
ed34e3c3 A	6	* Licensed under the Apache License, Version 2.0 (the "License");
	7	* you may not use this file except in compliance with the License.
	8	* You may obtain a copy of the License at
e91b9f68	9	*
ed34e3c3 A	10	* http://www.apache.org/licenses/LICENSE-2.0
	11	*
	12	* Unless required by applicable law or agreed to in writing, software
	13	* distributed under the License is distributed on an "AS IS" BASIS,
	14	* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	15	* See the License for the specific language governing permissions and
e91b9f68 A	16	* limitations under the License.
e91b9f68 A	17	*
ed34e3c3	18	* @APPLE_APACHE_LICENSE_HEADER_END@
e91b9f68 A	19	*/
	20	#ifndef _LAUNCH_H_
	21	#define _LAUNCH_H_
	22
ed34e3c3 A	23	#include <mach/mach.h>
ed34e3c3 A	24	#include <sys/cdefs.h>
e91b9f68 A	25	#include <stddef.h>
	26	#include <stdbool.h>
	27
5b0a4722 A	28	#pragma GCC visibility push(default)
5b0a4722 A	29
ed34e3c3 A	30	__BEGIN_DECLS
	31
	32	#ifdef __GNUC__
	33	#define __ld_normal __attribute__((__nothrow__))
	34	#define __ld_setter __attribute__((__nothrow__, __nonnull__))
	35	#define __ld_getter __attribute__((__nothrow__, __nonnull__, __pure__, __warn_unused_result__))
	36	#define __ld_iterator(x, y) __attribute__((__nonnull__(x, y)))
	37	#define __ld_allocator __attribute__((__nothrow__, __malloc__, __nonnull__, __warn_unused_result__))
	38	#else
	39	#define __ld_normal
	40	#define __ld_setter
	41	#define __ld_getter
	42	#define __ld_iterator(x, y)
	43	#define __ld_allocator
	44	#endif
	45
e91b9f68 A	46
	47	#define LAUNCH_KEY_SUBMITJOB "SubmitJob"
	48	#define LAUNCH_KEY_REMOVEJOB "RemoveJob"
	49	#define LAUNCH_KEY_STARTJOB "StartJob"
	50	#define LAUNCH_KEY_STOPJOB "StopJob"
	51	#define LAUNCH_KEY_GETJOB "GetJob"
e91b9f68 A	52	#define LAUNCH_KEY_GETJOBS "GetJobs"
	53	#define LAUNCH_KEY_CHECKIN "CheckIn"
	54
	55	#define LAUNCH_JOBKEY_LABEL "Label"
	56	#define LAUNCH_JOBKEY_DISABLED "Disabled"
	57	#define LAUNCH_JOBKEY_USERNAME "UserName"
	58	#define LAUNCH_JOBKEY_GROUPNAME "GroupName"
	59	#define LAUNCH_JOBKEY_TIMEOUT "TimeOut"
5b0a4722	60	#define LAUNCH_JOBKEY_EXITTIMEOUT "ExitTimeOut"
e91b9f68 A	61	#define LAUNCH_JOBKEY_INITGROUPS "InitGroups"
e91b9f68 A	62	#define LAUNCH_JOBKEY_SOCKETS "Sockets"
ed34e3c3	63	#define LAUNCH_JOBKEY_MACHSERVICES "MachServices"
5b0a4722	64	#define LAUNCH_JOBKEY_MACHSERVICELOOKUPPOLICIES "MachServiceLookupPolicies"
e91b9f68	65	#define LAUNCH_JOBKEY_INETDCOMPATIBILITY "inetdCompatibility"
ed34e3c3	66	#define LAUNCH_JOBKEY_ENABLEGLOBBING "EnableGlobbing"
e91b9f68 A	67	#define LAUNCH_JOBKEY_PROGRAMARGUMENTS "ProgramArguments"
	68	#define LAUNCH_JOBKEY_PROGRAM "Program"
	69	#define LAUNCH_JOBKEY_ONDEMAND "OnDemand"
ed34e3c3 A	70	#define LAUNCH_JOBKEY_KEEPALIVE "KeepAlive"
	71	#define LAUNCH_JOBKEY_LIMITLOADTOHOSTS "LimitLoadToHosts"
	72	#define LAUNCH_JOBKEY_LIMITLOADFROMHOSTS "LimitLoadFromHosts"
	73	#define LAUNCH_JOBKEY_LIMITLOADTOSESSIONTYPE "LimitLoadToSessionType"
e91b9f68 A	74	#define LAUNCH_JOBKEY_RUNATLOAD "RunAtLoad"
	75	#define LAUNCH_JOBKEY_ROOTDIRECTORY "RootDirectory"
	76	#define LAUNCH_JOBKEY_WORKINGDIRECTORY "WorkingDirectory"
e91b9f68 A	77	#define LAUNCH_JOBKEY_ENVIRONMENTVARIABLES "EnvironmentVariables"
e91b9f68 A	78	#define LAUNCH_JOBKEY_USERENVIRONMENTVARIABLES "UserEnvironmentVariables"
e91b9f68 A	79	#define LAUNCH_JOBKEY_UMASK "Umask"
e91b9f68 A	80	#define LAUNCH_JOBKEY_NICE "Nice"
5b0a4722 A	81	#define LAUNCH_JOBKEY_HOPEFULLYEXITSFIRST "HopefullyExitsFirst"
5b0a4722 A	82	#define LAUNCH_JOBKEY_HOPEFULLYEXITSLAST "HopefullyExitsLast"
e91b9f68 A	83	#define LAUNCH_JOBKEY_LOWPRIORITYIO "LowPriorityIO"
e91b9f68 A	84	#define LAUNCH_JOBKEY_SESSIONCREATE "SessionCreate"
5b0a4722	85	#define LAUNCH_JOBKEY_STARTONMOUNT "StartOnMount"
e91b9f68 A	86	#define LAUNCH_JOBKEY_SOFTRESOURCELIMITS "SoftResourceLimits"
e91b9f68 A	87	#define LAUNCH_JOBKEY_HARDRESOURCELIMITS "HardResourceLimits"
e91b9f68 A	88	#define LAUNCH_JOBKEY_STANDARDOUTPATH "StandardOutPath"
	89	#define LAUNCH_JOBKEY_STANDARDERRORPATH "StandardErrorPath"
	90	#define LAUNCH_JOBKEY_DEBUG "Debug"
ed34e3c3	91	#define LAUNCH_JOBKEY_WAITFORDEBUGGER "WaitForDebugger"
e91b9f68 A	92	#define LAUNCH_JOBKEY_QUEUEDIRECTORIES "QueueDirectories"
	93	#define LAUNCH_JOBKEY_WATCHPATHS "WatchPaths"
	94	#define LAUNCH_JOBKEY_STARTINTERVAL "StartInterval"
	95	#define LAUNCH_JOBKEY_STARTCALENDARINTERVAL "StartCalendarInterval"
	96	#define LAUNCH_JOBKEY_BONJOURFDS "BonjourFDs"
ed34e3c3 A	97	#define LAUNCH_JOBKEY_LASTEXITSTATUS "LastExitStatus"
ed34e3c3 A	98	#define LAUNCH_JOBKEY_PID "PID"
5b0a4722 A	99	#define LAUNCH_JOBKEY_THROTTLEINTERVAL "ThrottleInterval"
	100	#define LAUNCH_JOBKEY_LAUNCHONLYONCE "LaunchOnlyOnce"
	101	#define LAUNCH_JOBKEY_ABANDONPROCESSGROUP "AbandonProcessGroup"
f36da725 A	102	#define LAUNCH_JOBKEY_POLICIES "Policies"
	103
	104	#define LAUNCH_JOBPOLICY_DENYCREATINGOTHERJOBS "DenyCreatingOtherJobs"
e91b9f68 A	105
	106	#define LAUNCH_JOBINETDCOMPATIBILITY_WAIT "Wait"
	107
ed34e3c3 A	108	#define LAUNCH_JOBKEY_MACH_RESETATCLOSE "ResetAtClose"
	109	#define LAUNCH_JOBKEY_MACH_HIDEUNTILCHECKIN "HideUntilCheckIn"
	110
	111	#define LAUNCH_JOBKEY_KEEPALIVE_SUCCESSFULEXIT "SuccessfulExit"
	112	#define LAUNCH_JOBKEY_KEEPALIVE_NETWORKSTATE "NetworkState"
	113	#define LAUNCH_JOBKEY_KEEPALIVE_PATHSTATE "PathState"
5b0a4722 A	114	#define LAUNCH_JOBKEY_KEEPALIVE_OTHERJOBACTIVE "OtherJobActive"
5b0a4722 A	115	#define LAUNCH_JOBKEY_KEEPALIVE_OTHERJOBENABLED "OtherJobEnabled"
ed34e3c3	116
e91b9f68 A	117	#define LAUNCH_JOBKEY_CAL_MINUTE "Minute"
	118	#define LAUNCH_JOBKEY_CAL_HOUR "Hour"
	119	#define LAUNCH_JOBKEY_CAL_DAY "Day"
	120	#define LAUNCH_JOBKEY_CAL_WEEKDAY "Weekday"
	121	#define LAUNCH_JOBKEY_CAL_MONTH "Month"
	122
	123	#define LAUNCH_JOBKEY_RESOURCELIMIT_CORE "Core"
	124	#define LAUNCH_JOBKEY_RESOURCELIMIT_CPU "CPU"
	125	#define LAUNCH_JOBKEY_RESOURCELIMIT_DATA "Data"
	126	#define LAUNCH_JOBKEY_RESOURCELIMIT_FSIZE "FileSize"
	127	#define LAUNCH_JOBKEY_RESOURCELIMIT_MEMLOCK "MemoryLock"
	128	#define LAUNCH_JOBKEY_RESOURCELIMIT_NOFILE "NumberOfFiles"
	129	#define LAUNCH_JOBKEY_RESOURCELIMIT_NPROC "NumberOfProcesses"
	130	#define LAUNCH_JOBKEY_RESOURCELIMIT_RSS "ResidentSetSize"
	131	#define LAUNCH_JOBKEY_RESOURCELIMIT_STACK "Stack"
	132
5b0a4722 A	133	#define LAUNCH_JOBKEY_DISABLED_MACHINETYPE "MachineType"
	134	#define LAUNCH_JOBKEY_DISABLED_MODELNAME "ModelName"
	135
e91b9f68 A	136	#define LAUNCH_JOBSOCKETKEY_TYPE "SockType"
	137	#define LAUNCH_JOBSOCKETKEY_PASSIVE "SockPassive"
	138	#define LAUNCH_JOBSOCKETKEY_BONJOUR "Bonjour"
	139	#define LAUNCH_JOBSOCKETKEY_SECUREWITHKEY "SecureSocketWithKey"
	140	#define LAUNCH_JOBSOCKETKEY_PATHNAME "SockPathName"
aa59983a	141	#define LAUNCH_JOBSOCKETKEY_PATHMODE "SockPathMode"
e91b9f68 A	142	#define LAUNCH_JOBSOCKETKEY_NODENAME "SockNodeName"
	143	#define LAUNCH_JOBSOCKETKEY_SERVICENAME "SockServiceName"
	144	#define LAUNCH_JOBSOCKETKEY_FAMILY "SockFamily"
	145	#define LAUNCH_JOBSOCKETKEY_PROTOCOL "SockProtocol"
ab36757d	146	#define LAUNCH_JOBSOCKETKEY_MULTICASTGROUP "MulticastGroup"
e91b9f68 A	147
	148	typedef struct _launch_data *launch_data_t;
	149
	150	typedef enum {
	151	LAUNCH_DATA_DICTIONARY = 1,
	152	LAUNCH_DATA_ARRAY,
	153	LAUNCH_DATA_FD,
	154	LAUNCH_DATA_INTEGER,
	155	LAUNCH_DATA_REAL,
	156	LAUNCH_DATA_BOOL,
	157	LAUNCH_DATA_STRING,
	158	LAUNCH_DATA_OPAQUE,
	159	LAUNCH_DATA_ERRNO,
ed34e3c3	160	LAUNCH_DATA_MACHPORT,
e91b9f68 A	161	} launch_data_type_t;
e91b9f68 A	162
ed34e3c3 A	163	launch_data_t launch_data_alloc(launch_data_type_t) __ld_allocator;
	164	launch_data_t launch_data_copy(launch_data_t) __ld_allocator;
	165	launch_data_type_t launch_data_get_type(const launch_data_t) __ld_getter;
	166	void launch_data_free(launch_data_t) __ld_setter;
e91b9f68 A	167
	168	/* Generic Dictionaries */
	169	/* the value should not be changed while iterating */
ed34e3c3 A	170	bool launch_data_dict_insert(launch_data_t, const launch_data_t, const char *) __ld_setter;
	171	launch_data_t launch_data_dict_lookup(const launch_data_t, const char *) __ld_getter;
	172	bool launch_data_dict_remove(launch_data_t, const char *) __ld_setter;
	173	void launch_data_dict_iterate(const launch_data_t, void ()(const launch_data_t, const char , void ), void ) __ld_iterator(1, 2);
	174	size_t launch_data_dict_get_count(const launch_data_t) __ld_getter;
e91b9f68 A	175
e91b9f68 A	176	/* Generic Arrays */
ed34e3c3 A	177	bool launch_data_array_set_index(launch_data_t, const launch_data_t, size_t) __ld_setter;
	178	launch_data_t launch_data_array_get_index(const launch_data_t, size_t) __ld_getter;
	179	size_t launch_data_array_get_count(const launch_data_t) __ld_getter;
	180
	181	launch_data_t launch_data_new_fd(int) __ld_allocator;
	182	launch_data_t launch_data_new_machport(mach_port_t) __ld_allocator;
	183	launch_data_t launch_data_new_integer(long long) __ld_allocator;
	184	launch_data_t launch_data_new_bool(bool) __ld_allocator;
	185	launch_data_t launch_data_new_real(double) __ld_allocator;
	186	launch_data_t launch_data_new_string(const char *) __ld_allocator;
	187	launch_data_t launch_data_new_opaque(const void *, size_t) __ld_allocator;
	188
	189	bool launch_data_set_fd(launch_data_t, int) __ld_setter;
	190	bool launch_data_set_machport(launch_data_t, mach_port_t) __ld_setter;
	191	bool launch_data_set_integer(launch_data_t, long long) __ld_setter;
	192	bool launch_data_set_bool(launch_data_t, bool) __ld_setter;
	193	bool launch_data_set_real(launch_data_t, double) __ld_setter;
	194	bool launch_data_set_string(launch_data_t, const char *) __ld_setter;
	195	bool launch_data_set_opaque(launch_data_t, const void *, size_t) __ld_setter;
	196
	197	int launch_data_get_fd(const launch_data_t) __ld_getter;
	198	mach_port_t launch_data_get_machport(const launch_data_t) __ld_getter;
	199	long long launch_data_get_integer(const launch_data_t) __ld_getter;
	200	bool launch_data_get_bool(const launch_data_t) __ld_getter;
	201	double launch_data_get_real(const launch_data_t) __ld_getter;
	202	const char * launch_data_get_string(const launch_data_t) __ld_getter;
	203	void * launch_data_get_opaque(const launch_data_t) __ld_getter;
	204	size_t launch_data_get_opaque_size(const launch_data_t) __ld_getter;
	205	int launch_data_get_errno(const launch_data_t) __ld_getter;
e91b9f68 A	206
	207
	208	/* launch_get_fd()
	209	*
	210	* Use this to get the FD if you're doing asynchronous I/O with select(),
	211	* poll() or kevent().
	212	*/
ed34e3c3	213	int launch_get_fd(void) __ld_normal;
e91b9f68 A	214
	215	/* launch_msg()
	216	*
	217	* Use this API to send and receive messages.
	218	* Calling launch_msg() with no message to send is a valid way to get
	219	* asynchronously received messages.
	220	*
	221	* If a message was to be sent, it returns NULL and errno on failure.
	222	*
	223	* If no messages were to be sent, it returns NULL and errno is set to zero if
	224	* no more asynchronous messages are available.
	225	*/
ed34e3c3 A	226	launch_data_t launch_msg(const launch_data_t) __ld_normal;
	227
	228	__END_DECLS
e91b9f68	229
5b0a4722 A	230	#pragma GCC visibility pop
5b0a4722 A	231
e91b9f68	232	#endif