source: roaraudio/doc/new-cmds @ 5314:0b7dc787e4bd

Last change on this file since 5314:0b7dc787e4bd was 5314:0b7dc787e4bd, checked in by phi, 12 years ago

added ITST_BUILD

File size: 8.8 KB
Line 
1#($Revision$)
2!SECTION: Commands
3+DEVCTL = 33
4 +:version (uint8)
5 +:type (uint8)
6 +:vendor (uint8)
7 +VENDOR_ROARAUDIO = 0
8 +VENDOR_BASICDEV  = 1
9 +:subtype (uint8)
10 +:flags (uint8)
11 +:ot (uint8)
12 +:(id) (uint16) #(if not UNIID or SID)
13 +:data... (vardata)
14+CAPS = 34
15 +:version (uint8)
16 +:type (uint8)
17 +:flags (uint16)
18 +CF_REQUEST   = 0x0001
19 +CT_CAPS      = 0
20 +::data... (dataarray)
21 +:::captype (TODO)
22 +:::... (TODO)
23 +CT_STANDARDS = 1
24 +::data... (dataarray)
25 +:::stdvendor (uint8)
26 +STDV_ROARAUDIO = 0
27 +STDV_PROTO     = 1
28 +STDV_RFC       = 2
29 +:::stdversion (uint8)
30 +:::standard (uint16)
31+WAIT = 35
32 +:version (TODO)
33 +:flags (TODO)
34 :(TODO)
35+NOTIFY = 36
36 #(+=structof(WAIT))
37 #(Notify Types)
38 +NT_PROTO = NEEDS_CONST
39 +NT_SOCKET = NEEDS_CONST
40 +NT_SIGNAL = NEEDS_CONST
41 +NT_MSGQUEUE = NEEDS_CONST
42 +NT_FLOCK = NEEDS_CONST
43 +NT_FUTEX = NEEDS_CONST
44+SEEK = 37
45 +:version (TODO)
46 +:flags (TODO)
47 +:destination possition (TODO)
48 +:destination possition whence (TODO)
49 +:destination possition quality (TODO)
50 +:hint pos (TODO)
51 +:hint whence (TODO)
52 +:hint quality (TODO)
53 +:seek at (TODO)
54 +:seek to (TODO)
55 +:seek whence (TODO)
56 +SF_CONT_WHILE_SEEK = 0x01
57 +SF_CONT_ON_ERROR   = 0x02
58 +SF_HINT            = 0x04
59 +SF_SEEK            = 0x08
60 +HQ_BAD       = 0
61 +HQ_BAD_NB    = 1 #(bad, not before this possition)
62 +HQ_NEAR      = 2
63 +HQ_NEAR_NB   = 3 #(Near, not before this possition)
64 +HQ_GOOD      = 4
65 +HQ_GOOD_NB   = 5 #(good, not before this possition)
66 +HQ_EXACT     = HQ_EXACT_NB #(ID 6 is skiped here)
67 +HQ_EXACT_NB  = 7
68 +WHENCE_BEGIN = 0
69 +WHENCE_CUR   = 1
70 +WHENCE_END   = 2
71+CLIENTCTL = 38
72 +:version (uint8)
73 +:subcmd (uint8)
74 +:flags (uint16)
75 +:data (vardata)
76 +CC_HASHTABLE = PARA_HASHTABLE
77 +CC_WININFO   = PARA_WININFO
78 +CC_PROPTABLE = PARA_PROPTABLE
79+LOOKUP = 39
80 +:version (uint8)
81 +:flags (uint8)
82 +:extflags (uint8)
83 +:ot (uint8)
84 +:ht (uint32) #(hash type)
85 +:hash... (vardata)
86+CONCTL = 40
87 +:version (uint8)
88 +:flags (uint8)
89 +:session (uint8)
90 +:type (uint8)
91 +:stdvendor (uint8)
92 +:stdversion (uint8)
93 +:standard (uint16)
94 +CCT_NONE       = 0 #(This is the same like a NOOP-Command)
95 +CCT_CRYPTMSG   = 1 #(This request contains zero or more crypto packages according to given standard)
96 +CCT_OPENSESS   = 2 #(This opens a crypto session)
97 +:hash (uint32)
98 +:comp (uint16)
99 +COMPT_NONE  = 0
100 +COMPT_ZLIB  = 1
101 +COMPT_GZIP  = 2
102 +COMPT_BZIP2 = 3
103 +:complevel (uint8)
104 +:compflags (uint8)
105 +:data... (dataarray)
106 +CCT_CLOSESESS  = 3 #(This closes a opend cryto session)
107 +:hashlen (uint16)
108 +:hash (dataarray(:hashlen))
109 +:data... (dataarray)
110 +CCT_SESSDATA   = 4 #(This is some kind of data used in the session)
111 +:data... (dataarray)
112+LIST = NEEDS_CONST
113+GET_OBJ = NEEDS_CONST
114+OBJCTL = NEEDS_CONST
115*SERVER_INFO
116 +IT_SERVER   = 1
117  +:version (uint8)
118  +:reserved (uint8)
119  +:indexlen (uint16)
120  +::reserved (uint8)
121  +::type (uint8)
122  +ITST_VERSION     = 0
123  #(Format: Product/Version <VendorID/VendorName> (comments))
124  #(Example: roard/0.4 <0/RoarAudio> (Debian build))
125  +ITST_LOCATION    = 1
126  #(freeform)
127  +ITST_DESCRIPTION = 2
128  #(freeform)
129  +ITST_CONTACT     = 3
130  #(Format: first ["']nick["'] last (comment) <email>/OpenPGPkey/Phone/Room)
131  +ITST_UN_SYSNAME  = 4 #(uname -s)
132  +ITST_UN_NODENAME = 5 #(uname -n)
133  +ITST_UN_RELEASE  = 6 #(uname -r)
134  +ITST_UN_MACHINE  = 7 #(uname -m)
135  +ITST_SERIAL      = 8
136  +ITST_ADDRESS     = 9
137  +ITST_UIURL       = 10
138  +ITST_HOSTID      = 11
139  #(UNIX hostid in hex (%.8x), with leading zeros (8 or 16 hex-digits), This is returned by gethostid())
140  +ITST_LICENSE     = 12
141  #(Format: LicenseName-Version (options))
142  #(Example: GPL-3.0, LGPL-2.1, LGPL-3.0 (or later))
143  +ITST_BUILD       = 13
144  #(Manufacturing/compiling date and worker, all times in UTC)
145  #(Format: YYYY-MM-DD HH:MM:SS (worker))
146  #(Example: 2011-12-01 (build cluster 3))
147  +::len (uint16)
148  +:strings (dataarray)
149 +IT_COUNTERS = 2
150  +:version (uint8)
151  +:reserved (uint24)
152  +:data... (dataarray)
153  +::type (uint8)
154  +::flags (uint8)
155  +::reserved (uint16)
156  +::counter (uint32)
157  +CF_CURRENT = 0x01 #(Current value if set, sum if unset)
158  +CF_OTTYPE  = 0x02 #(Type is a OT_* type if set, or other if unset)
159 +IT_LISTEN   = 3
160  +:version (uint8)
161  +:reserved (uint24)
162  +:listensocks... (dataarray)
163  +::id (uint16)
164  +::flags (uint8)
165  +::socktype (uint8)
166  +::proto (uint16)
167  +::byteorder (uint16)
168  +::dir (uint32)
169  +::auinfo (packed-audioinfo) #(4*4*8 = 128bit)
170  +::addrlen (uint16)
171  +::addr (padded-string(:addrlen))
172  +LF_HAVEDIR = 0x01
173  +LF_HAVEAI  = 0x02
174*[GS]ET_STREAM_PARA
175 *PARA_INFO
176  +STREAMSTATE_ERROR    = 5 #(Stream is in some error condition, parent client should close or kick it)
177  +STREAMSTATE_NEEDSEEK = 6 #(like Error but stream can become usable again if you do a seek)
178 *PARA_FLAGS
179  +FLAG_SINGLESINK = 0x00040000
180  +TOGGLE_FLAG     = 2
181  +NOOP_FLAG       = 3
182  +PROTECT_FLAG    = 0x8000 #(flag to mark flags in changed by this protected)
183 +PARA_HASHTABLE  = 6   #(GTN, UUID, ...)
184  +:htsettertype (uint32)
185  +:htsettersize (uint16)
186  +:htsetterdata (vardata)
187  +:hashtable... (dataarray)
188  +::httype (uint32)
189  +::htsize (uint16)
190  +::htfunction (uint16)
191  +::htdata (vardata)
192  +HT_NONE       = 0
193  +HT_MD5        = 1
194  +HT_SHA1       = 2
195  +HT_RIPEMD160  = 3
196  +HT_MD2        = 5
197  +HT_TIGER      = 6
198  +HT_HAVAL      = 7
199  +HT_SHA256     = 8
200  +HT_SHA384     = 9
201  +HT_SHA512     = 10
202  +HT_SHA224     = 11
203  +HT_MD4        = 301
204  +HT_CRC32      = 302 #(ISO 3309, ITU-T V.42, IEEE 802.3)
205  +HT_RFC1510    = 303 #(HT_CRC32 as modified by RFC 1510)
206  +HT_RFC2440    = 304 #(poly=0x1864CFBL, init=0xB704CEL, OpenPGP)
207  +HT_WHIRLPOOL  = 305
208  +HT_UUID       = 70000
209#(GTN is the Global Track Number as used by for example the RoarAudio PlayList Daemon (rpld))
210#(It is a creator-runtime-unique number to identify the object.)
211  +HT_GTN8       = 70001
212  +HT_GTN16      = 70002
213  +HT_GTN32      = 70004 #("Short Global Track Number")
214  +HT_GTN64      = 70008 #("Long  Global Track Number")
215  +HT_CLIENTID   = 71000 + OT_CLIENT   = 71001
216  +HT_STREAMID   = 71000 + OT_STREAM   = 71002
217  +HT_SOURCEID   = 71000 + OT_SOURCE   = 71003
218  +HT_SAMPLEID   = 71000 + OT_SAMPLE   = 71004
219  +HT_MIXERID    = 71000 + OT_MIXER    = 71005
220  +HT_BRIDGEID   = 71000 + OT_BRIDGE   = 71006
221  +HT_LISTENID   = 71000 + OT_LISTEN   = 71007
222  +HT_ACTIONID   = 71000 + OT_ACTION   = 71008
223  +HT_MSGQUEUEID = 71000 + OT_MSGQUEUE = 71009
224  +HT_MSGBUSID   = 71000 + OT_MSGBUS   = 71010
225#(Next are article and book numers. They may be ued with HF_DISK and HF_WORK)
226  +HT_GTIN8      = 72001
227  +HT_GTIN13     = 72002
228  +HT_ISBN10     = 72003
229  +HT_ISBN13     = HT_GTIN13 #(ISBN-13 and GTIN/EAN-13 are the same)
230  +HT_ADLER32    = 73001 #(RFC1950)
231  +HF_NONE       =  0 #(This entry does not have anything to do with the object...)
232  +HF_OBJECT     =  1 #(This is an entry for exacltly this object)
233  +HF_PARENT     =  2 #(This is the parent object)
234  +HF_LOGIC      =  3 #(This is a logic group of this object)
235  +HF_PERMANENT  =  4 #(This can be used to acces exactly this object with a premanent address)
236  +HF_DEVICE     =  5 #(The device this is on or the device itself if this is a device)
237  +HF_DISK       =  6 #(The disk this is on, if this is a disk the same as HF_DEVICE)
238  +HF_SONG       =  7 #(This identifys the Song. This may for example be used with Tantalos)
239  +HF_APP        =  8 #(The application, device or other source generating this object)
240  +HF_FILE       =  9 #(The source file for this object)
241  +HF_ARTIST     = 10 #(This identifies any kind of artist/composer/interpret, to be used with Tantalos)
242  +HF_WORK       = 11 #(This identifies any kind of work/album/compilation, to be used with Tantalos)
243 +PARA_WININFO   = 7
244  +:wsystype (uint8)
245  +:socktype (uint8)
246  +:display (uint8)
247  +:screen (uint8)
248  +:addrlen (uint16)
249  +:addr (padded-string(:addrlen))
250  +:wins (dataarray)
251  +::window (uint32)
252 +PARA_PROPTABLE = 8
253  :(TODO)
254 +PARA_LTM       = 9
255 +PARA_USAGE     = 10 #(Used by RAUM)
256 +PARA_RADIO     = 11 #(Used by RDTCS)
257*KICK,...
258 +OT_OUTPUT   =  5
259 +OT_MIXER    =  6
260 +OT_BRIDGE   =  7
261 +OT_LISTEN   =  8
262 +OT_ACTION   =  9
263 +OT_MSGQUEUE = 10 #(Message queue, message is gone as soon as one client took it)
264 +OT_MSGBUS   = 11 #(Message bus, message is gone as soon as all listening clients got it)
265*ATTACH
266 *ATTACH_SOURCE
267  :(TODO)
268 *ATTACH_OUTPUT
269  :(TODO)
270 +ATTACH_MIXER    = 4
271  :(TODO)
272 +ATTACH_BRIDGE   = 5
273  :(TODO)
274*SET_VOL
275 +SET_VOL_MS       = 3
276 +SET_VOL_UNMAPPED = 4 #(like roarctls mono/stereo...)
277*AUTHCTL = GET_ACL
278*ACLCTL  = SET_ACL
279-GET_ACL #(reasignmened)
280-SET_ACL #(reasignmened)
281+SHIFT_DATA   = 40  #(get data from a stream)
282+RAUM_PICTURE = 202 #(Used by RAUM to store pictures)
283+RAUM_SYNC    = 203 #(Used by RAUM for raw seeking)
284!SECTIONEND
285!SECTION: Codecs
286+AUTLAW_LE  = 0x31
287+AUTLAW_BE  = 0x32
288+AUTLAW     = AUTLAW_BE
289+MUUTLAW_LE = 0x35
290+MUUTLAW_BE = 0x36
291+MUUTLAW    = MUUTLAW_BE
292+BRR        = 0x3c
293+OGG_OPUS   = 0x18
294+ROAR_OPUS  = 0x19
295!SECTIONEND
296!SECTION: Network
297+SOCKET_TYPE_LAT_SERVICE      = 12
298+SOCKET_TYPE_LAT_REVERSE_PORT = 13
299!SECTIONEND
Note: See TracBrowser for help on using the repository browser.