1 | .\" roard.1: |
---|
2 | |
---|
3 | .TH "roarctl" "1" "July 2008" "RoarAudio" "System Manager's Manual: roard" |
---|
4 | |
---|
5 | .SH NAME |
---|
6 | |
---|
7 | roarctl \- RoarAudio sound server controll tool |
---|
8 | |
---|
9 | .SH SYNOPSIS |
---|
10 | |
---|
11 | roarcat [OPTIONS]... COMMAND [OPTS] [COMMAND [OPTS] [COMMAND [OPTS] [...]]] |
---|
12 | |
---|
13 | .SH "DESCRIPTION" |
---|
14 | This tool controlls the RoarAudio's sound server. |
---|
15 | This is done by sending commands to the server. See \fBCOMMANDS\fR for a list. |
---|
16 | |
---|
17 | .SH "GENERAL OPTIONS" |
---|
18 | .TP |
---|
19 | \fB--help\fR |
---|
20 | Print some help text. |
---|
21 | |
---|
22 | .SH "NETWORK OPTIONS" |
---|
23 | .TP |
---|
24 | \fB--server SERVER\fR |
---|
25 | The server to connect to |
---|
26 | |
---|
27 | .SH "COMMANDS" |
---|
28 | .TP |
---|
29 | \fBhelp\fR |
---|
30 | Same as \fB--help\fR. |
---|
31 | |
---|
32 | .TP |
---|
33 | \fBstandby\fR, \fBoff\fR, \fBresume\fR, \fBon\fR |
---|
34 | Brings the server into standby mode or back into achtive (operating mode). |
---|
35 | |
---|
36 | .TP |
---|
37 | \fBstandbymode\fR |
---|
38 | Tells if the server is in standby mode or not. |
---|
39 | |
---|
40 | .TP |
---|
41 | \fBexit\fR |
---|
42 | Quits the server. |
---|
43 | |
---|
44 | .TP |
---|
45 | \fBvolume STREAMID CHANNELS VOL0 VOL1 VOL2...\fR |
---|
46 | Sets the mixing level for a stream with id \fISTREAMID\fR. |
---|
47 | |
---|
48 | \fICHANNELS\fR is the nummber of channels to set volume. |
---|
49 | This should be the number of channels of the stream or a symbolic name. |
---|
50 | Currently the symbolic names \fBmono\fR and \fBstereo\fR are allowed. |
---|
51 | If you use \fBmono\fR all channels will get the level you give as |
---|
52 | \fIVOL0\fR. If you use \fBstereo\fR it will try to set the mixing levels |
---|
53 | as you are used from stereo setups even if the setup is not in stereo. |
---|
54 | |
---|
55 | The parameters \fIVOL0\fR ... \fIVOLn\fR and the number of them depends |
---|
56 | on what you gave as \fICHANNELS\fR. You have to give exactly \fICHANNELS\fR |
---|
57 | parameters. |
---|
58 | |
---|
59 | If you give a numerical (not symbolic) value for \fICHANNELS\fR and |
---|
60 | the stream does have a diffrent number of channels the behavor is undefined. |
---|
61 | In the current implementation only the first \fICHANNELS\fR channels will be updated. |
---|
62 | This behavor may change in the future. |
---|
63 | |
---|
64 | .TP |
---|
65 | \fBkick TYPE ID\fR |
---|
66 | Kicks an object of \fITYPE\fR with id \fIID\fR. |
---|
67 | Possible types are: \fBclient stream sample source\fR |
---|
68 | |
---|
69 | You can get the \fIID\fR via \fBlist*\fR (see bellow). |
---|
70 | |
---|
71 | .TP |
---|
72 | \fBserveroinfo\fR |
---|
73 | Gets Informations about server output. |
---|
74 | |
---|
75 | .TP |
---|
76 | \fBlistclients\fR |
---|
77 | Gets Informations about clients. |
---|
78 | |
---|
79 | .TP |
---|
80 | \fBliststreams\fR |
---|
81 | Gets Informations about streams. |
---|
82 | |
---|
83 | .TP |
---|
84 | \fBallinfo\fR |
---|
85 | Same as "\fBserveroinfo\fR \fBlistclients\fR \fBliststreams\fR". |
---|
86 | |
---|
87 | .SH "ENVIRONMENT VARIABLES" |
---|
88 | Bellow only the basic environment varibales are listend. |
---|
89 | For a complete list see \fBlibroar\fR(7). |
---|
90 | |
---|
91 | .TP |
---|
92 | \fBHOME\fR |
---|
93 | The users home directory. |
---|
94 | |
---|
95 | .TP |
---|
96 | \fBROAR_SERVER\fR |
---|
97 | The address of the listening server. This may be in form of host:port for TCP/IP connections |
---|
98 | and /path/to/sock for UNIX Domain Sockets. |
---|
99 | This is the same as the \fB--server\fR option. |
---|
100 | |
---|
101 | .SH "BUGS" |
---|
102 | 1) Make the meta data commands api-fixed and list them here. |
---|
103 | |
---|
104 | 2) more often check if the user gave us enough arguments. |
---|
105 | |
---|
106 | .SH "SEE ALSO" |
---|
107 | \fBroarvorbis\fR(1), |
---|
108 | \fBroarfish\fR(1), |
---|
109 | \fBroarbaseclients\fR(1), |
---|
110 | \fBroartestclients\fR(1), |
---|
111 | \fBlibroar\fR(7), |
---|
112 | \fBRoarAudio\fR(7). |
---|
113 | |
---|
114 | .SH "HISTORY" |
---|
115 | |
---|
116 | For history information see \fBRoarAudio\fR(7). |
---|
117 | |
---|
118 | .\" ll |
---|