1 /* $NetBSD: openfirm.h,v 1.19 2002/10/05 17:01:52 chs Exp $ */ 2 3 /* 4 * Copyright (C) 1995, 1996 Wolfgang Solfrank. 5 * Copyright (C) 1995, 1996 TooLs GmbH. 6 * All rights reserved. 7 * 8 * Redistribution and use in source and binary forms, with or without 9 * modification, are permitted provided that the following conditions 10 * are met: 11 * 1. Redistributions of source code must retain the above copyright 12 * notice, this list of conditions and the following disclaimer. 13 * 2. Redistributions in binary form must reproduce the above copyright 14 * notice, this list of conditions and the following disclaimer in the 15 * documentation and/or other materials provided with the distribution. 16 * 3. All advertising materials mentioning features or use of this software 17 * must display the following acknowledgement: 18 * This product includes software developed by TooLs GmbH. 19 * 4. The name of TooLs GmbH may not be used to endorse or promote products 20 * derived from this software without specific prior written permission. 21 * 22 * THIS SOFTWARE IS PROVIDED BY TOOLS GMBH ``AS IS'' AND ANY EXPRESS OR 23 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 24 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 25 * IN NO EVENT SHALL TOOLS GMBH BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 26 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 27 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 28 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 29 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 30 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 31 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 32 */ 33 /* 34 * Prototypes for OpenFirmware Interface Routines 35 */ 36 37 #include <sys/param.h> /* XXX */ 38 #include <sys/device.h> /* XXX */ 39 40 /* 41 * Machine-independent OpenFirmware-related structures. 42 * XXX THESE DO NOT BELONG HERE. 43 */ 44 45 /* 46 * Generic OpenFirmware probe argument. 47 * This is how all probe structures must start 48 * in order to support generic OpenFirmware device drivers. 49 */ 50 struct ofbus_attach_args { 51 const char *oba_busname; 52 char oba_ofname[64]; 53 int oba_phandle; 54 55 /* 56 * Special unit field for disk devices. 57 * This is a KLUDGE to work around the fact that OpenFirmware 58 * doesn't probe the scsi bus completely. 59 * YES, I THINK THIS IS A BUG IN THE OPENFIRMWARE DEFINITION!!! XXX 60 * See also ofdisk.c. 61 */ 62 int oba_unit; 63 }; 64 65 /* 66 * The softc structure for devices we might be booted from (i.e. we might 67 * want to set root/swap to) needs to start with these fields: XXX 68 */ 69 struct ofbus_softc { 70 struct device sc_dev; 71 int sc_phandle; 72 int sc_unit; /* Might be missing for non-disk devices */ 73 }; 74 75 76 /* 77 * Functions and variables provided by machine-dependent code. 78 */ 79 extern char *OF_buf; 80 81 int OF_peer(int); 82 int OF_child(int); 83 int OF_parent(int); 84 int OF_instance_to_package(int); 85 int OF_getproplen(int, char *); 86 int OF_getprop(int, char *, void *, int); 87 int OF_nextprop(int, char *, void *); 88 int OF_setprop(int, char *, const void *, int); 89 int OF_finddevice(char *); 90 int OF_instance_to_path(int, char *, int); 91 int OF_package_to_path(int, char *, int); 92 int OF_call_method_1(char *, int, int, ...); 93 int OF_call_method(char *, int, int, int, ...); 94 int OF_open(char *); 95 void OF_close(int); 96 int OF_read(int, void *, int); 97 int OF_write(int, void *, int); 98 int OF_seek(int, u_quad_t); 99 void *OF_claim(void *, u_int, u_int); 100 void OF_release(void *, u_int); 101 int OF_milliseconds(void); 102 void OF_boot(char *) __attribute__((__noreturn__)); 103 void OF_enter(void); 104 void OF_exit(void) __attribute__((__noreturn__)); 105 void (*OF_set_callback(void(*)(void *)))(void *); 106 int openfirmware(void *); 107 108 /* 109 * Functions and variables provided by machine-independent code. 110 */ 111 int of_compatible(int, const char * const *); 112 int of_decode_int(const unsigned char *buf); 113 int of_packagename(int, char *, int); 114 115 int *of_network_decode_media(int, int *, int *); 116