blob: 9b989e7e0842d87dbe0eb9bed87382a97804b93a [file] [log] [blame]
Laszlo Ersekeb7ee2c2012-07-17 16:17:09 +02001/*
2 * Options Visitor
3 *
4 * Copyright Red Hat, Inc. 2012
5 *
6 * Author: Laszlo Ersek <lersek@redhat.com>
7 *
8 * This work is licensed under the terms of the GNU LGPL, version 2.1 or later.
9 * See the COPYING.LIB file in the top-level directory.
10 *
11 */
12
13#ifndef OPTS_VISITOR_H
14#define OPTS_VISITOR_H
15
Paolo Bonzini7b1b5d12012-12-17 18:19:43 +010016#include "qapi/visitor.h"
Laszlo Ersekeb7ee2c2012-07-17 16:17:09 +020017
Laszlo Ersek15a849b2013-08-20 00:35:38 +020018/* Inclusive upper bound on the size of any flattened range. This is a safety
19 * (= anti-annoyance) measure; wrong ranges should not cause long startup
20 * delays nor exhaust virtual memory.
21 */
22#define OPTS_VISITOR_RANGE_MAX 65536
23
Laszlo Ersekeb7ee2c2012-07-17 16:17:09 +020024typedef struct OptsVisitor OptsVisitor;
25
26/* Contrarily to qemu-option.c::parse_option_number(), OptsVisitor's "int"
27 * parser relies on strtoll() instead of strtoull(). Consequences:
28 * - string representations of negative numbers yield negative values,
29 * - values below INT64_MIN or LLONG_MIN are rejected,
30 * - values above INT64_MAX or LLONG_MAX are rejected.
Eric Blakeadfb2642016-04-28 15:45:20 -060031 *
32 * The Opts input visitor does not implement support for visiting QAPI
Eric Blake3bc97fd2016-04-28 15:45:22 -060033 * alternates, numbers (other than integers), null, or arbitrary
Eric Blaked9f62dd2016-04-28 15:45:31 -060034 * QTypes. It also requires a non-null list argument to
35 * visit_start_list().
Laszlo Ersekeb7ee2c2012-07-17 16:17:09 +020036 */
Eric Blake09204ea2016-06-09 10:48:36 -060037Visitor *opts_visitor_new(const QemuOpts *opts);
Laszlo Ersekeb7ee2c2012-07-17 16:17:09 +020038
39#endif