build.md

build guide

doxastica is written in C/C++: it's built for compilation by CL.exe and LINK.exe from the windows platform SDK. to build doxastica, use the provided "build.bat".

this builds with the tools from the windows 10 platform sdk

invoke this as follows:

• build clean: clean up all binaries
• build prereqs32 / build prereqs64 build xed, lua5.3 and beaengine in 32 or 64 bit
• build bins32 / build bins64 (requires prereqs32/prereqs64) build shackle32/shackle64.dll, peek.exe and ldr32/ldr64.exe
• bincommit copy all executable files to binz/

additionally, you can build individual modules, as thus:

• build xed32/xed64
• build bea32/bea64
• build lua32/lua64
• build shackle32/shackle64
• build peek
• build ldr32/ldr64

extending lua

The primary method of extending doxastica is by adding more lua functions - the lua core itself is fairly stable and works across x32/x64 modern apps. To add a function, you need to:

• Create the function. Copy one of the cs_ functions from anywhere
• Pass your parameters from lua (lua_tointeger, etc)
• Do your function
• Push your return value to the stack (As an integer, typically, but anything goes)

You need to also call lua_register to make lua recognize your function as a valid callable:

lua_register(luaState,"malloc",cs_malloc);

That's it, it's that simple - your host application will now have access to the lua function and vice versa.