trunk/src/device.c

/*
 *  Copyright (C) 2005  Anders Gavare.  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.
 *  3. The name of the author may not be used to endorse or promote products
 *     derived from this software without specific prior written permission.
 *
 *  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.
 *
 *
 *  $Id: device.c,v 1.20 2005/11/22 16:26:35 debug Exp $
 *
 *  Device registry framework.
 */

#include <stdio.h>
#include <stdlib.h>
#include <string.h>

#include "device.h"
#include "memory.h"
#include "misc.h"


static struct device_entry *device_entries = NULL;
static int device_entries_sorted = 0;
static int n_device_entries = 0;
static int device_exit_on_error = 1;

static struct pci_entry *pci_entries = NULL;
static int n_pci_entries = 0;


/*
 *  device_entry_compar():
 *
 *  Internal function, used by sort_entries().
 */
static int device_entry_compar(const void *a, const void *b)
{
        struct device_entry *pa = (struct device_entry *) a;
        struct device_entry *pb = (struct device_entry *) b;

        return strcmp(pa->name, pb->name);
}


/*
 *  sort_entries():
 *
 *  Internal function. Sorts the device_entries array in alphabetic order.
 */
static void sort_entries(void)
{
        qsort(device_entries, n_device_entries, sizeof(struct device_entry),
            device_entry_compar);

        device_entries_sorted = 1;
}


/*
 *  device_register():
 *
 *  Registers a device. The device is added to the end of the device_entries
 *  array, and the sorted flag is set to zero.
 *
 *  NOTE: It would be a bad thing if two devices had the same name. However,
 *        that isn't checked here, it is up to the caller!
 *
 *  Return value is 1 if the device was registered, 0 otherwise.
 */
int device_register(char *name, int (*initf)(struct devinit *))
{
        device_entries = realloc(device_entries, sizeof(struct device_entry)
            * (n_device_entries + 1));
        if (device_entries == NULL) {
                fprintf(stderr, "device_register(): out of memory\n");
                exit(1);
        }

        memset(&device_entries[n_device_entries], 0,
            sizeof(struct device_entry));

        device_entries[n_device_entries].name = strdup(name);
        device_entries[n_device_entries].initf = initf;

        device_entries_sorted = 0;
        n_device_entries ++;
        return 1;
}


/*
 *  pci_register():
 *
 *  Registers a pci device. The pci device is added to the pci_entries array.
 *
 *  Return value is 1 if the pci device was registered. If it was not
 *  added, this function does not return.
 */
int pci_register(char *name, void (*initf)(struct machine *, struct memory *,
        struct pci_device *))
{
        pci_entries = realloc(pci_entries, sizeof(struct pci_entry)
            * (n_pci_entries + 1));
        if (pci_entries == NULL) {
                fprintf(stderr, "pci_register(): out of memory\n");
                exit(1);
        }

        memset(&pci_entries[n_pci_entries], 0, sizeof(struct pci_entry));

        pci_entries[n_pci_entries].name = strdup(name);
        pci_entries[n_pci_entries].initf = initf;
        n_pci_entries ++;
        return 1;
}


/*
 *  pci_lookup_initf():
 *
 *  Find a pci device init function by scanning the pci_entries array.
 *
 *  Return value is a function pointer, or NULL if the name was not found.
 */
void (*pci_lookup_initf(char *name))(struct machine *machine,
        struct memory *mem, struct pci_device *pd)
{
        int i;

        if (name == NULL) {
                fprintf(stderr, "pci_lookup_initf(): name = NULL\n");
                exit(1);
        }

        for (i=0; i<n_pci_entries; i++)
                if (strcmp(name, pci_entries[i].name) == 0)
                        return pci_entries[i].initf;
        return NULL;
}


/*
 *  device_lookup():
 *
 *  Lookup a device name by scanning the device_entries array (as a binary
 *  search tree).
 *
 *  Return value is a pointer to the device_entry on success, or a NULL pointer
 *  if there was no such device.
 */
struct device_entry *device_lookup(char *name)
{
        int hi, lo;

        if (name == NULL) {
                fprintf(stderr, "device_lookup(): NULL ptr\n");
                exit(1);
        }

