src/pulsecore/cli-text.c

   1 /* $Id$ */
   2
   3 /***
   4   This file is part of PulseAudio.
   5
   6   Copyright 2004-2006 Lennart Poettering
   7
   8   PulseAudio is free software; you can redistribute it and/or modify
   9   it under the terms of the GNU Lesser General Public License as published
  10   by the Free Software Foundation; either version 2 of the License,
  11   or (at your option) any later version.
  12
  13   PulseAudio is distributed in the hope that it will be useful, but
  14   WITHOUT ANY WARRANTY; without even the implied warranty of
  15   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  16   General Public License for more details.
  17
  18   You should have received a copy of the GNU Lesser General Public License
  19   along with PulseAudio; if not, write to the Free Software
  20   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  21   USA.
  22 ***/
  23
  24 #ifdef HAVE_CONFIG_H
  25 #include <config.h>
  26 #endif
  27
  28 #include <string.h>
  29
  30 #include <pulse/volume.h>
  31 #include <pulse/xmalloc.h>
  32
  33 #include <pulsecore/module.h>
  34 #include <pulsecore/client.h>
  35 #include <pulsecore/sink.h>
  36 #include <pulsecore/source.h>
  37 #include <pulsecore/sink-input.h>
  38 #include <pulsecore/source-output.h>
  39 #include <pulsecore/strbuf.h>
  40 #include <pulsecore/sample-util.h>
  41 #include <pulsecore/core-scache.h>
  42 #include <pulsecore/autoload.h>
  43 #include <pulsecore/macro.h>
  44
  45 #include "cli-text.h"
  46
  47 char *pa_module_list_to_string(pa_core *c) {
  48     pa_strbuf *s;
  49     pa_module *m;
  50     uint32_t idx = PA_IDXSET_INVALID;
  51     pa_assert(c);
  52
  53     s = pa_strbuf_new();
  54
  55     pa_strbuf_printf(s, "%u module(s) loaded.\n", pa_idxset_size(c->modules));
  56
  57     for (m = pa_idxset_first(c->modules, &idx); m; m = pa_idxset_next(c->modules, &idx)) {
  58         pa_strbuf_printf(s, "    index: %u\n"
  59             "\tname: <%s>\n"
  60             "\targument: <%s>\n"
  61             "\tused: %i\n"
  62             "\tauto unload: %s\n",
  63             m->index, m->name, m->argument ? m->argument : "", m->n_used,
  64             m->auto_unload ? "yes" : "no");
  65     }
  66
  67     return pa_strbuf_tostring_free(s);
  68 }
  69
  70 char *pa_client_list_to_string(pa_core *c) {
  71     pa_strbuf *s;
  72     pa_client *client;
  73     uint32_t idx = PA_IDXSET_INVALID;
  74     pa_assert(c);
  75
  76     s = pa_strbuf_new();
  77
  78     pa_strbuf_printf(s, "%u client(s) logged in.\n", pa_idxset_size(c->clients));
  79
  80     for (client = pa_idxset_first(c->clients, &idx); client; client = pa_idxset_next(c->clients, &idx)) {
  81         pa_strbuf_printf(s, "    index: %u\n\tname: <%s>\n\tdriver: <%s>\n", client->index, client->name, client->driver);
  82
  83         if (client->owner)
  84             pa_strbuf_printf(s, "\towner module: <%u>\n", client->owner->index);
  85     }
  86
  87     return pa_strbuf_tostring_free(s);
  88 }
  89
  90 char *pa_sink_list_to_string(pa_core *c) {
  91     pa_strbuf *s;
  92     pa_sink *sink;
  93     uint32_t idx = PA_IDXSET_INVALID;
  94     static const char* const state_table[] = {
  95         [PA_SINK_RUNNING] = "RUNNING",
  96         [PA_SINK_SUSPENDED] = "SUSPENDED",
  97         [PA_SINK_IDLE] = "IDLE",
  98         [PA_SINK_UNLINKED] = "UNLINKED"
  99     };
 100     pa_assert(c);
 101
 102     s = pa_strbuf_new();
 103
 104     pa_strbuf_printf(s, "%u sink(s) available.\n", pa_idxset_size(c->sinks));
 105
 106     for (sink = pa_idxset_first(c->sinks, &idx); sink; sink = pa_idxset_next(c->sinks, &idx)) {
 107         char ss[PA_SAMPLE_SPEC_SNPRINT_MAX], cv[PA_CVOLUME_SNPRINT_MAX], cm[PA_CHANNEL_MAP_SNPRINT_MAX];
 108
 109         pa_strbuf_printf(
 110             s,
 111             "  %c index: %u\n"
 112             "\tname: <%s>\n"
 113             "\tdriver: <%s>\n"
 114             "\tflags: %s%s%s%s\n"
 115             "\tstate: %s\n"
 116             "\tvolume: <%s>\n"
 117             "\tmute: <%i>\n"
 118             "\tlatency: <%0.0f usec>\n"
 119             "\tmonitor source: <%u>\n"
 120             "\tsample spec: <%s>\n"
 121             "\tchannel map: <%s>\n"
 122             "\tused by: <%u>\n"
 123             "\tlinked by: <%u>\n",
 124             c->default_sink_name && !strcmp(sink->name, c->default_sink_name) ? '*' : ' ',
 125             sink->index,
 126             sink->name,
 127             sink->driver,
 128             sink->flags & PA_SINK_HW_VOLUME_CTRL ? "HW_VOLUME_CTRL " : "",
 129             sink->flags & PA_SINK_LATENCY ? "LATENCY " : "",
 130             sink->flags & PA_SINK_HARDWARE ? "HARDWARE " : "",
 131             sink->flags & PA_SINK_NETWORK ? "NETWORK " : "",
 132             state_table[pa_sink_get_state(sink)],
 133             pa_cvolume_snprint(cv, sizeof(cv), pa_sink_get_volume(sink)),
 134             !!pa_sink_get_mute(sink),
 135             (double) pa_sink_get_latency(sink),
 136             sink->monitor_source ? sink->monitor_source->index : PA_INVALID_INDEX,
 137             pa_sample_spec_snprint(ss, sizeof(ss), &sink->sample_spec),
 138             pa_channel_map_snprint(cm, sizeof(cm), &sink->channel_map),
 139             pa_sink_used_by(sink),
 140             pa_sink_linked_by(sink));
 141
 142         if (sink->module)
 143             pa_strbuf_printf(s, "\tmodule: <%u>\n", sink->module->index);
 144         if (sink->description)
 145             pa_strbuf_printf(s, "\tdescription: <%s>\n", sink->description);
 146     }
 147
 148     return pa_strbuf_tostring_free(s);
 149 }
 150
 151 char *pa_source_list_to_string(pa_core *c) {
 152     pa_strbuf *s;
 153     pa_source *source;
 154     uint32_t idx = PA_IDXSET_INVALID;
 155     static const char* const state_table[] = {
 156         [PA_SOURCE_RUNNING] = "RUNNING",
 157         [PA_SOURCE_SUSPENDED] = "SUSPENDED",
 158         [PA_SOURCE_IDLE] = "IDLE",
 159         [PA_SOURCE_UNLINKED] = "UNLINKED"
 160     };
 161     pa_assert(c);
 162
 163     s = pa_strbuf_new();
 164
 165     pa_strbuf_printf(s, "%u source(s) available.\n", pa_idxset_size(c->sources));
 166
 167     for (source = pa_idxset_first(c->sources, &idx); source; source = pa_idxset_next(c->sources, &idx)) {
 168         char ss[PA_SAMPLE_SPEC_SNPRINT_MAX], cm[PA_CHANNEL_MAP_SNPRINT_MAX], cv[PA_CVOLUME_SNPRINT_MAX];
 169
 170
 171         pa_strbuf_printf(
 172             s,
 173             "  %c index: %u\n"
 174             "\tname: <%s>\n"
 175             "\tdriver: <%s>\n"
 176             "\tflags: %s%s%s%s\n"
 177             "\tstate: %s\n"
 178             "\tvolume: <%s>\n"
 179             "\tmute: <%u>\n"
 180             "\tlatency: <%0.0f usec>\n"
 181             "\tsample spec: <%s>\n"
 182             "\tchannel map: <%s>\n"
 183             "\tused by: <%u>\n"
 184             "\tlinked by: <%u>\n",
 185             c->default_source_name && !strcmp(source->name, c->default_source_name) ? '*' : ' ',
 186             source->index,
 187             source->name,
 188             source->driver,
 189             source->flags & PA_SOURCE_HW_VOLUME_CTRL ? "HW_VOLUME_CTRL " : "",
 190             source->flags & PA_SOURCE_LATENCY ? "LATENCY " : "",
 191             source->flags & PA_SOURCE_HARDWARE ? "HARDWARE " : "",
 192             source->flags & PA_SOURCE_NETWORK ? "NETWORK " : "",
 193             state_table[pa_source_get_state(source)],
 194             pa_cvolume_snprint(cv, sizeof(cv), pa_source_get_volume(source)),
 195             !!pa_source_get_mute(source),
 196             (double) pa_source_get_latency(source),
 197             pa_sample_spec_snprint(ss, sizeof(ss), &source->sample_spec),
 198             pa_channel_map_snprint(cm, sizeof(cm), &source->channel_map),
 199             pa_source_used_by(source),
 200             pa_source_linked_by(source));
 201
 202         if (source->monitor_of)
 203             pa_strbuf_printf(s, "\tmonitor_of: <%u>\n", source->monitor_of->index);
 204         if (source->module)
 205             pa_strbuf_printf(s, "\tmodule: <%u>\n", source->module->index);
 206         if (source->description)
 207             pa_strbuf_printf(s, "\tdescription: <%s>\n", source->description);
 208     }
 209
 210     return pa_strbuf_tostring_free(s);
 211 }
 212
 213
 214 char *pa_source_output_list_to_string(pa_core *c) {
 215     pa_strbuf *s;
 216     pa_source_output *o;
 217     uint32_t idx = PA_IDXSET_INVALID;
 218     static const char* const state_table[] = {
 219         [PA_SOURCE_OUTPUT_RUNNING] = "RUNNING",
 220         [PA_SOURCE_OUTPUT_CORKED] = "CORKED",
 221         [PA_SOURCE_OUTPUT_UNLINKED] = "UNLINKED"
 222     };
 223     pa_assert(c);
 224
 225     s = pa_strbuf_new();
 226
 227     pa_strbuf_printf(s, "%u source outputs(s) available.\n", pa_idxset_size(c->source_outputs));
 228
 229     for (o = pa_idxset_first(c->source_outputs, &idx); o; o = pa_idxset_next(c->source_outputs, &idx)) {
 230         char ss[PA_SAMPLE_SPEC_SNPRINT_MAX], cm[PA_CHANNEL_MAP_SNPRINT_MAX];
 231
 232         pa_assert(o->source);
 233
 234         pa_strbuf_printf(
 235             s,
 236             "    index: %u\n"
 237             "\tname: '%s'\n"
 238             "\tdriver: <%s>\n"
 239             "\tflags: %s%s\n"
 240             "\tstate: %s\n"
 241             "\tsource: <%u> '%s'\n"
 242             "\tlatency: <%0.0f usec>\n"
 243             "\tsample spec: <%s>\n"
 244             "\tchannel map: <%s>\n"
 245             "\tresample method: %s\n",
 246             o->index,
 247             o->name,
 248             o->driver,
 249             o->flags & PA_SOURCE_OUTPUT_VARIABLE_RATE ? "VARIABLE_RATE " : "",
 250             o->flags & PA_SOURCE_OUTPUT_DONT_MOVE ? "DONT_MOVE " : "",
 251             state_table[pa_source_output_get_state(o)],
 252             o->source->index, o->source->name,
 253             (double) pa_source_output_get_latency(o),
 254             pa_sample_spec_snprint(ss, sizeof(ss), &o->sample_spec),
 255             pa_channel_map_snprint(cm, sizeof(cm), &o->channel_map),
 256             pa_resample_method_to_string(pa_source_output_get_resample_method(o)));
 257         if (o->module)
 258             pa_strbuf_printf(s, "\towner module: <%u>\n", o->module->index);
 259         if (o->client)
 260             pa_strbuf_printf(s, "\tclient: <%u> '%s'\n", o->client->index, o->client->name);
 261     }
 262
 263     return pa_strbuf_tostring_free(s);
 264 }
 265
 266 char *pa_sink_input_list_to_string(pa_core *c) {
 267     pa_strbuf *s;
 268     pa_sink_input *i;
 269     uint32_t idx = PA_IDXSET_INVALID;
 270     static const char* const state_table[] = {
 271         [PA_SINK_INPUT_RUNNING] = "RUNNING",
 272         [PA_SINK_INPUT_DRAINED] = "DRAINED",
 273         [PA_SINK_INPUT_CORKED] = "CORKED",
 274         [PA_SINK_INPUT_UNLINKED] = "UNLINKED"
 275     };
 276
 277     pa_assert(c);
 278     s = pa_strbuf_new();
 279
 280     pa_strbuf_printf(s, "%u sink input(s) available.\n", pa_idxset_size(c->sink_inputs));
 281
 282     for (i = pa_idxset_first(c->sink_inputs, &idx); i; i = pa_idxset_next(c->sink_inputs, &idx)) {
 283         char ss[PA_SAMPLE_SPEC_SNPRINT_MAX], cv[PA_CVOLUME_SNPRINT_MAX], cm[PA_CHANNEL_MAP_SNPRINT_MAX];
 284
 285         pa_assert(i->sink);
 286
 287         pa_strbuf_printf(
 288             s,
 289             "    index: %u\n"
 290             "\tname: <%s>\n"
 291             "\tdriver: <%s>\n"
 292             "\tflags: %s%s\n"
 293             "\tstate: %s\n"
 294             "\tsink: <%u> '%s'\n"
 295             "\tvolume: <%s>\n"
 296             "\tmute: <%i>\n"
 297             "\tlatency: <%0.0f usec>\n"
 298             "\tsample spec: <%s>\n"
 299             "\tchannel map: <%s>\n"
 300             "\tresample method: %s\n",
 301             i->index,
 302             i->name,
 303             i->driver,
 304             i->flags & PA_SINK_INPUT_VARIABLE_RATE ? "VARIABLE_RATE " : "",
 305             i->flags & PA_SINK_INPUT_DONT_MOVE ? "DONT_MOVE " : "",
 306             state_table[pa_sink_input_get_state(i)],
 307             i->sink->index, i->sink->name,
 308             pa_cvolume_snprint(cv, sizeof(cv), pa_sink_input_get_volume(i)),
 309             !!pa_sink_input_get_mute(i),
 310             (double) pa_sink_input_get_latency(i),
 311             pa_sample_spec_snprint(ss, sizeof(ss), &i->sample_spec),
 312             pa_channel_map_snprint(cm, sizeof(cm), &i->channel_map),
 313             pa_resample_method_to_string(pa_sink_input_get_resample_method(i)));
 314
 315         if (i->module)
 316             pa_strbuf_printf(s, "\tmodule: <%u>\n", i->module->index);
 317         if (i->client)
 318             pa_strbuf_printf(s, "\tclient: <%u> '%s'\n", i->client->index, i->client->name);
 319     }
 320
 321     return pa_strbuf_tostring_free(s);
 322 }
 323
 324 char *pa_scache_list_to_string(pa_core *c) {
 325     pa_strbuf *s;
 326     pa_assert(c);
 327
 328     s = pa_strbuf_new();
 329
 330     pa_strbuf_printf(s, "%u cache entries available.\n", c->scache ? pa_idxset_size(c->scache) : 0);
 331
 332     if (c->scache) {
 333         pa_scache_entry *e;
 334         uint32_t idx = PA_IDXSET_INVALID;
 335
 336         for (e = pa_idxset_first(c->scache, &idx); e; e = pa_idxset_next(c->scache, &idx)) {
 337             double l = 0;
 338             char ss[PA_SAMPLE_SPEC_SNPRINT_MAX] = "n/a", cv[PA_CVOLUME_SNPRINT_MAX], cm[PA_CHANNEL_MAP_SNPRINT_MAX] = "n/a";
 339
 340             if (e->memchunk.memblock) {
 341                 pa_sample_spec_snprint(ss, sizeof(ss), &e->sample_spec);
 342                 pa_channel_map_snprint(cm, sizeof(cm), &e->channel_map);
 343                 l = (double) e->memchunk.length / pa_bytes_per_second(&e->sample_spec);
 344             }
 345
 346             pa_strbuf_printf(
 347                 s,
 348                 "    name: <%s>\n"
 349                 "\tindex: <%u>\n"
 350                 "\tsample spec: <%s>\n"
 351                 "\tchannel map: <%s>\n"
 352                 "\tlength: <%lu>\n"
 353                 "\tduration: <%0.1fs>\n"
 354                 "\tvolume: <%s>\n"
 355                 "\tlazy: %s\n"
 356                 "\tfilename: %s\n",
 357                 e->name,
 358                 e->index,
 359                 ss,
 360                 cm,
 361                 (long unsigned)(e->memchunk.memblock ? e->memchunk.length : 0),
 362                 l,
 363                 pa_cvolume_snprint(cv, sizeof(cv), &e->volume),
 364                 e->lazy ? "yes" : "no",
 365                 e->filename ? e->filename : "n/a");
 366         }
 367     }
 368
 369     return pa_strbuf_tostring_free(s);
 370 }
 371
 372 char *pa_autoload_list_to_string(pa_core *c) {
 373     pa_strbuf *s;
 374     pa_assert(c);
 375
 376     s = pa_strbuf_new();
 377
 378     pa_strbuf_printf(s, "%u autoload entries available.\n", c->autoload_hashmap ? pa_hashmap_size(c->autoload_hashmap) : 0);
 379
 380     if (c->autoload_hashmap) {
 381         pa_autoload_entry *e;
 382         void *state = NULL;
 383
 384         while ((e = pa_hashmap_iterate(c->autoload_hashmap, &state, NULL))) {
 385             pa_strbuf_printf(
 386                 s, "    name: <%s>\n\ttype: <%s>\n\tindex: <%u>\n\tmodule_name: <%s>\n\targuments: <%s>\n",
 387                 e->name,
 388                 e->type == PA_NAMEREG_SOURCE ? "source" : "sink",
 389                 e->index,
 390                 e->module,
 391                 e->argument ? e->argument : "");
 392
 393         }
 394     }
 395
 396     return pa_strbuf_tostring_free(s);
 397 }
 398
 399 char *pa_full_status_string(pa_core *c) {
 400     pa_strbuf *s;
 401     int i;
 402
 403     s = pa_strbuf_new();
 404
 405     for (i = 0; i < 8; i++) {
 406         char *t = NULL;
 407
 408         switch (i) {
 409             case 0:
 410                 t = pa_sink_list_to_string(c);
 411                 break;
 412             case 1:
 413                 t = pa_source_list_to_string(c);
 414                 break;
 415             case 2:
 416                 t = pa_sink_input_list_to_string(c);
 417                 break;
 418             case 3:
 419                 t = pa_source_output_list_to_string(c);
 420                 break;
 421             case 4:
 422                 t = pa_client_list_to_string(c);
 423                 break;
 424             case 5:
 425                 t = pa_module_list_to_string(c);
 426                 break;
 427             case 6:
 428                 t = pa_scache_list_to_string(c);
 429                 break;
 430             case 7:
 431                 t = pa_autoload_list_to_string(c);
 432                 break;
 433         }
 434
 435         pa_strbuf_puts(s, t);
 436         pa_xfree(t);
 437     }
 438
 439     return pa_strbuf_tostring_free(s);
 440 }