iPXE
image_crypt_cmd.c File Reference

Image encryption management commands. More...

#include <stdint.h>
#include <stdio.h>
#include <string.h>
#include <getopt.h>
#include <ipxe/image.h>
#include <ipxe/command.h>
#include <ipxe/parseopt.h>
#include <usr/imgmgmt.h>
#include <usr/imgcrypt.h>

Go to the source code of this file.

Data Structures

struct  imgdecrypt_options
 "imgdecrypt" options More...

Functions

 FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
static int imgdecrypt_exec (int argc, char **argv)
 The "imgdecrypt" command.
 COMMAND (imgdecrypt, imgdecrypt_exec)
 Image encryption management commands.

Variables

static struct option_descriptor imgdecrypt_opts []
 "imgdecrypt" option list
static struct command_descriptor imgdecrypt_cmd
 "imgdecrypt" command descriptor

Detailed Description

Image encryption management commands.

Definition in file image_crypt_cmd.c.

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL )

◆ imgdecrypt_exec()

int imgdecrypt_exec ( int argc,
char ** argv )
static

The "imgdecrypt" command.

Parameters
argcArgument count
argvArgument list
Return values
rcReturn status code

Definition at line 74 of file image_crypt_cmd.c.

74 {
76 const char *image_name_uri;
77 const char *envelope_name_uri;
78 struct image *image;
79 struct image *envelope;
80 int rc;
81
82 /* Parse options */
83 if ( ( rc = parse_options ( argc, argv, &imgdecrypt_cmd, &opts ) ) != 0)
84 return rc;
85
86 /* Parse image name/URI string */
87 image_name_uri = argv[optind];
88
89 /* Parse envelope name/URI string */
90 envelope_name_uri = argv[ optind + 1 ];
91
92 /* Acquire the image */
93 if ( ( rc = imgacquire ( image_name_uri, opts.timeout, &image ) ) != 0 )
94 goto err_acquire_image;
95
96 /* Acquire the envelope image */
97 if ( ( rc = imgacquire ( envelope_name_uri, opts.timeout,
98 &envelope ) ) != 0 )
99 goto err_acquire_envelope;
100
101 /* Decrypt image */
102 if ( ( rc = imgdecrypt ( image, envelope, opts.name ) ) != 0 ) {
103 printf ( "Could not decrypt: %s\n", strerror ( rc ) );
104 goto err_decrypt;
105 }
106
107 /* Success */
108 rc = 0;
109
110 err_decrypt:
111 /* Discard envelope unless --keep was specified */
112 if ( ! opts.keep )
113 unregister_image ( envelope );
114 err_acquire_envelope:
115 err_acquire_image:
116 return rc;
117}
struct arbelprm_rc_send_wqe rc
Definition arbel.h:3
static union @024010030001061367220137227263210031030210157031 opts
"cert<xxx>" option list
int optind
Current option index.
Definition getopt.c:52
void unregister_image(struct image *image)
Unregister executable image.
Definition image.c:358
static struct command_descriptor imgdecrypt_cmd
"imgdecrypt" command descriptor
int imgdecrypt(struct image *image, struct image *envelope, const char *name)
Decrypt image using downloaded envelope.
Definition imgcrypt.c:47
int imgacquire(const char *name_uri, unsigned long timeout, struct image **image)
Acquire an image.
Definition imgmgmt.c:143
int parse_options(int argc, char **argv, struct command_descriptor *cmd, void *opts)
Parse command-line options.
Definition parseopt.c:485
char * strerror(int errno)
Retrieve string representation of error number.
Definition strerror.c:79
An executable image.
Definition image.h:24
"imgdecrypt" options
int printf(const char *fmt,...)
Write a formatted string to the console.
Definition vsprintf.c:465

References imgacquire(), imgdecrypt(), imgdecrypt_cmd, optind, opts, parse_options(), printf(), rc, strerror(), and unregister_image().

Referenced by COMMAND().

◆ COMMAND()

COMMAND ( imgdecrypt ,
imgdecrypt_exec  )

Image encryption management commands.

References imgdecrypt(), and imgdecrypt_exec().

Variable Documentation

◆ imgdecrypt_opts

struct option_descriptor imgdecrypt_opts[]
static
Initial value:
= {
OPTION_DESC ( "keep", 'k', no_argument,
struct imgdecrypt_options, keep, parse_flag ),
OPTION_DESC ( "timeout", 't', required_argument,
}
const char * name
Definition ath9k_hw.c:1986
void timeout(int)
@ required_argument
Option requires an argument.
Definition getopt.h:19
@ no_argument
Option does not take an argument.
Definition getopt.h:17
int parse_flag(char *text __unused, int *flag)
Parse flag.
Definition parseopt.c:227
int parse_string(char *text, char **value)
Parse string value.
Definition parseopt.c:74
int parse_timeout(char *text, unsigned long *value)
Parse timeout value (in ms)
Definition parseopt.c:115
#define OPTION_DESC(_longopt, _shortopt, _has_arg, _struct, _field, _parse)
Construct option descriptor.
Definition parseopt.h:68

"imgdecrypt" option list

Definition at line 53 of file image_crypt_cmd.c.

53 {
54 OPTION_DESC ( "name", 'n', required_argument,
56 OPTION_DESC ( "keep", 'k', no_argument,
57 struct imgdecrypt_options, keep, parse_flag ),
58 OPTION_DESC ( "timeout", 't', required_argument,
60};

◆ imgdecrypt_cmd

struct command_descriptor imgdecrypt_cmd
static
Initial value:
=
"<uri|image> <envelope uri|image>" )
static struct option_descriptor imgdecrypt_opts[]
"imgdecrypt" option list
#define COMMAND_DESC(_struct, _options, _min_args, _max_args, _usage)
Construct command descriptor.
Definition parseopt.h:109

"imgdecrypt" command descriptor

Definition at line 63 of file image_crypt_cmd.c.

Referenced by imgdecrypt_exec().