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
|
/* Definitions for boot script parser for Mach. */
#ifndef _boot_script_h
#define _boot_script_h
/* Written by Shantanu Goel (goel@cs.columbia.edu). */
/* Error codes returned by boot_script_parse_line()
and boot_script_exec_cmd(). */
#define BOOT_SCRIPT_NOMEM 1
#define BOOT_SCRIPT_SYNTAX_ERROR 2
#define BOOT_SCRIPT_INVALID_ASG 3
#define BOOT_SCRIPT_MACH_ERROR 4
#define BOOT_SCRIPT_UNDEF_SYM 5
#define BOOT_SCRIPT_EXEC_ERROR 6
#define BOOT_SCRIPT_INVALID_SYM 7
#define BOOT_SCRIPT_BAD_TYPE 8
/* Legal values for argument `type' to function
boot_script_set_variable and boot_script_define_function. */
#define VAL_NONE 0 /* none -- function runs at exec time */
#define VAL_STR 1 /* string */
#define VAL_PORT 2 /* port */
#define VAL_TASK 3 /* task port */
/* This structure describes a command. */
struct cmd
{
/* Cookie passed in to boot_script_parse_line. */
void *hook;
/* Path of executable. */
char *path;
/* Task port. */
task_t task;
/* Argument list. */
struct arg **args;
/* Amount allocated for `args'. */
int args_alloc;
/* Next available slot in `args'. */
int args_index;
/* List of functions that want to be run on command execution. */
struct sym **exec_funcs;
/* Amount allocated for `exec_funcs'. */
int exec_funcs_alloc;
/* Next available slot in `exec_funcs'. */
int exec_funcs_index;
};
/* The user must define these functions, we work like malloc and free. */
void *boot_script_malloc (unsigned int);
void boot_script_free (void *, unsigned int);
/* The user must define this function. Load the image of the
executable specified by PATH in TASK. Create a thread
in TASK and point it at the executable's entry point. Initialize
TASK's stack with argument vector ARGV of length ARGC whose
strings are STRINGS. STRINGS has length STRINGLEN.
Return 0 for success, non-zero otherwise. */
int boot_script_exec_cmd (void *hook,
task_t task, char *path, int argc,
char **argv, char *strings, int stringlen);
/* The user must define this function. Load the contents of FILE
into a fresh anonymous memory object and return the memory object port. */
mach_port_t boot_script_read_file (const char *file);
/* The user must define this functions to perform the corresponding
Mach task manipulations. */
int boot_script_task_create (struct cmd *); /* task_create + task_suspend */
int boot_script_task_resume (struct cmd *);
int boot_script_prompt_task_resume (struct cmd *);
int boot_script_insert_right (struct cmd *, mach_port_t, mach_port_t *namep);
int boot_script_insert_task_port (struct cmd *, task_t, mach_port_t *namep);
/* The user must define this function to clean up the `task_t'
returned by boot_script_task_create. */
void boot_script_free_task (task_t task, int aborting);
/* Parse the command line LINE. This causes the command line to be
converted into an internal format. Returns 0 for success, non-zero
otherwise.
NOTE: The parser writes into the line so it must not be a string constant.
It is also the responsibility of the caller not to deallocate the line
across calls to the parser. */
int boot_script_parse_line (void *hook, char *cmdline);
/* Execute the command lines prevously parsed.
Returns 0 for success, non-zero otherwise. */
int boot_script_exec (void);
/* Create an entry in the symbol table for variable NAME,
whose type is TYPE and value is VAL. Returns 0 on success,
non-zero otherwise. */
int boot_script_set_variable (const char *name, int type, int val);
/* Define the function NAME, which will return type RET_TYPE. */
int boot_script_define_function (const char *name, int ret_type,
int (*func) (const struct cmd *cmd, int *val));
/* Returns a string describing the error ERR. */
char *boot_script_error_string (int err);
#endif /* _boot_script_h */
|
