4 This file is part of PulseAudio.
6 PulseAudio is free software; you can redistribute it and/or modify
7 it under the terms of the GNU Lesser General Public License as published
8 by the Free Software Foundation; either version 2 of the License,
9 or (at your option) any later version.
11 PulseAudio is distributed in the hope that it will be useful, but
12 WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 General Public License for more details.
16 You should have received a copy of the GNU Lesser General Public License
17 along with PulseAudio; if not, write to the Free Software
18 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
36 #include <pulse/pulseaudio.h>
38 #define TIME_EVENT_USEC 50000
40 #if PA_API_VERSION != 9
41 #error Invalid Polypaudio API version
44 static enum { RECORD, PLAYBACK } mode = PLAYBACK;
46 static pa_context *context = NULL;
47 static pa_stream *stream = NULL;
48 static pa_mainloop_api *mainloop_api = NULL;
50 static void *buffer = NULL;
51 static size_t buffer_length = 0, buffer_index = 0;
53 static pa_io_event* stdio_event = NULL;
55 static char *stream_name = NULL, *client_name = NULL, *device = NULL;
57 static int verbose = 0;
58 static pa_volume_t volume = PA_VOLUME_NORM;
60 static pa_sample_spec sample_spec = {
61 .format = PA_SAMPLE_S16LE,
66 static pa_channel_map channel_map;
67 static int channel_map_set = 0;
69 /* A shortcut for terminating the application */
70 static void quit(int ret) {
72 mainloop_api->quit(mainloop_api, ret);
75 /* Write some data to the stream */
76 static void do_stream_write(size_t length) {
80 if (!buffer || !buffer_length)
84 if (l > buffer_length)
87 if (pa_stream_write(stream, (uint8_t*) buffer + buffer_index, l, NULL, 0, PA_SEEK_RELATIVE) < 0) {
88 fprintf(stderr, "pa_stream_write() failed: %s\n", pa_strerror(pa_context_errno(context)));
99 buffer_index = buffer_length = 0;
103 /* This is called whenever new data may be written to the stream */
104 static void stream_write_callback(pa_stream *s, size_t length, void *userdata) {
108 mainloop_api->io_enable(stdio_event, PA_IO_EVENT_INPUT);
113 do_stream_write(length);
116 /* This is called whenever new data may is available */
117 static void stream_read_callback(pa_stream *s, size_t length, void *userdata) {
122 mainloop_api->io_enable(stdio_event, PA_IO_EVENT_OUTPUT);
124 if (pa_stream_peek(s, &data, &length) < 0) {
125 fprintf(stderr, "pa_stream_peek() failed: %s\n", pa_strerror(pa_context_errno(context)));
130 assert(data && length);
133 fprintf(stderr, "Buffer overrun, dropping incoming data\n");
134 if (pa_stream_drop(s) < 0) {
135 fprintf(stderr, "pa_stream_drop() failed: %s\n", pa_strerror(pa_context_errno(context)));
141 buffer = pa_xmalloc(buffer_length = length);
142 memcpy(buffer, data, length);
147 /* This routine is called whenever the stream state changes */
148 static void stream_state_callback(pa_stream *s, void *userdata) {
151 switch (pa_stream_get_state(s)) {
152 case PA_STREAM_CREATING:
153 case PA_STREAM_TERMINATED:
156 case PA_STREAM_READY:
158 const pa_buffer_attr *a;
160 fprintf(stderr, "Stream successfully created.\n");
162 if (!(a = pa_stream_get_buffer_attr(s)))
163 fprintf(stderr, "pa_stream_get_buffer_attr() failed: %s\n", pa_strerror(pa_context_errno(pa_stream_get_context(s))));
166 if (mode == PLAYBACK)
167 fprintf(stderr, "Buffer metrics: maxlength=%u, tlength=%u, prebuf=%u, minreq=%u\n", a->maxlength, a->tlength, a->prebuf, a->minreq);
169 assert(mode == RECORD);
170 fprintf(stderr, "Buffer metrics: maxlength=%u, fragsize=%u\n", a->maxlength, a->fragsize);
179 case PA_STREAM_FAILED:
181 fprintf(stderr, "Stream error: %s\n", pa_strerror(pa_context_errno(pa_stream_get_context(s))));
186 /* This is called whenever the context status changes */
187 static void context_state_callback(pa_context *c, void *userdata) {
190 switch (pa_context_get_state(c)) {
191 case PA_CONTEXT_CONNECTING:
192 case PA_CONTEXT_AUTHORIZING:
193 case PA_CONTEXT_SETTING_NAME:
196 case PA_CONTEXT_READY: {
199 assert(c && !stream);
202 fprintf(stderr, "Connection established.\n");
204 if (!(stream = pa_stream_new(c, stream_name, &sample_spec, channel_map_set ? &channel_map : NULL))) {
205 fprintf(stderr, "pa_stream_new() failed: %s\n", pa_strerror(pa_context_errno(c)));
209 pa_stream_set_state_callback(stream, stream_state_callback, NULL);
210 pa_stream_set_write_callback(stream, stream_write_callback, NULL);
211 pa_stream_set_read_callback(stream, stream_read_callback, NULL);
213 if (mode == PLAYBACK) {
215 if ((r = pa_stream_connect_playback(stream, device, NULL, 0, pa_cvolume_set(&cv, sample_spec.channels, volume), NULL)) < 0) {
216 fprintf(stderr, "pa_stream_connect_playback() failed: %s\n", pa_strerror(pa_context_errno(c)));
221 if ((r = pa_stream_connect_record(stream, device, NULL, 0)) < 0) {
222 fprintf(stderr, "pa_stream_connect_record() failed: %s\n", pa_strerror(pa_context_errno(c)));
230 case PA_CONTEXT_TERMINATED:
234 case PA_CONTEXT_FAILED:
236 fprintf(stderr, "Connection failure: %s\n", pa_strerror(pa_context_errno(c)));
247 /* Connection draining complete */
248 static void context_drain_complete(pa_context*c, void *userdata) {
249 pa_context_disconnect(c);
252 /* Stream draining complete */
253 static void stream_drain_complete(pa_stream*s, int success, void *userdata) {
257 fprintf(stderr, "Failed to drain stream: %s\n", pa_strerror(pa_context_errno(context)));
262 fprintf(stderr, "Playback stream drained.\n");
264 pa_stream_disconnect(stream);
265 pa_stream_unref(stream);
268 if (!(o = pa_context_drain(context, context_drain_complete, NULL)))
269 pa_context_disconnect(context);
272 fprintf(stderr, "Draining connection to server.\n");
276 /* New data on STDIN **/
277 static void stdin_callback(pa_mainloop_api*a, pa_io_event *e, int fd, pa_io_event_flags_t f, void *userdata) {
280 assert(a == mainloop_api && e && stdio_event == e);
283 mainloop_api->io_enable(stdio_event, PA_IO_EVENT_NULL);
287 if (!stream || pa_stream_get_state(stream) != PA_STREAM_READY || !(l = w = pa_stream_writable_size(stream)))
290 buffer = pa_xmalloc(l);
292 if ((r = read(fd, buffer, l)) <= 0) {
297 fprintf(stderr, "Got EOF.\n");
299 if (!(o = pa_stream_drain(stream, stream_drain_complete, NULL))) {
300 fprintf(stderr, "pa_stream_drain(): %s\n", pa_strerror(pa_context_errno(context)));
305 pa_operation_unref(o);
307 fprintf(stderr, "read() failed: %s\n", strerror(errno));
311 mainloop_api->io_free(stdio_event);
323 /* Some data may be written to STDOUT */
324 static void stdout_callback(pa_mainloop_api*a, pa_io_event *e, int fd, pa_io_event_flags_t f, void *userdata) {
326 assert(a == mainloop_api && e && stdio_event == e);
329 mainloop_api->io_enable(stdio_event, PA_IO_EVENT_NULL);
333 assert(buffer_length);
335 if ((r = write(fd, (uint8_t*) buffer+buffer_index, buffer_length)) <= 0) {
336 fprintf(stderr, "write() failed: %s\n", strerror(errno));
339 mainloop_api->io_free(stdio_event);
347 if (!buffer_length) {
350 buffer_length = buffer_index = 0;
354 /* UNIX signal to quit recieved */
355 static void exit_signal_callback(pa_mainloop_api*m, pa_signal_event *e, int sig, void *userdata) {
357 fprintf(stderr, "Got signal, exiting.\n");
361 /* Show the current latency */
362 static void stream_update_timing_callback(pa_stream *s, int success, void *userdata) {
363 pa_usec_t latency, usec;
369 pa_stream_get_time(s, &usec) < 0 ||
370 pa_stream_get_latency(s, &latency, &negative) < 0) {
371 fprintf(stderr, "Failed to get latency: %s\n", pa_strerror(pa_context_errno(context)));
376 fprintf(stderr, "Time: %0.3f sec; Latency: %0.0f usec. \r",
377 (float) usec / 1000000,
378 (float) latency * (negative?-1:1));
381 /* Someone requested that the latency is shown */
382 static void sigusr1_signal_callback(pa_mainloop_api*m, pa_signal_event *e, int sig, void *userdata) {
387 pa_operation_unref(pa_stream_update_timing_info(stream, stream_update_timing_callback, NULL));
390 static void time_event_callback(pa_mainloop_api*m, pa_time_event *e, const struct timeval *tv, void *userdata) {
393 if (stream && pa_stream_get_state(stream) == PA_STREAM_READY) {
395 if (!(o = pa_stream_update_timing_info(stream, stream_update_timing_callback, NULL)))
396 fprintf(stderr, "pa_stream_update_timing_info() failed: %s\n", pa_strerror(pa_context_errno(context)));
398 pa_operation_unref(o);
401 pa_gettimeofday(&next);
402 pa_timeval_add(&next, TIME_EVENT_USEC);
404 m->time_restart(e, &next);
407 static void help(const char *argv0) {
409 printf("%s [options]\n\n"
410 " -h, --help Show this help\n"
411 " --version Show version\n\n"
412 " -r, --record Create a connection for recording\n"
413 " -p, --playback Create a connection for playback\n\n"
414 " -v, --verbose Enable verbose operations\n\n"
415 " -s, --server=SERVER The name of the server to connect to\n"
416 " -d, --device=DEVICE The name of the sink/source to connect to\n"
417 " -n, --client-name=NAME How to call this client on the server\n"
418 " --stream-name=NAME How to call this stream on the server\n"
419 " --volume=VOLUME Specify the initial (linear) volume in range 0...65536\n"
420 " --rate=SAMPLERATE The sample rate in Hz (defaults to 44100)\n"
421 " --format=SAMPLEFORMAT The sample type, one of s16le, s16be, u8, float32le,\n"
422 " float32be, ulaw, alaw (defaults to s16ne)\n"
423 " --channels=CHANNELS The number of channels, 1 for mono, 2 for stereo\n"
425 " --channel-map=CHANNELMAP Channel map to use instead of the default\n",
439 int main(int argc, char *argv[]) {
440 pa_mainloop* m = NULL;
442 char *bn, *server = NULL;
443 pa_time_event *time_event = NULL;
445 static const struct option long_options[] = {
446 {"record", 0, NULL, 'r'},
447 {"playback", 0, NULL, 'p'},
448 {"device", 1, NULL, 'd'},
449 {"server", 1, NULL, 's'},
450 {"client-name", 1, NULL, 'n'},
451 {"stream-name", 1, NULL, ARG_STREAM_NAME},
452 {"version", 0, NULL, ARG_VERSION},
453 {"help", 0, NULL, 'h'},
454 {"verbose", 0, NULL, 'v'},
455 {"volume", 1, NULL, ARG_VOLUME},
456 {"rate", 1, NULL, ARG_SAMPLERATE},
457 {"format", 1, NULL, ARG_SAMPLEFORMAT},
458 {"channels", 1, NULL, ARG_CHANNELS},
459 {"channel-map", 1, NULL, ARG_CHANNELMAP},
463 if (!(bn = strrchr(argv[0], '/')))
468 if (strstr(bn, "rec") || strstr(bn, "mon"))
470 else if (strstr(bn, "cat") || strstr(bn, "play"))
473 while ((c = getopt_long(argc, argv, "rpd:s:n:hv", long_options, NULL)) != -1) {
482 printf("pacat "PACKAGE_VERSION"\nCompiled with libpulse %s\nLinked with libpulse %s\n", pa_get_headers_version(), pa_get_library_version());
496 device = pa_xstrdup(optarg);
501 server = pa_xstrdup(optarg);
505 pa_xfree(client_name);
506 client_name = pa_xstrdup(optarg);
509 case ARG_STREAM_NAME:
510 pa_xfree(stream_name);
511 stream_name = pa_xstrdup(optarg);
519 int v = atoi(optarg);
520 volume = v < 0 ? 0 : v;
525 sample_spec.channels = atoi(optarg);
528 case ARG_SAMPLEFORMAT:
529 sample_spec.format = pa_parse_sample_format(optarg);
533 sample_spec.rate = atoi(optarg);
537 if (!pa_channel_map_parse(&channel_map, optarg)) {
538 fprintf(stderr, "Invalid channel map\n");
550 if (!pa_sample_spec_valid(&sample_spec)) {
551 fprintf(stderr, "Invalid sample specification\n");
555 if (channel_map_set && channel_map.channels != sample_spec.channels) {
556 fprintf(stderr, "Channel map doesn't match sample specification\n");
561 char t[PA_SAMPLE_SPEC_SNPRINT_MAX];
562 pa_sample_spec_snprint(t, sizeof(t), &sample_spec);
563 fprintf(stderr, "Opening a %s stream with sample specification '%s'.\n", mode == RECORD ? "recording" : "playback", t);
566 if (!(optind >= argc)) {
567 if (optind+1 == argc) {
570 if ((fd = open(argv[optind], mode == PLAYBACK ? O_RDONLY : O_WRONLY|O_TRUNC|O_CREAT, 0666)) < 0) {
571 fprintf(stderr, "open(): %s\n", strerror(errno));
575 if (dup2(fd, mode == PLAYBACK ? 0 : 1) < 0) {
576 fprintf(stderr, "dup2(): %s\n", strerror(errno));
583 stream_name = pa_xstrdup(argv[optind]);
586 fprintf(stderr, "Too many arguments.\n");
592 client_name = pa_xstrdup(bn);
595 stream_name = pa_xstrdup(client_name);
597 /* Set up a new main loop */
598 if (!(m = pa_mainloop_new())) {
599 fprintf(stderr, "pa_mainloop_new() failed.\n");
603 mainloop_api = pa_mainloop_get_api(m);
605 r = pa_signal_init(mainloop_api);
607 pa_signal_new(SIGINT, exit_signal_callback, NULL);
608 pa_signal_new(SIGTERM, exit_signal_callback, NULL);
610 pa_signal_new(SIGUSR1, sigusr1_signal_callback, NULL);
613 signal(SIGPIPE, SIG_IGN);
616 if (!(stdio_event = mainloop_api->io_new(mainloop_api,
617 mode == PLAYBACK ? STDIN_FILENO : STDOUT_FILENO,
618 mode == PLAYBACK ? PA_IO_EVENT_INPUT : PA_IO_EVENT_OUTPUT,
619 mode == PLAYBACK ? stdin_callback : stdout_callback, NULL))) {
620 fprintf(stderr, "io_new() failed.\n");
624 /* Create a new connection context */
625 if (!(context = pa_context_new(mainloop_api, client_name))) {
626 fprintf(stderr, "pa_context_new() failed.\n");
630 pa_context_set_state_callback(context, context_state_callback, NULL);
632 /* Connect the context */
633 pa_context_connect(context, server, 0, NULL);
638 pa_gettimeofday(&tv);
639 pa_timeval_add(&tv, TIME_EVENT_USEC);
641 if (!(time_event = mainloop_api->time_new(mainloop_api, &tv, time_event_callback, NULL))) {
642 fprintf(stderr, "time_new() failed.\n");
647 /* Run the main loop */
648 if (pa_mainloop_run(m, &ret) < 0) {
649 fprintf(stderr, "pa_mainloop_run() failed.\n");
655 pa_stream_unref(stream);
658 pa_context_unref(context);
661 assert(mainloop_api);
662 mainloop_api->io_free(stdio_event);
666 assert(mainloop_api);
667 mainloop_api->time_free(time_event);
679 pa_xfree(client_name);
680 pa_xfree(stream_name);