EFI shim command. More...

#include <getopt.h>
#include <ipxe/command.h>
#include <ipxe/parseopt.h>
#include <ipxe/efi/efi_image.h>
#include <usr/imgmgmt.h>
#include <usr/shimmgmt.h>

Data Structures
struct	shim_options
	"shim" options More...

Macros
#define	shim_dummy 1

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FILE_SECBOOT (PERMITTED)
static int	shim_exec (int argc, char **argv)
	The "shim" command.
	COMMAND (shim, shim_exec)
	Shim commands.

Variables
static struct option_descriptor	shim_opts []
	"shim" option list
static struct command_descriptor	shim_cmd
	"shim" command descriptor

Detailed Description

EFI shim command.

Definition in file shim_cmd.c.

Macro Definition Documentation

◆ shim_dummy

#define shim_dummy 1

Definition at line 44 of file shim_cmd.c.

Referenced by shim_exec().

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL )

◆ FILE_SECBOOT()

FILE_SECBOOT ( PERMITTED )

◆ shim_exec()

int shim_exec	(	int	argc,
		char **	argv )

static

The "shim" command.

Parameters

argc	Argument count
argv	Argument list

Return values

rc	Return status code

Definition at line 86 of file shim_cmd.c.

                                               {
        struct shim_options opts;
        struct image *image = NULL;
        struct image *kernel;
        char *name_uri;
        int download;
        int rc;
 
        /* Do absolutely nothing if this is a non-EFI platform */
        if ( shim_dummy ) {
                rc = 0;
                goto err_dummy;
        }
 
        /* Parse options */
        if ( ( rc = parse_options ( argc, argv, &shim_cmd, &opts ) ) != 0 )
                goto err_parse;
 
        /* Decide whether or not to download images */
        kernel = find_image_tag ( &selected_image );
        download = ( ! ( kernel && efi_can_load ( kernel ) ) );
 
        /* Parse name/URI string */
        name_uri = argv[optind];
 
        /* Acquire image, if applicable */
        if ( download && name_uri &&
             ( ( rc = imgacquire ( name_uri, opts.timeout, opts.quiet,
                                   &image ) ) != 0 ) ) {
                goto err_image;
        }
 
        /* (Un)register as shim */
        if ( ( rc = shim ( image, opts.require_loader, opts.allow_pxe,
                           opts.allow_sbat ) ) != 0 )
                goto err_shim;
 
 err_shim:
 err_image:
 err_parse:
 err_dummy:
        return rc;
}

References efi_can_load(), find_image_tag(), imgacquire(), kernel, NULL, optind, opts, parse_options(), rc, selected_image, shim(), shim_cmd, and shim_dummy.

Referenced by COMMAND().

◆ COMMAND()

COMMAND	(	shim	,
		shim_exec	)

Shim commands.

References shim(), and shim_exec().

Variable Documentation

◆ shim_opts

struct option_descriptor shim_opts[]

static

Initial value:

                               = {
        OPTION_DESC ( "timeout", 't', required_argument,
                      struct shim_options, timeout, parse_timeout ),
        OPTION_DESC ( "quiet", 'q', no_argument,
                      struct shim_options, quiet, parse_flag ),
        OPTION_DESC ( "require-loader", 'l', no_argument,
                      struct shim_options, require_loader, parse_flag ),
        OPTION_DESC ( "allow-pxe", 'p', no_argument,
                      struct shim_options, allow_pxe, parse_flag ),
        OPTION_DESC ( "allow-sbat", 's', no_argument,
                      struct shim_options, allow_sbat, parse_flag ),
}

"shim" option list

Definition at line 62 of file shim_cmd.c.

                                            {
        OPTION_DESC ( "timeout", 't', required_argument,
                      struct shim_options, timeout, parse_timeout ),
        OPTION_DESC ( "quiet", 'q', no_argument,
                      struct shim_options, quiet, parse_flag ),
        OPTION_DESC ( "require-loader", 'l', no_argument,
                      struct shim_options, require_loader, parse_flag ),
        OPTION_DESC ( "allow-pxe", 'p', no_argument,
                      struct shim_options, allow_pxe, parse_flag ),
        OPTION_DESC ( "allow-sbat", 's', no_argument,
                      struct shim_options, allow_sbat, parse_flag ),
};