wayland/protocol/tests.xml
Jonathan Leivent 0db836ebc8 tests: server needs zombies and zombie domino effect
2 new tests added to display-test.c:
server_needs_zombies demonstrates that the same reason for zombies in the
client exist in the server: proper demarshalling of fds
zombie_domino_effect demonstrates that messages sent to zombies need to
create new zombies for new_id args

Signed-off-by: Jonathan Leivent <jleivent@comcast.net>
2024-02-28 14:23:19 -05:00

102 lines
3.6 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<protocol name="build_time_wayland_tests">
<copyright>
Copyright © 2017 Samsung Electronics Co., Ltd
Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation files
(the "Software"), to deal in the Software without restriction,
including without limitation the rights to use, copy, modify, merge,
publish, distribute, sublicense, and/or sell copies of the Software,
and to permit persons to whom the Software is furnished to do so,
subject to the following conditions:
The above copyright notice and this permission notice (including the
next paragraph) shall be included in all copies or substantial
portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
</copyright>
<interface name="fd_passer" version="2">
<description summary="Sends an event with an fd">
A trivial interface for fd passing tests.
</description>
<request name="destroy" type="destructor"/>
<event name="pre_fd"/>
<event name="fd">
<description summary="passes a file descriptor"/>
<arg name="fd" type="fd" summary="file descriptor"/>
</event>
<!-- Version 2 additions -->
<request name="conjoin" since="2">
<description summary="register another fd passer with this one">
Tells this fd passer object about another one to send events
to for more complicated fd leak tests.
</description>
<arg name="passer" type="object" interface="fd_passer"/>
</request>
</interface>
<interface name="zombie_init" version="1">
<description summary="Set up zombie server and domino-effect tests">
A way to get these tests started.
</description>
<event name="new_obj_event">
<description summary="create a new object on the server"/>
<arg name="the_object" type="new_id" interface="zombie_target"/>
</event>
<request name="new_obj_request">
<description summary="create a new object on the client"/>
<arg name="the_object" type="new_id" interface="zombie_target"/>
</request>
<event name="got_it_event">
<arg name="target" type="object" interface="zombie_target"/>
</event>
<request name="got_it_request">
<arg name="target" type="object" interface="zombie_target"/>
</request>
<request name="try_this_fd_request">
<arg name="fd" type="fd" summary="file descriptor"/>
</request>
<event name="try_this_fd_event">
<arg name="fd" type="fd" summary="file descriptor"/>
</event>
</interface>
<interface name="zombie_target" version="1">
<description summary="object that will or should become a zombie"/>
<request name="have_an_fd_request">
<arg name="fd" type="fd" summary="file descriptor"/>
</request>
<event name="have_an_fd_event">
<arg name="fd" type="fd" summary="file descriptor"/>
</event>
<event name="have_a_new_id_event">
<arg name="the_id" type="new_id" interface="zombie_target"/>
</event>
<request name="destruct_request" type="destuctor"/>
<event name="destruct_event" type="destructor"/>
</interface>
</protocol>