mach_init.tproj/lists.h

   1 /*
   2  * Copyright (c) 1999-2002 Apple Computer, Inc. All rights reserved.
   3  *
   4  * @APPLE_LICENSE_HEADER_START@
   5  *
   6  * "Portions Copyright (c) 1999 Apple Computer, Inc.  All Rights
   7  * Reserved.  This file contains Original Code and/or Modifications of
   8  * Original Code as defined in and that are subject to the Apple Public
   9  * Source License Version 1.0 (the 'License').  You may not use this file
  10  * except in compliance with the License.  Please obtain a copy of the
  11  * License at http://www.apple.com/publicsource and read it before using
  12  * this file.
  13  *
  14  * The Original Code and all software distributed under the License are
  15  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  16  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  17  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  18  * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT.  Please see the
  19  * License for the specific language governing rights and limitations
  20  * under the License."
  21  *
  22  * @APPLE_LICENSE_HEADER_END@
  23  */
  24 /*
  25  * bootstrap -- fundamental service initiator and port server
  26  * Mike DeMoney, NeXT, Inc.
  27  * Copyright, 1990.  All rights reserved.
  28  *
  29  * lists.h -- interface to list routines
  30  */
  31
  32 #import <sys/types.h>
  33 #import <mach/mach.h>
  34 #import <mach/boolean.h>
  35 #import <servers/bootstrap_defs.h>
  36
  37 #ifndef NULL
  38 #define NULL    ((void *)0)
  39 #endif NULL
  40
  41 typedef struct bootstrap bootstrap_info_t;
  42 typedef struct service service_t;
  43 typedef struct server server_t;
  44
  45 /* Bootstrap info */
  46 struct bootstrap {
  47         bootstrap_info_t                *next;          /* list of all bootstraps */
  48         bootstrap_info_t                *prev;
  49         bootstrap_info_t                *parent;
  50         bootstrap_info_t                *deactivate;    /* list being deactivated */
  51         mach_port_name_t                bootstrap_port;
  52         mach_port_name_t                requestor_port;
  53         unsigned int                    ref_count;
  54 };
  55
  56 /* Service types */
  57 typedef enum {
  58         DECLARED,       /* Declared in config file */
  59         REGISTERED,     /* Registered dynamically */
  60         SELF            /* Name bound bootstrap service itself */
  61 } servicetype_t;
  62
  63 struct service {
  64         service_t       *next;          /* list of all services */
  65         service_t       *prev;
  66         name_t          name;           /* service name */
  67         mach_port_name_t        port;           /* service port,
  68                                            may have all rights if inactive */
  69         bootstrap_info_t        *bootstrap;     /* bootstrap port(s) used at this
  70                                          * level. */
  71         boolean_t       isActive;       /* server is running */
  72         servicetype_t   servicetype;    /* Declared, Registered, or Machport */
  73         server_t        *server;        /* server, declared services only */
  74 };
  75
  76 /* Server types */
  77 typedef enum {
  78         SERVER,         /* Launchable server */
  79         RESTARTABLE,    /* Restartable server */
  80         DEMAND,         /* Restartable server - on demand */
  81         MACHINIT,       /* mach_init doesn't get launched. */
  82 } servertype_t;
  83
  84 #define NULL_SERVER     NULL
  85 #define ACTIVE          TRUE
  86
  87 struct server {
  88         server_t        *next;          /* list of all servers */
  89         server_t        *prev;
  90         servertype_t    servertype;
  91         cmd_t           cmd;            /* server command to exec */
  92         int                     uid;            /* uid to exec server with */
  93         mach_port_t     port;           /* server's priv bootstrap port */
  94         mach_port_t     task_port;      /* server's task port */
  95         pid_t           pid;            /* server's pid */
  96         int             activity;               /* count of checkins/registers this instance */
  97         int             active_services;/* count of active services */
  98         bootstrap_info_t *bootstrap; /* bootstrap context */
  99 };
 100
 101 #define NO_PID  (-1)
 102
 103 extern void init_lists(void);
 104
 105 extern server_t *new_server(
 106         bootstrap_info_t        *bootstrap,
 107         const char                      *cmd,
 108         int                                     uid,
 109         servertype_t            servertype);
 110
 111 extern service_t                *new_service(
 112         bootstrap_info_t        *bootstrap,
 113         const char                      *name,
 114         mach_port_t                     service_port,
 115         boolean_t                       isActive,
 116         servicetype_t           servicetype,
 117         server_t                        *serverp);
 118
 119 extern bootstrap_info_t *new_bootstrap(
 120         bootstrap_info_t        *parent,
 121         mach_port_name_t        bootstrap_port,
 122         mach_port_name_t        requestor_port);
 123
 124 extern server_t *lookup_server_by_port(mach_port_t port);
 125 extern server_t *lookup_server_by_task_port(mach_port_t port);
 126 extern void setup_server(server_t *serverp);
 127 extern void delete_server(server_t *serverp);
 128 extern boolean_t active_server(server_t *serverp);
 129 extern boolean_t useless_server(server_t *serverp);
 130
 131 extern void delete_service(service_t *servicep);
 132 extern service_t *lookup_service_by_name(bootstrap_info_t *bootstrap, name_t name);
 133 extern service_t *lookup_service_by_port(mach_port_t port);
 134 extern service_t *lookup_service_by_server(server_t *serverp);
 135
 136 extern bootstrap_info_t *lookup_bootstrap_by_port(mach_port_t port);
 137 extern bootstrap_info_t *lookup_bootstrap_by_req_port(mach_port_t port);
 138 extern void deactivate_bootstrap(bootstrap_info_t *bootstrap);
 139 extern void deallocate_bootstrap(bootstrap_info_t *bootstrap);
 140 extern boolean_t active_bootstrap(bootstrap_info_t *bootstrap);
 141
 142 extern void *ckmalloc(unsigned nbytes);
 143
 144 extern bootstrap_info_t bootstraps;             /* head of list of bootstrap ports */
 145 extern server_t servers;                /* head of list of all servers */
 146 extern service_t services;              /* head of list of all services */
 147 extern unsigned nservices;              /* number of services in list */
 148
 149 #define FIRST(q)                ((q).next)
 150 #define NEXT(qe)                ((qe)->next)
 151 #define PREV(qe)                ((qe)->prev)
 152 #define IS_END(qe, q)           ((qe) == &(q))