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