mirror of
https://gitlab.freedesktop.org/wayland/wayland.git
synced 2025-11-02 09:01:39 -05:00
protocol: Suggest get_registry not be called frequently
I've heard some complaints that wl_display.get_registry "leaks" server memory because wl_registry has no destructor. While this isn't strictly true - all those resources are freed when the client disconnects - it's a bit of a gotcha for neophytes. Since wl_registry's version is not requested in any way through wl_display.get_registry, we can't add a destructor request without breaking ABI. So let's be a little more clear about the result of getting too many wl_registry objects. Signed-off-by: Derek Foreman <derekf@osg.samsung.com> Reviewed-by: Daniel Stone <daniels@collabora.com> Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
This commit is contained in:
parent
5bb8268766
commit
f6bbc975d3
1 changed files with 6 additions and 0 deletions
|
|
@ -57,6 +57,12 @@
|
|||
This request creates a registry object that allows the client
|
||||
to list and bind the global objects available from the
|
||||
compositor.
|
||||
|
||||
It should be noted that the server side resources consumed in
|
||||
response to a get_registry request can only be released when the
|
||||
client disconnects, not when the client side proxy is destroyed.
|
||||
Therefore, clients should invoke get_registry as infrequently as
|
||||
possible to avoid wasting memory.
|
||||
</description>
|
||||
<arg name="registry" type="new_id" interface="wl_registry"
|
||||
summary="global registry object"/>
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue