Copy the coredump header so we can rely on it in the selftests.
Showing the changes to tools/include/uapi/linux (1 of 1 file). Show all
Unified · Split
| @@ -0,0 +1,104 @@ | |||
| 1 | /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */ | ||
| 2 | |||
| 3 | #ifndef _UAPI_LINUX_COREDUMP_H | ||
| 4 | #define _UAPI_LINUX_COREDUMP_H | ||
| 5 | |||
| 6 | #include <linux/types.h> | ||
| 7 | |||
| 8 | /** | ||
| 9 | * coredump_{req,ack} flags | ||
| 10 | * @COREDUMP_KERNEL: kernel writes coredump | ||
| 11 | * @COREDUMP_USERSPACE: userspace writes coredump | ||
| 12 | * @COREDUMP_REJECT: don't generate coredump | ||
| 13 | * @COREDUMP_WAIT: wait for coredump server | ||
| 14 | */ | ||
| 15 | enum { | ||
| 16 | COREDUMP_KERNEL = (1ULL << 0), | ||
| 17 | COREDUMP_USERSPACE = (1ULL << 1), | ||
| 18 | COREDUMP_REJECT = (1ULL << 2), | ||
| 19 | COREDUMP_WAIT = (1ULL << 3), | ||
| 20 | }; | ||
| 21 | |||
| 22 | /** | ||
| 23 | * struct coredump_req - message kernel sends to userspace | ||
| 24 | * @size: size of struct coredump_req | ||
| 25 | * @size_ack: known size of struct coredump_ack on this kernel | ||
| 26 | * @mask: supported features | ||
| 27 | * | ||
| 28 | * When a coredump happens the kernel will connect to the coredump | ||
| 29 | * socket and send a coredump request to the coredump server. The @size | ||
| 30 | * member is set to the size of struct coredump_req and provides a hint | ||
| 31 | * to userspace how much data can be read. Userspace may use MSG_PEEK to | ||
| 32 | * peek the size of struct coredump_req and then choose to consume it in | ||
| 33 | * one go. Userspace may also simply read a COREDUMP_ACK_SIZE_VER0 | ||
| 34 | * request. If the size the kernel sends is larger userspace simply | ||
| 35 | * discards any remaining data. | ||
| 36 | * | ||
| 37 | * The coredump_req->mask member is set to the currently know features. | ||
| 38 | * Userspace may only set coredump_ack->mask to the bits raised by the | ||
| 39 | * kernel in coredump_req->mask. | ||
| 40 | * | ||
| 41 | * The coredump_req->size_ack member is set by the kernel to the size of | ||
| 42 | * struct coredump_ack the kernel knows. Userspace may only send up to | ||
| 43 | * coredump_req->size_ack bytes to the kernel and must set | ||
| 44 | * coredump_ack->size accordingly. | ||
| 45 | */ | ||
| 46 | struct coredump_req { | ||
| 47 | __u32 size; | ||
| 48 | __u32 size_ack; | ||
| 49 | __u64 mask; | ||
| 50 | }; | ||
| 51 | |||
| 52 | enum { | ||
| 53 | COREDUMP_REQ_SIZE_VER0 = 16U, /* size of first published struct */ | ||
| 54 | }; | ||
| 55 | |||
| 56 | /** | ||
| 57 | * struct coredump_ack - message userspace sends to kernel | ||
| 58 | * @size: size of the struct | ||
| 59 | * @spare: unused | ||
| 60 | * @mask: features kernel is supposed to use | ||
| 61 | * | ||
| 62 | * The @size member must be set to the size of struct coredump_ack. It | ||
| 63 | * may never exceed what the kernel returned in coredump_req->size_ack | ||
| 64 | * but it may of course be smaller (>= COREDUMP_ACK_SIZE_VER0 and <= | ||
| 65 | * coredump_req->size_ack). | ||
| 66 | * | ||
| 67 | * The @mask member must be set to the features the coredump server | ||
| 68 | * wants the kernel to use. Only bits the kernel returned in | ||
| 69 | * coredump_req->mask may be set. | ||
| 70 | */ | ||
| 71 | struct coredump_ack { | ||
| 72 | __u32 size; | ||
| 73 | __u32 spare; | ||
| 74 | __u64 mask; | ||
| 75 | }; | ||
| 76 | |||
| 77 | enum { | ||
| 78 | COREDUMP_ACK_SIZE_VER0 = 16U, /* size of first published struct */ | ||
| 79 | }; | ||
| 80 | |||
| 81 | /** | ||
| 82 | * enum coredump_mark - Markers for the coredump socket | ||
| 83 | * | ||
| 84 | * The kernel will place a single byte on the coredump socket. The | ||
| 85 | * markers notify userspace whether the coredump ack succeeded or | ||
| 86 | * failed. | ||
| 87 | * | ||
| 88 | * @COREDUMP_MARK_MINSIZE: the provided coredump_ack size was too small | ||
| 89 | * @COREDUMP_MARK_MAXSIZE: the provided coredump_ack size was too big | ||
| 90 | * @COREDUMP_MARK_UNSUPPORTED: the provided coredump_ack mask was invalid | ||
| 91 | * @COREDUMP_MARK_CONFLICTING: the provided coredump_ack mask has conflicting options | ||
| 92 | * @COREDUMP_MARK_REQACK: the coredump request and ack was successful | ||
| 93 | * @__COREDUMP_MARK_MAX: the maximum coredump mark value | ||
| 94 | */ | ||
| 95 | enum coredump_mark { | ||
| 96 | COREDUMP_MARK_REQACK = 0U, | ||
| 97 | COREDUMP_MARK_MINSIZE = 1U, | ||
| 98 | COREDUMP_MARK_MAXSIZE = 2U, | ||
| 99 | COREDUMP_MARK_UNSUPPORTED = 3U, | ||
| 100 | COREDUMP_MARK_CONFLICTING = 4U, | ||
| 101 | __COREDUMP_MARK_MAX = (1U << 31), | ||
| 102 | }; | ||
| 103 | |||
| 104 | #endif /* _UAPI_LINUX_COREDUMP_H */ | ||