src/protocol_jobmgr.defs

   1 /*
   2  * Copyright (c) 1999-2004 Apple Computer, Inc. All rights reserved.
   3  *
   4  * @APPLE_APACHE_LICENSE_HEADER_START@
   5  *
   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
   9  *
  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
  16  * limitations under the License.
  17  *
  18  * @APPLE_APACHE_LICENSE_HEADER_END@
  19  */
  20 /*
  21  * bootstrap -- fundamental service initiator and port server
  22  * Mike DeMoney, NeXT, Inc.
  23  * Copyright, 1990.  All rights reserved.
  24  */
  25
  26 subsystem bootstrap 400;
  27
  28 #include <mach/std_types.defs>
  29 #include <mach/mach_types.defs>
  30 #include "launchd_mig_types.defs"
  31 import "bootstrap_public.h";
  32 import "bootstrap_private.h";
  33
  34 userprefix vproc_mig_;
  35 serverprefix job_mig_;
  36
  37 routine create_server(
  38                 __bs_port       : job_t;
  39                 __server_cmd    : cmd_t;
  40                 __server_uid    : natural_t;
  41                 __on_demand     : boolean_t;
  42         ServerAuditToken        __token : audit_token_t;
  43         out     __server_port   : mach_port_make_send_t);
  44
  45 skip; /* Last used in 10.4. Was bootstrap_unprivileged() */
  46
  47 routine check_in(
  48                         __bs_port       : job_t;
  49                         __service_name  : name_t;
  50         ServerAuditToken        __token : audit_token_t;
  51                 out     __service_port  : mach_port_move_receive_t);
  52
  53 routine register(
  54                 __bs_port       : job_t;
  55         ServerAuditToken        __token : audit_token_t;
  56                 __service_name  : name_t;
  57                 __service_port  : mach_port_t);
  58
  59 routine look_up(
  60                 __bs_port       : job_t;
  61         ServerAuditToken        __token : audit_token_t;
  62                 __service_name  : name_t;
  63         out     __service_port  : mach_port_send_t);
  64
  65 skip; /* last used in 10.4 */
  66
  67 routine parent(
  68                 __bs_port       : job_t;
  69         out     __parent_port   : mach_port_send_t);
  70
  71 skip; /* last used in 10.4 */
  72
  73 routine info(
  74                 __bs_port       : job_t;
  75         out     __service_names : name_array_t, dealloc;
  76         out __service_active    : bootstrap_status_array_t, dealloc);
  77
  78 routine subset(
  79                 __bs_port       : job_t;
  80                 __requestor_port: mach_port_t;
  81         out     __subset_port   : mach_port_make_send_t);
  82
  83 routine create_service(
  84                 __bs_port       : job_t;
  85                 __service_name  : name_t;
  86         out     __service_port  : mach_port_t);
  87
  88 routine transfer_subset(
  89                 __bs_port       : job_t;
  90         out     __bs_reqport    : mach_port_t;
  91         out     __bs_rcvright   : mach_port_move_receive_t;
  92         out     __service_names : name_array_t, dealloc;
  93         out     __service_pids  : pointer_t, dealloc;
  94         out     __service_ports : mach_port_array_t, dealloc);
  95
  96 routine getsocket(
  97                 __bs_port       : job_t;
  98         out     __sockpath      : name_t);
  99
 100 routine spawn(
 101                 __bs_port       : job_t;
 102         ServerAuditToken        __token : audit_token_t;
 103                 __chars         : _internal_string_t;
 104                 __argc          : uint32_t;
 105                 __envc          : uint32_t;
 106                 __flags         : uint64_t;
 107                 __umask         : uint16_t;
 108         out     __pid           : pid_t;
 109         out     __obsvr_port    : mach_port_make_send_t);
 110
 111 routine wait(
 112                 __bs_port       : job_t;
 113         sreplyport              __rport : mach_port_make_send_once_t;
 114         ServerAuditToken        __token : audit_token_t;
 115         out     __waitval       : integer_t);
 116
 117 routine uncork_fork(
 118                 __bs_port       : job_t;
 119         ServerAuditToken        __token : audit_token_t);
 120
 121 /* Essentially the inverse of bootstrap_unprivileged() */
 122 routine get_self(
 123                 __bs_port       : job_t;
 124         ServerAuditToken        __token : audit_token_t;
 125         out     __job_port      : mach_port_make_send_t);