transform: luaxform transform script

[jlucovsky]

Continuation of #11940

Add the luaxform transform that uses a Lua script to receive and transform a sticky buffer.

Lua transforms receive arguments

• (always): length of input buffer and input buffer
• (always): number of additional arguments (may be 0)
• (when present): argument array (bounded by argument count)

Arguments are passed to the Lua script as they appear in the rule:

 luaxform:./lua/lua-transform.lua, bytes 4, offset 13, hash sha256;

When the transform is invoked, 3 additional arguments are passed (arg count will be 3)

• bytes 4
• offset 13
• hash sha256

The Lua script is responsible for parsing and using the arguments and returning a tuple: output-buffer, output-buffer-byte-count

I used this Lua script:

function init (args)
  -- Optional, no return value
end

function transform(input_len, input, argc, args)
    SCLogNotice("Input length: " .. input_len .. " arg-count: " .. argc)
    for i = 1, argc do
        print("Argument " .. i .. ":", args[i])
    end
    return string.upper(input), input_len
end

return 0

Example rule using the Lua script:

alert http any any -> any any (msg:"Lua Xform example"; flow:established;  file.data; luaxform:./lua/lua-transform.lua; content: "abc"; sid: 1;)

Link to ticket: https://redmine.openinfosecfoundation.org/issues/2290

Describe changes:

• Luaxform transform changes

Updates

• Rebase

Provide values to any of the below to override the defaults.

• To use an LibHTP, Suricata-Verify or Suricata-Update pull request,
  link to the pull request in the respective _BRANCH variable.
• Leave unused overrides blank or remove.

SV_REPO=
SV_BRANCH=OISF/suricata-verify#2090
SU_REPO=
SU_BRANCH=
LIBHTP_REPO=
LIBHTP_BRANCH=

[codecov]

Codecov Report

Attention: Patch coverage is 86.78815% with 58 lines in your changes missing coverage. Please review.

Project coverage is 83.00%. Comparing base (55b922c) to head (b3930a3).
Report is 32 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master   #11989      +/-   ##
==========================================
+ Coverage   82.75%   83.00%   +0.25%     
==========================================
  Files         910      913       +3     
  Lines      249016   258395    +9379     
==========================================
+ Hits       206069   214493    +8424     
- Misses      42947    43902     +955     

Flag	Coverage Δ
fuzzcorpus	60.95% <46.52%> (+0.14%)	⬆️
livemode	19.39% <12.94%> (+0.68%)	⬆️
pcap	44.40% <30.45%> (+0.28%)	⬆️
suricata-verify	62.66% <83.93%> (+0.37%)	⬆️
unittests	59.25% <28.47%> (+0.24%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

[suricata-qa]

Information: QA ran without warnings.

Pipeline 23135

[jufajardini]

Added some nit(ish) documentation comments.

[jlucovsky]

Continued in #12072