Changeset 86300 in vbox for trunk/include

Timestamp:

Sep 26, 2020 9:59:44 AM (5 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

140580

Message:

Runtime: Add API to load kernel modules by name and add simple implementation for macOS, bugref:9836

Location:

trunk/include/iprt

Files:

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

trunk/include/iprt/krnlmod.h

@@ -152 +152 @@
                                          PRTKRNLMODINFO phKrnlModInfoRef);
 
+/**
+ * Tries to load a kernel module by the given name.
+ *
+ * @returns IPRT status code.
+ * @retval  VERR_NOT_SUPPORTED if not supported by or implemented for the platform.
+ * @param   pszName         The name of the kernel module. This is highly platform
+ *                          dependent.
+ *
+ * @note On macOS for example the name is the bundle ID.
+ */
+RTDECL(int) RTKrnlModLoadByName(const char *pszName);
+
+/**
+ * Tries to load a kernel module by the given file path.
+ *
+ * @returns IPRT status code.
+ * @retval  VERR_NOT_SUPPORTED if not supported by or implemented for the platform.
+ * @param   pszPath         The path of the kernel module.
+ */
+RTDECL(int) RTKrnlModLoadByPath(const char *pszPath);
+
+/**
+ * Tries to unload a kernel module by the given name.
+ *
+ * @returns IPRT status code.
+ * @param   pszName         The name of the kernel module. This is highly platform
+ *                          dependent and should be queried with RTKrnlModInfoGetName()
+ *                          when checking whether the module was actually loaded.
+ *
+ * @note On macOS for example the name is the bundle ID.
+ */
+RTDECL(int) RTKrnlModUnloadByName(const char *pszName);
+
 /** @} */
 

trunk/include/iprt/mangling.h

@@ -1226 +1226 @@
 # define RTKrnlModInfoRetain                            RT_MANGLER(RTKrnlModInfoRetain)
 # define RTKrnlModInfoRelease                           RT_MANGLER(RTKrnlModInfoRelease)
+# define RTKrnlModLoadByName                            RT_MANGLER(RTKrnlModLoadByName)
+# define RTKrnlModLoadByPath                            RT_MANGLER(RTKrnlModLoadByPath)
 # define RTKrnlModLoadedGetCount                        RT_MANGLER(RTKrnlModLoadedGetCount)
 # define RTKrnlModLoadedQueryInfo                       RT_MANGLER(RTKrnlModLoadedQueryInfo)
 # define RTKrnlModLoadedQueryInfoAll                    RT_MANGLER(RTKrnlModLoadedQueryInfoAll)
 # define RTKrnlModQueryLoaded                           RT_MANGLER(RTKrnlModQueryLoaded)
+# define RTKrnlModUnloadByName                          RT_MANGLER(RTKrnlModUnloadByName)
 # define RTLatin1CalcUtf16Len                           RT_MANGLER(RTLatin1CalcUtf16Len)
 # define RTLatin1CalcUtf16LenEx                         RT_MANGLER(RTLatin1CalcUtf16LenEx)