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
|
/*-
* Copyright (c) 2011 Doug Rabson
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*
* $FreeBSD$
*/
/*
* USERBOOT interface versions
*/
#define USERBOOT_VERSION_1 1
#define USERBOOT_VERSION_2 2
#define USERBOOT_VERSION_3 3
/*
* Exit codes from the loader
*/
#define USERBOOT_EXIT_QUIT 1
#define USERBOOT_EXIT_REBOOT 2
struct loader_callbacks {
/*
* Console i/o
*/
/*
* Wait until a key is pressed on the console and then return it
*/
int (*getc)(void *arg);
/*
* Write the character ch to the console
*/
void (*putc)(void *arg, int ch);
/*
* Return non-zero if a key can be read from the console
*/
int (*poll)(void *arg);
/*
* Host filesystem i/o
*/
/*
* Open a file in the host filesystem
*/
int (*open)(void *arg, const char *filename, void **h_return);
/*
* Close a file
*/
int (*close)(void *arg, void *h);
/*
* Return non-zero if the file is a directory
*/
int (*isdir)(void *arg, void *h);
/*
* Read size bytes from a file. The number of bytes remaining
* in dst after reading is returned in *resid_return
*/
int (*read)(void *arg, void *h, void *dst, size_t size,
size_t *resid_return);
/*
* Read an entry from a directory. The entry's inode number is
* returned in *fileno_return, its type in *type_return and
* the name length in *namelen_return. The name itself is
* copied to the buffer name which must be at least PATH_MAX
* in size.
*/
int (*readdir)(void *arg, void *h, uint32_t *fileno_return,
uint8_t *type_return, size_t *namelen_return, char *name);
/*
* Seek to a location within an open file
*/
int (*seek)(void *arg, void *h, uint64_t offset,
int whence);
/*
* Return some stat(2) related information about the file
*/
int (*stat)(void *arg, void *h, int *mode_return,
int *uid_return, int *gid_return, uint64_t *size_return);
/*
* Disk image i/o
*/
/*
* Read from a disk image at the given offset
*/
int (*diskread)(void *arg, int unit, uint64_t offset,
void *dst, size_t size, size_t *resid_return);
/*
* Guest virtual machine i/o
*/
/*
* Copy to the guest address space
*/
int (*copyin)(void *arg, const void *from,
uint64_t to, size_t size);
/*
* Copy from the guest address space
*/
int (*copyout)(void *arg, uint64_t from,
void *to, size_t size);
/*
* Set a guest register value
*/
void (*setreg)(void *arg, int, uint64_t);
/*
* Set a guest MSR value
*/
void (*setmsr)(void *arg, int, uint64_t);
/*
* Set a guest CR value
*/
void (*setcr)(void *arg, int, uint64_t);
/*
* Set the guest GDT address
*/
void (*setgdt)(void *arg, uint64_t, size_t);
/*
* Transfer control to the guest at the given address
*/
void (*exec)(void *arg, uint64_t pc);
/*
* Misc
*/
/*
* Sleep for usec microseconds
*/
void (*delay)(void *arg, int usec);
/*
* Exit with the given exit code
*/
void (*exit)(void *arg, int v);
/*
* Return guest physical memory map details
*/
void (*getmem)(void *arg, uint64_t *lowmem,
uint64_t *highmem);
/*
* ioctl interface to the disk device
*/
int (*diskioctl)(void *arg, int unit, u_long cmd,
void *data);
/*
* Returns an environment variable in the form "name=value".
*
* If there are no more variables that need to be set in the
* loader environment then return NULL.
*
* 'num' is used as a handle for the callback to identify which
* environment variable to return next. It will begin at 0 and
* each invocation will add 1 to the previous value of 'num'.
*/
const char * (*getenv)(void *arg, int num);
};
|