menu.c File Reference

Menu selection. More...

#include <stdlib.h>
#include <string.h>
#include <assert.h>
#include <ipxe/list.h>
#include <ipxe/menu.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
static	LIST_HEAD (menus)
	List of all menus. More...
struct menu *	create_menu (const char *name, const char *title)
	Create menu. More...
struct menu_item *	add_menu_item (struct menu *menu, const char *label, const char *text, int shortcut, int is_default)
	Add menu item. More...
void	destroy_menu (struct menu *menu)
	Destroy menu. More...
struct menu *	find_menu (const char *name)
	Find menu. More...

Detailed Description

Menu selection.

Definition in file menu.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

LIST_HEAD()

static LIST_HEAD ( menus  )

static

List of all menus.

create_menu()

struct menu* create_menu	(	const char *	name,
		const char *	title
	)

Create menu.

Parameters

name	Menu name, or NULL
title	Menu title, or NULL

Return values

menu	Menu, or NULL on failure

Definition at line 48 of file menu.c.

                                                                  {
        size_t name_len;
        size_t title_len;
        size_t len;
        struct menu *menu;
        char *name_copy;
        char *title_copy;

        /* Destroy any existing menu of this name */
        menu = find_menu ( name );
        if ( menu )
                destroy_menu ( menu );

        /* Use empty title if none given */
        if ( ! title )
                title = "";

        /* Allocate menu */
        name_len = ( name ? ( strlen ( name ) + 1 /* NUL */ ) : 0 );
        title_len = ( strlen ( title ) + 1 /* NUL */ );
        len = ( sizeof ( *menu ) + name_len + title_len );
        menu = zalloc ( len );
        if ( ! menu )
                return NULL;
        name_copy = ( ( void * ) ( menu + 1 ) );
        title_copy = ( name_copy + name_len );

        /* Initialise menu */
        if ( name ) {
                strcpy ( name_copy, name );
                menu->name = name_copy;
        }
        strcpy ( title_copy, title );
        menu->title = title_copy;
        INIT_LIST_HEAD ( &menu->items );

        /* Add to list of menus */
        list_add_tail ( &menu->list, &menus );

        DBGC ( menu, "MENU %s created with title \"%s\"\n",
               menu->name, menu->title );

        return menu;
}

References DBGC, destroy_menu(), find_menu(), INIT_LIST_HEAD, menu::items, len, menu::list, list_add_tail, menu::name, name, NULL, strcpy(), strlen(), menu::title, and zalloc().

Referenced by menu_exec().

add_menu_item()

struct menu_item* add_menu_item	(	struct menu *	menu,
		const char *	label,
		const char *	text,
		int	shortcut,
		int	is_default
	)

Add menu item.

Parameters

menu	Menu
label	Label, or NULL
text	Text, or NULL
shortcut	Shortcut key
is_default	Item is the default item

Return values

item	Menu item, or NULL on failure

Definition at line 103 of file menu.c.

                                                    {
        size_t label_len;
        size_t text_len;
        size_t len;
        struct menu_item *item;
        char *label_copy;
        char *text_copy;

        /* Use empty text if none given */
        if ( ! text )
                text = "";

        /* Allocate item */
        label_len = ( label ? ( strlen ( label ) + 1 /* NUL */ ) : 0 );
        text_len = ( strlen ( text ) + 1 /* NUL */ );
        len = ( sizeof ( *item ) + label_len + text_len );
        item = zalloc ( len );
        if ( ! item )
                return NULL;
        label_copy = ( ( void * ) ( item + 1 ) );
        text_copy = ( label_copy + label_len );

        /* Initialise item */
        if ( label ) {
                strcpy ( label_copy, label );
                item->label = label_copy;
        }
        strcpy ( text_copy, text );
        item->text = text_copy;
        item->shortcut = shortcut;
        item->is_default = is_default;

        /* Add to list of items */
        list_add_tail ( &item->list, &menu->items );

        return item;
}

References menu_item::is_default, menu::items, menu_item::label, len, menu_item::list, list_add_tail, NULL, menu_item::shortcut, strcpy(), strlen(), menu_item::text, and zalloc().

Referenced by item_exec().

destroy_menu()

void destroy_menu

(

struct menu *

menu

)

Destroy menu.

Parameters

menu

Menu

Definition at line 148 of file menu.c.

                                        {
        struct menu_item *item;
        struct menu_item *tmp;

        /* Remove from list of menus */
        list_del ( &menu->list );

        /* Free items */
        list_for_each_entry_safe ( item, tmp, &menu->items, list ) {
                list_del ( &item->list );
                free ( item );
        }

        /* Free menu */
        free ( menu );
}

References free, menu::items, menu_item::list, menu::list, list_del, list_for_each_entry_safe, and tmp.

Referenced by choose_exec(), create_menu(), and menu_exec().

find_menu()

struct menu* find_menu

(

const char *

name

)

Find menu.

Parameters

name	Menu name, or NULL

Return values

menu	Menu, or NULL if not found

Definition at line 171 of file menu.c.

                                             {
        struct menu *menu;

        list_for_each_entry ( menu, &menus, list ) {
                if ( ( menu->name == name ) ||
                     ( strcmp ( menu->name, name ) == 0 ) ) {
                        return menu;
                }
        }

        return NULL;
}

References menu::list, list_for_each_entry, menu::name, name, NULL, and strcmp().

Referenced by create_menu(), and parse_menu().