Vm Merge

wiki

Overview

This script is designed to take a Lua source file, run luac to generate the Lua VM code, and merge the two together.

eg. Using the following code :-

a = {}

b = a.x

print(b)

luac produces :-


main <0:@a.lua> (9 instructions/36 bytes at 002F29E8)

0 params, 2 stacks, 0 locals, 4 strings, 0 numbers, 0 functions, 5 lines

     1	[2]	CREATETABLE	0

     2	[2]	SETGLOBAL  	0	; a

     3	[3]	GETGLOBAL  	0	; a

     4	[3]	GETDOTTED  	2	; x

     5	[3]	SETGLOBAL  	1	; b

     6	[4]	GETGLOBAL  	3	; print

     7	[4]	GETGLOBAL  	1	; b

     8	[4]	CALL       	0 0

     9	[4]	END

The script will merge the source and VM code to produce :-


 a = {}

 	CREATETABLE	0

 	SETGLOBAL  	0	; a

 b = a.x

 	GETGLOBAL  	0	; a

 	GETDOTTED  	2	; x

 	SETGLOBAL  	1	; b

 print(b)

 	GETGLOBAL  	3	; print

 	GETGLOBAL  	1	; b

 	CALL       	0 0

 	END

It can also produce the above in HTML format to make it a bit easier on the eye (unfortunately no HTML preview facility is available on this site) :-


<html><pre>

<b>a = {}</b>

        CREATETABLE	0

        SETGLOBAL  	0	; a

<b>b = a.x</b>

        GETGLOBAL  	0	; a

        GETDOTTED  	2	; x

        SETGLOBAL  	1	; b

<b>print(b)</b>

        GETGLOBAL  	3	; print

        GETGLOBAL  	1	; b

        CALL       	0 0

        END</pre></html>

Note, the above example is without line numbers. You can find some more examples on OptimisationTips page.

Command line

Get the script (below).
Run the script using: lua -f vmmerge.lua ...options...
Make sure you have the lua and luac executables in your path. luac -p -l is used to generated the VM code.
--fmt merge|html chooses output format (see above).
--nol removes line numbers
Pipe the output into a file to save it. eg. "... > file.txt"
eg. lua -f vmmerge.lua --file my.lua --fmt html > my.html

Vm Merge

Overview

Command line

Download

See Also