source: roaraudio/roard/include/client.h @ 5823:f9f70dbaa376

Last change on this file since 5823:f9f70dbaa376 was 5823:f9f70dbaa376, checked in by phi, 11 years ago

updated copyright

File size: 5.3 KB
Line 
1//client.h:
2
3/*
4 *      Copyright (C) Philipp 'ph3-der-loewe' Schafft - 2008-2013
5 *
6 *  This file is part of roard 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 *  RoarAudio 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 */
25
26#ifndef _CLIENT_H_
27#define _CLIENT_H_
28
29/*
30 Defined in <roaraudio/client.h>
31
32
33#define ROAR_BUFFER_NAME 80
34
35#define ROAR_CLIENTS_MAX 64
36#define ROAR_CLIENTS_MAX_STREAMS_PER_CLIENT 4
37
38struct roar_client {
39 int fh; /-* controll connection *-/
40// int last_stream; /-* id of the last stream created *-/
41 char name[ROAR_BUFFER_NAME];
42 int pid;
43 char host[ROAR_BUFFER_NAME];
44 int execed;
45 int streams[ROAR_CLIENTS_MAX_STREAMS_PER_CLIENT];
46} * g_clients[ROAR_CLIENTS_MAX];
47*/
48
49// access level:
50enum roard_client_acclev {
51 ACCLEV_ERROR    = -1, // used as erorr return value.
52 ACCLEV_NONE     =  0, // only very basic commands like NOOP and IDENTIFY
53 ACCLEV_IDENTED,       // same as NONE but INDENTIFY worked.
54 ACCLEV_CONCTL,        // only allowed to do basic connection things.
55 ACCLEV_GUEST,         // guest connection (read only)
56 ACCLEV_USER,          // normal user connect (read write)
57 ACCLEV_PWRUSER,       // power user, may access other user's clients
58 ACCLEV_ALL            // full (admin) access (read write ctl)
59};
60
61struct roar_client_nsubscribe {
62 struct roar_subscriber * sub;
63};
64
65extern struct roar_client_server {
66 struct roar_client _client;
67 size_t blockc;
68 struct roar_subscriber ** waits;
69 enum roard_client_acclev acclev;
70 // may be used by protocols working directly on big data blocks to buffer a bit:
71 struct roar_buffer * inbuf, * outbuf;
72 void * protoinst;
73} * g_clients[ROAR_CLIENTS_MAX];
74
75struct roard_listen;
76
77struct roard_proto {
78 int proto;
79 int subsystems;
80 const char * description;
81 struct roar_dl_lhandle * lhandle;
82 int (*new_client)(int client, struct roar_vio_calls * vio, struct roard_listen * lsock);
83 int (*delete_client)(int client);
84 int (*check_client)(int client, struct roar_vio_calls * vio);
85 int (*flush_client)(int client, struct roar_vio_calls * vio);
86 int (*flushed_client)(int client, struct roar_vio_calls * vio);
87};
88
89enum roard_proto_type {
90 ROARD_PROTO_TYPE_BUILDIN = 0,
91// ROARD_PROTO_TYPE_ROARDPROTO = 1, // old. Removed in 1.0beta6.
92 ROARD_PROTO_TYPE_COMMON = 2
93};
94
95struct roard_proto_handle {
96 int proto;
97 struct roar_dl_lhandle * lhandle;
98 enum roard_proto_type type;
99 const struct roar_keyval * para;
100 ssize_t paralen;
101 union {
102  int buildin; // dummy
103  const struct roar_dl_proto * common;
104 } impl;
105};
106
107#define MAX_PROTOS 16
108
109// basic functions
110int clients_init       (void);
111int clients_free       (void);
112int clients_new        (void);
113int clients_new_from_fh(int fh, int proto, int byteorder, int update_nnode);
114int clients_new_from_fh2(int fh, int proto, int byteorder,
115                         int update_nnode,
116                         struct roard_listen * lsock, struct sockaddr * sockaddr, socklen_t addrlen);
117int clients_delete     (int id);
118int clients_close      (int id, int nocheck_exec);
119int clients_set_fh     (int id, int    fh);
120int clients_set_pid    (int id, int    pid);
121int clients_set_uid    (int id, int    uid);
122int clients_set_gid    (int id, int    gid);
123int clients_set_name   (int id, const char * name);
124int clients_set_proto  (int id, int    proto);
125int clients_get        (int id, struct roar_client ** client);
126int clients_get_server (int id, struct roar_client_server ** client);
127int clients_get_fh     (int id);
128
129int clients_block      (int id, int unblock);
130
131// network functions
132int clients_check_all  (void);
133int clients_check      (int id);
134int clients_flush      (int id);
135int clients_send_mon   (struct roar_audio_info * sa);
136int clients_send_filter(struct roar_audio_info * sa);
137
138int clients_add_output (int id, struct roar_buffer ** buf);
139
140// proto support
141const struct roard_proto_handle * clients_get_protohandle(const int proto);
142int clients_register_proto_common(const struct roar_dl_proto * proto, struct roar_dl_lhandle * lhandle);
143int clients_unregister_proto(int proto);
144void print_protolist        (enum output_format format);
145
146// stream functions
147int client_stream_exec   (int client, int stream);
148int client_stream_set_fh (int client, int stream, int fh);
149int client_stream_add    (int client, int stream);
150int client_stream_delete (int client, int stream);
151int client_stream_move   (int client, int stream);
152
153// notify thingys
154int  clients_wait    (int client, struct roar_event * events, size_t num);
155void clients_ncb_wait(struct roar_notify_core * core, struct roar_event * event, void * userdata);
156
157// acclev:
158enum roard_client_acclev clients_str2acclev(const char * acclev);
159const char * clients_acclev2str(const enum roard_client_acclev acclev);
160
161#endif
162
163//ll
Note: See TracBrowser for help on using the repository browser.