1 | //vio_ctl.h: |
---|
2 | |
---|
3 | /* |
---|
4 | * Copyright (C) Philipp 'ph3-der-loewe' Schafft - 2008-2011 |
---|
5 | * |
---|
6 | * This file is part of libroar a part of RoarAudio, |
---|
7 | * a cross-platform sound system for both, home and professional use. |
---|
8 | * See README for details. |
---|
9 | * |
---|
10 | * This file is free software; you can redistribute it and/or modify |
---|
11 | * it under the terms of the GNU General Public License version 3 |
---|
12 | * as published by the Free Software Foundation. |
---|
13 | * |
---|
14 | * libroar is distributed in the hope that it will be useful, |
---|
15 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
---|
16 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
---|
17 | * GNU General Public License for more details. |
---|
18 | * |
---|
19 | * You should have received a copy of the GNU General Public License |
---|
20 | * along with this software; see the file COPYING. If not, write to |
---|
21 | * the Free Software Foundation, 51 Franklin Street, Fifth Floor, |
---|
22 | * Boston, MA 02110-1301, USA. |
---|
23 | * |
---|
24 | * NOTE for everyone want's to change something and send patches: |
---|
25 | * read README and HACKING! There a addition information on |
---|
26 | * the license of this document you need to read before you send |
---|
27 | * any patches. |
---|
28 | * |
---|
29 | * NOTE for uses of non-GPL (LGPL,...) software using libesd, libartsc |
---|
30 | * or libpulse*: |
---|
31 | * The libs libroaresd, libroararts and libroarpulse link this lib |
---|
32 | * and are therefore GPL. Because of this it may be illigal to use |
---|
33 | * them with any software that uses libesd, libartsc or libpulse*. |
---|
34 | */ |
---|
35 | |
---|
36 | #ifndef _LIBROARVIO_CTL_H_ |
---|
37 | #define _LIBROARVIO_CTL_H_ |
---|
38 | |
---|
39 | #include "libroar.h" |
---|
40 | |
---|
41 | // CTLs: |
---|
42 | /* |
---|
43 | * 0xAAAABBBB |
---|
44 | * AAAA: |
---|
45 | * 0x0001 -> Basic stream calls |
---|
46 | * 0x0002 -> Driver calls |
---|
47 | * |
---|
48 | * BBBB: |
---|
49 | * 0x0XXX -> Client |
---|
50 | * 0x1XXX -> Server |
---|
51 | */ |
---|
52 | |
---|
53 | #define ROAR_VIO_CTL_GET 0x1 |
---|
54 | #define ROAR_VIO_CTL_SET 0x2 |
---|
55 | |
---|
56 | #define ROAR_VIO_CTL_CLIENT 0x0000 |
---|
57 | #define ROAR_VIO_CTL_SERVER 0x1000 |
---|
58 | |
---|
59 | #define ROAR_VIO_CTL_GENERIC (0x0000<<16) |
---|
60 | #define ROAR_VIO_CTL_STREAM (0x0001<<16) |
---|
61 | #define ROAR_VIO_CTL_DRIVER (0x0002<<16) |
---|
62 | |
---|
63 | // basic calls: |
---|
64 | #define ROAR_VIO_CTL_GET_NEXT (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_GET|0x0100) |
---|
65 | #define ROAR_VIO_CTL_SET_NEXT (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_SET|0x0100) |
---|
66 | #define ROAR_VIO_CTL_GET_FH (ROAR_VIO_CTL_GENERIC|0x0110) |
---|
67 | #define ROAR_VIO_CTL_GET_READ_FH (ROAR_VIO_CTL_GENERIC|0x0111) |
---|
68 | #define ROAR_VIO_CTL_GET_WRITE_FH (ROAR_VIO_CTL_GENERIC|0x0112) |
---|
69 | #define ROAR_VIO_CTL_GET_SELECT_FH (ROAR_VIO_CTL_GENERIC|0x0113) |
---|
70 | #define ROAR_VIO_CTL_GET_SELECT_READ_FH (ROAR_VIO_CTL_GENERIC|0x0114) |
---|
71 | #define ROAR_VIO_CTL_GET_SELECT_WRITE_FH (ROAR_VIO_CTL_GENERIC|0x0115) |
---|
72 | #define ROAR_VIO_CTL_SELECT (ROAR_VIO_CTL_GENERIC|0x0120) |
---|
73 | #define ROAR_VIO_CTL_GET_UMMAP (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_GET|0x0130) /* Use mmap(), int as bool */ |
---|
74 | #define ROAR_VIO_CTL_SET_UMMAP (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_SET|0x0130) /* ** */ |
---|
75 | #define ROAR_VIO_CTL_GET_SHUTDOWN (ROAR_VIO_CTL_GENERIC|0x0140) /* shutdown(), need specs */ |
---|
76 | #define ROAR_VIO_CTL_SET_NOSYNC (ROAR_VIO_CTL_GENERIC|0x0150) /* delete call of vio sync() from object */ |
---|
77 | #define ROAR_VIO_CTL_GET_NAME (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_GET|0x0160) /* get name of VIO */ |
---|
78 | #define ROAR_VIO_CTL_ACCEPT (ROAR_VIO_CTL_GENERIC|0x0170) /* accept(), vio* */ |
---|
79 | #define ROAR_VIO_CTL_SHUTDOWN (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_SET|0x0174) /* shutdown(), int */ |
---|
80 | #define ROAR_VIO_CTL_SYSIO_IOCTL (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_SET|0x0180) /* ioctl(), */ |
---|
81 | /* struct roar_vio_sysio_ioctl* */ |
---|
82 | #define ROAR_VIO_CTL_FSTAT (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_GET|0x0184) /* fstat() */ |
---|
83 | #define ROAR_VIO_CTL_GET_SOCKNAME (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_GET|0x0188) /* getsockname() */ |
---|
84 | #define ROAR_VIO_CTL_GET_PEERNAME (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_GET|0x018C) /* getpeername() */ |
---|
85 | #define ROAR_VIO_CTL_GET_SYSIO_SOCKOPT (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_GET|0x0190) /* getsockopt() */ |
---|
86 | #define ROAR_VIO_CTL_SET_SYSIO_SOCKOPT (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_SET|0x0190) /* setsockopt() */ |
---|
87 | |
---|
88 | // more about network based protocols: |
---|
89 | #define ROAR_VIO_CTL_GET_MIMETYPE (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_GET|0x0190) |
---|
90 | #define ROAR_VIO_CTL_SET_MIMETYPE (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_SET|0x0190) |
---|
91 | #define ROAR_VIO_CTL_GET_USERPASS (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_SET|0x0194) |
---|
92 | #define ROAR_VIO_CTL_SET_USERPASS (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_SET|0x0194) |
---|
93 | |
---|
94 | // get or set data format used for read and write calls, see below |
---|
95 | #define ROAR_VIO_CTL_GET_DATA_FORMAT (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_GET|0x0170) |
---|
96 | #define ROAR_VIO_CTL_SET_DATA_FORMAT (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_SET|0x0170) |
---|
97 | |
---|
98 | // stream: |
---|
99 | #define ROAR_VIO_CTL_SET_STREAM (ROAR_VIO_CTL_STREAM|ROAR_VIO_CTL_CLIENT|ROAR_VIO_CTL_SET) /* normal streams */ |
---|
100 | #define ROAR_VIO_CTL_GET_STREAM (ROAR_VIO_CTL_STREAM|ROAR_VIO_CTL_CLIENT|ROAR_VIO_CTL_GET) |
---|
101 | #define ROAR_VIO_CTL_SET_DMXSCHAN (ROAR_VIO_CTL_STREAM|ROAR_VIO_CTL_CLIENT|ROAR_VIO_CTL_SET|0x10) /* simple DMX Channel */ |
---|
102 | #define ROAR_VIO_CTL_GET_DMXSCHAN (ROAR_VIO_CTL_STREAM|ROAR_VIO_CTL_CLIENT|ROAR_VIO_CTL_GET|0x10) |
---|
103 | #define ROAR_VIO_CTL_SET_DMXUNIV (ROAR_VIO_CTL_STREAM|ROAR_VIO_CTL_CLIENT|ROAR_VIO_CTL_SET|0x20) /* DMX Universe */ |
---|
104 | #define ROAR_VIO_CTL_GET_DMXUNIV (ROAR_VIO_CTL_STREAM|ROAR_VIO_CTL_CLIENT|ROAR_VIO_CTL_GET|0x20) |
---|
105 | |
---|
106 | #define ROAR_VIO_CTL_SET_SSTREAM (ROAR_VIO_CTL_STREAM|ROAR_VIO_CTL_SERVER|ROAR_VIO_CTL_SET) /* server streams */ |
---|
107 | #define ROAR_VIO_CTL_GET_SSTREAM (ROAR_VIO_CTL_STREAM|ROAR_VIO_CTL_SERVER|ROAR_VIO_CTL_GET) |
---|
108 | #define ROAR_VIO_CTL_SET_SSTREAMID (ROAR_VIO_CTL_STREAM|ROAR_VIO_CTL_SERVER|ROAR_VIO_CTL_SET|0x10) /* server streams */ |
---|
109 | #define ROAR_VIO_CTL_GET_SSTREAMID (ROAR_VIO_CTL_STREAM|ROAR_VIO_CTL_SERVER|ROAR_VIO_CTL_GET|0x10) |
---|
110 | |
---|
111 | #define ROAR_VIO_CTL_SET_AUINFO (ROAR_VIO_CTL_STREAM|ROAR_VIO_CTL_SET|0x2000) /* set a struct roar_audio_info */ |
---|
112 | #define ROAR_VIO_CTL_GET_AUINFO (ROAR_VIO_CTL_STREAM|ROAR_VIO_CTL_GET|0x2000) /* get a struct roar_audio_info */ |
---|
113 | |
---|
114 | #define ROAR_VIO_CTL_GET_DELAY (ROAR_VIO_CTL_STREAM|ROAR_VIO_CTL_GET|0x010) /* return in bytes as the vio interface */ |
---|
115 | /* does not know anything about streams */ |
---|
116 | |
---|
117 | #define ROAR_VIO_CTL_GET_DBLOCKS (ROAR_VIO_CTL_DRIVER|0x0001) /* get Driver Blocks */ |
---|
118 | #define ROAR_VIO_CTL_SET_DBLOCKS (ROAR_VIO_CTL_DRIVER|0x0002) /* set Driver Blocks */ |
---|
119 | #define ROAR_VIO_CTL_GET_DBLKSIZE (ROAR_VIO_CTL_DRIVER|0x0003) /* get Driver Blocks size (in byte) */ |
---|
120 | #define ROAR_VIO_CTL_SET_DBLKSIZE (ROAR_VIO_CTL_DRIVER|0x0004) /* set Driver Blocks size (in byte) */ |
---|
121 | #define ROAR_VIO_CTL_GET_VOLUME (ROAR_VIO_CTL_DRIVER|ROAR_VIO_CTL_GET|0x10) |
---|
122 | #define ROAR_VIO_CTL_SET_VOLUME (ROAR_VIO_CTL_DRIVER|ROAR_VIO_CTL_SET|0x10) |
---|
123 | |
---|
124 | // consts for ROAR_VIO_CTL_SHUTDOWN: |
---|
125 | #define ROAR_VIO_SHUTDOWN_READ 0x1 |
---|
126 | #define ROAR_VIO_SHUTDOWN_WRITE 0x2 |
---|
127 | #define ROAR_VIO_SHUTDOWN_LISTEN 0x4 /* like close() on listen sock but allow padding requests */ |
---|
128 | /* to be accept()ed */ |
---|
129 | #define ROAR_VIO_SHUTDOWN_RW (ROAR_VIO_SHUTDOWN_READ|ROAR_VIO_SHUTDOWN_WRITE) |
---|
130 | |
---|
131 | // Data format used for read/write(): |
---|
132 | |
---|
133 | // _D_ata _F_ormat _T_ypes: |
---|
134 | // generic types: |
---|
135 | #define ROAR_VIO_DFT_UNKNOWN -1 |
---|
136 | #define ROAR_VIO_DFT_NULL 0x0000 |
---|
137 | #define ROAR_VIO_DFT_RAW 0x0001 /* raw bytes, default */ |
---|
138 | |
---|
139 | // RoarAudio types: |
---|
140 | #define ROAR_VIO_DFT_RA_MESSAGE 0x0101 |
---|
141 | #define ROAR_VIO_DFT_RA_BUFFER 0x0102 |
---|
142 | |
---|
143 | // extern types: |
---|
144 | #define ROAR_VIO_DFT_OGG_PAGE 0x0201 |
---|
145 | #define ROAR_VIO_DFT_OGG_PACKET 0x0202 |
---|
146 | |
---|
147 | struct roar_vio_dataformat { |
---|
148 | unsigned int type; |
---|
149 | }; |
---|
150 | |
---|
151 | struct roar_vio_sysio_ioctl { |
---|
152 | long long int cmd; |
---|
153 | void * argp; |
---|
154 | }; |
---|
155 | |
---|
156 | struct roar_vio_sysio_sockopt { |
---|
157 | int level; |
---|
158 | int optname; |
---|
159 | void * optval; |
---|
160 | socklen_t optlen; |
---|
161 | }; |
---|
162 | |
---|
163 | #if 0 |
---|
164 | struct stat { |
---|
165 | dev_t st_dev; /* ID of device containing file */ |
---|
166 | ino_t st_ino; /* inode number */ |
---|
167 | X mode_t st_mode; /* protection */ |
---|
168 | X nlink_t st_nlink; /* number of hard links */ |
---|
169 | X uid_t st_uid; /* user ID of owner */ |
---|
170 | X gid_t st_gid; /* group ID of owner */ |
---|
171 | dev_t st_rdev; /* device ID (if special file) */ |
---|
172 | X off_t st_size; /* total size, in bytes */ |
---|
173 | X blksize_t st_blksize; /* blocksize for filesystem I/O */ |
---|
174 | X blkcnt_t st_blocks; /* number of blocks allocated */ |
---|
175 | time_t st_atime; /* time of last access */ |
---|
176 | time_t st_mtime; /* time of last modification */ |
---|
177 | time_t st_ctime; /* time of last status change */ |
---|
178 | }; |
---|
179 | #endif |
---|
180 | |
---|
181 | struct roar_vio_stat { |
---|
182 | mode_t mode; |
---|
183 | size_t linkc; |
---|
184 | uid_t uid; |
---|
185 | gid_t gid; |
---|
186 | size_t size; |
---|
187 | size_t blksize; |
---|
188 | size_t blocks; |
---|
189 | }; |
---|
190 | |
---|
191 | // struct for userpass: |
---|
192 | struct roar_userpass { |
---|
193 | int subtype; |
---|
194 | char * user; |
---|
195 | char * pass; |
---|
196 | }; |
---|
197 | |
---|
198 | // for ROAR_VIO_CTL_GET_SOCKNAME and ROAR_VIO_CTL_GET_PEERNAME |
---|
199 | struct roar_sockname { |
---|
200 | int flags; |
---|
201 | int type; |
---|
202 | char * addr; |
---|
203 | int port; |
---|
204 | }; |
---|
205 | |
---|
206 | #endif |
---|
207 | |
---|
208 | //ll |
---|