shim_cmd.c File Reference

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>

Go to the source code of this file.

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

Macros
#define	shim_dummy   1

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
static int	shim_exec (int argc, char **argv)
	The "shim" command. More...

Variables
static struct option_descriptor	shim_opts []
	"shim" option list More...
static struct command_descriptor	shim_cmd
	"shim" command descriptor More...
struct command shim_commands []	__command
	Shim commands. More...

Detailed Description

EFI shim command.

Definition in file shim_cmd.c.

Macro Definition Documentation

shim_dummy

#define shim_dummy   1

Definition at line 43 of file shim_cmd.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

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

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

"shim" option list

Definition at line 59 of file shim_cmd.c.

shim_cmd

struct command_descriptor shim_cmd

static

Initial value:

=
        COMMAND_DESC ( struct shim_options, shim_opts, 0, 1, NULL )

"shim" command descriptor

Definition at line 71 of file shim_cmd.c.

Referenced by shim_exec().

__command

struct command shim_commands [] __command

Initial value:

= {
        {
                .name = "shim",
                .exec = shim_exec,
        },
}

Shim commands.

Definition at line 126 of file shim_cmd.c.