Changeset 100307 in vbox for trunk/include

Timestamp:

Jun 28, 2023 10:17:34 AM (18 months ago)

Author:

vboxsync

Message:

Runtime,Additions,HostDrivers: Provide API to query the host page size and associated parameters for architectures where the used page size can vary (like on linux.arm64 depending on the kernel config), bugref:10476

Location:

trunk/include/iprt

Files:

• mangling.h (modified) (1 diff)
• system.h (modified) (1 diff)

trunk/include/iprt/mangling.h

@@ -2434 +2434 @@
 # define RTSymlinkRead                                  RT_MANGLER(RTSymlinkRead)
 # define RTSymlinkReadA                                 RT_MANGLER(RTSymlinkReadA)
+# define RTSystemGetPageSize                            RT_MANGLER(RTSystemGetPageSize)
+# define RTSystemGetPageOffsetMask                      RT_MANGLER(RTSystemGetPageOffsetMask)
+# define RTSystemGetPageShift                           RT_MANGLER(RTSystemGetPageShift)
+# define RTSystemPageAlignSize                          RT_MANGLER(RTSystemPageAlignSize)
 # define RTSystemQueryFirmwareType                      RT_MANGLER(RTSystemQueryFirmwareType)
 # define RTSystemQueryFirmwareBoolean                   RT_MANGLER(RTSystemQueryFirmwareBoolean)

trunk/include/iprt/system.h

@@ -163 +163 @@
  */
 RTDECL(int) RTSystemQueryUnavailableRam(uint64_t *pcb);
+
+/**
+ * Returns the page size in bytes of the system.
+ *
+ * @returns Page size in bytes.
+ */
+RTDECL(uint32_t) RTSystemGetPageSize(void);
+
+/**
+ * Returns the page shift in bits of the system.
+ *
+ * @returns Page shift in bits.
+ */
+RTDECL(uint32_t) RTSystemGetPageShift(void);
+
+/**
+ * Returns the page offset mask of the system.
+ *
+ * @returns Page offset maske.
+ */
+RTDECL(uintptr_t) RTSystemGetPageOffsetMask(void);
+
+/**
+ * Aligns the given size to the systems page size.
+ *
+ * @returns Byte size aligned to the systems page size.
+ * @param   cb                  The size in bytes to align.
+ */
+RTDECL(size_t) RTSystemPageAlignSize(size_t cb);