.\" Copyright (c) 2018-2022, 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/>.
.\"
.TH dnsjit.core.loader 3 "1.2.3" "dnsjit"
.SH NAME
dnsjit.core.loader \- Dynamic library loader
.SH SYNOPSIS
  local loader = require("dnsjit.core.loader")
  loader.load("example-input-zero/zero")
.SH DESCRIPTION
Module for loading dynamic libraries (.so) in more ways then LuaJIT can.
This is mainly used in external modules.
.SS Functions
.TP
.BR Loader.load "(name, global)"
Search
.B package.cpath
for the given name and load the first found.
If
.B global
is true (default true if not given) then the loaded symbols will also
be available globally.
Returns the loaded C library as per
.BR ffi.load() .
.br
The
.B ?
in each path of
.B package.cpath
will be replace by the given name, so usually the ".so" part of the
library does not need to be given.
See
.I package.cpath
and
.I package.loaders
in Lua 5.1 for more information.
.SH AUTHORS and CONTRIBUTORS
Jerry Lundström (DNS-OARC),
Tomáš Křížek (CZ.NIC),
Petr Špaček (ISC)
.LP
Maintained by DNS-OARC
.LP
.RS
.I https://www.dns-oarc.net/
.RE
.LP
.SH BUGS
For issues and feature requests please use:
.LP
.RS
\fIhttps://github.com/DNS-OARC/dnsjit/issues\fP
.RE
.LP
For question and help please use:
.LP
.RS
\fIadmin@dns-oarc.net\fP
.RE
.LP