autoboot.h File Reference

Automatic booting. More...

#include <gpxe/in.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER)
void	autoboot (void)
	Boot the system.
int	boot_next_server_and_filename (struct in_addr next_server, const char *filename)
	Boot using next-server and filename.
int	boot_root_path (const char *root_path)
	Boot using root path.
int	pxe_menu_boot (struct net_device *netdev) __attribute__((weak))
	Boot using PXE boot menu.
Variables
int	shutdown_exit_flags
	Shutdown flags for exit.

---

Detailed Description

Automatic booting.

Definition in file autoboot.h.

---

Function Documentation

FILE_LICENCE

(

GPL2_OR_LATER

)

void autoboot

(

void

)

Boot the system.

Definition at line 215 of file autoboot.c.

References close_all_netdevs(), find_boot_netdev(), for_each_netdev, netboot(), netdev, and printf().

Referenced by autoboot_exec(), and main().

                       {
        struct net_device *boot_netdev;
        struct net_device *netdev;

        /* If we have an identifable boot device, try that first */
        close_all_netdevs();
        if ( ( boot_netdev = find_boot_netdev() ) )
                netboot ( boot_netdev );

        /* If that fails, try booting from any of the other devices */
        for_each_netdev ( netdev ) {
                if ( netdev == boot_netdev )
                        continue;
                close_all_netdevs();
                netboot ( netdev );
        }

        printf ( "No more network devices\n" );
}

int boot_next_server_and_filename	(	struct in_addr	next_server,
		const char *	filename
	)

Boot using next-server and filename.

Parameters:

filename

Boot filename

Return values:

rc

Return status code

Definition at line 60 of file autoboot.c.

References alloc_image(), ENOMEM, image_put(), imgexec(), imgfetch(), inet_ntoa(), parse_uri(), register_and_autoload_image(), snprintf(), strlen(), uri_encode(), uri_is_absolute(), and URI_PATH.

Referenced by netboot(), and pxe_menu_boot().

                                                           {
        struct uri *uri;
        struct image *image;
        char buf[ 23 /* tftp://xxx.xxx.xxx.xxx/ */ +
                  ( 3 * strlen(filename) ) /* completely URI-encoded */
                  + 1 /* NUL */ ];
        int filename_is_absolute;
        int rc;

        /* Construct URI */
        uri = parse_uri ( filename );
        if ( ! uri )
                return -ENOMEM;
        filename_is_absolute = uri_is_absolute ( uri );
        uri_put ( uri );
        if ( ! filename_is_absolute ) {
                /* Construct a tftp:// URI for the filename.  We can't
                 * just rely on the current working URI, because the
                 * relative URI resolution will remove the distinction
                 * between filenames with and without initial slashes,
                 * which is significant for TFTP.
                 */
                snprintf ( buf, sizeof ( buf ), "tftp://%s/",
                           inet_ntoa ( next_server ) );
                uri_encode ( filename, buf + strlen ( buf ),
                             sizeof ( buf ) - strlen ( buf ), URI_PATH );
                filename = buf;
        }

        image = alloc_image();
        if ( ! image )
                return -ENOMEM;
        if ( ( rc = imgfetch ( image, filename,
                               register_and_autoload_image ) ) != 0 ) {
                goto done;
        }
        if ( ( rc = imgexec ( image ) ) != 0 )
                goto done;

 done:
        image_put ( image );
        return rc;
}

int boot_root_path

(

const char *

root_path

)

Boot using root path.

Parameters:

root_path

Root path

Return values:

rc

Return status code

Definition at line 111 of file autoboot.c.

References sanboot_protocol::boot, ENOTSUP, for_each_table_entry, sanboot_protocol::prefix, SANBOOT_PROTOCOLS, strlen(), and strncmp().

Referenced by netboot(), and sanboot_exec().

                                             {
        struct sanboot_protocol *sanboot;

        /* Quick hack */
        for_each_table_entry ( sanboot, SANBOOT_PROTOCOLS ) {
                if ( strncmp ( root_path, sanboot->prefix,
                               strlen ( sanboot->prefix ) ) == 0 ) {
                        return sanboot->boot ( root_path );
                }
        }

        return -ENOTSUP;
}

int pxe_menu_boot

(

struct net_device *

netdev

)

Boot using PXE boot menu.

Return values:

rc

Return status code

Note that a success return status indicates that a PXE boot menu item has been selected, and that the DHCP session should perform a boot server request/ack.

Definition at line 345 of file pxemenu.c.

References assert, boot_next_server_and_filename(), fetch_ipv4_setting(), fetch_string_setting(), find_settings(), free(), pxe_menu::items, pxe_menu_parse(), pxe_menu_prompt_and_select(), pxebs(), PXEBS_SETTINGS_NAME, pxe_menu::selection, and pxe_menu_item::type.

Referenced by netboot().

                                                {
        struct pxe_menu *menu;
        unsigned int pxe_type;
        struct settings *pxebs_settings;
        struct in_addr next_server;
        char filename[256];
        int rc;

        /* Parse and allocate boot menu */
        if ( ( rc = pxe_menu_parse ( &menu ) ) != 0 )
                return rc;

        /* Make selection from boot menu */
        if ( ( rc = pxe_menu_prompt_and_select ( menu ) ) != 0 ) {
                free ( menu );
                return rc;
        }
        pxe_type = menu->items[menu->selection].type;

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

        /* Return immediately if local boot selected */
        if ( ! pxe_type )
                return 0;

        /* Attempt PXE Boot Server Discovery */
        if ( ( rc = pxebs ( netdev, pxe_type ) ) != 0 )
                return rc;

        /* Attempt boot */
        pxebs_settings = find_settings ( PXEBS_SETTINGS_NAME );
        assert ( pxebs_settings );
        fetch_ipv4_setting ( pxebs_settings, &next_server_setting,
                             &next_server );
        fetch_string_setting ( pxebs_settings, &filename_setting,
                               filename, sizeof ( filename ) );
        return boot_next_server_and_filename ( next_server, filename );
}

---

Variable Documentation

int shutdown_exit_flags

Shutdown flags for exit.

Definition at line 43 of file autoboot.c.

Referenced by keep_san(), and main().