mirrors/pulseaudio
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/pulseaudio/pulseaudio.git synced 2025-11-06 13:29:56 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

pacmd: Added --help and --version options.

Browse source 
All utilities should have the --help and --version command line options.
These two were added to pacmd, also the goto label was changed from fail
to quit like in the other utilities.

BugLink: https://bugs.freedesktop.org/show_bug.cgi?id=45030
This commit is contained in:
poljar 2012-05-01 23:17:22 +02:00 • committed by Tanu Kaskinen
parent a0879ac3f6
commit a6394b1cb0
1 changed files with 90 additions and 12 deletions
Download patch file Download diff file Expand all files Collapse all files

102
src/utils/pacmd.c
View file

@ -30,6 +30,7 @@
#include <errno.h> #include <errno.h>
#include <string.h> #include <string.h>
#include <sys/un.h> #include <sys/un.h>
#include <getopt.h>
#include <locale.h> #include <locale.h>
#include <pulse/util.h> #include <pulse/util.h>
@ -42,6 +43,51 @@
#include <pulsecore/log.h> #include <pulsecore/log.h>
#include <pulsecore/pid.h> #include <pulsecore/pid.h>
static void help(const char *argv0) {
printf("%s %s\n", argv0, "exit");
printf("%s %s\n", argv0, "help");
printf("%s %s\n", argv0, "list-(modules|sinks|sources|clients|cards|samples)");
printf("%s %s\n", argv0, "list-(sink-inputs|source-outputs)");
printf("%s %s\n", argv0, "stat");
printf("%s %s\n", argv0, "info");
printf("%s %s %s\n", argv0, "load-module", _("NAME [ARGS ...]"));
printf("%s %s %s\n", argv0, "unload-module", _("#N"));
printf("%s %s %s\n", argv0, "describe-module", _("NAME"));
printf("%s %s %s\n", argv0, "set-(sink|source)-volume", _("NAME|#N VOLUME"));
printf("%s %s %s\n", argv0, "set-(sink-input|source-output)-volume", _("#N VOLUME"));
printf("%s %s %s\n", argv0, "set-(sink|source)-mute", _("NAME|#N 1|0"));
printf("%s %s %s\n", argv0, "set-(sink-input|source-output)-mute", _("#N 1|0"));
printf("%s %s %s\n", argv0, "update-(sink|source)-proplist", _("NAME|#N KEY=VALUE"));
printf("%s %s %s\n", argv0, "update-(sink-input|source-output)-proplist", _("#N KEY=VALUE"));
printf("%s %s %s\n", argv0, "set-default(sink|source)", _("NAME|#N"));
printf("%s %s %s\n", argv0, "kill-(client|sink-input|source-output)", _("#N"));
printf("%s %s %s\n", argv0, "play-sample", _("NAME SINK|#N"));
printf("%s %s %s\n", argv0, "remove-sample", _("NAME"));
printf("%s %s %s\n", argv0, "load-sample", _("NAME FILENAME"));
printf("%s %s %s\n", argv0, "load-sample-lazy", _("NAME FILENAME"));
printf("%s %s %s\n", argv0, "load-sample-dir-lazy", _("PATHNAME"));
printf("%s %s %s\n", argv0, "play-file", _("FILENAME SINK|#N"));
printf("%s %s\n", argv0, "dump");
printf("%s %s %s\n", argv0, "move-(sink-input|source-output)", _("#N SINK|SOURCE"));
printf("%s %s %s\n", argv0, "suspend-(sink|source)", _("NAME|#N 1|0"));
printf("%s %s %s\n", argv0, "suspend", _("1|0"));
printf("%s %s %s\n", argv0, "set-card-profile", _("CARD PROFILE"));
printf("%s %s %s\n", argv0, "set-(sink|source)-port", _("NAME|#N PORT"));
printf("%s %s %s\n", argv0, "set-log-level", _("NUMERIC LEVEL"));
printf("%s %s %s\n", argv0, "set-log-meta", _("1|0"));
printf("%s %s %s\n", argv0, "set-log-time", _("1|0"));
printf("%s %s %s\n", argv0, "set-log-backtrace", _("FRAMES"));
printf(_("\n"
" -h, --help Show this help\n"
" --version Show version\n"
"When no command is given pacdm starts in the interactive mode\n" ));
}
enum {
ARG_VERSION = 256
};
int main(int argc, char*argv[]) { int main(int argc, char*argv[]) {
pid_t pid; pid_t pid;
int fd = -1; int fd = -1;
@ -57,26 +103,57 @@ int main(int argc, char*argv[]) {
int stdin_type = 0, stdout_type = 0, fd_type = 0; int stdin_type = 0, stdout_type = 0, fd_type = 0;
char *bn = NULL;
int c;
static const struct option long_options[] = {
{"version", 0, NULL, ARG_VERSION},
{"help", 0, NULL, 'h'},
{NULL, 0, NULL, 0}
};
setlocale(LC_ALL, ""); setlocale(LC_ALL, "");
#ifdef ENABLE_NLS #ifdef ENABLE_NLS
bindtextdomain(GETTEXT_PACKAGE, PULSE_LOCALEDIR); bindtextdomain(GETTEXT_PACKAGE, PULSE_LOCALEDIR);
#endif #endif
bn = pa_path_get_filename(argv[0]);
while ((c = getopt_long(argc, argv, "h", long_options, NULL)) != -1) {
switch (c) {
case 'h' :
help(bn);
ret = 0;
goto quit;
case ARG_VERSION:
printf(_("pacmd %s\n"
"Compiled with libpulse %s\n"
"Linked with libpulse %s\n"),
PACKAGE_VERSION,
pa_get_headers_version(),
pa_get_library_version());
ret = 0;
goto quit;
default:
goto quit;
}
}
if (pa_pid_file_check_running(&pid, "pulseaudio") < 0) { if (pa_pid_file_check_running(&pid, "pulseaudio") < 0) {
pa_log(_("No PulseAudio daemon running, or not running as session daemon.")); pa_log(_("No PulseAudio daemon running, or not running as session daemon."));
goto fail; goto quit;
} }
if ((fd = pa_socket_cloexec(PF_UNIX, SOCK_STREAM, 0)) < 0) { if ((fd = pa_socket_cloexec(PF_UNIX, SOCK_STREAM, 0)) < 0) {
pa_log(_("socket(PF_UNIX, SOCK_STREAM, 0): %s"), strerror(errno)); pa_log(_("socket(PF_UNIX, SOCK_STREAM, 0): %s"), strerror(errno));
goto fail; goto quit;
} }
pa_zero(sa); pa_zero(sa);
sa.sun_family = AF_UNIX; sa.sun_family = AF_UNIX;
if (!(cli = pa_runtime_path("cli"))) if (!(cli = pa_runtime_path("cli")))
goto fail; goto quit;
pa_strlcpy(sa.sun_path, cli, sizeof(sa.sun_path)); pa_strlcpy(sa.sun_path, cli, sizeof(sa.sun_path));
pa_xfree(cli); pa_xfree(cli);
@ -86,15 +163,16 @@ int main(int argc, char*argv[]) {
if ((r = connect(fd, (struct sockaddr*) &sa, sizeof(sa))) < 0 && (errno != ECONNREFUSED && errno != ENOENT)) { if ((r = connect(fd, (struct sockaddr*) &sa, sizeof(sa))) < 0 && (errno != ECONNREFUSED && errno != ENOENT)) {
pa_log(_("connect(): %s"), strerror(errno)); pa_log(_("connect(): %s"), strerror(errno));
goto fail; goto quit;
} }
if (r >= 0) if (r >= 0)
break; break;
if (pa_pid_file_kill(SIGUSR2, NULL, "pulseaudio") < 0) { if (pa_pid_file_kill(SIGUSR2, NULL, "pulseaudio") < 0) {
pa_log(_("Failed to kill PulseAudio daemon.")); pa_log(_("Failed to kill PulseAudio daemon."));
goto fail; goto quit;
} }
pa_msleep(300); pa_msleep(300);
@ -102,7 +180,7 @@ int main(int argc, char*argv[]) {
if (i >= 5) { if (i >= 5) {
pa_log(_("Daemon not responding.")); pa_log(_("Daemon not responding."));
goto fail; goto quit;
} }
buf_size = pa_pipe_buf(fd); buf_size = pa_pipe_buf(fd);
@ -182,7 +260,7 @@ int main(int argc, char*argv[]) {
continue; continue;
pa_log(_("poll(): %s"), strerror(errno)); pa_log(_("poll(): %s"), strerror(errno));
goto fail; goto quit;
} }
if (watch_stdin) { if (watch_stdin) {
@ -193,7 +271,7 @@ int main(int argc, char*argv[]) {
if ((r = pa_read(STDIN_FILENO, ibuf, ibuf_size, &stdin_type)) <= 0) { if ((r = pa_read(STDIN_FILENO, ibuf, ibuf_size, &stdin_type)) <= 0) {
if (r < 0) { if (r < 0) {
pa_log(_("read(): %s"), strerror(errno)); pa_log(_("read(): %s"), strerror(errno));
goto fail; goto quit;
} }
ibuf_eof = TRUE; ibuf_eof = TRUE;
@ -213,7 +291,7 @@ int main(int argc, char*argv[]) {
if ((r = pa_read(fd, obuf, obuf_size, &fd_type)) <= 0) { if ((r = pa_read(fd, obuf, obuf_size, &fd_type)) <= 0) {
if (r < 0) { if (r < 0) {
pa_log(_("read(): %s"), strerror(errno)); pa_log(_("read(): %s"), strerror(errno));
goto fail; goto quit;
} }
obuf_eof = TRUE; obuf_eof = TRUE;
@ -235,7 +313,7 @@ int main(int argc, char*argv[]) {
if ((r = pa_write(STDOUT_FILENO, obuf + obuf_index, obuf_length, &stdout_type)) < 0) { if ((r = pa_write(STDOUT_FILENO, obuf + obuf_index, obuf_length, &stdout_type)) < 0) {
pa_log(_("write(): %s"), strerror(errno)); pa_log(_("write(): %s"), strerror(errno));
goto fail; goto quit;
} }
obuf_length -= (size_t) r; obuf_length -= (size_t) r;
@ -253,7 +331,7 @@ int main(int argc, char*argv[]) {
if ((r = pa_write(fd, ibuf + ibuf_index, ibuf_length, &fd_type)) < 0) { if ((r = pa_write(fd, ibuf + ibuf_index, ibuf_length, &fd_type)) < 0) {
pa_log(_("write(): %s"), strerror(errno)); pa_log(_("write(): %s"), strerror(errno));
goto fail; goto quit;
} }
ibuf_length -= (size_t) r; ibuf_length -= (size_t) r;
@ -264,7 +342,7 @@ int main(int argc, char*argv[]) {
ret = 0; ret = 0;
fail: quit:
if (fd >= 0) if (fd >= 0)
pa_close(fd); pa_close(fd);