bsd/kern/mach_loader.h

   1 /*
   2  * Copyright (c) 2000-2007 Apple 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  *      Copyright (C) 1992, NeXT, Inc.
  30  *
  31  *      File:   kern/mach_loader.h
  32  *
  33  *      Mach object file loader API.
  34  *
  35  * HISTORY
  36  *  24-Aug-92   Doug Mitchell at NeXT
  37  *      Created.
  38  */
  39
  40 #ifndef _BSD_KERN_MACH_LOADER_H_
  41 #define _BSD_KERN_MACH_LOADER_H_
  42
  43 #include <mach/mach_types.h>
  44 #include <mach-o/loader.h>
  45
  46 typedef int load_return_t;
  47
  48 /*
  49  * Structure describing the result from calling load_machfile(), if that
  50  * function returns LOAD_SUCCESS.
  51  */
  52 typedef struct _load_result {
  53         user_addr_t             mach_header;
  54         user_addr_t             entry_point;
  55         user_addr_t             user_stack;
  56         mach_vm_size_t          user_stack_size;
  57         mach_vm_address_t       all_image_info_addr;
  58         mach_vm_size_t          all_image_info_size;
  59         int                     thread_count;
  60         unsigned int
  61                 /* boolean_t */ unixproc        :1,
  62                                 needs_dynlinker : 1,
  63                                 dynlinker       :1,
  64                                 prog_allocated_stack    :1,
  65                                 prog_stack_size : 1,
  66                                 validentry      :1,
  67                                                 :0;
  68         unsigned int            csflags;
  69         unsigned char   uuid[16];
  70         mach_vm_address_t       min_vm_addr;
  71         mach_vm_address_t       max_vm_addr;
  72         unsigned int            platform_binary;
  73 } load_result_t;
  74
  75 struct image_params;
  76 load_return_t load_machfile(
  77         struct image_params     *imgp,
  78         struct mach_header      *header,
  79         thread_t                thread,
  80         vm_map_t                map,
  81         load_result_t           *result);
  82
  83 #define LOAD_SUCCESS            0
  84 #define LOAD_BADARCH            1       /* CPU type/subtype not found */
  85 #define LOAD_BADMACHO           2       /* malformed mach-o file */
  86 #define LOAD_SHLIB              3       /* shlib version mismatch */
  87 #define LOAD_FAILURE            4       /* Miscellaneous error */
  88 #define LOAD_NOSPACE            5       /* No VM available */
  89 #define LOAD_PROTECT            6       /* protection violation */
  90 #define LOAD_RESOURCE           7       /* resource allocation failure */
  91 #define LOAD_ENOENT             8       /* resource not found */
  92 #define LOAD_IOERROR            9       /* IO error */
  93 #define LOAD_DECRYPTFAIL        10      /* FP decrypt failure */
  94
  95 #endif  /* _BSD_KERN_MACH_LOADER_H_ */