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. More...

	COMMAND (shim, shim_exec)
	Shim commands. More...

Variables
static struct option_descriptor	shim_opts []
	"shim" option list More...

static struct command_descriptor	shim_cmd
	"shim" command descriptor More...

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.

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL )

◆ FILE_SECBOOT()

FILE_SECBOOT ( PERMITTED )

◆ shim_exec()

static 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 82 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,
                                    &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.

◆ COMMAND()

COMMAND	(	shim	,
		shim_exec
	)

Shim commands.

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 ( "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 ),
}