The drive specification alone does not necessarily contain enough information to perform a SAN boot (or local disk boot) under UEFI. If the next-stage bootloader is installed in the EFI system partition under a non-standard name (e.g. "\EFI\debian\grubx64.efi") then this explicit boot filename must also be specified. Generalise this concept to use a "SAN boot configuration parameters" structure (currently containing only the optional explicit boot filename), to allow for easy expansion to provide other parameters such as the partition UUID or volume label. Signed-off-by: Michael Brown <mcb30@ipxe.org>
207 lines
5.3 KiB
C
207 lines
5.3 KiB
C
/*
|
|
* Copyright (C) 2010 Michael Brown <mbrown@fensystems.co.uk>.
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License as
|
|
* published by the Free Software Foundation; either version 2 of the
|
|
* License, or any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful, but
|
|
* WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
|
|
* 02110-1301, USA.
|
|
*
|
|
* You can also choose to distribute this program under the terms of
|
|
* the Unmodified Binary Distribution Licence (as given in the file
|
|
* COPYING.UBDL), provided that you have satisfied its requirements.
|
|
*/
|
|
|
|
#include <stdio.h>
|
|
#include <string.h>
|
|
#include <errno.h>
|
|
#include <getopt.h>
|
|
#include <ipxe/command.h>
|
|
#include <ipxe/parseopt.h>
|
|
#include <ipxe/uri.h>
|
|
#include <ipxe/sanboot.h>
|
|
#include <usr/autoboot.h>
|
|
|
|
FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
|
|
|
|
/** @file
|
|
*
|
|
* SAN commands
|
|
*
|
|
*/
|
|
|
|
/** "sanboot" options */
|
|
struct sanboot_options {
|
|
/** Drive number */
|
|
unsigned int drive;
|
|
/** Do not describe SAN device */
|
|
int no_describe;
|
|
/** Keep SAN device */
|
|
int keep;
|
|
/** Filename */
|
|
char *filename;
|
|
};
|
|
|
|
/** "sanboot" option list */
|
|
static union {
|
|
/* "sanboot" takes all four options */
|
|
struct option_descriptor sanboot[4];
|
|
/* "sanhook" takes only --drive and --no-describe */
|
|
struct option_descriptor sanhook[2];
|
|
/* "sanunhook" takes only --drive */
|
|
struct option_descriptor sanunhook[1];
|
|
} opts = {
|
|
.sanboot = {
|
|
OPTION_DESC ( "drive", 'd', required_argument,
|
|
struct sanboot_options, drive, parse_integer ),
|
|
OPTION_DESC ( "no-describe", 'n', no_argument,
|
|
struct sanboot_options, no_describe, parse_flag ),
|
|
OPTION_DESC ( "keep", 'k', no_argument,
|
|
struct sanboot_options, keep, parse_flag ),
|
|
OPTION_DESC ( "filename", 'f', required_argument,
|
|
struct sanboot_options, filename, parse_string ),
|
|
},
|
|
};
|
|
|
|
|
|
/** "sanhook" command descriptor */
|
|
static struct command_descriptor sanhook_cmd =
|
|
COMMAND_DESC ( struct sanboot_options, opts.sanhook, 1, MAX_ARGUMENTS,
|
|
"<root-path>" );
|
|
|
|
/** "sanboot" command descriptor */
|
|
static struct command_descriptor sanboot_cmd =
|
|
COMMAND_DESC ( struct sanboot_options, opts.sanboot, 0, MAX_ARGUMENTS,
|
|
"[<root-path>]" );
|
|
|
|
/** "sanunhook" command descriptor */
|
|
static struct command_descriptor sanunhook_cmd =
|
|
COMMAND_DESC ( struct sanboot_options, opts.sanunhook, 0, 0, NULL );
|
|
|
|
/**
|
|
* The "sanboot", "sanhook" and "sanunhook" commands
|
|
*
|
|
* @v argc Argument count
|
|
* @v argv Argument list
|
|
* @v default_flags Default set of flags for uriboot()
|
|
* @v no_root_path_flags Additional flags to apply if no root path is present
|
|
* @ret rc Return status code
|
|
*/
|
|
static int sanboot_core_exec ( int argc, char **argv,
|
|
struct command_descriptor *cmd,
|
|
int default_flags, int no_root_path_flags ) {
|
|
struct sanboot_options opts;
|
|
struct san_boot_config config;
|
|
struct uri *uris[argc];
|
|
int count;
|
|
int flags;
|
|
int i;
|
|
int rc;
|
|
|
|
/* Initialise options */
|
|
memset ( &opts, 0, sizeof ( opts ) );
|
|
opts.drive = san_default_drive();
|
|
|
|
/* Parse options */
|
|
if ( ( rc = reparse_options ( argc, argv, cmd, &opts ) ) != 0 )
|
|
goto err_parse_options;
|
|
|
|
/* Parse root paths, if present */
|
|
count = ( argc - optind );
|
|
for ( i = 0 ; i < count ; i++ ) {
|
|
uris[i] = parse_uri ( argv[ optind + i ] );
|
|
if ( ! uris[i] ) {
|
|
rc = -ENOMEM;
|
|
goto err_parse_uri;
|
|
}
|
|
}
|
|
|
|
/* Construct configuration parameters */
|
|
config.filename = opts.filename;
|
|
|
|
/* Construct flags */
|
|
flags = default_flags;
|
|
if ( opts.no_describe )
|
|
flags |= URIBOOT_NO_SAN_DESCRIBE;
|
|
if ( opts.keep )
|
|
flags |= URIBOOT_NO_SAN_UNHOOK;
|
|
if ( ! count )
|
|
flags |= no_root_path_flags;
|
|
|
|
/* Boot from root path */
|
|
if ( ( rc = uriboot ( NULL, uris, count, opts.drive, &config,
|
|
flags ) ) != 0 )
|
|
goto err_uriboot;
|
|
|
|
err_uriboot:
|
|
i = count;
|
|
err_parse_uri:
|
|
for ( i-- ; i >= 0 ; i-- )
|
|
uri_put ( uris[i] );
|
|
err_parse_options:
|
|
return rc;
|
|
}
|
|
|
|
/**
|
|
* The "sanhook" command
|
|
*
|
|
* @v argc Argument count
|
|
* @v argv Argument list
|
|
* @ret rc Return status code
|
|
*/
|
|
static int sanhook_exec ( int argc, char **argv ) {
|
|
return sanboot_core_exec ( argc, argv, &sanhook_cmd,
|
|
( URIBOOT_NO_SAN_BOOT |
|
|
URIBOOT_NO_SAN_UNHOOK ), 0 );
|
|
}
|
|
|
|
/**
|
|
* The "sanboot" command
|
|
*
|
|
* @v argc Argument count
|
|
* @v argv Argument list
|
|
* @ret rc Return status code
|
|
*/
|
|
static int sanboot_exec ( int argc, char **argv ) {
|
|
return sanboot_core_exec ( argc, argv, &sanboot_cmd,
|
|
0, URIBOOT_NO_SAN_UNHOOK );
|
|
}
|
|
|
|
/**
|
|
* The "sanunhook" command
|
|
*
|
|
* @v argc Argument count
|
|
* @v argv Argument list
|
|
* @ret rc Return status code
|
|
*/
|
|
static int sanunhook_exec ( int argc, char **argv ) {
|
|
return sanboot_core_exec ( argc, argv, &sanunhook_cmd,
|
|
( URIBOOT_NO_SAN_DESCRIBE |
|
|
URIBOOT_NO_SAN_BOOT ), 0 );
|
|
}
|
|
|
|
/** SAN commands */
|
|
struct command sanboot_commands[] __command = {
|
|
{
|
|
.name = "sanhook",
|
|
.exec = sanhook_exec,
|
|
},
|
|
{
|
|
.name = "sanboot",
|
|
.exec = sanboot_exec,
|
|
},
|
|
{
|
|
.name = "sanunhook",
|
|
.exec = sanunhook_exec,
|
|
},
|
|
};
|