OS Manuals

/usr/bin/capnpc

Cap'n Proto serialization/RPC system - core runtime library

From capnproto 1.5.0-r4 (enterprise-packages), captured 2026-11-08 by running capnpc --help (exit 0). permalink

Usage: /usr/bin/capnpc [<option>...] <source>...

Compiles Cap'n Proto schema files and generates 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 '/').
    -i, --generate-id
        Generate a new 64-bit unique ID for use in a Cap'n Proto schema.
    --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.
    -o<lang>[:<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 searches 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.  If <lang> is '-', the compiler dumps the request to
        standard output.
    --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 compile --src-prefix=foo/bar -oc++:corge foo/bar/baz/qux.capnp
        would generate the files corge/baz/qux.capnp.{h,c++}.
    --verbose
        Log informational messages to stderr; useful for debugging.
    --version
        Print version information and exit.
    --help
        Display this help text and exit.
Options (8)
OptionDescriptionSource
-I, --import-path dirAdd <dir> to the list of directories searched for non-relative imports (ones that start with a '/').help
-i, --generate-idGenerate a new 64-bit unique ID for use in a Cap'n Proto schema.help
--no-standard-importDo not add any default import paths;help
-o, --output lang>[:<dirGenerate source code for language <lang> in directory <dir> (default: current directory).help
--src-prefix prefixIf a file specified for compilation starts with <prefix>, remove the prefix for the purpose of deciding the names of output files.help
--verboseLog informational messages to stderr;help
--versionPrint version information and exit.help
--helpDisplay this help text and exit.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.