mirror of
				https://gitlab.freedesktop.org/wayland/wayland.git
				synced 2025-11-03 09:01:42 -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