        if (!device_entries_sorted)
                sort_entries();

        if (n_device_entries == 0)
                return NULL;

        lo = 0; hi = n_device_entries - 1;

        while (lo <= hi) {
                int r, i = (lo + hi) / 2;

                /*  printf("device_lookup(): i=%i (lo=%i hi=%i)\n", i, lo, hi);
                    printf("  name='%s', '%s'\n", name,
                    device_entries[i].name);  */

                r = strcmp(name, device_entries[i].name);
                if (r == 0) {
                        /*  Found it!  */
                        return &device_entries[i];
                }

                /*  Try left or right half:  */
                if (r < 0)
                        hi = i - 1;
                if (r > 0)
                        lo = i + 1;
        }

        return NULL;
}


/*
 *  device_unregister():
 *
 *  Unregisters a device.
 *
 *  Return value is 1 if a device was unregistered, 0 otherwise.
 */
int device_unregister(char *name)
{
        ssize_t i;
        struct device_entry *p = device_lookup(name);

        if (p == NULL) {
                fatal("device_unregister(): no such device (\"%s\")\n", name);
                return 0;
        }

        i = (size_t)p - (size_t)device_entries;
        i /= sizeof(struct device_entry);

        free(device_entries[i].name);
        device_entries[i].name = NULL;

        if (i == n_device_entries-1) {
                /*  Do nothing if we're removing the last array element.  */
        } else {
                /*  Remove array element i by copying the last element
                    to i's position:  */
                device_entries[i] = device_entries[n_device_entries-1];

                /*  The array is not sorted anymore:  */
                device_entries_sorted = 0;
        }

        n_device_entries --;

        /*  TODO: realloc?  */
        return 1;
}


/*
 *  device_add():
 *
 *  Add a device to a machine. For example: "kn210 addr=0x12340000" adds a
 *  device called "kn210" at a specific address.
 *
 *  TODO: This function is quite ugly, and should be cleaned up.
 */
void *device_add(struct machine *machine, char *name_and_params)
{
        struct device_entry *p;
        struct devinit devinit;
        char *s2, *s3;
        size_t len;

        memset(&devinit, 0, sizeof(struct devinit));
        devinit.machine = machine;

        /*  Default values:  */
        devinit.addr_mult = 1;
        devinit.in_use = 1;

        /*  Get the device name first:  */
        s2 = name_and_params;
        while (s2[0] != ',' && s2[0] != ' ' && s2[0] != '\0')
                s2 ++;

        len = (size_t)s2 - (size_t)name_and_params;
        devinit.name = malloc(len + 1);
        if (devinit.name == NULL) {
                fprintf(stderr, "device_add(): out of memory\n");
                exit(1);
        }
        memcpy(devinit.name, name_and_params, len);
        devinit.name[len] = '\0';

        p = device_lookup(devinit.name);
        if (p == NULL) {
                fatal("no such device (\"%s\")\n", devinit.name);
                if (device_exit_on_error)
                        exit(1);
                else
                        goto return_fail;
        }

        /*  Get params from name_and_params:  */
        while (*s2 != '\0') {
                /*  Skip spaces, commas, and semicolons:  */
                while (*s2 == ' ' || *s2 == ',' || *s2 == ';')
                        s2 ++;

                if (*s2 == '\0')
                        break;

                /*  s2 now points to the next param. eg "addr=1234"  */

                /*  Get a word (until there is a '=' sign):  */
                s3 = s2;
                while (*s3 != '=' && *s3 != '\0')
                        s3 ++;
                if (s3 == s2) {
                        fatal("weird param: %s\n", s2);
                        if (device_exit_on_error)
                                exit(1);
                        else
                                goto return_fail;
                }
                s3 ++;
                /*  s3 now points to the parameter value ("1234")  */

                if (strncmp(s2, "addr=", 5) == 0) {
                        devinit.addr = mystrtoull(s3, NULL, 0);
                } else if (strncmp(s2, "addr2=", 6) == 0) {
                        devinit.addr2 = mystrtoull(s3, NULL, 0);
                } else if (strncmp(s2, "len=", 4) == 0) {
                        devinit.len = mystrtoull(s3, NULL, 0);
                } else if (strncmp(s2, "addr_mult=", 10) == 0) {
                        devinit.addr_mult = mystrtoull(s3, NULL, 0);
                } else if (strncmp(s2, "pci_little_endian=", 18) == 0) {
                        devinit.pci_little_endian = mystrtoull(s3, NULL, 0);
                        switch (devinit.pci_little_endian) {
                        case 0: break;
                        case 1: devinit.pci_little_endian =
                                    MEM_PCI_LITTLE_ENDIAN;
                                break;
                        default:fatal("Bad pci_little_endian value.\n");
                                exit(1);
                        }
                } else if (strncmp(s2, "irq=", 4) == 0) {
                        devinit.irq_nr = mystrtoull(s3, NULL, 0);
                } else if (strncmp(s2, "in_use=", 7) == 0) {
                        devinit.in_use = mystrtoull(s3, NULL, 0);
                } else if (strncmp(s2, "name2=", 6) == 0) {
                        char *h = s2 + 6;
                        size_t len = 0;
                        while (*h && *h != ' ')
                                h++, len++;
                        devinit.name2 = malloc(len + 1);
                        if (devinit.name2 == NULL) {
                                fprintf(stderr, "out of memory\n");
                                exit(1);
                        }
                        snprintf(devinit.name2, len + 1, s2 + 6);
                } else {
                        fatal("unknown param: %s\n", s2);
                        if (device_exit_on_error)
                                exit(1);
                        else
                                goto return_fail;
                }

                /*  skip to the next param:  */
                s2 = s3;
                while (*s2 != '\0' && *s2 != ' ' && *s2 != ',' && *s2 != ';')
                        s2 ++;
        }


        /*
         *  Call the init function for this device:
         */

        devinit.return_ptr = NULL;

        if (!p->initf(&devinit)) {
                fatal("error adding device (\"%s\")\n", name_and_params);
                if (device_exit_on_error)
                        exit(1);
                else
                        goto return_fail;
        }

        free(devinit.name);
        return devinit.return_ptr;

return_fail:
        free(devinit.name);
        return NULL;
}


