libkern/kxld/kxld_seg.h

   1 /*
   2  * Copyright (c) 2008 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 #ifndef _KXLD_SEG_H_
  29 #define _KXLD_SEG_H_
  30
  31 #include <mach/vm_prot.h>
  32 #include <sys/types.h>
  33 #if KERNEL
  34     #include <libkern/kxld_types.h>
  35 #else
  36     #include "kxld_types.h"
  37 #endif
  38
  39 #include "kxld_array.h"
  40
  41 struct kxld_sect;
  42 struct kxld_symtab;
  43 struct segment_command;
  44 struct segment_command_64;
  45 typedef struct kxld_seg KXLDSeg;
  46
  47 struct kxld_seg {
  48     char segname[16];
  49     kxld_addr_t base_addr;
  50     kxld_addr_t link_addr;
  51     kxld_size_t vmsize;
  52     kxld_size_t fileoff;
  53     KXLDArray sects;
  54     u_int flags;
  55     vm_prot_t maxprot;
  56     vm_prot_t initprot;
  57 };
  58
  59 /*******************************************************************************
  60 * Constructors and Destructors
  61 *******************************************************************************/
  62
  63 #if KXLD_USER_OR_ILP32
  64 kern_return_t kxld_seg_init_from_macho_32(KXLDSeg *seg, struct segment_command *src)
  65     __attribute__((nonnull, visibility("hidden")));
  66 #endif /* KXLD_USER_OR_ILP32 */
  67
  68 #if KXLD_USER_OR_LP64
  69 kern_return_t kxld_seg_init_from_macho_64(KXLDSeg *seg, struct segment_command_64 *src)
  70     __attribute__((nonnull, visibility("hidden")));
  71 #endif /* KXLD_USER_OR_LP64 */
  72
  73 #if KXLD_USER_OR_OBJECT
  74 kern_return_t kxld_seg_create_seg_from_sections(KXLDArray *segarray,
  75     KXLDArray *sectarray)
  76     __attribute__((nonnull, visibility("hidden")));
  77
  78 kern_return_t kxld_seg_finalize_object_segment(KXLDArray *segarray,
  79     KXLDArray *section_order, u_long hdrsize)
  80     __attribute__((nonnull, visibility("hidden")));
  81
  82 kern_return_t kxld_seg_init_linkedit(KXLDArray *segs)
  83     __attribute__((nonnull, visibility("hidden")));
  84 #endif /* KXLD_USER_OR_OBJECT */
  85
  86 void kxld_seg_clear(KXLDSeg *seg)
  87     __attribute__((nonnull, visibility("hidden")));
  88
  89 void kxld_seg_deinit(KXLDSeg *seg)
  90     __attribute__((nonnull, visibility("hidden")));
  91
  92
  93 /*******************************************************************************
  94 * Accessors
  95 *******************************************************************************/
  96
  97 kxld_size_t kxld_seg_get_vmsize(const KXLDSeg *seg)
  98     __attribute__((pure, nonnull, visibility("hidden")));
  99
 100 u_long kxld_seg_get_macho_header_size(const KXLDSeg *seg, boolean_t is_32_bit)
 101     __attribute__((pure, nonnull, visibility("hidden")));
 102
 103 u_long kxld_seg_get_macho_data_size(const KXLDSeg *seg)
 104     __attribute__((pure, nonnull, visibility("hidden")));
 105
 106 kern_return_t
 107 kxld_seg_export_macho_to_file_buffer(const KXLDSeg *seg, u_char *buf,
 108     u_long *header_offset, u_long header_size,
 109     u_long *data_offset, u_long data_size,
 110     boolean_t is_32_bit)
 111     __attribute__((nonnull, visibility("hidden")));
 112
 113 kern_return_t
 114 kxld_seg_export_macho_to_vm(const KXLDSeg *seg, u_char *buf,
 115     u_long *header_offset, u_long header_size,
 116     u_long data_size, kxld_addr_t file_link_addr,
 117     boolean_t is_32_bit)
 118     __attribute__((nonnull, visibility("hidden")));
 119
 120 /*******************************************************************************
 121 * Modifiers
 122 *******************************************************************************/
 123
 124 kern_return_t kxld_seg_add_section(KXLDSeg *seg, struct kxld_sect *sect)
 125     __attribute__((nonnull, visibility("hidden")));
 126
 127 /* To be called after all sections are added */
 128 kern_return_t kxld_seg_finish_init(KXLDSeg *seg)
 129     __attribute__((nonnull, visibility("hidden")));
 130
 131 void kxld_seg_set_vm_protections(KXLDSeg *seg, boolean_t strict_protections)
 132     __attribute__((nonnull, visibility("hidden")));
 133
 134 void kxld_seg_relocate(KXLDSeg *seg, kxld_addr_t link_addr)
 135     __attribute__((nonnull, visibility("hidden")));
 136
 137 void kxld_seg_populate_linkedit(KXLDSeg *seg,
 138     const struct kxld_symtab *symtab, boolean_t is_32_bit)
 139     __attribute__((nonnull, visibility("hidden")));
 140
 141 #endif /* _KXLD_SEG_H_ */
 142