Scroll to navigation

ovsdb-idlc(1) Open vSwitch Manual ovsdb-idlc(1)


ovsdb-idlc - Open vSwitch IDL (Interface Definition Language) compiler


ovsdb-idlc annotate schema annotations
ovsdb-idlc c-idl-header idl
ovsdb-idlc c-idl-source idl
ovsdb-idlc --help
ovsdb-idlc --version


The ovsdb-idlc program is a command-line tool for translating Open vSwitch database interface definition language (IDL) schemas into other formats. It is used while building Open vSwitch, not at installation or configuration time. Thus, it is not normally installed as part of Open vSwitch.

The idl files used as input for most ovsdb-idlc commands have the same format as the OVSDB schemas, specified in the OVSDB specification, with a few additions:

"idlPrefix" member of <database-schema>
This member, which is required, specifies a string that is prefixed to top-level names in C bindings. It should probably end in an underscore.
"idlHeader" member of <database-schema>
This member, which is required, specifies the name of the IDL header. It will be output on an #include line in the source file generated by the C bindings. It should include the bracketing "" or <>.


Reads schema, which should be a file in JSON format (ordinarily an OVSDB schema file), then reads and executes the Python syntax fragment in annotations. The Python syntax fragment is passed the JSON object as a local variable named s. It may modify this data in any way. After the Python code returns, the object as modified is re-serialized as JSON on standard output.
Reads idl and prints on standard output a C header file that defines a structure for each table defined by the schema.
Reads idl and prints on standard output a C source file that implements C bindings for the database defined by the schema.



ovsdb-idlc is more lenient about the format of OVSDB schemas than other OVSDB tools. It may successfully parse schemas that, e.g., ovsdb-tool rejects.


The OVSDB specification.

November 2009 Open vSwitch