/*
 *  device_dumplist():
 *
 *  Dump a list of all registered devices.  (If the list is not sorted when
 *  this function is called, it is implicitly sorted.)
 */
void device_dumplist(void)
{
        int i;

        if (!device_entries_sorted)
                sort_entries();

        for (i=0; i<n_device_entries; i++) {
                debug("  %s", device_entries[i].name);

                /*  TODO: flags?  */

                debug("\n");
        }
}


/*
 *  device_set_exit_on_error():
 *
 *  This function selects the behaviour of the emulator when a device is not
 *  found. During startup, it is nicest to abort the whole emulator session,
 *  but if a device addition is attempted from within the debugger, then it is
 *  nicer to just print a warning and continue.
 */
void device_set_exit_on_error(int exit_on_error)
{
        device_exit_on_error = exit_on_error;
}


/*
 *  device_init():
 *
 *  Initialize the device registry, and call autodev_init() to automatically
 *  add all normal devices (from the src/devices/ directory).
 *
 *  This function should be called before any other device_*() function is used.
 */
void device_init(void)
{
        device_entries = NULL;
        device_entries_sorted = 0;
        n_device_entries = 0;

        autodev_init();
}

1	/*
2	* Copyright (C) 2005 Anders Gavare. All rights reserved.
3	*
4	* Redistribution and use in source and binary forms, with or without
5	* modification, are permitted provided that the following conditions are met:
6	*
7	* 1. Redistributions of source code must retain the above copyright
8	* notice, this list of conditions and the following disclaimer.
9	* 2. Redistributions in binary form must reproduce the above copyright
10	* notice, this list of conditions and the following disclaimer in the
11	* documentation and/or other materials provided with the distribution.
12	* 3. The name of the author may not be used to endorse or promote products
13	* derived from this software without specific prior written permission.
14	*
15	* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16	* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17	* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18	* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19	* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20	* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21	* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22	* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23	* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24	* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25	* SUCH DAMAGE.
26	*
27	*
28	* $Id: device.c,v 1.20 2005/11/22 16:26:35 debug Exp $
29	*
30	* Device registry framework.
31	*/
32
33	#include <stdio.h>
34	#include <stdlib.h>
35	#include <string.h>
36
37	#include "device.h"
38	#include "memory.h"
39	#include "misc.h"
40
41
42	static struct device_entry *device_entries = NULL;
43	static int device_entries_sorted = 0;
44	static int n_device_entries = 0;
45	static int device_exit_on_error = 1;
46
47	static struct pci_entry *pci_entries = NULL;
48	static int n_pci_entries = 0;
49
50
51	/*
52	* device_entry_compar():
53	*
54	* Internal function, used by sort_entries().
55	*/
56	static int device_entry_compar(const void a, const void b)
57	{
58	struct device_entry pa = (struct device_entry ) a;
59	struct device_entry pb = (struct device_entry ) b;
60
61	return strcmp(pa->name, pb->name);
62	}
63
64
65	/*
66	* sort_entries():
67	*
68	* Internal function. Sorts the device_entries array in alphabetic order.
69	*/
70	static void sort_entries(void)
71	{
72	qsort(device_entries, n_device_entries, sizeof(struct device_entry),
73	device_entry_compar);
74
75	device_entries_sorted = 1;
76	}
77
78
79	/*
80	* device_register():
81	*
82	* Registers a device. The device is added to the end of the device_entries
83	* array, and the sorted flag is set to zero.
84	*
85	* NOTE: It would be a bad thing if two devices had the same name. However,
86	* that isn't checked here, it is up to the caller!
87	*
88	* Return value is 1 if the device was registered, 0 otherwise.
89	*/
90	int device_register(char name, int (initf)(struct devinit *))
91	{
92	device_entries = realloc(device_entries, sizeof(struct device_entry)
93	* (n_device_entries + 1));
94	if (device_entries == NULL) {
95	fprintf(stderr, "device_register(): out of memory\n");
96	exit(1);
97	}
98
99	memset(&device_entries[n_device_entries], 0,
100	sizeof(struct device_entry));
101
102	device_entries[n_device_entries].name = strdup(name);
103	device_entries[n_device_entries].initf = initf;
104
105	device_entries_sorted = 0;
106	n_device_entries ++;
107	return 1;
108	}
109
110
111	/*
112	* pci_register():
113	*
114	* Registers a pci device. The pci device is added to the pci_entries array.
115	*
116	* Return value is 1 if the pci device was registered. If it was not
117	* added, this function does not return.
118	*/
119	int pci_register(char name, void (initf)(struct machine , struct memory ,
120	struct pci_device *))
121	{
122	pci_entries = realloc(pci_entries, sizeof(struct pci_entry)
123	* (n_pci_entries + 1));
124	if (pci_entries == NULL) {
125	fprintf(stderr, "pci_register(): out of memory\n");
126	exit(1);
127	}
128
129	memset(&pci_entries[n_pci_entries], 0, sizeof(struct pci_entry));
130
131	pci_entries[n_pci_entries].name = strdup(name);
132	pci_entries[n_pci_entries].initf = initf;
133	n_pci_entries ++;
134	return 1;
135	}
136
137
138	/*
139	* pci_lookup_initf():
140	*
141	* Find a pci device init function by scanning the pci_entries array.
142	*
143	* Return value is a function pointer, or NULL if the name was not found.
144	*/
145	void (pci_lookup_initf(char name))(struct machine *machine,
146	struct memory mem, struct pci_device pd)
147	{
148	int i;
149
150	if (name == NULL) {
151	fprintf(stderr, "pci_lookup_initf(): name = NULL\n");
152	exit(1);
153	}
154
155	for (i=0; i<n_pci_entries; i++)
156	if (strcmp(name, pci_entries[i].name) == 0)
157	return pci_entries[i].initf;
158	return NULL;
159	}
160
161
162	/*
163	* device_lookup():
164	*
165	* Lookup a device name by scanning the device_entries array (as a binary
166	* search tree).
167	*
168	* Return value is a pointer to the device_entry on success, or a NULL pointer
169	* if there was no such device.
170	*/
171	struct device_entry device_lookup(char name)
172	{
173	int hi, lo;
174
175	if (name == NULL) {
176	fprintf(stderr, "device_lookup(): NULL ptr\n");
177	exit(1);
178	}
179
180	if (!device_entries_sorted)
181	sort_entries();
182
183	if (n_device_entries == 0)
184	return NULL;
185
186	lo = 0; hi = n_device_entries - 1;
187
188	while (lo <= hi) {
189	int r, i = (lo + hi) / 2;
190
191	/* printf("device_lookup(): i=%i (lo=%i hi=%i)\n", i, lo, hi);
192	printf(" name='%s', '%s'\n", name,
193	device_entries[i].name); */
194
195	r = strcmp(name, device_entries[i].name);
196	if (r == 0) {
197	/* Found it! */
198	return &device_entries[i];
199	}
200
201	/* Try left or right half: */
202	if (r < 0)
203	hi = i - 1;
204	if (r > 0)
205	lo = i + 1;
206	}
207
208	return NULL;
209	}
210
211
212	/*
213	* device_unregister():
214	*
215	* Unregisters a device.
216	*
217	* Return value is 1 if a device was unregistered, 0 otherwise.
218	*/
219	int device_unregister(char *name)
220	{
221	ssize_t i;
222	struct device_entry *p = device_lookup(name);
223
224	if (p == NULL) {
225	fatal("device_unregister(): no such device (\"%s\")\n", name);
226	return 0;
227	}
228
229	i = (size_t)p - (size_t)device_entries;
230	i /= sizeof(struct device_entry);
231
232	free(device_entries[i].name);
233	device_entries[i].name = NULL;
234
235	if (i == n_device_entries-1) {
236	/* Do nothing if we're removing the last array element. */
237	} else {
238	/* Remove array element i by copying the last element
239	to i's position: */
240	device_entries[i] = device_entries[n_device_entries-1];
241
242	/* The array is not sorted anymore: */
243	device_entries_sorted = 0;
244	}
245
246	n_device_entries --;
247
248	/* TODO: realloc? */
249	return 1;
250	}
251
252
253	/*
254	* device_add():
255	*
256	* Add a device to a machine. For example: "kn210 addr=0x12340000" adds a
257	* device called "kn210" at a specific address.
258	*
259	* TODO: This function is quite ugly, and should be cleaned up.
260	*/
261	void device_add(struct machine machine, char *name_and_params)
262	{
263	struct device_entry *p;
264	struct devinit devinit;
265	char s2, s3;
266	size_t len;
267
268	memset(&devinit, 0, sizeof(struct devinit));
269	devinit.machine = machine;
270
271	/* Default values: */
272	devinit.addr_mult = 1;
273	devinit.in_use = 1;
274
275	/* Get the device name first: */
276	s2 = name_and_params;
277	while (s2[0] != ',' && s2[0] != ' ' && s2[0] != '\0')
278	s2 ++;
279
280	len = (size_t)s2 - (size_t)name_and_params;
281	devinit.name = malloc(len + 1);
282	if (devinit.name == NULL) {
283	fprintf(stderr, "device_add(): out of memory\n");
284	exit(1);
285	}
286	memcpy(devinit.name, name_and_params, len);
287	devinit.name[len] = '\0';
288
289	p = device_lookup(devinit.name);
290	if (p == NULL) {
291	fatal("no such device (\"%s\")\n", devinit.name);
292	if (device_exit_on_error)
293	exit(1);
294	else
295	goto return_fail;
296	}
297
298	/* Get params from name_and_params: */
299	while (*s2 != '\0') {
300	/* Skip spaces, commas, and semicolons: */
301	while (s2 == ' ' \|\| s2 == ',' \|\| *s2 == ';')
302	s2 ++;
303
304	if (*s2 == '\0')
305	break;
306
307	/* s2 now points to the next param. eg "addr=1234" */
308
309	/* Get a word (until there is a '=' sign): */
310	s3 = s2;
311	while (s3 != '=' && s3 != '\0')
312	s3 ++;
313	if (s3 == s2) {
314	fatal("weird param: %s\n", s2);
315	if (device_exit_on_error)
316	exit(1);
317	else
318	goto return_fail;
319	}
320	s3 ++;
321	/* s3 now points to the parameter value ("1234") */
322
323	if (strncmp(s2, "addr=", 5) == 0) {
324	devinit.addr = mystrtoull(s3, NULL, 0);
325	} else if (strncmp(s2, "addr2=", 6) == 0) {
326	devinit.addr2 = mystrtoull(s3, NULL, 0);
327	} else if (strncmp(s2, "len=", 4) == 0) {
328	devinit.len = mystrtoull(s3, NULL, 0);
329	} else if (strncmp(s2, "addr_mult=", 10) == 0) {
330	devinit.addr_mult = mystrtoull(s3, NULL, 0);
331	} else if (strncmp(s2, "pci_little_endian=", 18) == 0) {
332	devinit.pci_little_endian = mystrtoull(s3, NULL, 0);
333	switch (devinit.pci_little_endian) {
334	case 0: break;
335	case 1: devinit.pci_little_endian =
336	MEM_PCI_LITTLE_ENDIAN;
337	break;
338	default:fatal("Bad pci_little_endian value.\n");
339	exit(1);
340	}
341	} else if (strncmp(s2, "irq=", 4) == 0) {
342	devinit.irq_nr = mystrtoull(s3, NULL, 0);
343	} else if (strncmp(s2, "in_use=", 7) == 0) {
344	devinit.in_use = mystrtoull(s3, NULL, 0);
345	} else if (strncmp(s2, "name2=", 6) == 0) {
346	char *h = s2 + 6;
347	size_t len = 0;
348	while (h && h != ' ')
349	h++, len++;
350	devinit.name2 = malloc(len + 1);
351	if (devinit.name2 == NULL) {
352	fprintf(stderr, "out of memory\n");
353	exit(1);
354	}
355	snprintf(devinit.name2, len + 1, s2 + 6);
356	} else {
357	fatal("unknown param: %s\n", s2);
358	if (device_exit_on_error)
359	exit(1);
360	else
361	goto return_fail;
362	}
363
364	/* skip to the next param: */
365	s2 = s3;
366	while (s2 != '\0' && s2 != ' ' && s2 != ',' && s2 != ';')
367	s2 ++;
368	}
369
370
371	/*
372	* Call the init function for this device:
373	*/
374
375	devinit.return_ptr = NULL;
376
377	if (!p->initf(&devinit)) {
378	fatal("error adding device (\"%s\")\n", name_and_params);
379	if (device_exit_on_error)
380	exit(1);
381	else
382	goto return_fail;
383	}
384
385	free(devinit.name);
386	return devinit.return_ptr;
387
388	return_fail:
389	free(devinit.name);
390	return NULL;
391	}
392
393
394	/*
395	* device_dumplist():
396	*
397	* Dump a list of all registered devices. (If the list is not sorted when
398	* this function is called, it is implicitly sorted.)
399	*/
400	void device_dumplist(void)
401	{
402	int i;
403
404	if (!device_entries_sorted)
405	sort_entries();
406
407	for (i=0; i<n_device_entries; i++) {
408	debug(" %s", device_entries[i].name);
409
410	/* TODO: flags? */
411
412	debug("\n");
413	}
414	}
415
416
417	/*
418	* device_set_exit_on_error():
419	*
420	* This function selects the behaviour of the emulator when a device is not
421	* found. During startup, it is nicest to abort the whole emulator session,
422	* but if a device addition is attempted from within the debugger, then it is
423	* nicer to just print a warning and continue.
424	*/
425	void device_set_exit_on_error(int exit_on_error)
426	{
427	device_exit_on_error = exit_on_error;
428	}
429
430
431	/*
432	* device_init():
433	*
434	* Initialize the device registry, and call autodev_init() to automatically
435	* add all normal devices (from the src/devices/ directory).
436	*
437	* This function should be called before any other device_*() function is used.
438	*/
439	void device_init(void)
440	{
441	device_entries = NULL;
442	device_entries_sorted = 0;
443	n_device_entries = 0;
444
445	autodev_init();
446	}
447