zeek/tools/bifcl
Jon Siwek a86b98bb9e bifcl: Move headers into include/ subdir
This avoids potential problems with libc++ 8+ on case-insensitive file
systems due to inclusion of a new header called <version> which will end
up conflicting with the VERSION file if the search path includes the
project root.
2025-08-20 08:52:24 -07:00
..
include bifcl: Move headers into include/ subdir 2025-08-20 08:52:24 -07:00
bif_arg.cc bifcl: Port bifcl code from Bro 2025-08-20 08:52:24 -07:00
builtin-func.l bifcl: Rename Bro to Zeek 2025-08-20 08:52:24 -07:00
builtin-func.y bifcl: Rename Bro to Zeek 2025-08-20 08:52:24 -07:00
CMakeLists.txt bifcl: Move headers into include/ subdir 2025-08-20 08:52:24 -07:00
module_util.cc bifcl: Port bifcl code from Bro 2025-08-20 08:52:24 -07:00
README bifcl: Rename Bro to Zeek 2025-08-20 08:52:24 -07:00

.. _Zeek: https://www.zeek.org

=================
Zeek BIF Compiler
=================

The ``bifcl`` program simply takes a ``.bif`` file as input and
generates C++ header/source files along with a ``.zeek`` script
that all-together provide the declaration and implementation of Zeek_
Built-In-Functions (BIFs), which can then be compiled and shipped
as part of a Zeek plugin.

A BIF allows one to write arbitrary C++ code and access it via a
function call inside a Zeek script.  In this way, they can also be
used to access parts of Zeek's internal C++ API that aren't already
exposed via their own BIFs.

At the moment, learning the format of a ``.bif`` file is likely easiest
by just taking a look at the ``.bif`` files inside the Zeek source-tree.