mirror of
https://github.com/ibm-s390-linux/s390-tools.git
synced 2026-08-05 02:14:52 +00:00
8fa1b5a00b
Sometimes dumping a virtual machine from the outside is the only way to get the data that is needed. This can be the case if a dumping mechanism like kdump hasn't been configured or data needs to be fetched at a specific point. Dumping a protected guest from the outside without help from FW/HW doesn't yield sufficient data to be useful. Hence we have introduced Protected Virtualization (PV) dump support - also named confidential dump support. The confidential dump support works by integrating the firmware into the dump process. New Ultravisor calls (UVC) are used to initiate the dump process, dump CPU data, dump memory state and lastly complete the dump process. The guest's data is fully encrypted and can only be decrypted by the entity that owns the customer communication key (CCK) for the dumped guest. The output format is very similar the normal s390 vmcore ELF format, it's only enriched by new sections where the returned data from the UVC "Complete Configuration Dump" and the UVC "Dump Configuration Storage State" is stored. The encrypted CPU data is stored in a new note type `NT_S390_PV_CPU_DATA`. The old note types do still exists but without any confidential data stored. The memory data is stored in the LOAD segment as usual but for PV dumps it's fully AES-XTS encrypted. This commit adds support for reading/decrypting PV guest dumps to zgetdump by introducing a new DFI input module (`dfi_pv_elf.c`). For specifying the customer communication key a new command line option `--key` is added. Signed-off-by: Marc Hartmayer <mhartmay@linux.ibm.com> Reviewed-by: Steffen Eiden <seiden@linux.ibm.com> Signed-off-by: Jan Höppner <hoeppner@linux.ibm.com>
115 lines
2.8 KiB
C
115 lines
2.8 KiB
C
/*
|
|
* s390-tools/include/zt_common.h
|
|
* common s390-tools definitions.
|
|
*
|
|
* Copyright IBM Corp. 2004, 2017
|
|
*
|
|
* s390-tools is free software; you can redistribute it and/or modify
|
|
* it under the terms of the MIT license. See LICENSE for details.
|
|
*
|
|
*/
|
|
|
|
#ifndef LIB_ZT_COMMON_H
|
|
#define LIB_ZT_COMMON_H
|
|
|
|
#define STRINGIFY_1(x) #x
|
|
#define STRINGIFY(x) STRINGIFY_1(x)
|
|
|
|
/* Use this macro to make constant macros usable in both assembler and
|
|
* C code.
|
|
*
|
|
* Usage example:
|
|
* #define IMAGE_ENTRY _AC(0x10000, UL)
|
|
*/
|
|
#ifndef _AC
|
|
#ifdef __ASSEMBLER__
|
|
#define _AC(X, TYPE) X
|
|
#else
|
|
#define _AC(X, TYPE) X##TYPE
|
|
#endif
|
|
#endif
|
|
|
|
|
|
#ifndef __ASSEMBLER__
|
|
|
|
#ifndef sizeof_field
|
|
#define sizeof_field(type, field) (sizeof((type *)0)->field)
|
|
#endif
|
|
|
|
#ifdef UNUSED
|
|
#elif defined(__GNUC__)
|
|
# define UNUSED(x) UNUSED_ ## x __attribute__((unused))
|
|
#else
|
|
# define UNUSED(x) x
|
|
#endif
|
|
|
|
#ifdef STATIC_ASSERT
|
|
#elif defined(__GNUC__) && ((__GNUC__ == 4 && __GNUC_MINOR__ >= 6) || __GNUC__ >= 5)
|
|
# define STATIC_ASSERT(test) _Static_assert((test), "(" #test ") failed");
|
|
#else
|
|
# define STATIC_ASSERT(test)
|
|
#endif
|
|
|
|
#define ALIGN(x, a) __ALIGN_MASK(x, (typeof(x))(a) - 1)
|
|
#define __ALIGN_MASK(x, mask) (((x) + (mask)) & ~(mask))
|
|
#define ARRAY_SIZE(x) (sizeof(x) / sizeof((x)[0]))
|
|
|
|
#ifndef ROUNDUP
|
|
# define ROUNDUP(x, y) ((((x) + ((y) - 1)) / (y)) * (y))
|
|
#endif
|
|
|
|
#define RELEASE_STRING STRINGIFY (S390_TOOLS_RELEASE)
|
|
#define TOOLS_LIBDIR STRINGIFY (S390_TOOLS_LIBDIR)
|
|
#define TOOLS_SYSCONFDIR STRINGIFY (S390_TOOLS_SYSCONFDIR)
|
|
#define TOOLS_BINDIR STRINGIFY (S390_TOOLS_BINDIR)
|
|
#define TOOLS_DATADIR STRINGIFY (S390_TOOLS_DATADIR)
|
|
|
|
#define __noreturn __attribute__((noreturn))
|
|
#define __packed __attribute__((packed))
|
|
#define __aligned(x) __attribute__((aligned(x)))
|
|
#define __may_alias __attribute__((may_alias))
|
|
#define __section(x) __attribute__((__section__(#x)))
|
|
#define __noinline __attribute__((__noinline__))
|
|
#define __big_endian
|
|
/* The Linux kernel (in stddef.h) and glibc (sys/cdefs.h) define
|
|
* __always_inline. Therefore undefine it first to allow the headers
|
|
* to be included first.
|
|
*/
|
|
#undef __always_inline
|
|
#define __always_inline inline __attribute__((always_inline))
|
|
|
|
#define __pa32(x) ((uint32_t)(unsigned long)(x))
|
|
#define __pa(x) ((unsigned long)(x))
|
|
|
|
#define barrier() __asm__ __volatile__("": : :"memory")
|
|
|
|
#undef MIN
|
|
#define MIN(x, y) \
|
|
({ \
|
|
__typeof__(x) _x = (x); \
|
|
__typeof__(y) _y = (y); \
|
|
\
|
|
_x < _y ? _x : _y; \
|
|
})
|
|
|
|
#undef MAX
|
|
#define MAX(x, y) \
|
|
({ \
|
|
__typeof__(x) _x = (x); \
|
|
__typeof__(y) _y = (y); \
|
|
\
|
|
_x > _y ? _x : _y; \
|
|
})
|
|
|
|
typedef unsigned long long u64;
|
|
typedef signed long long s64;
|
|
typedef unsigned int u32;
|
|
typedef signed int s32;
|
|
typedef unsigned short int u16;
|
|
typedef signed short int s16;
|
|
typedef unsigned char u8;
|
|
typedef signed char s8;
|
|
|
|
#endif /* __ASSEMBLER__ */
|
|
#endif /* LIB_ZT_COMMON_H */
|