plpks_read_bootloader_var(9)

💖 NAME 💖

plpks_read_bootloader_var — okay bestie, this is the one that fetches the data for the specified variable owned by the bootloader consumer. It’s giving “bootloader’s own little PLPKS situation,” and we’re obsessed.

✨ SYNOPSIS ✨

int plpks_read_bootloader_var (struct plpks_var *var );

🎀 ARGUMENTS 🎀

• var — the variable to be read from the PLPKS. That’s the whole argument, no cap.

💜 DESCRIPTION 💜

okay so the consumer or the owner of the object is the bootloader. The H_PKS_READ_OBJECT HCALL reads an object from the PLPKS. The caller must allocate the buffer var->data and specify the length for this buffer in var->datalen. If no buffer is provided, var->datalen will be populated with the requested object’s size — literally the requested object’s size, bestie.

possible reasons for the returned errno values are giving:

• -ENXIO — if PLPKS is not supported.
• -EIO — if PLPKS access is blocked due to the LPAR’s state, if an error occurred while processing the request.
• -EINVAL — if invalid authorization parameter, if invalid object label parameter, if invalid object label len parameter, if invalid output data parameter, if invalid output data len parameter.
• -EPERM — if access is denied.
• -ENOENT — if the requested object was not found.
• -EFBIG — if the requested object couldn’t be stored in the buffer provided.
• -EBUSY — if unable to handle the request.

⭐ RETURN ⭐

On success 0 is returned, a negative errno if not. That’s the vibe check, periodt.

🌈 SEE ALSO 🌈

Kernel file ./arch/powerpc/platforms/pseries/plpks.c, plus all these iconic section 9 friends:

• plpks_get_version(9)
• plpks_get_objoverhead(9)
• plpks_get_maxpwsize(9)
• plpks_get_maxobjectsize(9)
• plpks_get_maxobjectlabelsize(9)
• plpks_get_totalsize(9)
• plpks_get_usedspace(9)
• plpks_get_supportedpolicies(9)
• plpks_get_maxlargeobjectsize(9)
• plpks_get_signedupdatealgorithms(9)
• plpks_get_wrappingfeatures(9)
• plpks_get_passwordlen(9)
• plpks_is_available(9)
• plpks_signed_update_var(9)
• plpks_write_var(9)
• plpks_remove_var(9)
• plpks_wrapping_is_supported(9)
• plpks_gen_wrapping_key(9)
• plpks_wrap_object(9)
• plpks_unwrap_object(9)
• plpks_read_os_var(9)
• plpks_read_fw_var(9)
• plpks_populate_fdt(9)
• plpks_early_init_devtree(9)

mwah 💋 this page is plpks_read_bootloader_var(9), source/version ./arch/powerpc/platforms/pseries, dated October 2026. bye bestie 🫶