efi_cmdline.c File Reference

EFI command line. More...

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <ctype.h>
#include <errno.h>
#include <ipxe/init.h>
#include <ipxe/image.h>
#include <ipxe/script.h>
#include <ipxe/uaccess.h>
#include <ipxe/efi/efi.h>
#include <ipxe/efi/efi_cmdline.h>

Go to the source code of this file.

Macros
#define	colour   &efi_cmdline_image
	Colour for debug messages.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FILE_SECBOOT (PERMITTED)
static void	efi_cmdline_free (struct refcnt *refcnt)
	Free command line image.
static int	efi_cmdline_init (void)
	Initialise EFI command line.
static void	efi_cmdline_startup (void)
	EFI command line startup function.
struct startup_fn efi_cmdline_startup_fn	__startup_fn (STARTUP_NORMAL)
	Command line and initrd initialisation function.

Variables
const wchar_t *	efi_cmdline
	EFI command line (may not be wNUL-terminated.
size_t	efi_cmdline_len
	Length of EFI command line (in bytes).
static void *	efi_cmdline_copy
	Internal copy of the command line.
static struct image	efi_cmdline_image
	Embedded script representing the command line.

Detailed Description

EFI command line.

Definition in file efi_cmdline.c.

Macro Definition Documentation

colour

#define colour   &efi_cmdline_image

Colour for debug messages.

Definition at line 76 of file efi_cmdline.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

FILE_SECBOOT()

FILE_SECBOOT

(

PERMITTED

)

efi_cmdline_free()

void efi_cmdline_free ( struct refcnt * refcnt )

static

Free command line image.

Parameters

refcnt

Reference count

Definition at line 59 of file efi_cmdline.c.

                                                       {
        struct image *image = container_of ( refcnt, struct image, refcnt );
 
        DBGC ( image, "CMDLINE freeing command line\n" );
        free_image ( refcnt );
        free ( efi_cmdline_copy );
}

References container_of, DBGC, efi_cmdline_copy, free, and free_image().

efi_cmdline_init()

int efi_cmdline_init ( void )

static

Initialise EFI command line.

Return values

rc	Return status code

Definition at line 83 of file efi_cmdline.c.

                                     {
        wchar_t *wcmdline;
        char *cmdline;
        size_t len;
        int rc;
 
        /* Do nothing if no command line was specified */
        if ( ! efi_cmdline_len ) {
                DBGC ( colour, "CMDLINE found no command line\n" );
                return 0;
        }
 
        /* Create wNUL-terminated copy of command line */
        len = ( efi_cmdline_len + 1 /* possible half CHAR16 */
                + 2 /* wNUL */ );
        efi_cmdline_copy = zalloc ( len );
        if ( ! efi_cmdline_copy ) {
                rc = -ENOMEM;
                goto err_alloc;
        }
        memcpy ( efi_cmdline_copy, efi_cmdline, efi_cmdline_len );
        wcmdline = efi_cmdline_copy;
 
        /* Convert to ASCII in situ */
        snprintf ( efi_cmdline_copy, len, "%ls", wcmdline );
        cmdline = efi_cmdline_copy;
        wcmdline = NULL;
        DBGC ( colour, "CMDLINE found command line \"%s\"\n", cmdline );
 
        /* Mark command line as consumed */
        efi_cmdline_len = 0;
 
        /* Strip image name and surrounding whitespace */
        while ( isspace ( *cmdline ) )
                cmdline++;
        while ( *cmdline && ( ! isspace ( *cmdline ) ) )
                cmdline++;
        while ( isspace ( *cmdline ) )
                cmdline++;
        DBGC ( colour, "CMDLINE using command line \"%s\"\n", cmdline );
 
        /* Prepare and register image */
        efi_cmdline_image.data = cmdline;
        efi_cmdline_image.len = strlen ( cmdline );
        if ( efi_cmdline_image.len &&
             ( ( rc = register_image ( &efi_cmdline_image ) ) != 0 ) ) {
                DBGC ( colour, "CMDLINE could not register command line: %s\n",
                       strerror ( rc ) );
                goto err_register_image;
        }
 
        /* Drop our reference to the image */
        image_put ( &efi_cmdline_image );
 
        return 0;
 
 err_register_image:
        image_put ( &efi_cmdline_image );
 err_alloc:
        return rc;
}

References cmdline, colour, DBGC, efi_cmdline, efi_cmdline_copy, efi_cmdline_image, efi_cmdline_len, ENOMEM, image_put(), isspace(), len, memcpy(), NULL, rc, register_image(), snprintf(), strerror(), strlen(), and zalloc().

Referenced by efi_cmdline_startup().

efi_cmdline_startup()

void efi_cmdline_startup ( void )

static

EFI command line startup function.

Definition at line 149 of file efi_cmdline.c.

                                         {
        int rc;
 
        /* Initialise command line */
        if ( ( rc = efi_cmdline_init() ) != 0 ) {
                /* No way to report failure */
                return;
        }
}

References efi_cmdline_init(), and rc.

Referenced by __startup_fn().

__startup_fn()

struct startup_fn efi_cmdline_startup_fn __startup_fn

(

STARTUP_NORMAL

)

Command line and initrd initialisation function.

References __startup_fn, efi_cmdline_startup(), and STARTUP_NORMAL.

Variable Documentation

efi_cmdline

const wchar_t* efi_cmdline

EFI command line (may not be wNUL-terminated.

Definition at line 46 of file efi_cmdline.c.

Referenced by efi_cmdline_init(), efi_init(), and FILE_SECBOOT().

efi_cmdline_len

size_t efi_cmdline_len

Length of EFI command line (in bytes).

Definition at line 49 of file efi_cmdline.c.

Referenced by efi_cmdline_init(), efi_init(), and FILE_SECBOOT().

efi_cmdline_copy

void* efi_cmdline_copy

static

Internal copy of the command line.

Definition at line 52 of file efi_cmdline.c.

Referenced by efi_cmdline_free(), and efi_cmdline_init().

efi_cmdline_image

struct image efi_cmdline_image

static

Initial value:

                  = {
        .refcnt = REF_INIT ( efi_cmdline_free ),
        .name = "<CMDLINE>",
        .flags = ( IMAGE_STATIC | IMAGE_STATIC_NAME ),
        .type = &script_image_type,
}

Embedded script representing the command line.

Definition at line 68 of file efi_cmdline.c.

                                      {
        .refcnt = REF_INIT ( efi_cmdline_free ),
        .name = "<CMDLINE>",
        .flags = ( IMAGE_STATIC | IMAGE_STATIC_NAME ),
        .type = &script_image_type,
};

Referenced by efi_cmdline_init().