qapi: Improve specificity of type/member descriptions
[qemu/armbru.git] / chardev / char-fe.c
blob7789f7be9c873928be895d618e98978b504005d5
1 /*
2 * QEMU System Emulator
4 * Copyright (c) 2003-2008 Fabrice Bellard
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22 * THE SOFTWARE.
24 #include "qemu/osdep.h"
25 #include "qemu/error-report.h"
26 #include "qapi/error.h"
27 #include "qapi/qmp/qerror.h"
28 #include "sysemu/replay.h"
30 #include "chardev/char-fe.h"
31 #include "chardev/char-io.h"
32 #include "chardev-internal.h"
34 int qemu_chr_fe_write(CharBackend *be, const uint8_t *buf, int len)
36 Chardev *s = be->chr;
38 if (!s) {
39 return 0;
42 return qemu_chr_write(s, buf, len, false);
45 int qemu_chr_fe_write_all(CharBackend *be, const uint8_t *buf, int len)
47 Chardev *s = be->chr;
49 if (!s) {
50 return 0;
53 return qemu_chr_write(s, buf, len, true);
56 int qemu_chr_fe_read_all(CharBackend *be, uint8_t *buf, int len)
58 Chardev *s = be->chr;
59 int offset = 0;
60 int res;
62 if (!s || !CHARDEV_GET_CLASS(s)->chr_sync_read) {
63 return 0;
66 if (qemu_chr_replay(s) && replay_mode == REPLAY_MODE_PLAY) {
67 return replay_char_read_all_load(buf);
70 while (offset < len) {
71 retry:
72 res = CHARDEV_GET_CLASS(s)->chr_sync_read(s, buf + offset,
73 len - offset);
74 if (res == -1 && errno == EAGAIN) {
75 g_usleep(100);
76 goto retry;
79 if (res == 0) {
80 break;
83 if (res < 0) {
84 if (qemu_chr_replay(s) && replay_mode == REPLAY_MODE_RECORD) {
85 replay_char_read_all_save_error(res);
87 return res;
90 offset += res;
93 if (qemu_chr_replay(s) && replay_mode == REPLAY_MODE_RECORD) {
94 replay_char_read_all_save_buf(buf, offset);
96 return offset;
99 int qemu_chr_fe_ioctl(CharBackend *be, int cmd, void *arg)
101 Chardev *s = be->chr;
102 int res;
104 if (!s || !CHARDEV_GET_CLASS(s)->chr_ioctl || qemu_chr_replay(s)) {
105 res = -ENOTSUP;
106 } else {
107 res = CHARDEV_GET_CLASS(s)->chr_ioctl(s, cmd, arg);
110 return res;
113 int qemu_chr_fe_get_msgfd(CharBackend *be)
115 Chardev *s = be->chr;
116 int fd;
117 int res = (qemu_chr_fe_get_msgfds(be, &fd, 1) == 1) ? fd : -1;
118 if (s && qemu_chr_replay(s)) {
119 error_report("Replay: get msgfd is not supported "
120 "for serial devices yet");
121 exit(1);
123 return res;
126 int qemu_chr_fe_get_msgfds(CharBackend *be, int *fds, int len)
128 Chardev *s = be->chr;
130 if (!s) {
131 return -1;
134 return CHARDEV_GET_CLASS(s)->get_msgfds ?
135 CHARDEV_GET_CLASS(s)->get_msgfds(s, fds, len) : -1;
138 int qemu_chr_fe_set_msgfds(CharBackend *be, int *fds, int num)
140 Chardev *s = be->chr;
142 if (!s) {
143 return -1;
146 return CHARDEV_GET_CLASS(s)->set_msgfds ?
147 CHARDEV_GET_CLASS(s)->set_msgfds(s, fds, num) : -1;
150 void qemu_chr_fe_accept_input(CharBackend *be)
152 Chardev *s = be->chr;
154 if (!s) {
155 return;
158 if (CHARDEV_GET_CLASS(s)->chr_accept_input) {
159 CHARDEV_GET_CLASS(s)->chr_accept_input(s);
161 qemu_notify_event();
164 void qemu_chr_fe_printf(CharBackend *be, const char *fmt, ...)
166 char buf[CHR_READ_BUF_LEN];
167 va_list ap;
168 va_start(ap, fmt);
169 vsnprintf(buf, sizeof(buf), fmt, ap);
170 /* XXX this blocks entire thread. Rewrite to use
171 * qemu_chr_fe_write and background I/O callbacks */
172 qemu_chr_fe_write_all(be, (uint8_t *)buf, strlen(buf));
173 va_end(ap);
176 Chardev *qemu_chr_fe_get_driver(CharBackend *be)
178 /* this is unsafe for the users that support chardev hotswap */
179 assert(be->chr_be_change == NULL);
180 return be->chr;
183 bool qemu_chr_fe_backend_connected(CharBackend *be)
185 return !!be->chr;
188 bool qemu_chr_fe_backend_open(CharBackend *be)
190 return be->chr && be->chr->be_open;
193 bool qemu_chr_fe_init(CharBackend *b, Chardev *s, Error **errp)
195 int tag = 0;
197 if (s) {
198 if (CHARDEV_IS_MUX(s)) {
199 MuxChardev *d = MUX_CHARDEV(s);
201 if (d->mux_cnt >= MAX_MUX) {
202 goto unavailable;
205 d->backends[d->mux_cnt] = b;
206 tag = d->mux_cnt++;
207 } else if (s->be) {
208 goto unavailable;
209 } else {
210 s->be = b;
214 b->fe_open = false;
215 b->tag = tag;
216 b->chr = s;
217 return true;
219 unavailable:
220 error_setg(errp, QERR_DEVICE_IN_USE, s->label);
221 return false;
224 void qemu_chr_fe_deinit(CharBackend *b, bool del)
226 assert(b);
228 if (b->chr) {
229 qemu_chr_fe_set_handlers(b, NULL, NULL, NULL, NULL, NULL, NULL, true);
230 if (b->chr->be == b) {
231 b->chr->be = NULL;
233 if (CHARDEV_IS_MUX(b->chr)) {
234 MuxChardev *d = MUX_CHARDEV(b->chr);
235 d->backends[b->tag] = NULL;
237 if (del) {
238 Object *obj = OBJECT(b->chr);
239 if (obj->parent) {
240 object_unparent(obj);
241 } else {
242 object_unref(obj);
245 b->chr = NULL;
249 void qemu_chr_fe_set_handlers_full(CharBackend *b,
250 IOCanReadHandler *fd_can_read,
251 IOReadHandler *fd_read,
252 IOEventHandler *fd_event,
253 BackendChangeHandler *be_change,
254 void *opaque,
255 GMainContext *context,
256 bool set_open,
257 bool sync_state)
259 Chardev *s;
260 int fe_open;
262 s = b->chr;
263 if (!s) {
264 return;
267 if (!opaque && !fd_can_read && !fd_read && !fd_event) {
268 fe_open = 0;
269 remove_fd_in_watch(s);
270 } else {
271 fe_open = 1;
273 b->chr_can_read = fd_can_read;
274 b->chr_read = fd_read;
275 b->chr_event = fd_event;
276 b->chr_be_change = be_change;
277 b->opaque = opaque;
279 qemu_chr_be_update_read_handlers(s, context);
281 if (set_open) {
282 qemu_chr_fe_set_open(b, fe_open);
285 if (fe_open) {
286 qemu_chr_fe_take_focus(b);
287 /* We're connecting to an already opened device, so let's make sure we
288 also get the open event */
289 if (sync_state && s->be_open) {
290 qemu_chr_be_event(s, CHR_EVENT_OPENED);
295 void qemu_chr_fe_set_handlers(CharBackend *b,
296 IOCanReadHandler *fd_can_read,
297 IOReadHandler *fd_read,
298 IOEventHandler *fd_event,
299 BackendChangeHandler *be_change,
300 void *opaque,
301 GMainContext *context,
302 bool set_open)
304 qemu_chr_fe_set_handlers_full(b, fd_can_read, fd_read, fd_event, be_change,
305 opaque, context, set_open,
306 true);
309 void qemu_chr_fe_take_focus(CharBackend *b)
311 if (!b->chr) {
312 return;
315 if (CHARDEV_IS_MUX(b->chr)) {
316 mux_set_focus(b->chr, b->tag);
320 int qemu_chr_fe_wait_connected(CharBackend *be, Error **errp)
322 if (!be->chr) {
323 error_setg(errp, "missing associated backend");
324 return -1;
327 return qemu_chr_wait_connected(be->chr, errp);
330 void qemu_chr_fe_set_echo(CharBackend *be, bool echo)
332 Chardev *chr = be->chr;
334 if (chr && CHARDEV_GET_CLASS(chr)->chr_set_echo) {
335 CHARDEV_GET_CLASS(chr)->chr_set_echo(chr, echo);
339 void qemu_chr_fe_set_open(CharBackend *be, int fe_open)
341 Chardev *chr = be->chr;
343 if (!chr) {
344 return;
347 if (be->fe_open == fe_open) {
348 return;
350 be->fe_open = fe_open;
351 if (CHARDEV_GET_CLASS(chr)->chr_set_fe_open) {
352 CHARDEV_GET_CLASS(chr)->chr_set_fe_open(chr, fe_open);
356 guint qemu_chr_fe_add_watch(CharBackend *be, GIOCondition cond,
357 FEWatchFunc func, void *user_data)
359 Chardev *s = be->chr;
360 GSource *src;
361 guint tag;
363 if (!s || CHARDEV_GET_CLASS(s)->chr_add_watch == NULL) {
364 return 0;
367 src = CHARDEV_GET_CLASS(s)->chr_add_watch(s, cond);
368 if (!src) {
369 return 0;
372 g_source_set_callback(src, (GSourceFunc)func, user_data, NULL);
373 tag = g_source_attach(src, s->gcontext);
374 g_source_unref(src);
376 return tag;
379 void qemu_chr_fe_disconnect(CharBackend *be)
381 Chardev *chr = be->chr;
383 if (chr && CHARDEV_GET_CLASS(chr)->chr_disconnect) {
384 CHARDEV_GET_CLASS(chr)->chr_disconnect(chr);