paraslash Paraslash Audio Streaming
About   News   Download   Documentation   Development



para_audioc - communicate with para_audiod through a local socket


para_audioc [--help] [--detailed-help] [--version] [--loglevel=<severity>] [--complete] [--history-file=<filename>] [--socket=<path>] [--bufsize=<bytes>] [--] [command [options]]


The client program to control para_audiod at runtime. It can enable/disable streaming, receive status info, or grab the audio stream at any point of the decoding process.

If no command is given, para_audioc enters interactive mode.


Common options
The following options are implemented generically and are available for many of the commands.
, --help

print help and exit


print help, including all details, and exit

-V, --version

print version and exit

-l, --loglevel=<severity>

control amount of logging

values: debug, info, notice, warning, error, crit, emerg

Log only messages with severity greater or equal than the given value. Possible values:

debug: Produces really noisy output. info: Still noisy, but won’t fill up the disk quickly. notice: Indicates normal, but significant event. warning: Unexpected events that can be handled. error: Unhandled error condition. crit: System might be unreliable. emerg: Last message before exit.


print possible command line completions

If this flag is given, the environment variables COMP_LINE and COMP_POINT are examined to obtain the current command line and the cursor position respectively. Possible completions are written to stdout and the program exits.


location of the file for the command history list

If para_audioc runs in interactive mode, it reads the history file on startup. Upon exit, the in-memory history is appended to the history file.

If this option is not given, the history file is expected at ~/.paraslash/audioc.history.

Options for para_audioc
, --socket=<path>

path to well-known socket

The default path of the socket is /var/paraslash/audiod.socket.$HOSTNAME.

-b, --bufsize=<bytes>

size of internal buffer

default: 8192


Written by Andre Noll
Copyright (C) 2024 Andre Noll
License: GNU GPL version 2
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
Report bugs to Andre Noll