bwrap: move the DBus and Wayland socket parsing to ContainerHelpersHEADdev

We had to bump the plugin iid for the stop() change, so now's the
perfect time to extend the Helpers API.

Change-Id: I3070bbb12c721027594d629311f67890c6924696
Pick-to: 6.10
Reviewed-by: Dominik Holland <[email protected]>

1 files changed, 20 insertions, 1 deletions

diff --git a/src/plugin-interfaces/containerinterface.cpp b/src/plugin-interfaces/containerinterface.cpp
index 1a27014f..6f390321 100644
--- a/src/plugin-interfaces/containerinterface.cpp
+++ b/src/plugin-interfaces/containerinterface.cpp
@@ -492,7 +492,7 @@ bool ContainerManagerInterface::initialize(ContainerHelperFunctions *) { return
     namespace.
 
     \note This function needs root privileges.
-    \note This functions will throw \c std::exceptions on error and will simply return on
+    \note This functions will throw a \c std::exception on error and will simply return on
           successful completion.
 */
 
@@ -504,3 +504,22 @@ bool ContainerManagerInterface::initialize(ContainerHelperFunctions *) { return
     \l{ContainerInterface::stop}{stop} with \l{ContainerInterface::WatchdogExit}{WatchdogExit}
     via ContainerInterface.
 */
+
+/*! \fn QString ContainerHelperFunctions::checkDBusSocketPath(const QString &dbusAddress, const QByteArray &typeHint)
+    \since 6.10
+
+    This function parses the given \a dbusAddress to check if the referenced D-Bus socket exists.
+    If it does, this function returns the absolute path to that socket.
+    If the socket does not exist, it throws a \c std::exception.
+
+    The \a typeHint is used to provide context for the exception's error message (e.g.
+    \c "session" or \c "p2p").
+*/
+
+/*! \fn QString ContainerHelperFunctions::checkWaylandSocketPath(const QString &xdgRuntimeDir, const QString &waylandDisplay)
+    \since 6.10
+
+    Checks if a Wayland socket exists in the given \a xdgRuntimeDir named \a waylandDisplay.
+    If it does, this function returns the absolute path to that socket.
+    If the socket does not exist, it throws a \c std::exception.
+*/