launchd-329.3.tar.gz

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

diff --git a/launchd/src/bootstrap.h b/launchd/src/bootstrap.h
index b76c52a745b04db172e7c6bca4e4d73c046a7512..15f32481310c9f392e86a799a087c0a435c0ed8a 100644 (file)
--- a/launchd/src/bootstrap.h
+++ b/launchd/src/bootstrap.h
@@ -96,18 +96,21 @@ typedef char cmd_t[BOOTSTRAP_MAX_CMD_LEN];
 typedef name_t *name_array_t;
 typedef int bootstrap_status_t;
 typedef bootstrap_status_t *bootstrap_status_array_t;
 typedef name_t *name_array_t;
 typedef int bootstrap_status_t;
 typedef bootstrap_status_t *bootstrap_status_array_t;

+typedef unsigned int bootstrap_property_t;
+typedef bootstrap_property_t * bootstrap_property_array_t;

 
 typedef boolean_t *bool_array_t;
 
 #define        BOOTSTRAP_MAX_LOOKUP_COUNT              20
 
 
 typedef boolean_t *bool_array_t;
 
 #define        BOOTSTRAP_MAX_LOOKUP_COUNT              20
 

-#define        BOOTSTRAP_SUCCESS                       0
+#define        BOOTSTRAP_SUCCESS                               0

 #define        BOOTSTRAP_NOT_PRIVILEGED                1100
 #define        BOOTSTRAP_NAME_IN_USE                   1101
 #define        BOOTSTRAP_UNKNOWN_SERVICE               1102
 #define        BOOTSTRAP_SERVICE_ACTIVE                1103
 #define        BOOTSTRAP_NOT_PRIVILEGED                1100
 #define        BOOTSTRAP_NAME_IN_USE                   1101
 #define        BOOTSTRAP_UNKNOWN_SERVICE               1102
 #define        BOOTSTRAP_SERVICE_ACTIVE                1103

-#define        BOOTSTRAP_BAD_COUNT                     1104
-#define        BOOTSTRAP_NO_MEMORY                     1105
+#define        BOOTSTRAP_BAD_COUNT                             1104
+#define        BOOTSTRAP_NO_MEMORY                             1105
+#define BOOTSTRAP_NO_CHILDREN                  1106

 
 #define BOOTSTRAP_STATUS_INACTIVE              0
 #define BOOTSTRAP_STATUS_ACTIVE                        1
 
 #define BOOTSTRAP_STATUS_INACTIVE              0
 #define BOOTSTRAP_STATUS_ACTIVE                        1


@@ -233,13 +236,16 @@ kern_return_t bootstrap_parent(
  *
  * This API is deprecated. Old scenarios and recommendations:
  *
  *
  * This API is deprecated. Old scenarios and recommendations:
  *

- * 1) If the code was registering a well known name, please switch to launchd.
+ * 1) Code that used to call bootstrap_check_in() and then bootstrap_register()
+ *    can now always call bootstrap_check_in().

  *
  *

- * 2) If the code was registering a dynamically generated string and passing
+ * 2) If the code was registering a well known name, please switch to launchd.
+ *
+ * 3) If the code was registering a dynamically generated string and passing

  *    the string to other applications, please rewrite the code to send a Mach
  *    send-right directly.
  *
  *    the string to other applications, please rewrite the code to send a Mach
  *    send-right directly.
  *

- * 3) If the launchd job maintained an optional Mach service, please reserve
+ * 4) If the launchd job maintained an optional Mach service, please reserve

  *    the name with launchd and control the presense of the service through
  *    ownership of the Mach receive right like so.
  *
  *    the name with launchd and control the presense of the service through
  *    ownership of the Mach receive right like so.
  *


@@ -261,26 +267,27 @@ kern_return_t bootstrap_parent(
  *             Returns BOOTSTRAP_NAME_IN_USE, if service has already been
  *                     register or checked-in.
  */
  *             Returns BOOTSTRAP_NAME_IN_USE, if service has already been
  *                     register or checked-in.
  */

-kern_return_t bootstrap_register(
-               mach_port_t bp,
-               name_t service_name,
-               mach_port_t sp)
-               AVAILABLE_MAC_OS_X_VERSION_10_0_AND_LATER_BUT_DEPRECATED_IN_MAC_OS_X_VERSION_10_5;
+AVAILABLE_MAC_OS_X_VERSION_10_0_AND_LATER_BUT_DEPRECATED_IN_MAC_OS_X_VERSION_10_5
+kern_return_t
+bootstrap_register(mach_port_t bp, name_t service_name, mach_port_t sp);

 
 /*
  * bootstrap_create_service()
  *
 
 /*
  * bootstrap_create_service()
  *

- * Creates a service named "service_name" and returns send rights to that
+ * Creates a service named "service_name" and returns a send right to that

  * port in "service_port."  The port may later be checked in as if this
  * port were configured in the bootstrap configuration file.
  *
  * port in "service_port."  The port may later be checked in as if this
  * port were configured in the bootstrap configuration file.
  *

+ * This API is deprecated. Please call bootstrap_check_in() instead.
+ *

  * Errors:     Returns appropriate kernel errors on rpc failure.
  *             Returns BOOTSTRAP_SERVICE_ACTIVE, if service already exists.
  */
  * Errors:     Returns appropriate kernel errors on rpc failure.
  *             Returns BOOTSTRAP_SERVICE_ACTIVE, if service already exists.
  */

-kern_return_t bootstrap_create_service(
-               mach_port_t bp,
-               name_t service_name,
-               mach_port_t *sp);
+#ifdef AVAILABLE_MAC_OS_X_VERSION_10_0_AND_LATER_BUT_DEPRECATED_IN_MAC_OS_X_VERSION_10_6
+AVAILABLE_MAC_OS_X_VERSION_10_0_AND_LATER_BUT_DEPRECATED_IN_MAC_OS_X_VERSION_10_6
+#endif
+kern_return_t
+bootstrap_create_service(mach_port_t bp, name_t service_name, mach_port_t *sp);

 
 /*
  * bootstrap_check_in()
 
 /*
  * bootstrap_check_in()


@@ -302,7 +309,7 @@ kern_return_t bootstrap_create_service(
  */
 kern_return_t bootstrap_check_in(
                mach_port_t bp,
  */
 kern_return_t bootstrap_check_in(
                mach_port_t bp,

-               name_t service_name,
+               const name_t service_name,

                mach_port_t *sp);
 
 /*
                mach_port_t *sp);
 
 /*


@@ -317,7 +324,7 @@ kern_return_t bootstrap_check_in(
  */
 kern_return_t bootstrap_look_up(
                mach_port_t bp,
  */
 kern_return_t bootstrap_look_up(
                mach_port_t bp,

-               name_t service_name,
+               const name_t service_name,

                mach_port_t *sp);
 
 /*
                mach_port_t *sp);
 
 /*