mirror of
				https://gitlab.freedesktop.org/pulseaudio/pulseaudio.git
				synced 2025-11-03 09:01:50 -05:00 
			
		
		
		
	core: add message handler
This patch adds a small message handler to the core which enables
clients to list available handlers via the list-handlers message.
Command: pacmd send-message /core list-handlers
pactl can be used with the same parameters.
The patch also introduces a convention for the return string.
It consists of a list of elements where curly braces are used
to separate elements. Each element can itself contain further
elements. For example consider a message that returns multiple
elements which each contain an integer and an array of float.
A response string would look like that:
{{Integer} {{1st float} {2nd float} ...}}{...}
Part-of: <https://gitlab.freedesktop.org/pulseaudio/pulseaudio/-/merge_requests/51>
			
			
This commit is contained in:
		
							parent
							
								
									68f2f1395d
								
							
						
					
					
						commit
						5c0ab52145
					
				
					 3 changed files with 84 additions and 6 deletions
				
			
		| 
						 | 
				
			
			@ -33,11 +33,13 @@
 | 
			
		|||
#include <pulsecore/module.h>
 | 
			
		||||
#include <pulsecore/core-rtclock.h>
 | 
			
		||||
#include <pulsecore/core-util.h>
 | 
			
		||||
#include <pulsecore/message-handler.h>
 | 
			
		||||
#include <pulsecore/core-scache.h>
 | 
			
		||||
#include <pulsecore/core-subscribe.h>
 | 
			
		||||
#include <pulsecore/random.h>
 | 
			
		||||
#include <pulsecore/log.h>
 | 
			
		||||
#include <pulsecore/macro.h>
 | 
			
		||||
#include <pulsecore/strbuf.h>
 | 
			
		||||
 | 
			
		||||
#include "core.h"
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			@ -61,6 +63,45 @@ static int core_process_msg(pa_msgobject *o, int code, void *userdata, int64_t o
 | 
			
		|||
 | 
			
		||||
static void core_free(pa_object *o);
 | 
			
		||||
 | 
			
		||||
/* Returns a list of handlers. */
 | 
			
		||||
static char *message_handler_list(pa_core *c) {
 | 
			
		||||
    pa_strbuf *buf;
 | 
			
		||||
    void *state = NULL;
 | 
			
		||||
    struct pa_message_handler *handler;
 | 
			
		||||
 | 
			
		||||
    buf = pa_strbuf_new();
 | 
			
		||||
 | 
			
		||||
    pa_strbuf_putc(buf, '{');
 | 
			
		||||
    PA_HASHMAP_FOREACH(handler, c->message_handlers, state) {
 | 
			
		||||
        pa_strbuf_putc(buf, '{');
 | 
			
		||||
 | 
			
		||||
        pa_strbuf_printf(buf, "{%s} {", handler->object_path);
 | 
			
		||||
        if (handler->description)
 | 
			
		||||
            pa_strbuf_puts(buf, handler->description);
 | 
			
		||||
 | 
			
		||||
        pa_strbuf_puts(buf, "}}");
 | 
			
		||||
    }
 | 
			
		||||
    pa_strbuf_putc(buf, '}');
 | 
			
		||||
 | 
			
		||||
    return pa_strbuf_to_string_free(buf);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
static int core_message_handler(const char *object_path, const char *message, const char *message_parameters, char **response, void *userdata) {
 | 
			
		||||
    pa_core *c;
 | 
			
		||||
 | 
			
		||||
    pa_assert(c = (pa_core *) userdata);
 | 
			
		||||
    pa_assert(message);
 | 
			
		||||
    pa_assert(response);
 | 
			
		||||
    pa_assert(pa_safe_streq(object_path, "/core"));
 | 
			
		||||
 | 
			
		||||
    if (pa_streq(message, "list-handlers")) {
 | 
			
		||||
        *response = message_handler_list(c);
 | 
			
		||||
        return PA_OK;
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    return -PA_ERR_NOTIMPLEMENTED;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
pa_core* pa_core_new(pa_mainloop_api *m, bool shared, bool enable_memfd, size_t shm_size) {
 | 
			
		||||
    pa_core* c;
 | 
			
		||||
    pa_mempool *pool;
 | 
			
		||||
| 
						 | 
				
			
			@ -105,6 +146,8 @@ pa_core* pa_core_new(pa_mainloop_api *m, bool shared, bool enable_memfd, size_t
 | 
			
		|||
    c->shared = pa_hashmap_new(pa_idxset_string_hash_func, pa_idxset_string_compare_func);
 | 
			
		||||
    c->message_handlers = pa_hashmap_new(pa_idxset_string_hash_func, pa_idxset_string_compare_func);
 | 
			
		||||
 | 
			
		||||
    pa_message_handler_register(c, "/core", "Core message handler", core_message_handler, (void *) c);
 | 
			
		||||
 | 
			
		||||
    c->default_source = NULL;
 | 
			
		||||
    c->default_sink = NULL;
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			@ -202,6 +245,8 @@ static void core_free(pa_object *o) {
 | 
			
		|||
    pa_assert(pa_hashmap_isempty(c->shared));
 | 
			
		||||
    pa_hashmap_free(c->shared);
 | 
			
		||||
 | 
			
		||||
    pa_message_handler_unregister(c, "/core");
 | 
			
		||||
 | 
			
		||||
    pa_assert(pa_hashmap_isempty(c->message_handlers));
 | 
			
		||||
    pa_hashmap_free(c->message_handlers);
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue