usr/src/boot/sys/boot/i386/libi386/libi386.h

   1 /*-
   2  * Copyright (c) 1998 Michael Smith <msmith@freebsd.org>
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright
  11  *    notice, this list of conditions and the following disclaimer in the
  12  *    documentation and/or other materials provided with the distribution.
  13  *
  14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  17  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  18  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  24  * SUCH DAMAGE.
  25  *
  26  */
  27
  28 #ifndef _LIBI386_H
  29 #define _LIBI386_H
  30
  31 /*
  32  * i386 fully-qualified device descriptor.
  33  * Note, this must match struct zfs_devdesc for zfs support.
  34  */
  35 /* Note: Must match the 'struct devdesc' in stand.h */
  36 struct i386_devdesc {
  37     struct devsw        *d_dev;
  38     int                 d_type;
  39     int                 d_unit;
  40     union
  41     {
  42         struct
  43         {
  44             void        *data;
  45             int         slice;
  46             int         partition;
  47             off_t       offset;
  48         } biosdisk;
  49         struct
  50         {
  51             void        *data;
  52         } bioscd;
  53         struct
  54         {
  55             void        *data;
  56             uint64_t    pool_guid;
  57             uint64_t    root_guid;
  58         } zfs;
  59     } d_kind;
  60 };
  61
  62 /*
  63  * relocater trampoline support.
  64  */
  65 struct relocate_data {
  66         uint32_t        src;
  67         uint32_t        dest;
  68         uint32_t        size;
  69 };
  70
  71 extern void relocater(void);
  72
  73 /*
  74  * The relocater_data[] is fixed size array allocated in relocater_tramp.S
  75  */
  76 extern struct relocate_data relocater_data[];
  77 extern uint32_t relocater_size;
  78
  79 extern uint16_t relocator_ip;
  80 extern uint16_t relocator_cs;
  81 extern uint16_t relocator_ds;
  82 extern uint16_t relocator_es;
  83 extern uint16_t relocator_fs;
  84 extern uint16_t relocator_gs;
  85 extern uint16_t relocator_ss;
  86 extern uint16_t relocator_sp;
  87 extern uint32_t relocator_esi;
  88 extern uint32_t relocator_eax;
  89 extern uint32_t relocator_ebx;
  90 extern uint32_t relocator_edx;
  91 extern uint32_t relocator_ebp;
  92 extern uint16_t relocator_a20_enabled;
  93
  94 int     i386_getdev(void **vdev, const char *devspec, const char **path);
  95 char    *i386_fmtdev(void *vdev);
  96 int     i386_setcurrdev(struct env_var *ev, int flags, const void *value);
  97
  98 extern struct devdesc   currdev;        /* our current device */
  99
 100 #define MAXDEV          31              /* maximum number of distinct devices */
 101 #define MAXBDDEV        MAXDEV
 102
 103 /* exported devices XXX rename? */
 104 extern struct devsw bioscd;
 105 extern struct devsw biosdisk;
 106 extern struct devsw pxedisk;
 107 extern struct fs_ops pxe_fsops;
 108
 109 int     bc_add(int biosdev);            /* Register CD booted from. */
 110 int     bc_getdev(struct i386_devdesc *dev);    /* return dev_t for (dev) */
 111 int     bc_bios2unit(int biosdev);      /* xlate BIOS device -> bioscd unit */
 112 int     bc_unit2bios(int unit);         /* xlate bioscd unit -> BIOS device */
 113 uint32_t bd_getbigeom(int bunit);       /* return geometry in bootinfo format */
 114 int     bd_bios2unit(int biosdev);      /* xlate BIOS device -> biosdisk unit */
 115 int     bd_unit2bios(int unit);         /* xlate biosdisk unit -> BIOS device */
 116 int     bd_getdev(struct i386_devdesc *dev);    /* return dev_t for (dev) */
 117
 118 ssize_t i386_copyin(const void *src, vm_offset_t dest, const size_t len);
 119 ssize_t i386_copyout(const vm_offset_t src, void *dest, const size_t len);
 120 ssize_t i386_readin(const int fd, vm_offset_t dest, const size_t len);
 121
 122 struct preloaded_file;
 123 void    bios_addsmapdata(struct preloaded_file *);
 124 void    bios_getsmap(void);
 125
 126 void    bios_getmem(void);
 127 extern uint32_t         bios_basemem;   /* base memory in bytes */
 128 extern uint32_t         bios_extmem;    /* extended memory in bytes */
 129 extern vm_offset_t      memtop;         /* last address of physical memory + 1 */
 130 extern vm_offset_t      memtop_copyin;  /* memtop less heap size for the cases */
 131                                         /*  when heap is at the top of         */
 132                                         /*  extended memory; for other cases   */
 133                                         /*  just the same as memtop            */
 134 extern uint32_t         high_heap_size; /* extended memory region available */
 135 extern vm_offset_t      high_heap_base; /* for use as the heap */
 136
 137 void    biospci_detect(void);
 138 int biospci_find_devclass(uint32_t class, int index, uint32_t *locator);
 139 int biospci_read_config(uint32_t locator, int offset, int width, uint32_t *val);
 140 uint32_t biospci_locator(int8_t bus, uint8_t device, uint8_t function);
 141 int biospci_write_config(uint32_t locator, int offset, int width, uint32_t val);
 142
 143 void    biosacpi_detect(void);
 144
 145 int     i386_autoload(void);
 146 vm_offset_t i386_loadaddr(u_int type, void *data, vm_offset_t addr);
 147
 148 int     bi_getboothowto(char *kargs);
 149 void    bi_setboothowto(int howto);
 150 vm_offset_t     bi_copyenv(vm_offset_t addr);
 151 int     bi_load32(char *args, int *howtop, int *bootdevp, vm_offset_t *bip,
 152             vm_offset_t *modulep, vm_offset_t *kernend);
 153 int     bi_load64(char *args, vm_offset_t addr, vm_offset_t *modulep,
 154             vm_offset_t *kernend, int add_smap);
 155 int     bi_checkcpu(void);
 156
 157 int     mb_kernel_cmdline(struct preloaded_file *, struct devdesc *, char **);
 158 void    multiboot_tramp(uint32_t, vm_offset_t, vm_offset_t);
 159 void    pxe_enable(void *pxeinfo);
 160
 161 #endif /* _LIBI386_H */