|
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [RFC PATCH 07/11] docs/doxygen: Add doxygen tags to elfnote.h
Add docygen tags to comments for:
1) Create elf_notes group
2) Set documentation for macros
Signed-off-by: Luca Fancellu <luca.fancellu@xxxxxxx>
---
xen/include/public/elfnote.h | 68 ++++++++++++++++++++++--------------
1 file changed, 42 insertions(+), 26 deletions(-)
diff --git a/xen/include/public/elfnote.h b/xen/include/public/elfnote.h
index 181cbc4ec7..13ae6e3164 100644
--- a/xen/include/public/elfnote.h
+++ b/xen/include/public/elfnote.h
@@ -24,11 +24,20 @@
* Copyright (c) 2006, Ian Campbell, XenSource Ltd.
*/
+/**
+ * @file
+ * @brief Definitions used for the Xen ELF notes.
+ */
+
#ifndef __XEN_PUBLIC_ELFNOTE_H__
#define __XEN_PUBLIC_ELFNOTE_H__
/*
* `incontents 200 elfnotes ELF notes
+ */
+
+/**
+ * @brief ELF notes
*
* The notes should live in a PT_NOTE segment and have "Xen" in the
* name field.
@@ -41,28 +50,31 @@
*
* String values (for non-legacy) are NULL terminated ASCII, also known
* as ASCIZ type.
+ *
+ * @addtogroup elf_notes ELF notes
+ * @{
*/
-/*
+/**
* NAME=VALUE pair (string).
*/
#define XEN_ELFNOTE_INFO 0
-/*
+/**
* The virtual address of the entry point (numeric).
*
* LEGACY: VIRT_ENTRY
*/
#define XEN_ELFNOTE_ENTRY 1
-/* The virtual address of the hypercall transfer page (numeric).
+/** The virtual address of the hypercall transfer page (numeric).
*
* LEGACY: HYPERCALL_PAGE. (n.b. legacy value is a physical page
* number not a virtual address)
*/
#define XEN_ELFNOTE_HYPERCALL_PAGE 2
-/* The virtual address where the kernel image should be mapped (numeric).
+/** The virtual address where the kernel image should be mapped (numeric).
*
* Defaults to 0.
*
@@ -70,7 +82,7 @@
*/
#define XEN_ELFNOTE_VIRT_BASE 3
-/*
+/**
* The offset of the ELF paddr field from the actual required
* pseudo-physical address (numeric).
*
@@ -82,35 +94,35 @@
*/
#define XEN_ELFNOTE_PADDR_OFFSET 4
-/*
+/**
* The version of Xen that we work with (string).
*
* LEGACY: XEN_VER
*/
#define XEN_ELFNOTE_XEN_VERSION 5
-/*
+/**
* The name of the guest operating system (string).
*
* LEGACY: GUEST_OS
*/
#define XEN_ELFNOTE_GUEST_OS 6
-/*
+/**
* The version of the guest operating system (string).
*
* LEGACY: GUEST_VER
*/
#define XEN_ELFNOTE_GUEST_VERSION 7
-/*
+/**
* The loader type (string).
*
* LEGACY: LOADER
*/
#define XEN_ELFNOTE_LOADER 8
-/*
+/**
* The kernel supports PAE (x86/32 only, string = "yes", "no" or
* "bimodal").
*
@@ -126,7 +138,7 @@
*/
#define XEN_ELFNOTE_PAE_MODE 9
-/*
+/**
* The features supported/required by this kernel (string).
*
* The string must consist of a list of feature names (as given in
@@ -138,7 +150,7 @@
*/
#define XEN_ELFNOTE_FEATURES 10
-/*
+/**
* The kernel requires the symbol table to be loaded (string = "yes" or "no")
* LEGACY: BSD_SYMTAB (n.b. The legacy treated the presence or absence
* of this string as a boolean flag rather than requiring "yes" or
@@ -146,7 +158,7 @@
*/
#define XEN_ELFNOTE_BSD_SYMTAB 11
-/*
+/**
* The lowest address the hypervisor hole can begin at (numeric).
*
* This must not be set higher than HYPERVISOR_VIRT_START. Its presence
@@ -155,13 +167,13 @@
*/
#define XEN_ELFNOTE_HV_START_LOW 12
-/*
+/**
* List of maddr_t-sized mask/value pairs describing how to recognize
* (non-present) L1 page table entries carrying valid MFNs (numeric).
*/
#define XEN_ELFNOTE_L1_MFN_VALID 13
-/*
+/**
* Whether or not the guest supports cooperative suspend cancellation.
* This is a numeric value.
*
@@ -169,7 +181,7 @@
*/
#define XEN_ELFNOTE_SUSPEND_CANCEL 14
-/*
+/**
* The (non-default) location the initial phys-to-machine map should be
* placed at by the hypervisor (Dom0) or the tools (DomU).
* The kernel must be prepared for this mapping to be established using
@@ -182,13 +194,13 @@
*/
#define XEN_ELFNOTE_INIT_P2M 15
-/*
+/**
* Whether or not the guest can deal with being passed an initrd not
* mapped through its initial page tables.
*/
#define XEN_ELFNOTE_MOD_START_PFN 16
-/*
+/**
* The features supported by this kernel (numeric).
*
* Other than XEN_ELFNOTE_FEATURES on pre-4.2 Xen, this note allows a
@@ -201,7 +213,7 @@
*/
#define XEN_ELFNOTE_SUPPORTED_FEATURES 17
-/*
+/**
* Physical entry point into the kernel.
*
* 32bit entry point into the kernel. When requested to launch the
@@ -211,12 +223,12 @@
*/
#define XEN_ELFNOTE_PHYS32_ENTRY 18
-/*
+/**
* The number of the highest elfnote defined.
*/
#define XEN_ELFNOTE_MAX XEN_ELFNOTE_PHYS32_ENTRY
-/*
+/**
* System information exported through crash notes.
*
* The kexec / kdump code will create one XEN_ELFNOTE_CRASH_INFO
@@ -225,7 +237,7 @@
*/
#define XEN_ELFNOTE_CRASH_INFO 0x1000001
-/*
+/**
* System registers exported through crash notes.
*
* The kexec / kdump code will create one XEN_ELFNOTE_CRASH_REGS
@@ -236,7 +248,7 @@
#define XEN_ELFNOTE_CRASH_REGS 0x1000002
-/*
+/**
* xen dump-core none note.
* xm dump-core code will create one XEN_ELFNOTE_DUMPCORE_NONE
* in its dump file to indicate that the file is xen dump-core
@@ -245,7 +257,7 @@
*/
#define XEN_ELFNOTE_DUMPCORE_NONE 0x2000000
-/*
+/**
* xen dump-core header note.
* xm dump-core code will create one XEN_ELFNOTE_DUMPCORE_HEADER
* in its dump file.
@@ -253,7 +265,7 @@
*/
#define XEN_ELFNOTE_DUMPCORE_HEADER 0x2000001
-/*
+/**
* xen dump-core xen version note.
* xm dump-core code will create one XEN_ELFNOTE_DUMPCORE_XEN_VERSION
* in its dump file. It contains the xen version obtained via the
@@ -262,7 +274,7 @@
*/
#define XEN_ELFNOTE_DUMPCORE_XEN_VERSION 0x2000002
-/*
+/**
* xen dump-core format version note.
* xm dump-core code will create one XEN_ELFNOTE_DUMPCORE_FORMAT_VERSION
* in its dump file. It contains a format version identifier.
@@ -270,6 +282,10 @@
*/
#define XEN_ELFNOTE_DUMPCORE_FORMAT_VERSION 0x2000003
+/**
+ * @}
+*/
+
#endif /* __XEN_PUBLIC_ELFNOTE_H__ */
/*
--
2.17.1
|
 |
Lists.xenproject.org is hosted with RackSpace, monitoring our |