code.delx.au - pulseaudio/blob - 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 #include <pulse/timeval.h>
  33
  34 #include <pulsecore/module.h>
  35 #include <pulsecore/client.h>
  36 #include <pulsecore/sink.h>
  37 #include <pulsecore/source.h>
  38 #include <pulsecore/sink-input.h>
  39 #include <pulsecore/source-output.h>
  40 #include <pulsecore/strbuf.h>
  41 #include <pulsecore/sample-util.h>
  42 #include <pulsecore/core-scache.h>
  43 #include <pulsecore/autoload.h>
  44 #include <pulsecore/macro.h>
  45 #include <pulsecore/core-util.h>
  46
  47 #include "cli-text.h"
  48
  49 char *pa_module_list_to_string(pa_core *c) {
  50     pa_strbuf *s;
  51     pa_module *m;
  52     uint32_t idx = PA_IDXSET_INVALID;
  53     pa_assert(c);
  54
  55     s = pa_strbuf_new();
  56
  57     pa_strbuf_printf(s, "%u module(s) loaded.\n", pa_idxset_size(c->modules));
  58
  59     for (m = pa_idxset_first(c->modules, &idx); m; m = pa_idxset_next(c->modules, &idx)) {
  60         pa_strbuf_printf(s, "    index: %u\n"
  61                          "\tname: <%s>\n"
  62                          "\targument: <%s>\n"
  63                          "\tused: %i\n"
  64                          "\tauto unload: %s\n",
  65                          m->index, m->name, m->argument ? m->argument : "", m->n_used,
  66                          pa_yes_no(m->auto_unload));
  67     }
  68
  69     return pa_strbuf_tostring_free(s);
  70 }
  71
  72 char *pa_client_list_to_string(pa_core *c) {
  73     pa_strbuf *s;
  74     pa_client *client;
  75     uint32_t idx = PA_IDXSET_INVALID;
  76     pa_assert(c);
  77
  78     s = pa_strbuf_new();
  79
  80     pa_strbuf_printf(s, "%u client(s) logged in.\n", pa_idxset_size(c->clients));
  81
  82     for (client = pa_idxset_first(c->clients, &idx); client; client = pa_idxset_next(c->clients, &idx)) {
  83         char *t;
  84         pa_strbuf_printf(
  85                 s,
  86                 "    index: %u\n"
  87                 "\tdriver: <%s>\n",
  88                 client->index,
  89                 client->driver);
  90
  91         if (client->module)
  92             pa_strbuf_printf(s, "\towner module: %u\n", client->module->index);
  93
  94         t = pa_proplist_to_string(client->proplist);
  95         pa_strbuf_printf(s, "\tproperties:\n%s", t);
  96         pa_xfree(t);
  97     }
  98
  99     return pa_strbuf_tostring_free(s);
 100 }
 101
 102 char *pa_sink_list_to_string(pa_core *c) {
 103     pa_strbuf *s;
 104     pa_sink *sink;
 105     uint32_t idx = PA_IDXSET_INVALID;
 106     static const char* const state_table[] = {
 107         [PA_SINK_INIT] = "INIT",
 108         [PA_SINK_RUNNING] = "RUNNING",
 109         [PA_SINK_SUSPENDED] = "SUSPENDED",
 110         [PA_SINK_IDLE] = "IDLE",
 111         [PA_SINK_UNLINKED] = "UNLINKED"
 112     };
 113     pa_assert(c);
 114
 115     s = pa_strbuf_new();
 116
 117     pa_strbuf_printf(s, "%u sink(s) available.\n", pa_idxset_size(c->sinks));
 118
 119     for (sink = pa_idxset_first(c->sinks, &idx); sink; sink = pa_idxset_next(c->sinks, &idx)) {
 120         char ss[PA_SAMPLE_SPEC_SNPRINT_MAX], cv[PA_CVOLUME_SNPRINT_MAX], cm[PA_CHANNEL_MAP_SNPRINT_MAX], *t;
 121
 122         pa_strbuf_printf(
 123             s,
 124             "  %c index: %u\n"
 125             "\tname: <%s>\n"
 126             "\tdriver: <%s>\n"
 127             "\tflags: %s%s%s%s%s%s\n"
 128             "\tstate: %s\n"
 129             "\tvolume: %s\n"
 130             "\tmuted: %s\n"
 131             "\tcurrent latency: %0.2f ms\n"
 132             "\tconfigured latency: %0.2f ms; range is %0.2f .. %0.2f ms\n"
 133             "\tmonitor source: %u\n"
 134             "\tsample spec: %s\n"
 135             "\tchannel map: %s\n"
 136             "\tused by: %u\n"
 137             "\tlinked by: %u\n",
 138             c->default_sink_name && !strcmp(sink->name, c->default_sink_name) ? '*' : ' ',
 139             sink->index,
 140             sink->name,
 141             sink->driver,
 142             sink->flags & PA_SINK_HARDWARE ? "HARDWARE " : "",
 143             sink->flags & PA_SINK_NETWORK ? "NETWORK " : "",
 144             sink->flags & PA_SINK_HW_MUTE_CTRL ? "HW_MUTE_CTRL " : "",
 145             sink->flags & PA_SINK_HW_VOLUME_CTRL ? "HW_VOLUME_CTRL " : "",
 146             sink->flags & PA_SINK_DECIBEL_VOLUME ? "DECIBEL_VOLUME " : "",
 147             sink->flags & PA_SINK_LATENCY ? "LATENCY " : "",
 148             state_table[pa_sink_get_state(sink)],
 149             pa_cvolume_snprint(cv, sizeof(cv), pa_sink_get_volume(sink)),
 150             pa_yes_no(pa_sink_get_mute(sink)),
 151             (double) pa_sink_get_latency(sink) / PA_USEC_PER_MSEC,
 152             (double) pa_sink_get_requested_latency(sink) / PA_USEC_PER_MSEC, (double) sink->min_latency / PA_USEC_PER_MSEC, (double) sink->max_latency / PA_USEC_PER_MSEC,
 153             sink->monitor_source ? sink->monitor_source->index : PA_INVALID_INDEX,
 154             pa_sample_spec_snprint(ss, sizeof(ss), &sink->sample_spec),
 155             pa_channel_map_snprint(cm, sizeof(cm), &sink->channel_map),
 156             pa_sink_used_by(sink),
 157             pa_sink_linked_by(sink));
 158
 159         if (sink->module)
 160             pa_strbuf_printf(s, "\tmodule: %u\n", sink->module->index);
 161
 162         t = pa_proplist_to_string(sink->proplist);
 163         pa_strbuf_printf(s, "\tproperties:\n%s", t);
 164         pa_xfree(t);
 165     }
 166
 167     return pa_strbuf_tostring_free(s);
 168 }
 169
 170 char *pa_source_list_to_string(pa_core *c) {
 171     pa_strbuf *s;
 172     pa_source *source;
 173     uint32_t idx = PA_IDXSET_INVALID;
 174     static const char* const state_table[] = {
 175         [PA_SOURCE_INIT] = "INIT",
 176         [PA_SOURCE_RUNNING] = "RUNNING",
 177         [PA_SOURCE_SUSPENDED] = "SUSPENDED",
 178         [PA_SOURCE_IDLE] = "IDLE",
 179         [PA_SOURCE_UNLINKED] = "UNLINKED"
 180     };
 181     pa_assert(c);
 182
 183     s = pa_strbuf_new();
 184
 185     pa_strbuf_printf(s, "%u source(s) available.\n", pa_idxset_size(c->sources));
 186
 187     for (source = pa_idxset_first(c->sources, &idx); source; source = pa_idxset_next(c->sources, &idx)) {
 188         char ss[PA_SAMPLE_SPEC_SNPRINT_MAX], cm[PA_CHANNEL_MAP_SNPRINT_MAX], cv[PA_CVOLUME_SNPRINT_MAX], *t;
 189
 190         pa_strbuf_printf(
 191             s,
 192             "  %c index: %u\n"
 193             "\tname: <%s>\n"
 194             "\tdriver: <%s>\n"
 195             "\tflags: %s%s%s%s%s%s\n"
 196             "\tstate: %s\n"
 197             "\tvolume: %s\n"
 198             "\tmuted: %s\n"
 199             "\tcurrent latency: %0.2f ms\n"
 200             "\tconfigured latency: %0.2f ms; range is %0.2f .. %0.2f ms\n"
 201             "\tsample spec: %s\n"
 202             "\tchannel map: %s\n"
 203             "\tused by: %u\n"
 204             "\tlinked by: %u\n",
 205             c->default_source_name && !strcmp(source->name, c->default_source_name) ? '*' : ' ',
 206             source->index,
 207             source->name,
 208             source->driver,
 209             source->flags & PA_SOURCE_HARDWARE ? "HARDWARE " : "",
 210             source->flags & PA_SOURCE_NETWORK ? "NETWORK " : "",
 211             source->flags & PA_SOURCE_HW_MUTE_CTRL ? "HW_MUTE_CTRL " : "",
 212             source->flags & PA_SOURCE_HW_VOLUME_CTRL ? "HW_VOLUME_CTRL " : "",
 213             source->flags & PA_SOURCE_DECIBEL_VOLUME ? "DECIBEL_VOLUME " : "",
 214             source->flags & PA_SOURCE_LATENCY ? "LATENCY " : "",
 215             state_table[pa_source_get_state(source)],
 216             pa_cvolume_snprint(cv, sizeof(cv), pa_source_get_volume(source)),
 217             pa_yes_no(pa_source_get_mute(source)),
 218             (double) pa_source_get_latency(source) / PA_USEC_PER_MSEC,
 219             (double) pa_source_get_requested_latency(source) / PA_USEC_PER_MSEC, (double) source->min_latency / PA_USEC_PER_MSEC, (double) source->max_latency / PA_USEC_PER_MSEC,
 220             pa_sample_spec_snprint(ss, sizeof(ss), &source->sample_spec),
 221             pa_channel_map_snprint(cm, sizeof(cm), &source->channel_map),
 222             pa_source_used_by(source),
 223             pa_source_linked_by(source));
 224
 225         if (source->monitor_of)
 226             pa_strbuf_printf(s, "\tmonitor_of: %u\n", source->monitor_of->index);
 227         if (source->module)
 228             pa_strbuf_printf(s, "\tmodule: %u\n", source->module->index);
 229
 230         t = pa_proplist_to_string(source->proplist);
 231         pa_strbuf_printf(s, "\tproperties:\n%s", t);
 232         pa_xfree(t);
 233     }
 234
 235     return pa_strbuf_tostring_free(s);
 236 }
 237
 238
 239 char *pa_source_output_list_to_string(pa_core *c) {
 240     pa_strbuf *s;
 241     pa_source_output *o;
 242     uint32_t idx = PA_IDXSET_INVALID;
 243     static const char* const state_table[] = {
 244         [PA_SOURCE_OUTPUT_INIT] = "INIT",
 245         [PA_SOURCE_OUTPUT_RUNNING] = "RUNNING",
 246         [PA_SOURCE_OUTPUT_CORKED] = "CORKED",
 247         [PA_SOURCE_OUTPUT_UNLINKED] = "UNLINKED"
 248     };
 249     pa_assert(c);
 250
 251     s = pa_strbuf_new();
 252
 253     pa_strbuf_printf(s, "%u source outputs(s) available.\n", pa_idxset_size(c->source_outputs));
 254
 255     for (o = pa_idxset_first(c->source_outputs, &idx); o; o = pa_idxset_next(c->source_outputs, &idx)) {
 256         char ss[PA_SAMPLE_SPEC_SNPRINT_MAX], cm[PA_CHANNEL_MAP_SNPRINT_MAX], *t, clt[28];
 257         pa_usec_t cl;
 258
 259         if ((cl = pa_source_output_get_requested_latency(o)) == (pa_usec_t) -1)
 260             pa_snprintf(clt, sizeof(clt), "n/a");
 261         else
 262             pa_snprintf(clt, sizeof(clt), "%0.2f ms", (double) cl / PA_USEC_PER_MSEC);
 263
 264         pa_assert(o->source);
 265
 266         pa_strbuf_printf(
 267             s,
 268             "    index: %u\n"
 269             "\tdriver: <%s>\n"
 270             "\tflags: %s%s%s%s%s%s%s%s\n"
 271             "\tstate: %s\n"
 272             "\tsource: %u <%s>\n"
 273             "\tcurrent latency: %0.2f ms\n"
 274             "\trequested latency: %s\n"
 275             "\tsample spec: %s\n"
 276             "\tchannel map: %s\n"
 277             "\tresample method: %s\n",
 278             o->index,
 279             o->driver,
 280             o->flags & PA_SOURCE_OUTPUT_VARIABLE_RATE ? "VARIABLE_RATE " : "",
 281             o->flags & PA_SOURCE_OUTPUT_DONT_MOVE ? "DONT_MOVE " : "",
 282             o->flags & PA_SOURCE_OUTPUT_START_CORKED ? "START_CORKED " : "",
 283             o->flags & PA_SOURCE_OUTPUT_NO_REMAP ? "NO_REMAP " : "",
 284             o->flags & PA_SOURCE_OUTPUT_NO_REMIX ? "NO_REMIX " : "",
 285             o->flags & PA_SOURCE_OUTPUT_FIX_FORMAT ? "FIX_FORMAT " : "",
 286             o->flags & PA_SOURCE_OUTPUT_FIX_RATE ? "FIX_RATE " : "",
 287             o->flags & PA_SOURCE_OUTPUT_FIX_CHANNELS ? "FIX_CHANNELS " : "",
 288             state_table[pa_source_output_get_state(o)],
 289             o->source->index, o->source->name,
 290             (double) pa_source_output_get_latency(o) / PA_USEC_PER_MSEC,
 291             clt,
 292             pa_sample_spec_snprint(ss, sizeof(ss), &o->sample_spec),
 293             pa_channel_map_snprint(cm, sizeof(cm), &o->channel_map),
 294             pa_resample_method_to_string(pa_source_output_get_resample_method(o)));
 295         if (o->module)
 296             pa_strbuf_printf(s, "\towner module: %u\n", o->module->index);
 297         if (o->client)
 298             pa_strbuf_printf(s, "\tclient: %u <%s>\n", o->client->index, pa_strnull(pa_proplist_gets(o->client->proplist, PA_PROP_APPLICATION_NAME)));
 299
 300         t = pa_proplist_to_string(o->proplist);
 301         pa_strbuf_printf(s, "\tproperties:\n%s", t);
 302         pa_xfree(t);
 303     }
 304
 305     return pa_strbuf_tostring_free(s);
 306 }
 307
 308 char *pa_sink_input_list_to_string(pa_core *c) {
 309     pa_strbuf *s;
 310     pa_sink_input *i;
 311     uint32_t idx = PA_IDXSET_INVALID;
 312     static const char* const state_table[] = {
 313         [PA_SINK_INPUT_INIT] = "INIT",
 314         [PA_SINK_INPUT_RUNNING] = "RUNNING",
 315         [PA_SINK_INPUT_DRAINED] = "DRAINED",
 316         [PA_SINK_INPUT_CORKED] = "CORKED",
 317         [PA_SINK_INPUT_UNLINKED] = "UNLINKED"
 318     };
 319
 320     pa_assert(c);
 321     s = pa_strbuf_new();
 322
 323     pa_strbuf_printf(s, "%u sink input(s) available.\n", pa_idxset_size(c->sink_inputs));
 324
 325     for (i = pa_idxset_first(c->sink_inputs, &idx); i; i = pa_idxset_next(c->sink_inputs, &idx)) {
 326         char ss[PA_SAMPLE_SPEC_SNPRINT_MAX], cv[PA_CVOLUME_SNPRINT_MAX], cm[PA_CHANNEL_MAP_SNPRINT_MAX], *t, clt[28];
 327         pa_usec_t cl;
 328
 329         if ((cl = pa_sink_input_get_requested_latency(i)) == (pa_usec_t) -1)
 330             pa_snprintf(clt, sizeof(clt), "n/a");
 331         else
 332             pa_snprintf(clt, sizeof(clt), "%0.2f ms", (double) cl / PA_USEC_PER_MSEC);
 333
 334         pa_assert(i->sink);
 335
 336         pa_strbuf_printf(
 337             s,
 338             "    index: %u\n"
 339             "\tdriver: <%s>\n"
 340             "\tflags: %s%s%s%s%s%s%s%s\n"
 341             "\tstate: %s\n"
 342             "\tsink: %u <%s>\n"
 343             "\tvolume: %s\n"
 344             "\tmuted: %s\n"
 345             "\tcurrent latency: %0.2f ms\n"
 346             "\trequested latency: %s\n"
 347             "\tsample spec: %s\n"
 348             "\tchannel map: %s\n"
 349             "\tresample method: %s\n",
 350             i->index,
 351             i->driver,
 352             i->flags & PA_SINK_INPUT_VARIABLE_RATE ? "VARIABLE_RATE " : "",
 353             i->flags & PA_SINK_INPUT_DONT_MOVE ? "DONT_MOVE " : "",
 354             i->flags & PA_SINK_INPUT_START_CORKED ? "START_CORKED " : "",
 355             i->flags & PA_SINK_INPUT_NO_REMAP ? "NO_REMAP " : "",
 356             i->flags & PA_SINK_INPUT_NO_REMIX ? "NO_REMIX " : "",
 357             i->flags & PA_SINK_INPUT_FIX_FORMAT ? "FIX_FORMAT " : "",
 358             i->flags & PA_SINK_INPUT_FIX_RATE ? "FIX_RATE " : "",
 359             i->flags & PA_SINK_INPUT_FIX_CHANNELS ? "FIX_CHANNELS " : "",
 360             state_table[pa_sink_input_get_state(i)],
 361             i->sink->index, i->sink->name,
 362             pa_cvolume_snprint(cv, sizeof(cv), pa_sink_input_get_volume(i)),
 363             pa_yes_no(pa_sink_input_get_mute(i)),
 364             (double) pa_sink_input_get_latency(i) / PA_USEC_PER_MSEC,
 365             clt,
 366             pa_sample_spec_snprint(ss, sizeof(ss), &i->sample_spec),
 367             pa_channel_map_snprint(cm, sizeof(cm), &i->channel_map),
 368             pa_resample_method_to_string(pa_sink_input_get_resample_method(i)));
 369
 370         if (i->module)
 371             pa_strbuf_printf(s, "\tmodule: %u\n", i->module->index);
 372         if (i->client)
 373             pa_strbuf_printf(s, "\tclient: %u <%s>\n", i->client->index, pa_strnull(pa_proplist_gets(i->client->proplist, PA_PROP_APPLICATION_NAME)));
 374
 375         t = pa_proplist_to_string(i->proplist);
 376         pa_strbuf_printf(s, "\tproperties:\n%s", t);
 377         pa_xfree(t);
 378     }
 379
 380     return pa_strbuf_tostring_free(s);
 381 }
 382
 383 char *pa_scache_list_to_string(pa_core *c) {
 384     pa_strbuf *s;
 385     pa_assert(c);
 386
 387     s = pa_strbuf_new();
 388
 389     pa_strbuf_printf(s, "%u cache entries available.\n", c->scache ? pa_idxset_size(c->scache) : 0);
 390
 391     if (c->scache) {
 392         pa_scache_entry *e;
 393         uint32_t idx = PA_IDXSET_INVALID;
 394
 395         for (e = pa_idxset_first(c->scache, &idx); e; e = pa_idxset_next(c->scache, &idx)) {
 396             double l = 0;
 397             char ss[PA_SAMPLE_SPEC_SNPRINT_MAX] = "n/a", cv[PA_CVOLUME_SNPRINT_MAX], cm[PA_CHANNEL_MAP_SNPRINT_MAX] = "n/a", *t;
 398
 399             if (e->memchunk.memblock) {
 400                 pa_sample_spec_snprint(ss, sizeof(ss), &e->sample_spec);
 401                 pa_channel_map_snprint(cm, sizeof(cm), &e->channel_map);
 402                 l = (double) e->memchunk.length / pa_bytes_per_second(&e->sample_spec);
 403             }
 404
 405             pa_strbuf_printf(
 406                 s,
 407                 "    name: <%s>\n"
 408                 "\tindex: %u\n"
 409                 "\tsample spec: %s\n"
 410                 "\tchannel map: %s\n"
 411                 "\tlength: %lu\n"
 412                 "\tduration: %0.1f s\n"
 413                 "\tvolume: %s\n"
 414                 "\tlazy: %s\n"
 415                 "\tfilename: <%s>\n",
 416                 e->name,
 417                 e->index,
 418                 ss,
 419                 cm,
 420                 (long unsigned)(e->memchunk.memblock ? e->memchunk.length : 0),
 421                 l,
 422                 pa_cvolume_snprint(cv, sizeof(cv), &e->volume),
 423                 pa_yes_no(e->lazy),
 424                 e->filename ? e->filename : "n/a");
 425
 426             t = pa_proplist_to_string(e->proplist);
 427             pa_strbuf_printf(s, "\tproperties:\n%s", t);
 428             pa_xfree(t);
 429         }
 430     }
 431
 432     return pa_strbuf_tostring_free(s);
 433 }
 434
 435 char *pa_autoload_list_to_string(pa_core *c) {
 436     pa_strbuf *s;
 437     pa_assert(c);
 438
 439     s = pa_strbuf_new();
 440
 441     pa_strbuf_printf(s, "%u autoload entries available.\n", c->autoload_hashmap ? pa_hashmap_size(c->autoload_hashmap) : 0);
 442
 443     if (c->autoload_hashmap) {
 444         pa_autoload_entry *e;
 445         void *state = NULL;
 446
 447         while ((e = pa_hashmap_iterate(c->autoload_hashmap, &state, NULL))) {
 448             pa_strbuf_printf(
 449                 s,
 450                 "    name: <%s>\n"
 451                 "\ttype: %s\n"
 452                 "\tindex: %u\n"
 453                 "\tmodule_name: <%s>\n"
 454                 "\targuments: <%s>\n",
 455                 e->name,
 456                 e->type == PA_NAMEREG_SOURCE ? "source" : "sink",
 457                 e->index,
 458                 e->module,
 459                 e->argument ? e->argument : "");
 460
 461         }
 462     }
 463
 464     return pa_strbuf_tostring_free(s);
 465 }
 466
 467 char *pa_full_status_string(pa_core *c) {
 468     pa_strbuf *s;
 469     int i;
 470
 471     s = pa_strbuf_new();
 472
 473     for (i = 0; i < 8; i++) {
 474         char *t = NULL;
 475
 476         switch (i) {
 477             case 0:
 478                 t = pa_sink_list_to_string(c);
 479                 break;
 480             case 1:
 481                 t = pa_source_list_to_string(c);
 482                 break;
 483             case 2:
 484                 t = pa_sink_input_list_to_string(c);
 485                 break;
 486             case 3:
 487                 t = pa_source_output_list_to_string(c);
 488                 break;
 489             case 4:
 490                 t = pa_client_list_to_string(c);
 491                 break;
 492             case 5:
 493                 t = pa_module_list_to_string(c);
 494                 break;
 495             case 6:
 496                 t = pa_scache_list_to_string(c);
 497                 break;
 498             case 7:
 499                 t = pa_autoload_list_to_string(c);
 500                 break;
 501         }
 502
 503         pa_strbuf_puts(s, t);
 504         pa_xfree(t);
 505     }
 506
 507     return pa_strbuf_tostring_free(s);
 508 }