Annotation of sys/dev/ofw/openfirm.h, Revision 1.1.1.1
1.1 nbrk 1: /* $OpenBSD: openfirm.h,v 1.9 2004/01/11 16:20:01 drahn 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_getprop(int handle, char *prop, void *buf, int buflen);
50: int OF_setprop(int, char *, const void *, int);
51: int OF_nextprop(int, char *, void *);
52: int OF_finddevice(char *name);
53: int OF_instance_to_path(int ihandle, char *buf, int buflen);
54: int OF_package_to_path(int phandle, char *buf, int buflen);
55: int OF_call_method_1(char *method, int ihandle, int nargs, ...);
56: int OF_call_method(char *method, int ihandle, int nargs, int nreturns, ...);
57: int OF_open(char *dname);
58: void OF_close(int handle);
59: int OF_read(int handle, void *addr, int len);
60: int OF_write(int handle, void *addr, int len);
61: int OF_seek(int handle, u_quad_t pos);
62: void OF_boot(char *bootspec);
63: void OF_enter(void);
64: void OF_exit(void) __attribute__((__noreturn__));
65: int OF_interpret(char *cmd, int nreturns, ...);
66: #if 0
67: void (*OF_set_callback(void (*newfunc)(void *))) ();
68: #endif
69: int OF_getnodebyname(int, const char *);
70:
71: /*
72: * Some generic routines for OpenFirmware handling.
73: */
74: int ofnmmatch(char *cp1, char *cp2);
75: void ofw_intr_establish(void);
76:
77: /*
78: * Generic OpenFirmware probe argument.
79: * This is how all probe structures must start
80: * in order to support generic OpenFirmware device drivers.
81: */
82: struct ofprobe {
83: int phandle;
84: /*
85: * Special unit field for disk devices.
86: * This is a KLUDGE to work around the fact that OpenFirmware
87: * doesn't probe the scsi bus completely.
88: * YES, I THINK THIS IS A BUG IN THE OPENFIRMWARE DEFINITION!!! XXX
89: * See also ofdisk.c.
90: */
91: int unit;
92: };
93:
94: /*
95: * The softc structure for devices we might be booted from (i.e. we might
96: * want to set root/swap to) needs to start with these fields: XXX
97: */
98: struct ofb_softc {
99: struct device sc_dev;
100: int sc_phandle;
101: int sc_unit; /* Might be missing for non-disk devices */
102: };
CVSweb