Postfix mruby database plugin

Require

Postfix

Postfix 3.0 with dynamicmaps=yes. See Postfix Installtion From Source Code.

mruby

To build libmruby.so:

% git clone https://github.com/mruby/mruby.git
% cd mruby
% git checkout 097bfdcac573861567716e4247265becec6b249a .
% patch -p1 < mruby.diff
% make
% mkdir -p $MRUBYDIR
% cp ./build/host/lib/libmruby.so $MRUBYDIR

mruby.diff is here.

Install

% git clone https://github.com/tmtm/postfix-mruby.git
% cd postfix-mruby
% gcc -I $POSTFIX_SRC_DIR/include -I $MRUBY_WORK_DIR/include -fPIC -g -O -DLINUX3 -c postfix-mruby.c
% LD_RUN_PATH=$MRUBYDIR gcc -shared -o postfix-mruby.so postfix-mruby.o -L$MRUBYDIR -lmruby -lm
% sudo cp postfix-mruby.so $(postconf -h shlib_directory)

and, add mruby postfix-mruby.so dict_mruby_open configuration into /path/to/etc/dynamicmaps.cf

Usage

Write mruby script that returns an object with #lookup method.

The #lookup method takes one argument and returns String.

Use mruby:fullpath_of_the_script as lookup table.

Example

[upcase.rb]

class Upcase
  def lookup(key)
    Log.info "input: #{key}" if Log.verbose?
    return key.upcase
  end
end
Upcase.new

% postmap -q abc mruby:/path/to/upcase.rb
ABC

Logging

• Log.verbose returns verbose level (Fixnum).
• Log.verbose? returns true (if verbose > 0) or false (if verbose == 0).
• Log.info(msg) log info level message.
• Log.warn(msg) log warn level message.
• Log.error(msg) log error level message.
• Log.fatal(msg) log fatal level message and abort.

License

MIT license