[2058] | 1 | //vio_ctl.h: |
---|
| 2 | |
---|
| 3 | /* |
---|
[4708] | 4 | * Copyright (C) Philipp 'ph3-der-loewe' Schafft - 2008-2011 |
---|
[2058] | 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 |
---|
[3517] | 21 | * the Free Software Foundation, 51 Franklin Street, Fifth Floor, |
---|
| 22 | * Boston, MA 02110-1301, USA. |
---|
[2058] | 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 |
---|
[2858] | 55 | |
---|
[2058] | 56 | #define ROAR_VIO_CTL_CLIENT 0x0000 |
---|
| 57 | #define ROAR_VIO_CTL_SERVER 0x1000 |
---|
[2858] | 58 | |
---|
[2058] | 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: |
---|
[3435] | 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 */ |
---|
[3769] | 78 | #define ROAR_VIO_CTL_ACCEPT (ROAR_VIO_CTL_GENERIC|0x0170) /* accept(), vio* */ |
---|
[3796] | 79 | #define ROAR_VIO_CTL_SHUTDOWN (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_SET|0x0174) /* shutdown(), int */ |
---|
[3852] | 80 | #define ROAR_VIO_CTL_SYSIO_IOCTL (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_SET|0x0180) /* ioctl(), */ |
---|
| 81 | /* struct roar_vio_sysio_ioctl* */ |
---|
[3878] | 82 | #define ROAR_VIO_CTL_FSTAT (ROAR_VIO_CTL_GENERIC|ROAR_VIO_CTL_GET|0x0184) /* fstat() */ |
---|
[4705] | 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() */ |
---|
[4718] | 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() */ |
---|
[2858] | 87 | |
---|
[4530] | 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 | |
---|
[2858] | 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) |
---|
[2058] | 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 | |
---|
[3796] | 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) |
---|
[2058] | 130 | |
---|
[2858] | 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 | |
---|
[3852] | 151 | struct roar_vio_sysio_ioctl { |
---|
| 152 | long long int cmd; |
---|
| 153 | void * argp; |
---|
| 154 | }; |
---|
| 155 | |
---|
[4718] | 156 | struct roar_vio_sysio_sockopt { |
---|
| 157 | int level; |
---|
| 158 | int optname; |
---|
| 159 | void * optval; |
---|
| 160 | socklen_t optlen; |
---|
| 161 | }; |
---|
| 162 | |
---|
[3878] | 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 | |
---|
[4530] | 191 | // struct for userpass: |
---|
| 192 | struct roar_userpass { |
---|
| 193 | int subtype; |
---|
| 194 | char * user; |
---|
| 195 | char * pass; |
---|
| 196 | }; |
---|
| 197 | |
---|
[4705] | 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 | |
---|
[2058] | 206 | #endif |
---|
| 207 | |
---|
| 208 | //ll |
---|