diff options
author | Ryan Gonzalez <rymg19@gmail.com> | 2020-03-04 21:57:52 -0600 |
---|---|---|
committer | Alexander Larsson <alexander.larsson@gmail.com> | 2020-06-09 13:51:02 +0200 |
commit | c690eb90e44a227ada67c357410c1e3b1b494f41 (patch) | |
tree | a7e8145ea5534ac852f869d01c933233356ffa7a /data | |
parent | f687f6b2ebfe9bc69f59e42bb96475ca01f08548 (diff) | |
download | flatpak-c690eb90e44a227ada67c357410c1e3b1b494f41.tar.gz |
portal: Add SpawnStarted and notify-start
These can be used to monitor when a spawned child process has fully
started and to get its relative PID.
Diffstat (limited to 'data')
-rw-r--r-- | data/org.freedesktop.portal.Flatpak.xml | 33 |
1 files changed, 32 insertions, 1 deletions
diff --git a/data/org.freedesktop.portal.Flatpak.xml b/data/org.freedesktop.portal.Flatpak.xml index 731eaabb..a30088b5 100644 --- a/data/org.freedesktop.portal.Flatpak.xml +++ b/data/org.freedesktop.portal.Flatpak.xml @@ -36,7 +36,7 @@ bus name org.freedesktop.portal.Flatpak and the object path /org/freedesktop/portal/Flatpak. - This documentation describes version 3 of this interface. + This documentation describes version 4 of this interface. --> <interface name='org.freedesktop.portal.Flatpak'> <property name="version" type="u" access="read"/> @@ -111,6 +111,15 @@ This was added in version 3 of this interface (available from flatpak 1.6.0 and later). </para></listitem> </varlistentry> + <varlistentry> + <term>64</term> + <listitem><para> + Emit a SpawnStarted signal once the sandboxed process has been + fully started. + </para><para> + This was added in version 4 of this interface (available from flatpak 1.8.0 and later). + </para></listitem> + </varlistentry> </variablelist> The following options are supported: @@ -229,6 +238,28 @@ </method> <!-- + SpawnStarted: + @pid: the PID of the process that has been started + @relpid: the PID of the process relative to the current namespace. + This is only non-zero if the expose PIDs flag (32) was passed to + org.freedesktop.portal.Flatpak.Spawn(), and it may still be zero if + the process exits before its relative PID could be read. + + Emitted when a process started by org.freedesktop.portal.Flatpak.Spawn() + has fully started. In other words, org.freedesktop.portal.Flatpak.Spawn() returns once the sandbox + has been started, and this signal is emitted once the process inside + itself is started. + + Only emitted by version 4 of this interface (available from flatpak + 1.8.0 and later) and if the notify start flag (64) was passed to + org.freedesktop.portal.Flatpak.Spawn(). + --> + <signal name="SpawnStarted"> + <arg type='u' name='pid' direction='out'/> + <arg type='u' name='relpid' direction='out'/> + </signal> + + <!-- SpawnExited: @pid: the PID of the process that has ended @exit_status: the exit status (see waitpid(2)) |