labwc/protocols/xi-socket-manager-unstable-v1.xml
2026-02-28 18:34:32 +01:00

51 lines
2.3 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<protocol name="xi_socket_manager_unstable_v1">
<copyright>
Copyright © 2026 Tobias Bengfort
Permission to use, copy, modify, distribute, and sell this
software and its documentation for any purpose is hereby granted
without fee, provided that the above copyright notice appear in
all copies and that both that copyright notice and this permission
notice appear in supporting documentation, and that the name of
the copyright holders not be used in advertising or publicity
pertaining to distribution of the software without specific,
written prior permission. The copyright holders make no
representations about the suitability of this software for any
purpose. It is provided "as is" without express or implied
warranty.
THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS
SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS, IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY
SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
THIS SOFTWARE.
</copyright>
<interface name="xi_socket_manager_v1" version="1">
<description summary="register privileged sockets">
If a client has received a privileged socket via WAYLAND_SOCKET, it can
use this interface to register additional privileged sockets to pass to
child processes.
</description>
<request name="destroy" type="destructor">
<description summary="destroy the manager object">
Destroy the manager. This doesn't destroy objects created with the
manager.
</description>
</request>
<request name="register_socket">
<description summary="register a socket with the same permissions as the current one">
Registers a new socket with the same permissions as the current one.
The socket must be created by the client. After registraton, it can then
be passed to a child process via WAYLAND_SOCKET.
</description>
<arg name="fd" type="fd"/>
</request>
</interface>
</protocol>