imgcrypt.h File Reference

Image encryption management. More...

#include <ipxe/image.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
int	imgdecrypt (struct image *image, struct image *envelope, const char *name)
	Decrypt image using downloaded envelope. More...

Detailed Description

Image encryption management.

Definition in file imgcrypt.h.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

imgdecrypt()

int imgdecrypt	(	struct image *	image,
		struct image *	envelope,
		const char *	name
	)

Decrypt image using downloaded envelope.

Parameters

image	Image to decrypt
envelope	Image containing decryption key
name	Decrypted image name (or NULL to use default)

Return values

rc	Return status code

Definition at line 47 of file imgcrypt.c.

                                    {
        struct cms_message *cms;
        int rc;

        /* Parse envelope */
        if ( ( rc = cms_message ( envelope, &cms ) ) != 0 )
                goto err_parse;

        /* Decrypt image */
        if ( ( rc = cms_decrypt ( cms, image, name, &private_key ) ) != 0 )
                goto err_decrypt;

        /* Drop reference to message */
        cms_put ( cms );
        cms = NULL;

        /* Record decryption */
        syslog ( LOG_NOTICE, "Image \"%s\" decrypted OK\n", image->name );

        return 0;

 err_decrypt:
        cms_put ( cms );
 err_parse:
        syslog ( LOG_ERR, "Image \"%s\" decryption failed: %s\n",
                 image->name, strerror ( rc ) );
        return rc;
}

References cms_decrypt(), cms_put(), LOG_ERR, LOG_NOTICE, image::name, name, NULL, rc, strerror(), and syslog.

Referenced by imgdecrypt_exec().