kumo.apply_supplemental_trace_header

kumo.apply_supplemental_trace_header(msg, opt_params)

Since: Dev Builds Only

The functionality described in this section requires a dev build of KumoMTA. You can obtain a dev build by following the instructions in the Installation section.

Builds a supplemental trace header according to the optional parameters, and adds it to the message.

If opt_params is omitted or is nil, then the default params will be used. The parameters are the same as the start_esmtp_listener.trace_headers parameter value.

Example: add a default supplemental trace header

Both of these examples are equivalent:

kumo.apply_supplemental_trace_header(msg)

kumo.apply_supplemental_trace_header(msg, {
  supplemental_header = true,
  header_name = 'X-KumoRef',
  include_meta_names = {},
})