1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
|
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License (the "License").
* You may not use this file except in compliance with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* or http://www.opensolaris.org/os/licensing.
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* Copyright 2007 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
#ifndef _SYS_PROMIF_H
#define _SYS_PROMIF_H
#pragma ident "%Z%%M% %I% %E% SMI"
#include <sys/types.h>
#include <sys/obpdefs.h>
#if defined(_KERNEL) || defined(_KMDB)
#include <sys/va_list.h>
#endif
#ifdef __cplusplus
extern "C" {
#endif
/*
* These are for V0 ops only. We sometimes have to specify
* to promif which type of operation we need to perform
* and since we can't get such a property from a V0 prom, we
* sometimes just assume it. V2 and later proms do the right thing.
*/
#define BLOCK 0
#define NETWORK 1
#define BYTE 2
#if defined(_KERNEL) || defined(_KMDB)
extern caddr_t prom_map(caddr_t virthint, uint_t space,
uint_t phys, uint_t size);
/*
* resource allocation group: OBP and IEEE 1275-1994.
* prom_alloc is platform dependent on SPARC.
*/
extern caddr_t prom_alloc(caddr_t virthint, uint_t size, int align);
extern void prom_free(caddr_t virt, uint_t size);
/*
* Device tree and property group: OBP and IEEE 1275-1994.
*/
extern pnode_t prom_childnode(pnode_t nodeid);
extern pnode_t prom_nextnode(pnode_t nodeid);
extern pnode_t prom_optionsnode(void);
extern pnode_t prom_alias_node(void);
extern pnode_t prom_rootnode(void);
extern int prom_getproplen(pnode_t nodeid, caddr_t name);
extern int prom_getprop(pnode_t nodeid, caddr_t name,
caddr_t value);
extern caddr_t prom_nextprop(pnode_t nodeid, caddr_t previous,
caddr_t next);
extern char *prom_decode_composite_string(void *buf,
size_t buflen, char *prev);
/*
* Device tree and property group: IEEE 1275-1994 Only.
*/
extern pnode_t prom_finddevice(char *path);
extern int prom_bounded_getprop(pnode_t nodeid,
caddr_t name, caddr_t buffer, int buflen);
/*
* Device pathnames and pathname conversion: OBP and IEEE 1275-1994.
*/
extern int prom_devname_from_pathname(char *path, char *buffer);
extern char *prom_path_gettoken(char *from, char *to);
/*
* Device pathnames and pathname conversion: IEEE 1275-1994 only.
*/
/*
* Special device nodes: OBP and IEEE 1275-1994.
*/
extern int prom_stdin_is_keyboard(void);
extern int prom_stdout_is_framebuffer(void);
extern void prom_framebuffer_getpos(int *row, int *col);
extern void prom_framebuffer_getcolors(int *fg, int *bg);
extern char *prom_stdinpath(void);
extern char *prom_stdoutpath(void);
extern void prom_strip_options(char *from, char *to);
extern void prom_pathname(char *);
/*
* Special device nodes: IEEE 1275-1994 only.
*/
/*
* Administrative group: OBP and IEEE 1275-1994.
*/
extern void prom_enter_mon(void);
extern void prom_exit_to_mon(void)
__NORETURN;
extern void prom_reboot(char *bootstr)
__NORETURN;
extern void prom_panic(char *string)
__NORETURN;
extern int prom_is_openprom(void);
extern int prom_is_p1275(void);
extern int prom_version_name(char *buf, int buflen);
extern int prom_version_boot_syscalls(void);
extern uint_t prom_gettime(void);
extern char *prom_bootpath(void);
extern char *prom_bootargs(void);
/*
* Administrative group: OBP only.
*/
/*
* Administrative group: IEEE 1275-1994 only.
*/
/*
* Administrative group: IEEE 1275 only.
*/
/*
* Promif support group: Generic.
*/
extern void prom_init(char *progname, void *prom_cookie);
typedef uint_t prom_generation_cookie_t;
#define prom_tree_access(CALLBACK, ARG, GENP) (CALLBACK)((ARG), 0)
/*
* I/O Group: OBP and IEEE 1275.
*/
extern uchar_t prom_getchar(void);
extern void prom_putchar(char c);
extern int prom_mayget(void);
extern int prom_mayput(char c);
extern int prom_open(char *name);
extern int prom_close(int fd);
extern int prom_read(int fd, caddr_t buf, uint_t len,
uint_t startblk, char type);
extern int prom_write(int fd, caddr_t buf, uint_t len,
uint_t startblk, char devtype);
extern int prom_seek(int fd, unsigned long long offset);
extern void prom_writestr(const char *buf, size_t bufsize);
/*PRINTFLIKE1*/
extern void prom_printf(const char *fmt, ...)
__PRINTFLIKE(1);
#pragma rarely_called(prom_printf)
extern void prom_vprintf(const char *fmt, __va_list adx)
__VPRINTFLIKE(1);
#pragma rarely_called(prom_vprintf)
/*PRINTFLIKE2*/
extern char *prom_sprintf(char *s, const char *fmt, ...)
__PRINTFLIKE(2);
extern char *prom_vsprintf(char *s, const char *fmt, __va_list adx)
__VPRINTFLIKE(2);
/*
* promif tree searching routines ... OBP and IEEE 1275-1994.
*/
extern pnode_t prom_findnode_byname(pnode_t id, char *name);
extern char *prom_get_extend_name(void);
extern int prom_devreset(int);
extern int OpenCount;
extern struct ihandle *open_devices[];
#define PROM_STOP { \
prom_printf("File %s line %d\n", __FILE__, __LINE__); \
prom_enter_mon(); \
}
#endif /* _KERNEL || _KMDB */
#ifdef _KERNEL
/*
* Used by wrappers which bring up console frame buffer before prom_printf()
* and other prom calls that may output to the console. Struct is filled in
* in prom_env.c and in sunpm.c
*/
typedef struct promif_owrap {
void (*preout)(void);
void (*postout)(void);
} promif_owrap_t;
extern void prom_suspend_prepost(void);
extern void prom_resume_prepost(void);
/*
* WAN boot key storage interface
*/
int prom_set_security_key(char *keyname, caddr_t buf, int buflen, int *reslen,
int *status);
int prom_get_security_key(char *keyname, caddr_t buf, int buflen, int *keylen,
int *status);
#endif /* _KERNEL */
#ifdef __cplusplus
}
#endif
#endif /* _SYS_PROMIF_H */
|
