---
name: "ecppc"
section: "1"
platform: "linux"
package: "libtntnet-dev"
version: "3.0-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ecppc"
---

# ecppc(1)

compiler for ecpp(7)

## NAME

ecppc - compiler for [ecpp(7)](/ecpp/7.md)

## SYNOPSIS

`ecppc` \[`-bhszvtM`\] \[`-s-`\] \[`-o` *filename*\]  \[`-n` *name*\] \[`-m` *mimetype*\] \[`--mimetypes` *filename*\] \[`-I` *dir*\] \[`-l` *log-category*\] *filename*

`ecppc` `-bb` *filename* ...

`ecppc` \[`OPTION`\]

## DESCRIPTION

`ecppc` is the compiler for the ecpp-language. `ecpp` is a template language, which lets the user embed C++-code  into HTML  for  use  in  [tntnet(8)](/tntnet/8.md). `ecppc` generates a C++-class from a ecpp template. It can also compile binary data into a C++-class, which makes it possible to integrate them in a tntnet application.

## OPTIONS

`-b`\
   This enables binary-mode. Ecppc does not look for ecpp-tags, but creates a\
   class, which just copies the data

`-bb`\
   This enables multi-binary-mode. Every binary-file has some overhead, when\
   packed into a tntnet-application. This overhead can be quite significant, when\
   binary-files are small, like small icons in a web application. To reduce this\
   overhead, multiple binaries can be packed into a single class, which removes\
   the per-binary overhead completely.

When the component is called, it uses the path-info-parameter\
   (request.getPathInfo()) from the request, to decide, which binary to send. If\
   no filename matches the path-info, processing is declined. The binaries need\
   not be of same mime-type, since the mime-type is looked automatically from the\
   mime-database by file- extension of the source-file.

`-i` *filename*\
   In multi binary mode (option `-bb`) filenames can be read from the file\
   specified with this option. This can be useful when the command line gets too\
   long or just for convenience.

`-I` *dir*\
   Search include-files in directory. This option can be passed multiple times.\
   All specified directories are searched in turn for include-files.

`-l` *log-category*\
   Set log category. Default is *component.componentname*.

`-L`\
   Disable generation of #line-directives

`-m` *mimetype*\
   Set mimetype of output. This is the mimetype, sent by the component to the\
   browser in the Content-Type- header. Without this parameter the mimetype is\
   looked up from the mime-database of your system using the file-extension of\
   the source-file.

`--mimetypes` *file*\
   Read mimetypes from file (default: /etc/mime.types).

`-M`\
   This disables normal processing and prints just the ecpp-dependencies from\
   this component. The output can be included into a Makefile. Ecpp-dependencies\
   are introduces by the \<%include\>-tag.

`-C, --cmake`\
   Prints ecpp dependencies in a syntax, which `cmake` understands.

`-n` *name*\
   Set the name of the component. Normally this is derived from the\
   source-file-name by removing the path and .ecpp-extension.

`-o` *filename*\
   Write the generated file to the specified file instead of deriving the\
   filename from the source-file-name.  The outputfilename is normally the\
   source-file where the extension is replaced by .cpp.

`-p`\
   Keep path name when deriving name of component from input file name.

`-s`\
   Generate singleton. Normally ecppc decides automatically, if the template is\
   suitable for a singleton.  This option force ecppc to generate a singleton.

`-s-`\
   Do not generate a singleton.

`-v`\
   Enable verbose mode. This prints additional information about the processing\
   on the standard-output.

`-z`\
   Compress the data in the component. Compressed data is automatically\
   decopressed on first use. This reduces the code-size, but slightly slows down\
   the first call of the component.

`-h, --help`\
   display this information

`-V, --version`\
   display program version

## AUTHOR

This manual page was written by Tommi Mäkitalo  ⟨tommi@tntnet.org⟩.

## SEE ALSO

[tntnet(8)](/tntnet/8.md), [ecpp(7)](/ecpp/7.md)