summaryrefslogtreecommitdiffstats
path: root/include/dnsjit/output/respdiff.lua
blob: 7d17b4acdfaf04120f073db4919fe52f1b876659 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
-- Copyright (c) 2018-2021, OARC, Inc.
-- All rights reserved.
--
-- This file is part of dnsjit.
--
-- dnsjit is free software: you can redistribute it and/or modify
-- it under the terms of the GNU General Public License as published by
-- the Free Software Foundation, either version 3 of the License, or
-- (at your option) any later version.
--
-- dnsjit is distributed in the hope that it will be useful,
-- but WITHOUT ANY WARRANTY; without even the implied warranty of
-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-- GNU General Public License for more details.
--
-- You should have received a copy of the GNU General Public License
-- along with dnsjit.  If not, see <http://www.gnu.org/licenses/>.

-- dnsjit.output.respdiff
-- Output to respdiff LMDB
--   local output = require("dnsjit.output.respdiff").new("/path/to/lmdb")
--
-- Output to an LMDB database (format 2018-05-21) that can be used by respdiff
-- to compare the responses found in the input data with the responses
-- received.
-- The receive function expects to get a chain of 2 or 3
-- .IR core.object.payload .
-- For a completed query; The top of the chain is the query, after it the
-- original response and then the received response.
-- For a timed out query; The top of the chain is the query, after it the
-- original response.
module(...,package.seeall)

require("dnsjit.output.respdiff_h")
local ffi = require("ffi")
local C = ffi.C

local t_name = "output_respdiff_t"
local output_respdiff_t = ffi.typeof(t_name)
local Respdiff = {}

-- Create a new Respdiff output and created the LMDB database in the directory
-- .IR path .
-- The
-- .I origname
-- and
-- .I recvname
-- are used to populate the meta table, these names should be the same as
-- what is configured in
-- .IR respdiff.cfg .
-- Optional
-- .I mapsize
-- can be given to increase the database size beyond the default size of 10MB.
function Respdiff.new(path, origname, recvname, mapsize)
    if mapsize == nil then
        mapsize = 10485760
    end
    local self = {
        obj = output_respdiff_t(),
        path = path,
        origname = origname,
        recvname = recvname,
    }
    C.output_respdiff_init(self.obj, path, mapsize)
    ffi.gc(self.obj, C.output_respdiff_destroy)
    return setmetatable(self, { __index = Respdiff })
end

-- Return the Log object to control logging of this instance or module.
function Respdiff:log()
    if self == nil then
        return C.output_respdiff_log()
    end
    return self.obj._log
end

-- Return the C functions and context for receiving objects.
function Respdiff:receive()
    return C.output_respdiff_receiver(self.obj), self.obj
end

-- Commit the LMDB transactions, can not store any more objects after this
-- call.
-- The given
-- .I start_time
-- and
-- .I end_time
-- are used to fill the meta table.
function Respdiff:commit(start_time, end_time)
    C.output_respdiff_commit(self.obj, self.origname, self.recvname, start_time, end_time)
end

-- respdiff " https://gitlab.nic.cz/knot/respdiff"
return Respdiff