boot: Add comments for struct pxe_label

Some members are not commented. Add the missing comments and tidy up the
style a little.

Signed-off-by: Simon Glass <sjg@chromium.org>
This commit is contained in:
Simon Glass
2025-08-02 07:02:13 +12:00
parent 53b02e1015
commit 324a3ac00a

View File

@@ -23,20 +23,28 @@
* take a 'include file getter' function. * take a 'include file getter' function.
*/ */
/* /**
* Describes a single label given in a pxe file. * struct pxe_label - describes a single label in a pxe file
* *
* Create these with the 'label_create' function given below. * Create these with label_create()
* *
* name - the name of the menu as given on the 'menu label' line. * @num: String version of the ID number of the label, e.g. "1"
* kernel_label - the kernel label, including FIT config if present. * @name: name of the 'label' line
* kernel - the path to the kernel file to use for this label. * @menu: name of the menu as given on the 'menu label' line
* append - kernel command line to use when booting this label * @kernel_label: the kernel label, including FIT config if present
* initrd - path to the initrd to use for this label. * @kernel: the path to the kernel file to use for this label
* attempted - 0 if we haven't tried to boot this label, 1 if we have. * @config: FIT configuration to use (after '#'), or NULL if none
* localboot - 1 if this label specified 'localboot', 0 otherwise. * @append: kernel command line to use when booting this label
* kaslrseed - 1 if generate kaslrseed from hw_rng * @initrd: path to the initrd to use for this label.
* list - lets these form a list, which a pxe_menu struct will hold. * @fdt: path to FDT to use
* @fdtdir: path to FDT directory to use
* @fdtoverlays: space-separated list of paths of FDT overlays to apply
* @ipappend: flags for appending IP address (0x1) and MAC address (0x3)
* @attempted: 0 if we haven't tried to boot this label, 1 if we have
* @localboot: 1 if this label specified 'localboot', 0 otherwise
* @localboot_val: value of the localboot parameter
* @kaslrseed: 1 to generate kaslrseed from hw_rng
* @list: lets these form a list, which a pxe_menu struct will hold.
*/ */
struct pxe_label { struct pxe_label {
char num[4]; char num[4];