capnp

NAME

capnp - compiler for Capn Proto data interchange format definition files

SYNOPSIS

capnp [<options>] <command> [<args>]

capnp id

capnp [--help | --version]

DESCRIPTION

This manual page documents briefly the capnp command.

It was written for the Debian distribution because the original program does not have a manual page.

capnp is wrapper for various tools used to manipulate the Capn Proto data interchange format. These tools include a definition file compiler, a C++ backend, a decoder for converting Capn Proto messages to text and a generator for Capn Proto definition IDs.

OPTIONS

The program follows the usual GNU command line syntax, with long options starting with two dashes (`-). A summary of options is included below.

-IDIR, --import-pathDIR

Add DIR to the list of directories searched for non-relative imports (ones that start with a /).

--no-standard-import

Do not add any default import paths; use only those specified by -I. Otherwise, typically /usr/include and /usr/local/include are added by default.

--verbose

Log informational messages to stderr; useful for debugging.

--help

Show summary of options.

--version

Show version of program.

COMMANDS

compile

Compile Capn Proto schema files & generate corresponding source code in one or more languages.

OPTIONS

-I*<dir>, --import-path=<dir>*
Add <dir> to the list of directories searched for non-relative imports (ones that start with a /).
--no-standard-import
Do not add any default import paths; use only those specified by -I. Otherwise, typically /usr/include and /usr/local/include are added by default.
-olang[:dir], **--output=**lang[:dir]
Generate source code for language <lang> in directory <dir> (default: current directory). <lang> actually specifies a plugin to use. If <lang> is a simple word, the compiler for a plugin called capnpc-<lang> in $PATH. If <lang> is a file path containing slashes, it is interpreted as the exact plugin executable file name, and $PATH is not searched.
--src-prefix=<prefix>
If a file specified for compilation starts with <prefix>, remove the prefix for the purpose of deciding the names of output files. For example, the following command: capnp --src-prefix=foo/bar -oc++:corge foo/bar/baz/qux.capnp would generate the files corge/baz/qux.capnp.{h,c++}.

decode

Decodes one or more encoded Capn Proto messages as text. Messages are read from standard input and by default are expected to be in standard Capn Proto serialization format.

OPTIONS

-I*<dir>, --import-path=<dir>*
Add <dir> to the list of directories searched for non-relative imports (ones that start with a /).
-f, --flat
Interpret the input as one large single-segment message rather than a stream in standard serialization format.
--no-standard-import
Do not add any default import paths; use only those specified by -I. Otherwise, typically /usr/include and /usr/local/include are added by default.
-p, --packed
Expect the input to be packed using standard Capn Proto packing, which deflates zero-valued bytes.
--short
Print in short (non-pretty) format. Each message will be printed on one line, without using whitespace to improve readability.

id

Generates a unique identifier for Capn Proto schema files.

AUTHOR

Tom Lee <debian@tomlee.co>

Wrote this manpage for the Debian system.

COPYRIGHT

This manual page was written for the Debian system (and may be used by others).

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or (at your option) any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.