Jonathan Brossard WCC internal documentation

The Witchcraft Compiler Collection

http://github.com/endrazine/wcc/

Contents

1	Data Structure Index				1
	1.1	Data Structures .		. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	1
2	File Index				3
	2.1	File List	. . . . .	. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	3
3	Data Structure Documentation				5
	3.1	breakpoint_t Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			5
		3.1.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		5
		3.1.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		5
			3.1.2.1	backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	5
			3.1.2.2	ptr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	5
			3.1.2.3	weight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	5
	3.2	ctx_t Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			5
		3.2.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		6
		3.2.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		6
			3.2.2.1	abfd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	6
			3.2.2.2	archsz . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	6
			3.2.2.3	base_address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	7
			3.2.2.4	binname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	7
			3.2.2.5	coreﬁle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	7
			3.2.2.6	fdout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	7
			3.2.2.7	has_relativerelocations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	7
			3.2.2.8	mphdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	7
			3.2.2.9	mphnum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	7
			3.2.2.10	mshdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	7
			3.2.2.11	mshnum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	7
			3.2.2.12	opt_arch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	7
			3.2.2.13	opt_asmdebug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	7
			3.2.2.14	opt_binname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	7
			3.2.2.15	opt_core . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	8
			3.2.2.16	opt_debug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	8

iv				CONTENTS
		3.2.2.17	opt_entrypoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 8
		3.2.2.18	opt_exec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 8
		3.2.2.19	opt_ﬂags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 8
		3.2.2.20	opt_interp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 8
		3.2.2.21	opt_original . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 8
		3.2.2.22	opt_poison . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 8
		3.2.2.23	opt_reloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 8
		3.2.2.24	opt_shared . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 8
		3.2.2.25	opt_sstrip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 8
		3.2.2.26	opt_static . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 8
		3.2.2.27	opt_strip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 9
		3.2.2.28	opt_verbose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 9
		3.2.2.29	phnum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 9
		3.2.2.30	shnum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 9
		3.2.2.31	start_phdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 9
		3.2.2.32	start_shdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 9
		3.2.2.33	strndx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 9
		3.2.2.34	strndx_index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 9
		3.2.2.35	strndx_len . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 9
3.3	elfdata_t Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			. . . . 9
	3.3.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 10
	3.3.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 10
		3.3.2.1	base . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 10
		3.3.2.2	dyn_index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 10
		3.3.2.3	dyns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 10
		3.3.2.4	ehdr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 10
		3.3.2.5	et_dyn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 10
		3.3.2.6	limit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 10
		3.3.2.7	link_map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 10
		3.3.2.8	p_pltgot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 10
		3.3.2.9	phdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 10
		3.3.2.10	r_debug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 11
3.4	eps_t Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			. . . . 11
	3.4.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 11
	3.4.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 11
		3.4.2.1	addr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 11
		3.4.2.2	name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 11
		3.4.2.3	next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 11
		3.4.2.4	prev . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 11
3.5	gimport_t Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			. . . . 11

The Witchcraft Compiler Collection

CONTENTS				v
	3.5.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		12
	3.5.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		12
		3.5.2.1	r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	12
		3.5.2.2	rtype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	12
		3.5.2.3	sec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	12
		3.5.2.4	sindex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	12
		3.5.2.5	sname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	12
3.6	help_t Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			12
	3.6.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		12
	3.6.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		13
		3.6.2.1	descr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	13
		3.6.2.2	name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	13
		3.6.2.3	proto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	13
		3.6.2.4	protopreﬁx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	13
		3.6.2.5	retval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	13
3.7	learn_key_t Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			13
	3.7.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		13
	3.7.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		13
		3.7.2.1	targ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	13
		3.7.2.2	tfunction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	13
		3.7.2.3	tlib . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	14
		3.7.2.4	ttype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	14
		3.7.2.5	tvalue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	14
3.8	learn_t Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			14
	3.8.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		14
	3.8.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		14
		3.8.2.1	hh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	14
		3.8.2.2	key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	14
		3.8.2.3	toffset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	14
3.9	linenoiseCompletions Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			14
	3.9.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		15
	3.9.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		15
		3.9.2.1	cvec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	15
		3.9.2.2	len . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	15
3.10	lua_Debug Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			15
	3.10.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		15
	3.10.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		16
		3.10.2.1	currentline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	16
		3.10.2.2	event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	16
		3.10.2.3	i_ci . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	16

The Witchcraft Compiler Collection

vi				CONTENTS
		3.10.2.4	istailcall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 16
		3.10.2.5	isvararg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 16
		3.10.2.6	lastlinedeﬁned . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 16
		3.10.2.7	linedeﬁned . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 16
		3.10.2.8	name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 16
		3.10.2.9	namewhat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 16
		3.10.2.10	nparams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 16
		3.10.2.11	nups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 16
		3.10.2.12	short_src . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 16
		3.10.2.13	source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 17
		3.10.2.14 what . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 17
3.11	luaL_Buffer Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			. . . . 17
	3.11.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 17
	3.11.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 17
		3.11.2.1	b . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 17
		3.11.2.2	initb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 17
		3.11.2.3	L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 17
		3.11.2.4	n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 17
		3.11.2.5	size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 18
3.12	luaL_Reg Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			. . . . 18
	3.12.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 18
	3.12.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 18
		3.12.2.1	func . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 18
		3.12.2.2	name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 18
3.13	luaL_Stream Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			. . . . 18
	3.13.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 18
	3.13.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 19
		3.13.2.1	closef . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 19
		3.13.2.2	f . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 19
3.14	msec_t Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			. . . . 19
	3.14.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 19
	3.14.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 19
		3.14.2.1	data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 19
		3.14.2.2	ﬂags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 19
		3.14.2.3	len . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 19
		3.14.2.4	name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 19
		3.14.2.5	next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 20
		3.14.2.6	outoffset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 20
		3.14.2.7	prev . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 20
		3.14.2.8	s_bfd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 20

The Witchcraft Compiler Collection

CONTENTS				vii
		3.14.2.9	s_elf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	20
3.15	mseg_t Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			20
	3.15.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		20
	3.15.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		20
		3.15.2.1	next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	20
		3.15.2.2	p_align . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	21
		3.15.2.3	p_ﬁlesz . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	21
		3.15.2.4	p_ﬂags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	21
		3.15.2.5	p_memsz . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	21
		3.15.2.6	p_offset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	21
		3.15.2.7	p_paddr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	21
		3.15.2.8	p_type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	21
		3.15.2.9	p_vaddr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	21
		3.15.2.10 prev . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		21
3.16	preload_t Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			21
	3.16.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		22
	3.16.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		22
		3.16.2.1	name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	22
		3.16.2.2	next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	22
		3.16.2.3	prev . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	22
3.17	range_t Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			22
	3.17.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		22
	3.17.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		22
		3.17.2.1	max . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	22
		3.17.2.2	min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	22
3.18	script_t Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			23
	3.18.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		23
	3.18.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		23
		3.18.2.1	name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	23
		3.18.2.2	next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	23
		3.18.2.3	prev . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	23
3.19	section Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			23
	3.19.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		24
	3.19.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		24
		3.19.2.1	end . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	24
		3.19.2.2	hperms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	24
		3.19.2.3	init . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	24
		3.19.2.4	name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	24
		3.19.2.5	next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	24
		3.19.2.6	num . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	24

The Witchcraft Compiler Collection

viii				CONTENTS
		3.19.2.7	perms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 24
		3.19.2.8	proba . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 24
		3.19.2.9	probableval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 24
		3.19.2.10 size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 24
3.20	sections_t Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			. . . . 25
	3.20.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 25
	3.20.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 25
		3.20.2.1	addr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 25
		3.20.2.2	ﬂags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 25
		3.20.2.3	libname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 25
		3.20.2.4	name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 25
		3.20.2.5	next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 25
		3.20.2.6	perms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 25
		3.20.2.7	prev . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 25
		3.20.2.8	size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 26
3.21	segments_t Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			. . . . 26
	3.21.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 26
	3.21.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 26
		3.21.2.1	addr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 26
		3.21.2.2	ﬂags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 26
		3.21.2.3	libname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 26
		3.21.2.4	next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 26
		3.21.2.5	perms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 26
		3.21.2.6	prev . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 27
		3.21.2.7	size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 27
		3.21.2.8	type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 27
3.22	signame_t Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			. . . . 27
	3.22.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 27
	3.22.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 27
		3.22.2.1	name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 27
		3.22.2.2	signal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 27
3.23	symaddr Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			. . . . 27
	3.23.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 28
	3.23.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 28
		3.23.2.1	addr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 28
		3.23.2.2	name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 28
		3.23.2.3	next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 28
3.24	symbols_t Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			. . . . 28
	3.24.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 28
	3.24.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 28

The Witchcraft Compiler Collection

CONTENTS				ix
		3.24.2.1	addr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	28
		3.24.2.2	hbind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	29
		3.24.2.3	htype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	29
		3.24.2.4	libname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	29
		3.24.2.5	next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	29
		3.24.2.6	prev . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	29
		3.24.2.7	size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	29
		3.24.2.8	symbol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	29
		3.24.2.9	value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	29
3.25	tuple_t Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			29
	3.25.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		29
	3.25.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		30
		3.25.2.1	addr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	30
		3.25.2.2	name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	30
3.26	wsh_t Struct Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			30
	3.26.1	Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		31
	3.26.2	Field Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		31
		3.26.2.1	bp_array . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	31
		3.26.2.2	bp_num . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	31
		3.26.2.3	bp_points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	31
		3.26.2.4	btcaller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	31
		3.26.2.5	eps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	31
		3.26.2.6	errcontext . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	31
		3.26.2.7	faultaddr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	32
		3.26.2.8	ﬁrstcontext . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	32
		3.26.2.9	ﬁrsterrno . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	32
		3.26.2.10	ﬁrstsicode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	32
		3.26.2.11	ﬁrstsignal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	32
		3.26.2.12	globalsignals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	32
		3.26.2.13	interrupted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	32
		3.26.2.14	is_stdinscript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	32
		3.26.2.15	L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	32
		3.26.2.16	learnﬁle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	32
		3.26.2.17	learnlog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	32
		3.26.2.18	longjmp_ptr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	32
		3.26.2.19	longjmp_ptr_high . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	33
		3.26.2.20	longjmp_ptr_high_cnt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	33
		3.26.2.21	mainhandle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	33
		3.26.2.22	opt_argc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	33
		3.26.2.23	opt_argv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	33

The Witchcraft Compiler Collection

x		CONTENTS
3.26.2.24 opt_hollywood . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 33
3.26.2.25 opt_rescan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 33
3.26.2.26 opt_verbose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 33
3.26.2.27 opt_verbosetrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 33
3.26.2.28 phdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 33
3.26.2.29 pltgot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 33
3.26.2.30 pltsz . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 33
3.26.2.31 preload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 34
3.26.2.32 reason . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 34
3.26.2.33 script_argnum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 34
3.26.2.34 script_args . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 34
3.26.2.35 scriptﬁle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 34
3.26.2.36 scriptname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 34
3.26.2.37 scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 34
3.26.2.38 shdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 34
3.26.2.39 sigbus_count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 34
3.26.2.40 sigbus_hash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 34
3.26.2.41 singlebranch_count . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 34
3.26.2.42 singlebranch_hash . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 34
3.26.2.43 singlestep_count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 35
3.26.2.44 singlestep_hash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 35
3.26.2.45 symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 35
3.26.2.46 totsignals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 35
3.26.2.47 trace_rtrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 35
3.26.2.48 trace_singlebranch . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 35
3.26.2.49 trace_singlestep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 35
3.26.2.50 trace_strace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 35
3.26.2.51 trace_unaligned . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 35
4 File Documentation		37
4.1 wcc/wcc.c File Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 37
4.1.1 Macro Deﬁnition Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 40
4.1.1.1 __USE_GNU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 40
4.1.1.2 _GNU_SOURCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 40
4.1.1.3	CS_MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 41
4.1.1.4 DEFAULT_STRNDX_SIZE . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 41
4.1.1.5	Elf_Addr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 41
4.1.1.6	Elf_Ehdr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 41
4.1.1.7	Elf_Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 41
4.1.1.8	Elf_Phdr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 41

The Witchcraft Compiler Collection

CONTENTS			xi
	4.1.1.9	ELF_R_INFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	41
	4.1.1.10	ELF_R_SYM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	41
	4.1.1.11	ELF_R_TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	41
	4.1.1.12	Elf_Rel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	41
	4.1.1.13	Elf_Rela . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	41
	4.1.1.14	Elf_Section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	41
	4.1.1.15	Elf_Shdr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	42
	4.1.1.16	ELF_ST_BIND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	42
	4.1.1.17	ELF_ST_TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	42
	4.1.1.18	Elf_Sword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	42
	4.1.1.19	Elf_Sym . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	42
	4.1.1.20	Elf_Word . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	42
	4.1.1.21	Elf_Xword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	42
	4.1.1.22	ELFCLASS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	42
	4.1.1.23	ELFMACHINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	42
	4.1.1.24	elis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	42
	4.1.1.25	EXTRA_CREATED_SECTIONS . . . . . . . . . . . . . . . . . . . . . . . . . .	42
	4.1.1.26	FLAG_BSS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	42
	4.1.1.27	FLAG_NOBIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	43
	4.1.1.28	FLAG_NOWRITE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	43
	4.1.1.29	FLAG_TEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	43
	4.1.1.30	iﬁs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	43
	4.1.1.31	MAXPADLEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	43
	4.1.1.32	nullstr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	43
	4.1.1.33	RELOC_MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	43
	4.1.1.34	RELOC_X86_32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	43
	4.1.1.35	RELOC_X86_64 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	43
4.1.2	Typedef Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		43
	4.1.2.1	ctx_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	43
	4.1.2.2	gimport_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	43
	4.1.2.3	msec_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	43
	4.1.2.4	mseg_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	43
4.1.3	Function Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		44
	4.1.3.1	add_extra_symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	44
	4.1.3.2	add_symaddr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	44
	4.1.3.3	adjust_baseaddress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	44
	4.1.3.4	alignfromname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	44
	4.1.3.5	alloc_phdr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	44
	4.1.3.6	analyze_text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	44
	4.1.3.7	append_reloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	44

The Witchcraft Compiler Collection

xii		CONTENTS
4.1.3.8	append_strtab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 44
4.1.3.9	append_sym . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 44
4.1.3.10	check_global_import . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 45
4.1.3.11	copy_body . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 45
4.1.3.12	craft_section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 45
4.1.3.13	create_phdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 45
4.1.3.14	ctx_getopt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 45
4.1.3.15	ctx_init . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 45
4.1.3.16	desired_arch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 45
4.1.3.17	entszfromname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 45
4.1.3.18	ﬁxup_strtab_and_symtab . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 45
4.1.3.19	ﬁxup_symtab_section_index . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 45
4.1.3.20	ﬁxup_text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 46
4.1.3.21	ﬂags_from_name . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 46
4.1.3.22	hexdump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 46
4.1.3.23	info_from_name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 46
4.1.3.24	internal_function_store . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 46
4.1.3.25	libify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 46
4.1.3.26	link_from_name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 47
4.1.3.27	load_binary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 47
4.1.3.28	main . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 47
4.1.3.29	max . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 47
4.1.3.30	merge_phdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 47
4.1.3.31	mk_section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 47
4.1.3.32	open_best . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 47
4.1.3.33	open_target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 48
4.1.3.34	patch_symbol_index . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 48
4.1.3.35	pﬂag_from_section . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 48
4.1.3.36	phdr_cmp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 48
4.1.3.37	phdr_cmp_premerge . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 48
4.1.3.38	print_bfd_sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 48
4.1.3.39	print_maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 48
4.1.3.40	print_msec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 48
4.1.3.41	print_version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 48
4.1.3.42	protect_perms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 48
4.1.3.43	ptype_from_section . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 49
4.1.3.44	rd_sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 49
4.1.3.45	rd_symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 49
4.1.3.46	rd_symtab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 49
4.1.3.47	reloc_htype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 49

The Witchcraft Compiler Collection

CONTENTS		xiii
4.1.3.48	reloc_htype_x86_32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	49
4.1.3.49	reloc_htype_x86_64 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	49
4.1.3.50	rm_section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	49
4.1.3.51	save_dynstr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	49
4.1.3.52	save_dynsym . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	49
4.1.3.53	save_global_import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	50
4.1.3.54	save_reloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	50
4.1.3.55	sec_name_from_index_after_strip . . . . . . . . . . . . . . . . . . . . . . . . .	50
4.1.3.56	secindex_from_name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	50
4.1.3.57	secindex_from_name_after_strip . . . . . . . . . . . . . . . . . . . . . . . . .	50
4.1.3.58	section_from_addr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	50
4.1.3.59	section_from_index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	50
4.1.3.60	section_from_name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	50
4.1.3.61	sort_phdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	50
4.1.3.62	sort_phdrs_premerge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	50
4.1.3.63	strip_binary_reloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	51
4.1.3.64	typefromname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	51
4.1.3.65	usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	51
4.1.4 Variable Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		51
4.1.4.1	allowed_sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	51
4.1.4.2	blnames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	51
4.1.4.3	datavma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	51
4.1.4.4	deltastrtab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	51
4.1.4.5	gimports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	51
4.1.4.6	gimportslen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	51
4.1.4.7	globalreloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	52
4.1.4.8	globalreloclen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	52
4.1.4.9	globalrelocoffset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	52
4.1.4.10	globalstrtab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	52
4.1.4.11	globalstrtablen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	52
4.1.4.12	globalstrtableoffset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	52
4.1.4.13	globalsymindex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	52
4.1.4.14	globalsymtab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	52
4.1.4.15	globalsymtablen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	52
4.1.4.16	globalsymtableoffset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	52
4.1.4.17	maxdata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	52
4.1.4.18	maxnewsec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	52
4.1.4.19	maxoldsec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	53
4.1.4.20	maxtext . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	53
4.1.4.21	mindata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	53

The Witchcraft Compiler Collection

xiv				CONTENTS
		4.1.4.22	mintext . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 53
		4.1.4.23	orig_sz . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 53
		4.1.4.24	orig_text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 53
		4.1.4.25	symaddrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 53
		4.1.4.26	textvma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 53
4.2	wld/wld.c File Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			. . . . 53
	4.2.1	Macro Deﬁnition Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 54
		4.2.1.1	DEFAULT_NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 54
	4.2.2	Function Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 54
		4.2.2.1	main . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 54
		4.2.2.2	mk_lib . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 54
		4.2.2.3	print_version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 54
4.3	wsh/helper.c File Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			. . . . 54
	4.3.1	Macro Deﬁnition Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 55
		4.3.1.1	_FILE_OFFSET_BITS . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 55
		4.3.1.2	_XOPEN_SOURCE . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 55
		4.3.1.3	HAS_ZFIRST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 55
	4.3.2	Function Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 55
		4.3.2.1	is_mapped . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 55
		4.3.2.2	read_maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 55
	4.3.3	Variable Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 55
		4.3.3.1	lastsignal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 55
		4.3.3.2	nsections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 55
		4.3.3.3	zﬁrst . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 56
4.4	wsh/include/colors.h File Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			. . . . 56
	4.4.1	Macro Deﬁnition Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 56
		4.4.1.1	BLACK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 56
		4.4.1.2	BLUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 56
		4.4.1.3	BROWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 56
		4.4.1.4	CLEAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 56
		4.4.1.5	CYAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 56
		4.4.1.6	DARKGRAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 56
		4.4.1.7	GRAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 56
		4.4.1.8	GREEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 57
		4.4.1.9	MAGENTA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 57
		4.4.1.10	NORMAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 57
		4.4.1.11	RED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 57
		4.4.1.12	YELLOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 57
4.5	wsh/include/lauxlib.h File Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			. . . . 57
	4.5.1	Macro Deﬁnition Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 59

The Witchcraft Compiler Collection

CONTENTS			xv
	4.5.1.1	LUA_ERRFILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	59
	4.5.1.2	LUA_FILEHANDLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	59
	4.5.1.3	LUA_NOREF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	59
	4.5.1.4	LUA_REFNIL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	59
	4.5.1.5	lua_writeline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	59
	4.5.1.6	lua_writestring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	59
	4.5.1.7	lua_writestringerror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	59
	4.5.1.8	luaL_addchar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	59
	4.5.1.9	luaL_addsize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	59
	4.5.1.10	luaL_argcheck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	60
	4.5.1.11	luaL_checkstring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	60
	4.5.1.12	luaL_checkversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	60
	4.5.1.13	luaL_doﬁle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	60
	4.5.1.14	luaL_dostring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	60
	4.5.1.15	luaL_getmetatable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	60
	4.5.1.16	luaL_loadbuffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	60
	4.5.1.17	luaL_loadﬁle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	60
	4.5.1.18	luaL_newlib . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	60
	4.5.1.19	luaL_newlibtable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	60
	4.5.1.20	LUAL_NUMSIZES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	60
	4.5.1.21	luaL_opt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	60
	4.5.1.22	luaL_optstring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	61
	4.5.1.23	luaL_prepbuffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	61
	4.5.1.24	luaL_typename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	61
4.5.2	Typedef Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		61
	4.5.2.1	luaL_Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	61
	4.5.2.2	luaL_Reg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	61
	4.5.2.3	luaL_Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	61
4.5.3	Function Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		61
	4.5.3.1	luaL_addlstring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	61
	4.5.3.2	luaL_addstring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	61
	4.5.3.3	luaL_addvalue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	61
	4.5.3.4	luaL_argerror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	61
	4.5.3.5	luaL_bufﬁnit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	61
	4.5.3.6	luaL_bufﬁnitsize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	61
	4.5.3.7	luaL_callmeta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	61
	4.5.3.8	luaL_checkany . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	61
	4.5.3.9	luaL_checkinteger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	61
	4.5.3.10	luaL_checklstring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	61
	4.5.3.11	luaL_checknumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	61

The Witchcraft Compiler Collection

xvi				CONTENTS
		4.5.3.12	luaL_checkoption . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 61
		4.5.3.13	luaL_checkstack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 61
		4.5.3.14	luaL_checktype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 61
		4.5.3.15	luaL_checkudata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 61
		4.5.3.16	luaL_checkversion_ . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 61
		4.5.3.17	luaL_error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.18	luaL_execresult . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.19	luaL_ﬁleresult . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.20	luaL_getmetaﬁeld . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.21	luaL_getsubtable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.22	luaL_gsub . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.23	luaL_len . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.24	luaL_loadbufferx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.25	luaL_loadﬁlex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.26	luaL_loadstring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.27	luaL_newmetatable . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.28	luaL_newstate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.29	luaL_optinteger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.30	luaL_optlstring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.31	luaL_optnumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.32	luaL_prepbuffsize . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.33	luaL_pushresult . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.34	luaL_pushresultsize . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.35	luaL_ref . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.36	luaL_requiref . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.37	luaL_setfuncs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.38	luaL_setmetatable . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.39	luaL_testudata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.40	luaL_tolstring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.41	luaL_traceback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.42	luaL_unref . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
		4.5.3.43	luaL_where . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 62
4.6	wsh/include/libwitch/helper.h File Reference . . . . . . . . . . . . . . . . . . . . . . . . .			. . . . 63
	4.6.1	Function Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 63
		4.6.1.1	is_mapped . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 63
		4.6.1.2	read_maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 63
	4.6.2	Variable Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 63
		4.6.2.1	nsections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 63
		4.6.2.2	zﬁrst . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 63
4.7	wsh/include/libwitch/mylaux.h File Reference . . . . . . . . . . . . . . . . . . . . . . . . .			. . . . 63

The Witchcraft Compiler Collection

CONTENTS				xvii
	4.7.1	Macro Deﬁnition Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		64
		4.7.1.1	luaL_argcheck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	64
		4.7.1.2	luaL_checkstring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	64
		4.7.1.3	luaL_doﬁle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	64
		4.7.1.4	luaL_dostring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	64
		4.7.1.5	luaL_getmetatable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	64
		4.7.1.6	luaL_loadbuffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	64
		4.7.1.7	luaL_newlib . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	64
		4.7.1.8	luaL_newlibtable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	64
		4.7.1.9	luaL_opt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	64
		4.7.1.10	luaL_optstring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	64
		4.7.1.11	luaL_typename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	64
4.8	wsh/include/libwitch/sigs.h File Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			65
	4.8.1	Typedef Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		65
		4.8.1.1	signame_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	65
	4.8.2	Variable Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		65
		4.8.2.1	signames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	65
4.9	wsh/include/libwitch/wsh.h File Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			66
	4.9.1	Macro Deﬁnition Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		70
		4.9.1.1	_GNU_SOURCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	70
		4.9.1.2	BIND_FLAGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	70
		4.9.1.3	DEFAULT_LEARN_FILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	70
		4.9.1.4	default_poison . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	70
		4.9.1.5	DEFAULT_SCRIPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	70
		4.9.1.6	DEFAULT_SCRIPT_INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . .	70
		4.9.1.7	DMGL_ANSI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	70
		4.9.1.8	DMGL_ARM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	70
		4.9.1.9	DMGL_PARAMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	70
		4.9.1.10	ELF32_ST_BIND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	70
		4.9.1.11	ELF32_ST_INFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	70
		4.9.1.12	ELF32_ST_TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	70
		4.9.1.13	ELF64_ST_BIND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	71
		4.9.1.14	ELF64_ST_INFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	71
		4.9.1.15	ELF64_ST_TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	71
		4.9.1.16	Elf_Dyn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	71
		4.9.1.17	Elf_Ehdr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	71
		4.9.1.18	Elf_Phdr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	71
		4.9.1.19	Elf_Shdr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	71
		4.9.1.20	Elf_Sym . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	71
		4.9.1.21	FAULT_EXEC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	71

The Witchcraft Compiler Collection

xviii		CONTENTS
4.9.1.22	FAULT_READ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 71
4.9.1.23	FAULT_WRITE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 71
4.9.1.24	HPERMSMAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 71
4.9.1.25	LINES_MAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 72
4.9.1.26	luaL_reg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 72
4.9.1.27	MAX_SIGNALS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 72
4.9.1.28	MIN_BIN_SIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 72
4.9.1.29	MY_CPU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 72
4.9.1.30	PROC_ASLR_PATH . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 72
4.9.1.31	read_arg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 72
4.9.1.32	read_arg1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 72
4.9.1.33	read_arg2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 73
4.9.1.34	read_arg3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 73
4.9.1.35	read_arg4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 74
4.9.1.36	SHELL_HISTORY_NAME . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 74
4.9.1.37	SKIP_BOTTOM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 74
4.9.1.38	SKIP_INIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 74
4.9.1.39	STB_GLOBAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 74
4.9.1.40	STB_GNU_SECONDARY . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 74
4.9.1.41	STB_GNU_UNIQUE . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 74
4.9.1.42	STB_LOCAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 74
4.9.1.43	STB_WEAK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 75
4.9.1.44	STT_COMMON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 75
4.9.1.45	STT_FILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 75
4.9.1.46	STT_FUNC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 75
4.9.1.47	STT_NOTYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 75
4.9.1.48	STT_OBJECT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 75
4.9.1.49	STT_SECTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 75
4.9.1.50	STT_TLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 75
4.9.1.51	USE_LUA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 75
4.9.2 Typedef Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 75
4.9.2.1	breakpoint_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 75
4.9.2.2	eps_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 75
4.9.2.3	preload_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 75
4.9.2.4	range_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 76
4.9.2.5	script_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 76
4.9.2.6	sections_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 76
4.9.2.7	segments_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 76
4.9.2.8	symbols_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 76
4.9.2.9	tuple_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 76

The Witchcraft Compiler Collection

CONTENTS		xix
4.9.2.10	wsh_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	76
4.9.3 Function Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		76
4.9.3.1	add_symbol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	76
4.9.3.2	alloccharbuf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	76
4.9.3.3	bfmap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	76
4.9.3.4	breakpoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	76
4.9.3.5	bsspolute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	77
4.9.3.6	cplus_demangle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	77
4.9.3.7	disable_aslr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	77
4.9.3.8	disable_core . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	77
4.9.3.9	do_loadlib . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	77
4.9.3.10	empty_phdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	77
4.9.3.11	empty_shdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	77
4.9.3.12	enable_aslr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	77
4.9.3.13	enable_core . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	78
4.9.3.14	entrypoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	78
4.9.3.15	execlib . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	78
4.9.3.16	gencore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	78
4.9.3.17	getcharbuf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	78
4.9.3.18	getsize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	78
4.9.3.19	grep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	78
4.9.3.20	grepptr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	78
4.9.3.21	headers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	78
4.9.3.22	help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	78
4.9.3.23	hexdump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	79
4.9.3.24	hollywood . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	79
4.9.3.25	info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	79
4.9.3.26	libcall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	79
4.9.3.27	loadbin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	80
4.9.3.28	ltrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	80
4.9.3.29	man . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	80
4.9.3.30	map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	80
4.9.3.31	newarray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	80
4.9.3.32	phdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	80
4.9.3.33	print_functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	80
4.9.3.34	print_libs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	80
4.9.3.35	print_objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	80
4.9.3.36	print_phdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	81
4.9.3.37	print_shdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	81
4.9.3.38	print_symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	81

The Witchcraft Compiler Collection

xx		CONTENTS
4.9.3.39	print_version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 81
4.9.3.40	priv_memcpy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 81
4.9.3.41	priv_strcat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 81
4.9.3.42	priv_strcpy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 81
4.9.3.43	procmap_lua . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 81
4.9.3.44	prototypes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 81
4.9.3.45	ralloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 82
4.9.3.46	rawmemaddr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 82
4.9.3.47	rawmemread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 82
4.9.3.48	rawmemstr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 82
4.9.3.49	rawmemstrlen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 82
4.9.3.50	rawmemusage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 82
4.9.3.51	rawmemwrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 82
4.9.3.52	rdnum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 82
4.9.3.53	rdstr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 83
4.9.3.54	reload_elfs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 83
4.9.3.55	rescan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 83
4.9.3.56	rtrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 83
4.9.3.57	script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 83
4.9.3.58	segment_add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 83
4.9.3.59 set_align_ﬂag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 83
4.9.3.60 set_branch_ﬂag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 83
4.9.3.61 set_trace_ﬂag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 83
4.9.3.62	setarray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 83
4.9.3.63	setcharbuf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 83
4.9.3.64	shdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 84
4.9.3.65	sicode_strerror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 84
4.9.3.66	signaltoname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 84
4.9.3.67	singlebranch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 84
4.9.3.68	singlestep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 84
4.9.3.69	systrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 84
4.9.3.70	traceunaligned . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 84
4.9.3.71	unrtrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 84
4.9.3.72 unset_align_ﬂag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 84
4.9.3.73 unset_branch_ﬂag . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 84
4.9.3.74 unset_trace_ﬂag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 84
4.9.3.75	unsinglebranch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 84
4.9.3.76	unsinglestep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 85
4.9.3.77	unsystrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 85
4.9.3.78	untraceunaligned . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 85

The Witchcraft Compiler Collection

CONTENTS				xxi
		4.9.3.79	unverbosetrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	85
		4.9.3.80	usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	85
		4.9.3.81	verbose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	85
		4.9.3.82	verbosetrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	85
		4.9.3.83	wsh_getopt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	85
		4.9.3.84	wsh_init . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	85
		4.9.3.85	wsh_loadlibs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	85
		4.9.3.86	wsh_run . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	85
		4.9.3.87	xalloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	86
		4.9.3.88	xfree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	86
	4.9.4	Variable Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		86
		4.9.4.1	__progname_full . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	86
4.10	wsh/include/libwitch/wsh_functions.h File Reference . . . . . . . . . . . . . . . . . . . . . . . . .			86
	4.10.1	Variable Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		86
		4.10.1.1	default_options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	86
		4.10.1.2	exposed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	86
		4.10.1.3	global_xalloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	86
		4.10.1.4	lua_blacklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	86
		4.10.1.5	lua_default_functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	87
		4.10.1.6	ranges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	87
4.11	wsh/include/linenoise.h File Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			87
	4.11.1	Typedef Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		88
		4.11.1.1	linenoiseCompletionCallback . . . . . . . . . . . . . . . . . . . . . . . . . . .	88
		4.11.1.2	linenoiseCompletions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	88
	4.11.2	Function Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		88
		4.11.2.1	linenoise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	88
		4.11.2.2	linenoiseAddCompletion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	88
		4.11.2.3	linenoiseClearScreen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	88
		4.11.2.4	linenoiseHistoryAdd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	88
		4.11.2.5	linenoiseHistoryLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	88
		4.11.2.6	linenoiseHistorySave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	88
		4.11.2.7	linenoiseHistorySetMaxLen . . . . . . . . . . . . . . . . . . . . . . . . . . . .	88
		4.11.2.8	linenoisePrintKeyCodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	88
		4.11.2.9	linenoiseSetCompletionCallback . . . . . . . . . . . . . . . . . . . . . . . . . .	88
		4.11.2.10 linenoiseSetMultiLine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		88
4.12	wsh/include/longjmp.h File Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			88
	4.12.1	Macro Deﬁnition Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		89
		4.12.1.1	CATCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	89
		4.12.1.2	ETRY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	89
		4.12.1.3	FINALLY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	89

The Witchcraft Compiler Collection

xxii		CONTENTS
4.12.1.4	THROW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 89
4.12.1.5	TRY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 89
4.13 wsh/include/lua.h File Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 89
4.13.1 Macro Deﬁnition Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 93
4.13.1.1	LUA_AUTHORS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 93
4.13.1.2	lua_call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 93
4.13.1.3	LUA_COPYRIGHT . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 93
4.13.1.4	LUA_ERRERR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 93
4.13.1.5	LUA_ERRGCMM . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 94
4.13.1.6	LUA_ERRMEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 94
4.13.1.7	LUA_ERRRUN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 94
4.13.1.8	LUA_ERRSYNTAX . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 94
4.13.1.9	LUA_GCCOLLECT . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 94
4.13.1.10	LUA_GCCOUNT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 94
4.13.1.11	LUA_GCCOUNTB . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 94
4.13.1.12	LUA_GCISRUNNING . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 94
4.13.1.13	LUA_GCRESTART . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 94
4.13.1.14	LUA_GCSETPAUSE . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 94
4.13.1.15	LUA_GCSETSTEPMUL . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 94
4.13.1.16	LUA_GCSTEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 94
4.13.1.17	LUA_GCSTOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 95
4.13.1.18	lua_getextraspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 95
4.13.1.19	LUA_HOOKCALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 95
4.13.1.20	LUA_HOOKCOUNT . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 95
4.13.1.21	LUA_HOOKLINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 95
4.13.1.22	LUA_HOOKRET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 95
4.13.1.23	LUA_HOOKTAILCALL . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 95
4.13.1.24	lua_insert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 95
4.13.1.25	lua_isboolean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 95
4.13.1.26	lua_isfunction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 95
4.13.1.27	lua_islightuserdata . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 95
4.13.1.28	lua_isnil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 95
4.13.1.29	lua_isnone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 96
4.13.1.30	lua_isnoneornil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 96
4.13.1.31	lua_istable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 96
4.13.1.32	lua_isthread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 96
4.13.1.33	LUA_MASKCALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 96
4.13.1.34	LUA_MASKCOUNT . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 96
4.13.1.35	LUA_MASKLINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 96
4.13.1.36	LUA_MASKRET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 96

The Witchcraft Compiler Collection

CONTENTS	xxiii
4.13.1.37 LUA_MINSTACK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	96
4.13.1.38 LUA_MULTRET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	96
4.13.1.39 lua_newtable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	96
4.13.1.40 LUA_NUMTAGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	96
4.13.1.41 LUA_OK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	97
4.13.1.42 LUA_OPADD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	97
4.13.1.43 LUA_OPBAND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	97
4.13.1.44 LUA_OPBNOT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	97
4.13.1.45 LUA_OPBOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	97
4.13.1.46 LUA_OPBXOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	97
4.13.1.47 LUA_OPDIV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	97
4.13.1.48 LUA_OPEQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	97
4.13.1.49 LUA_OPIDIV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	97
4.13.1.50 LUA_OPLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	97
4.13.1.51 LUA_OPLT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	97
4.13.1.52 LUA_OPMOD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	97
4.13.1.53 LUA_OPMUL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	98
4.13.1.54 LUA_OPPOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	98
4.13.1.55 LUA_OPSHL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	98
4.13.1.56 LUA_OPSHR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	98
4.13.1.57 LUA_OPSUB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	98
4.13.1.58 LUA_OPUNM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	98
4.13.1.59 lua_pcall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	98
4.13.1.60 lua_pop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	98
4.13.1.61 lua_pushcfunction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	98
4.13.1.62 lua_pushglobaltable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	98
4.13.1.63 lua_pushliteral . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	98
4.13.1.64 lua_register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	98
4.13.1.65 LUA_REGISTRYINDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	99
4.13.1.66 LUA_RELEASE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	99
4.13.1.67 lua_remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	99
4.13.1.68 lua_replace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	99
4.13.1.69 LUA_RIDX_GLOBALS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	99
4.13.1.70 LUA_RIDX_LAST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	99
4.13.1.71 LUA_RIDX_MAINTHREAD . . . . . . . . . . . . . . . . . . . . . . . . . . . .	99
4.13.1.72 LUA_SIGNATURE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	99
4.13.1.73 LUA_TBOOLEAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	99
4.13.1.74 LUA_TFUNCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	99
4.13.1.75 LUA_TLIGHTUSERDATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	99
4.13.1.76 LUA_TNIL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	99

The Witchcraft Compiler Collection

xxiv			CONTENTS
	4.13.1.77 LUA_TNONE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 100
	4.13.1.78 LUA_TNUMBER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 100
	4.13.1.79 lua_tointeger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 100
	4.13.1.80 lua_tonumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 100
	4.13.1.81 lua_tostring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 100
	4.13.1.82 LUA_TSTRING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 100
	4.13.1.83 LUA_TTABLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 100
	4.13.1.84 LUA_TTHREAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 100
	4.13.1.85 LUA_TUSERDATA . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 100
	4.13.1.86 lua_upvalueindex . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 100
	4.13.1.87 LUA_VERSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 100
	4.13.1.88 LUA_VERSION_MAJOR . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 100
	4.13.1.89 LUA_VERSION_MINOR . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 101
	4.13.1.90 LUA_VERSION_NUM . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 101
	4.13.1.91 LUA_VERSION_RELEASE . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 101
	4.13.1.92 LUA_YIELD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 101
	4.13.1.93 lua_yield . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 101
4.13.2	Typedef Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 101
	4.13.2.1	lua_Alloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 101
	4.13.2.2	lua_CFunction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 101
	4.13.2.3	lua_Debug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 101
	4.13.2.4	lua_Hook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 101
	4.13.2.5	lua_Integer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 101
	4.13.2.6	lua_KContext . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 101
	4.13.2.7	lua_KFunction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 101
	4.13.2.8	lua_Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 102
	4.13.2.9	lua_Reader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 102
	4.13.2.10	lua_State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 102
	4.13.2.11	lua_Unsigned . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 102
	4.13.2.12 lua_Writer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 102
4.13.3	Function Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 102
	4.13.3.1	lua_absindex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 102
	4.13.3.2	lua_arith . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 102
	4.13.3.3	lua_atpanic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 102
	4.13.3.4	lua_callk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 102
	4.13.3.5	lua_checkstack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 102
	4.13.3.6	lua_close . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 102
	4.13.3.7	lua_compare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 102
	4.13.3.8	lua_concat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 102
	4.13.3.9	lua_copy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 102

The Witchcraft Compiler Collection

CONTENTS	xxv
4.13.3.10 lua_createtable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	102
4.13.3.11 lua_dump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	102
4.13.3.12 lua_error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	102
4.13.3.13 lua_gc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	102
4.13.3.14 lua_getallocf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	102
4.13.3.15 lua_getﬁeld . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	102
4.13.3.16 lua_getglobal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.17 lua_gethook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.18 lua_gethookcount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.19 lua_gethookmask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.20 lua_geti . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.21 lua_getinfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.22 lua_getlocal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.23 lua_getmetatable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.24 lua_getstack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.25 lua_gettable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.26 lua_gettop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.27 lua_getupvalue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.28 lua_getuservalue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.29 lua_iscfunction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.30 lua_isinteger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.31 lua_isnumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.32 lua_isstring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.33 lua_isuserdata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.34 lua_isyieldable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.35 lua_len . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.36 lua_load . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.37 lua_newstate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.38 lua_newthread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.39 lua_newuserdata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.40 lua_next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.41 lua_pcallk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.42 lua_pushboolean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	103
4.13.3.43 lua_pushcclosure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	104
4.13.3.44 lua_pushfstring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	104
4.13.3.45 lua_pushinteger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	104
4.13.3.46 lua_pushlightuserdata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	104
4.13.3.47 lua_pushlstring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	104
4.13.3.48 lua_pushnil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	104
4.13.3.49 lua_pushnumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	104

The Witchcraft Compiler Collection

xxvi	CONTENTS
4.13.3.50 lua_pushstring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.51 lua_pushthread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.52 lua_pushvalue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.53 lua_pushvfstring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.54 lua_rawequal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.55 lua_rawget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.56 lua_rawgeti . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.57 lua_rawgetp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.58 lua_rawlen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.59 lua_rawset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.60 lua_rawseti . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.61 lua_rawsetp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.62 lua_resume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.63 lua_rotate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.64 lua_setallocf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.65 lua_setﬁeld . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.66 lua_setglobal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.67 lua_sethook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.68 lua_seti . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.69 lua_setlocal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.70 lua_setmetatable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 104
4.13.3.71 lua_settable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 105
4.13.3.72 lua_settop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 105
4.13.3.73 lua_setupvalue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 105
4.13.3.74 lua_setuservalue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 105
4.13.3.75 lua_status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 105
4.13.3.76 lua_stringtonumber . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 105
4.13.3.77 lua_toboolean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 105
4.13.3.78 lua_tocfunction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 105
4.13.3.79 lua_tointegerx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 105
4.13.3.80 lua_tolstring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 105
4.13.3.81 lua_tonumberx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 105
4.13.3.82 lua_topointer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 105
4.13.3.83 lua_tothread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 105
4.13.3.84 lua_touserdata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 105
4.13.3.85 lua_type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 105
4.13.3.86 lua_typename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 105
4.13.3.87 lua_upvalueid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 105
4.13.3.88 lua_upvaluejoin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 105
4.13.3.89 lua_version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 105

The Witchcraft Compiler Collection

CONTENTS			xxvii
	4.13.3.90 lua_xmove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		105
	4.13.3.91 lua_yieldk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		105
4.13.4	Variable Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		105
	4.13.4.1	lua_ident . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	105
4.14 wsh/include/luaconf.h File Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			105
4.14.1	Macro Deﬁnition Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		106
	4.14.1.1	l_ﬂoor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	106
	4.14.1.2	l_mathlim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	107
	4.14.1.3	l_mathop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	107
	4.14.1.4	l_sprintf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	107
	4.14.1.5	LUA_API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	107
	4.14.1.6	LUA_CDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	107
	4.14.1.7	LUA_CPATH_DEFAULT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	107
	4.14.1.8	LUA_DIRSEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	107
	4.14.1.9	LUA_EXTRASPACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	107
	4.14.1.10	LUA_FLOAT_DOUBLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	107
	4.14.1.11	LUA_FLOAT_FLOAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	107
	4.14.1.12	LUA_FLOAT_LONGDOUBLE . . . . . . . . . . . . . . . . . . . . . . . . . . .	107
	4.14.1.13	LUA_FLOAT_TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	107
	4.14.1.14	lua_getlocaledecpoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	108
	4.14.1.15	LUA_IDSIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	108
	4.14.1.16	LUA_INT_INT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	108
	4.14.1.17	LUA_INT_LONG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	108
	4.14.1.18	LUA_INT_LONGLONG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	108
	4.14.1.19	LUA_INT_TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	108
	4.14.1.20	lua_integer2str . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	108
	4.14.1.21	LUA_INTEGER_FMT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	108
	4.14.1.22	LUA_KCONTEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	108
	4.14.1.23	LUA_LDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	108
	4.14.1.24	LUA_NUMBER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	108
	4.14.1.25	lua_number2str . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	108
	4.14.1.26	lua_number2strx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	109
	4.14.1.27	LUA_NUMBER_FMT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	109
	4.14.1.28	LUA_NUMBER_FRMLEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	109
	4.14.1.29	lua_numbertointeger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	109
	4.14.1.30	LUA_PATH_DEFAULT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	109
	4.14.1.31	LUA_QL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	109
	4.14.1.32	LUA_QS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	109
	4.14.1.33	LUA_ROOT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	109
	4.14.1.34	lua_str2number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	109

The Witchcraft Compiler Collection

xxviii				CONTENTS
		4.14.1.35 lua_strx2number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 109
		4.14.1.36 LUA_UNSIGNED . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 110
		4.14.1.37 LUA_VDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 110
		4.14.1.38 LUAI_BITSINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 110
		4.14.1.39 LUAI_DDEC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 110
		4.14.1.40 LUAI_DDEF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 110
		4.14.1.41 LUAI_FUNC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 110
		4.14.1.42 LUAI_MAXSTACK . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 110
		4.14.1.43 LUAI_UACINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 110
		4.14.1.44 LUAI_UACNUMBER . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 110
		4.14.1.45 LUAL_BUFFERSIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 110
		4.14.1.46 LUALIB_API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 110
		4.14.1.47 LUAMOD_API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 110
4.15	wsh/include/lualib.h File Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			. . . . 111
	4.15.1	Macro Deﬁnition Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 111
		4.15.1.1	lua_assert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 111
		4.15.1.2	LUA_BITLIBNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 111
		4.15.1.3	LUA_COLIBNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 111
		4.15.1.4	LUA_DBLIBNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 111
		4.15.1.5	LUA_IOLIBNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 112
		4.15.1.6	LUA_LOADLIBNAME . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 112
		4.15.1.7	LUA_MATHLIBNAME . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 112
		4.15.1.8	LUA_OSLIBNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 112
		4.15.1.9	LUA_STRLIBNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 112
		4.15.1.10	LUA_TABLIBNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 112
		4.15.1.11 LUA_UTF8LIBNAME . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 112
	4.15.2	Function Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 112
		4.15.2.1	luaL_openlibs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 112
		4.15.2.2	luaopen_base . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 112
		4.15.2.3	luaopen_bit32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 112
		4.15.2.4	luaopen_coroutine . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 112
		4.15.2.5	luaopen_debug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 112
		4.15.2.6	luaopen_io . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 112
		4.15.2.7	luaopen_math . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 112
		4.15.2.8	luaopen_os . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 112
		4.15.2.9	luaopen_package . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 112
		4.15.2.10	luaopen_string . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 112
		4.15.2.11	luaopen_table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 112
		4.15.2.12 luaopen_utf8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		. . . . 113
4.16	wsh/wsh.c File Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			. . . . 113

The Witchcraft Compiler Collection

CONTENTS			xxix
4.16.1	Macro Deﬁnition Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		116
	4.16.1.1	CS_MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	116
	4.16.1.2	Elf_Addr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	117
	4.16.1.3	Elf_Ehdr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	117
	4.16.1.4	Elf_Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	117
	4.16.1.5	Elf_Phdr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	117
	4.16.1.6	ELF_R_INFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	117
	4.16.1.7	ELF_R_SYM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	117
	4.16.1.8	ELF_R_TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	117
	4.16.1.9	Elf_Rel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	117
	4.16.1.10	Elf_Rela . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	117
	4.16.1.11	Elf_Section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	117
	4.16.1.12	Elf_Shdr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	117
	4.16.1.13	ELF_ST_BIND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	117
	4.16.1.14	ELF_ST_TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	118
	4.16.1.15	Elf_Sword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	118
	4.16.1.16	Elf_Sym . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	118
	4.16.1.17	Elf_Word . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	118
	4.16.1.18	Elf_Xword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	118
	4.16.1.19	ELFCLASS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	118
	4.16.1.20	ELFMACHINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	118
	4.16.1.21	REG_RIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	118
	4.16.1.22 RELOC_MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		119
4.16.2	Typedef Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		119
	4.16.2.1	help_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	119
	4.16.2.2	learn_key_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	119
	4.16.2.3	learn_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	119
4.16.3	Function Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		119
	4.16.3.1	_exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	119
	4.16.3.2	add_binary_preload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	119
	4.16.3.3	add_script_arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	119
	4.16.3.4	add_script_exec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	119
	4.16.3.5	add_symbol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	119
	4.16.3.6	afﬁnity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	119
	4.16.3.7	alarmhandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	119
	4.16.3.8	alloccharbuf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	120
	4.16.3.9	bfmap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	120
	4.16.3.10	breakpoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	120
	4.16.3.11	bsspolute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	120
	4.16.3.12	btr_disable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	120

The Witchcraft Compiler Collection

xxx	CONTENTS
4.16.3.13 btr_enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 120
4.16.3.14 bushandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 120
4.16.3.15 completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 120
4.16.3.16 declare_func . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 121
4.16.3.17 declare_internals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 121
4.16.3.18 declare_num . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 121
4.16.3.19 decode_ﬂags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 121
4.16.3.20 decode_type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 121
4.16.3.21 detailed_help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 121
4.16.3.22 disable_aslr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 121
4.16.3.23 disable_core . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 121
4.16.3.24 do_loadlib . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 121
4.16.3.25 empty_eps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 122
4.16.3.26 empty_phdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 122
4.16.3.27 empty_shdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 122
4.16.3.28 empty_symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 122
4.16.3.29 enable_aslr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 122
4.16.3.30 enable_core . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 122
4.16.3.31 entry_point_add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 122
4.16.3.32 entrypoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 122
4.16.3.33 execlib . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 122
4.16.3.34 exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 122
4.16.3.35 exit_group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 123
4.16.3.36 fatal_error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 123
4.16.3.37 gencore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 123
4.16.3.38 getcharbuf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 123
4.16.3.39 grep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 123
4.16.3.40 grepptr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 123
4.16.3.41 headers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 123
4.16.3.42 help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 123
4.16.3.43 hexdump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 123
4.16.3.44 hollywood . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 124
4.16.3.45 info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 124
4.16.3.46 info_function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 124
4.16.3.47 inthandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 124
4.16.3.48 learn_proto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 124
4.16.3.49 libcall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 124
4.16.3.50 loadbin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 125
4.16.3.51 loadlibrary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 125
4.16.3.52 ltrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 125

The Witchcraft Compiler Collection

CONTENTS	xxxi
4.16.3.53 lua_strerror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	125
4.16.3.54 man . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	125
4.16.3.55 map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	125
4.16.3.56 mk_backtrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	125
4.16.3.57 parse_dyn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	125
4.16.3.58 parse_link_map_dyn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	126
4.16.3.59 phdr_callback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	126
4.16.3.60 phdr_cmp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	126
4.16.3.61 phdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	126
4.16.3.62 print_backtrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	126
4.16.3.63 print_eps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	126
4.16.3.64 print_functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	126
4.16.3.65 print_libs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	126
4.16.3.66 print_objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	126
4.16.3.67 print_phdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	127
4.16.3.68 print_procmap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	127
4.16.3.69 print_shdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	127
4.16.3.70 print_symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	127
4.16.3.71 printarg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	127
4.16.3.72 priv_memcpy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	127
4.16.3.73 priv_strcat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	127
4.16.3.74 priv_strcpy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	127
4.16.3.75 procmap_lua . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	127
4.16.3.76 prototypes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	127
4.16.3.77 ptoh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	128
4.16.3.78 ralloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	128
4.16.3.79 rawmemaddr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	128
4.16.3.80 rawmemread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	128
4.16.3.81 rawmemstr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	128
4.16.3.82 rawmemstrlen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	128
4.16.3.83 rawmemusage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	128
4.16.3.84 rawmemwrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	128
4.16.3.85 rdnum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	129
4.16.3.86 rdstr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	129
4.16.3.87 read_elf_sig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	129
4.16.3.88 reload_elfs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	129
4.16.3.89 rescan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	129
4.16.3.90 restore_exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	129
4.16.3.91 rtrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	129
4.16.3.92 run_script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	129

The Witchcraft Compiler Collection

xxxii	CONTENTS
4.16.3.93 run_shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 129
4.16.3.94 scan_section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 130
4.16.3.95 scan_sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 130
4.16.3.96 scan_symbol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 130
4.16.3.97 scan_syms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 130
4.16.3.98 script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 130
4.16.3.99 section_add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 130
4.16.3.100section_from_addr . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 130
4.16.3.101segment_add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 130
4.16.3.102segment_from_addr . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 131
4.16.3.103set_align_ﬂag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 131
4.16.3.104set_alloc_opt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 131
4.16.3.105set_branch_ﬂag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 131
4.16.3.106set_sighandlers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 131
4.16.3.107set_trace_ﬂag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 131
4.16.3.108setcharbuf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 131
4.16.3.109shdr_callback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 131
4.16.3.110shdr_cmp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 131
4.16.3.111shdrs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 131
4.16.3.112sicode_strerror . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 131
4.16.3.113sicodetoname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 132
4.16.3.114sighandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 132
4.16.3.115signaltoname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 132
4.16.3.116singlebranch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 132
4.16.3.117singlestep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 132
4.16.3.118sort_learnt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 132
4.16.3.119symbol_from_addr . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 132
4.16.3.120symbol_from_name . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 132
4.16.3.121symbol_tobind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 132
4.16.3.122symbol_totype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 132
4.16.3.123systrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 133
4.16.3.124test_stdin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 133
4.16.3.125traceback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 133
4.16.3.126traceunaligned . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 133
4.16.3.127traphandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 133
4.16.3.128unrtrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 133
4.16.3.129unset_align_ﬂag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 133
4.16.3.130unset_branch_ﬂag . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 133
4.16.3.131unset_trace_ﬂag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 133
4.16.3.132unsinglebranch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	. . . . 133

The Witchcraft Compiler Collection

CONTENTS			xxxiii
	4.16.3.133unsinglestep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		134
	4.16.3.134unsystrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		134
	4.16.3.135untraceunaligned . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		134
	4.16.3.136unverbosetrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		134
	4.16.3.137verbose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		134
	4.16.3.138verbosetrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		134
	4.16.3.139wsh_getopt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		134
	4.16.3.140wsh_init . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		134
	4.16.3.141wsh_loadlibs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		134
	4.16.3.142wsh_print_version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		134
	4.16.3.143wsh_run . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		134
	4.16.3.144wsh_usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		135
	4.16.3.145xalloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		135
	4.16.3.146xfree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		135
4.16.4	Variable Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		135
	4.16.4.1	cmdhelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	135
	4.16.4.2	fcnhelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	135
	4.16.4.3	protorecords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	136
	4.16.4.4	wsh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	136
4.17 wsh/wshmain.c File Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .			137
4.17.1	Function Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		137
	4.17.1.1	main . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	137
4.17.2	Variable Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .		137
	4.17.2.1	wsh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	137

Index

138

The Witchcraft Compiler Collection

Chapter 1

Data Structure Index

1.1 Data Structures
Here are the data structures with brief descriptions:
breakpoint_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	5
ctx_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	5
elfdata_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	9
eps_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	11
gimport_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	11
help_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	12
learn_key_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	13
learn_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	14
linenoiseCompletions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	14
lua_Debug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	15
luaL_Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	17
luaL_Reg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	18
luaL_Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	18
msec_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	19
mseg_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	20
preload_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	21
range_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	22
script_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	23
section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	23
sections_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	25
segments_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	26
signame_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	27
symaddr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	27
symbols_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	28
tuple_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	29
wsh_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	30

2	Data Structure Index

The Witchcraft Compiler Collection

Chapter 2

File Index

2.1 File List
Here is a list of all ﬁles with brief descriptions:
wcc/wcc.c . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	37
wld/wld.c . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	53
wsh/helper.c . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	54
wsh/wsh.c . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	113
wsh/wshmain.c . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	137
wsh/include/colors.h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	56
wsh/include/lauxlib.h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	57
wsh/include/linenoise.h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	87
wsh/include/longjmp.h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	88
wsh/include/lua.h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	89
wsh/include/luaconf.h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	105
wsh/include/lualib.h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	111
wsh/include/libwitch/helper.h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	63
wsh/include/libwitch/mylaux.h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	63
wsh/include/libwitch/sigs.h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	65
wsh/include/libwitch/wsh.h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	66
wsh/include/libwitch/wsh_functions.h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .	86

4	File Index

The Witchcraft Compiler Collection

Chapter 3

Data Structure Documentation

3.1 breakpoint_t Struct Reference

#include <wsh.h>

Data Fields

•char ptr

•char backup

•unsigned int weight

3.1.1Detailed Description

Breakpoint structure

Deﬁnition at line 442 of ﬁle wsh.h.

3.1.2Field Documentation

3.1.2.1char breakpoint_t::backup

Deﬁnition at line 444 of ﬁle wsh.h.

3.1.2.2char breakpoint_t::ptr

Deﬁnition at line 443 of ﬁle wsh.h.

3.1.2.3unsigned int breakpoint_t::weight

Deﬁnition at line 445 of ﬁle wsh.h.

The documentation for this struct was generated from the following ﬁle:

• wsh/include/libwitch/wsh.h

3.2 ctx_t Struct Reference

6	Data Structure Documentation

Data Fields

•char binname

•unsigned int archsz

•unsigned int shnum

•unsigned int phnum

•char strndx

•unsigned int strndx_len

•unsigned int strndx_index

•unsigned int start_shdrs

•unsigned int start_phdrs

•int fdout

•bfd abfd

•unsigned int coreﬁle

•unsigned int base_address

•msec_t mshdrs

•unsigned int mshnum

•mseg_t mphdrs

•unsigned int mphnum

•unsigned int has_relativerelocations

•char opt_binname

•char opt_interp

•unsigned int opt_arch

•unsigned int opt_static

•unsigned int opt_reloc

•unsigned int opt_strip

•unsigned int opt_sstrip

•unsigned int opt_exec

•unsigned int opt_core

•unsigned int opt_shared

•unsigned int opt_verbose

•unsigned long int opt_entrypoint

•unsigned char opt_poison

•unsigned int opt_original

•unsigned int opt_debug

•unsigned int opt_asmdebug

•unsigned int opt_ﬂags

3.2.1Detailed Description

Deﬁnition at line 264 of ﬁle wcc.c.

3.2.2Field Documentation

3.2.2.1bfd ctx_t::abfd

Deﬁnition at line 279 of ﬁle wcc.c.

3.2.2.2unsigned int ctx_t::archsz

Deﬁnition at line 270 of ﬁle wcc.c.

The Witchcraft Compiler Collection

3.2 ctx_t Struct Reference

3.2.2.3unsigned int ctx_t::base_address

Deﬁnition at line 283 of ﬁle wcc.c.

3.2.2.4char ctx_t::binname

Internal options

Deﬁnition at line 269 of ﬁle wcc.c.

3.2.2.5unsigned int ctx_t::coreﬁle

Deﬁnition at line 280 of ﬁle wcc.c.

3.2.2.6int ctx_t::fdout

Deﬁnition at line 278 of ﬁle wcc.c.

3.2.2.7unsigned int ctx_t::has_relativerelocations

Deﬁnition at line 293 of ﬁle wcc.c.

3.2.2.8mseg_t ctx_t::mphdrs

Deﬁnition at line 290 of ﬁle wcc.c.

3.2.2.9unsigned int ctx_t::mphnum

Deﬁnition at line 291 of ﬁle wcc.c.

3.2.2.10msec_t ctx_t::mshdrs

Deﬁnition at line 286 of ﬁle wcc.c.

3.2.2.11unsigned int ctx_t::mshnum

Deﬁnition at line 287 of ﬁle wcc.c.

3.2.2.12unsigned int ctx_t::opt_arch

Deﬁnition at line 299 of ﬁle wcc.c.

3.2.2.13unsigned int ctx_t::opt_asmdebug

Deﬁnition at line 312 of ﬁle wcc.c.

3.2.2.14char ctx_t::opt_binname

User options

Deﬁnition at line 297 of ﬁle wcc.c.

The Witchcraft Compiler Collection

8	Data Structure Documentation

3.2.2.15unsigned int ctx_t::opt_core

Deﬁnition at line 305 of ﬁle wcc.c.

3.2.2.16unsigned int ctx_t::opt_debug

Deﬁnition at line 311 of ﬁle wcc.c.

3.2.2.17unsigned long int ctx_t::opt_entrypoint

Deﬁnition at line 308 of ﬁle wcc.c.

3.2.2.18unsigned int ctx_t::opt_exec

Deﬁnition at line 304 of ﬁle wcc.c.

3.2.2.19unsigned int ctx_t::opt_ﬂags

Deﬁnition at line 313 of ﬁle wcc.c.

3.2.2.20char ctx_t::opt_interp

Deﬁnition at line 298 of ﬁle wcc.c.

3.2.2.21unsigned int ctx_t::opt_original

Deﬁnition at line 310 of ﬁle wcc.c.

3.2.2.22unsigned char ctx_t::opt_poison

Deﬁnition at line 309 of ﬁle wcc.c.

3.2.2.23unsigned int ctx_t::opt_reloc

Deﬁnition at line 301 of ﬁle wcc.c.

3.2.2.24unsigned int ctx_t::opt_shared

Deﬁnition at line 306 of ﬁle wcc.c.

3.2.2.25unsigned int ctx_t::opt_sstrip

Deﬁnition at line 303 of ﬁle wcc.c.

3.2.2.26unsigned int ctx_t::opt_static

Deﬁnition at line 300 of ﬁle wcc.c.

The Witchcraft Compiler Collection

3.3 elfdata_t Struct Reference

3.2.2.27unsigned int ctx_t::opt_strip

Deﬁnition at line 302 of ﬁle wcc.c.

3.2.2.28unsigned int ctx_t::opt_verbose

Deﬁnition at line 307 of ﬁle wcc.c.

3.2.2.29unsigned int ctx_t::phnum

Deﬁnition at line 272 of ﬁle wcc.c.

3.2.2.30unsigned int ctx_t::shnum

Deﬁnition at line 271 of ﬁle wcc.c.

3.2.2.31unsigned int ctx_t::start_phdrs

Deﬁnition at line 277 of ﬁle wcc.c.

3.2.2.32unsigned int ctx_t::start_shdrs

Deﬁnition at line 276 of ﬁle wcc.c.

3.2.2.33char ctx_t::strndx

Deﬁnition at line 273 of ﬁle wcc.c.

3.2.2.34unsigned int ctx_t::strndx_index

Deﬁnition at line 275 of ﬁle wcc.c.

3.2.2.35unsigned int ctx_t::strndx_len

Deﬁnition at line 274 of ﬁle wcc.c.

The documentation for this struct was generated from the following ﬁle:

•wcc/wcc.c

3.3elfdata_t Struct Reference

#include <wsh.h>

Data Fields

•bool et_dyn

•Elf_Dyn dyns

•Elf_Ehdr ehdr

•Elf_Phdr phdrs

The Witchcraft Compiler Collection

10	Data Structure Documentation

•uint32_t dyn_index

•uintptr_t base

•uintptr_t limit

•uintptr_t p_pltgot

•struct r_debug r_debug

•struct link_map link_map

3.3.1Detailed Description

Internal representation of an ELF

Deﬁnition at line 417 of ﬁle wsh.h.

3.3.2Field Documentation

3.3.2.1uintptr_t elfdata_t::base

Deﬁnition at line 423 of ﬁle wsh.h.

3.3.2.2uint32_t elfdata_t::dyn_index

Deﬁnition at line 422 of ﬁle wsh.h.

3.3.2.3Elf_Dyn elfdata_t::dyns

Deﬁnition at line 419 of ﬁle wsh.h.

3.3.2.4Elf_Ehdr elfdata_t::ehdr

Deﬁnition at line 420 of ﬁle wsh.h.

3.3.2.5bool elfdata_t::et_dyn

Deﬁnition at line 418 of ﬁle wsh.h.

3.3.2.6uintptr_t elfdata_t::limit

Deﬁnition at line 423 of ﬁle wsh.h.

3.3.2.7struct link_map elfdata_t::link_map

Deﬁnition at line 426 of ﬁle wsh.h.

3.3.2.8uintptr_t elfdata_t::p_pltgot

Deﬁnition at line 424 of ﬁle wsh.h.

3.3.2.9Elf_Phdr elfdata_t::phdrs

Deﬁnition at line 421 of ﬁle wsh.h.

The Witchcraft Compiler Collection

3.4 eps_t Struct Reference

3.3.2.10struct r_debug elfdata_t::r_debug

Deﬁnition at line 425 of ﬁle wsh.h.

The documentation for this struct was generated from the following ﬁle:

•wsh/include/libwitch/wsh.h

3.4eps_t Struct Reference

#include <wsh.h>

Data Fields

•unsigned long int addr

•char name

•struct eps_t prev

•struct eps_t next

3.4.1Detailed Description

Deﬁnition at line 520 of ﬁle wsh.h.

3.4.2Field Documentation

3.4.2.1unsigned long int eps_t::addr

Deﬁnition at line 521 of ﬁle wsh.h.

3.4.2.2char eps_t::name

Deﬁnition at line 522 of ﬁle wsh.h.

3.4.2.3struct eps_t eps_t::next

Deﬁnition at line 525 of ﬁle wsh.h.

3.4.2.4struct eps_t eps_t::prev

Deﬁnition at line 524 of ﬁle wsh.h.

The documentation for this struct was generated from the following ﬁle:

•wsh/include/libwitch/wsh.h

3.5gimport_t Struct Reference

Data Fields

• char sname

The Witchcraft Compiler Collection

12	Data Structure Documentation

•msec_t sec

•Elf_Rela r

•int rtype

•unsigned int sindex

3.5.1Detailed Description

Deﬁnition at line 2770 of ﬁle wcc.c.

3.5.2Field Documentation

3.5.2.1Elf_Rela gimport_t::r

Deﬁnition at line 2773 of ﬁle wcc.c.

3.5.2.2int gimport_t::rtype

Deﬁnition at line 2774 of ﬁle wcc.c.

3.5.2.3msec_t gimport_t::sec

Deﬁnition at line 2772 of ﬁle wcc.c.

3.5.2.4unsigned int gimport_t::sindex

Deﬁnition at line 2775 of ﬁle wcc.c.

3.5.2.5char gimport_t::sname

Deﬁnition at line 2771 of ﬁle wcc.c.

The documentation for this struct was generated from the following ﬁle:

•wcc/wcc.c

3.6help_t Struct Reference

Data Fields

•char name

•char proto

•char descr

•char protopreﬁx

•char retval

3.6.1Detailed Description

Deﬁnition at line 489 of ﬁle wsh.c.

The Witchcraft Compiler Collection

3.7 learn_key_t Struct Reference

3.6.2Field Documentation

3.6.2.1char help_t::descr

Deﬁnition at line 492 of ﬁle wsh.c.

3.6.2.2char help_t::name

Deﬁnition at line 490 of ﬁle wsh.c.

3.6.2.3char help_t::proto

Deﬁnition at line 491 of ﬁle wsh.c.

3.6.2.4char help_t::protopreﬁx

Deﬁnition at line 493 of ﬁle wsh.c.

3.6.2.5char help_t::retval

Deﬁnition at line 494 of ﬁle wsh.c.

The documentation for this struct was generated from the following ﬁle:

•wsh/wsh.c

3.7learn_key_t Struct Reference

Data Fields

•char ttype [10]

•char tlib [200]

•char tfunction [200]

•char targ [20]

•char tvalue [200]

3.7.1Detailed Description

Deﬁnition at line 1861 of ﬁle wsh.c.

3.7.2Field Documentation

3.7.2.1char learn_key_t::targ[20]

Deﬁnition at line 1866 of ﬁle wsh.c.

3.7.2.2char learn_key_t::tfunction[200]

Deﬁnition at line 1865 of ﬁle wsh.c.

The Witchcraft Compiler Collection

14	Data Structure Documentation

3.7.2.3char learn_key_t::tlib[200]

Deﬁnition at line 1864 of ﬁle wsh.c.

3.7.2.4char learn_key_t::ttype[10]

Deﬁnition at line 1863 of ﬁle wsh.c.

3.7.2.5char learn_key_t::tvalue[200]

Deﬁnition at line 1867 of ﬁle wsh.c.

The documentation for this struct was generated from the following ﬁle:

•wsh/wsh.c

3.8learn_t Struct Reference

Data Fields

•learn_key_t key

•char toffset [20]

•UT_hash_handle hh

3.8.1Detailed Description

Deﬁnition at line 1870 of ﬁle wsh.c.

3.8.2Field Documentation

3.8.2.1UT_hash_handle learn_t::hh

Deﬁnition at line 1873 of ﬁle wsh.c.

3.8.2.2learn_key_t learn_t::key

Deﬁnition at line 1871 of ﬁle wsh.c.

3.8.2.3char learn_t::toffset[20]

Deﬁnition at line 1872 of ﬁle wsh.c.

The documentation for this struct was generated from the following ﬁle:

•wsh/wsh.c

3.9linenoiseCompletions Struct Reference

#include <linenoise.h>

The Witchcraft Compiler Collection

3.10 lua_Debug Struct Reference

Data Fields

•size_t len

•char cvec

3.9.1Detailed Description

Deﬁnition at line 46 of ﬁle linenoise.h.

3.9.2Field Documentation

3.9.2.1char linenoiseCompletions::cvec

Deﬁnition at line 48 of ﬁle linenoise.h.

3.9.2.2size_t linenoiseCompletions::len

Deﬁnition at line 47 of ﬁle linenoise.h.

The documentation for this struct was generated from the following ﬁle:

• wsh/include/linenoise.h

3.10 lua_Debug Struct Reference

#include <lua.h>

Data Fields

•int event

•const char name

•const char namewhat

•const char what

•const char source

•int currentline

•int linedeﬁned

•int lastlinedeﬁned

•unsigned char nups

•unsigned char nparams

•char isvararg

•char istailcall

•char short_src [LUA_IDSIZE]

•struct CallInfo i_ci

3.10.1Detailed Description

Deﬁnition at line 441 of ﬁle lua.h.

The Witchcraft Compiler Collection

16	Data Structure Documentation

3.10.2Field Documentation

3.10.2.1int lua_Debug::currentline

Deﬁnition at line 447 of ﬁle lua.h.

3.10.2.2int lua_Debug::event

Deﬁnition at line 442 of ﬁle lua.h.

3.10.2.3struct CallInfo lua_Debug::i_ci

Deﬁnition at line 456 of ﬁle lua.h.

3.10.2.4char lua_Debug::istailcall

Deﬁnition at line 453 of ﬁle lua.h.

3.10.2.5char lua_Debug::isvararg

Deﬁnition at line 452 of ﬁle lua.h.

3.10.2.6int lua_Debug::lastlinedeﬁned

Deﬁnition at line 449 of ﬁle lua.h.

3.10.2.7int lua_Debug::linedeﬁned

Deﬁnition at line 448 of ﬁle lua.h.

3.10.2.8const char lua_Debug::name

Deﬁnition at line 443 of ﬁle lua.h.

3.10.2.9const char lua_Debug::namewhat

Deﬁnition at line 444 of ﬁle lua.h.

3.10.2.10unsigned char lua_Debug::nparams

Deﬁnition at line 451 of ﬁle lua.h.

3.10.2.11unsigned char lua_Debug::nups

Deﬁnition at line 450 of ﬁle lua.h.

3.10.2.12char lua_Debug::short_src[LUA_IDSIZE]

Deﬁnition at line 454 of ﬁle lua.h.

The Witchcraft Compiler Collection

3.11 luaL_Buffer Struct Reference

3.10.2.13const char lua_Debug::source

Deﬁnition at line 446 of ﬁle lua.h.

3.10.2.14const char lua_Debug::what

Deﬁnition at line 445 of ﬁle lua.h.

The documentation for this struct was generated from the following ﬁle:

• wsh/include/lua.h

3.11 luaL_Buffer Struct Reference

#include <lauxlib.h>

Data Fields

•char b

•size_t size

•size_t n

•lua_State L

•char initb [LUAL_BUFFERSIZE]

3.11.1Detailed Description

Deﬁnition at line 140 of ﬁle lauxlib.h.

3.11.2Field Documentation

3.11.2.1char luaL_Buffer::b

Deﬁnition at line 141 of ﬁle lauxlib.h.

3.11.2.2char luaL_Buffer::initb[LUAL_BUFFERSIZE]

Deﬁnition at line 145 of ﬁle lauxlib.h.

3.11.2.3lua_State luaL_Buffer::L

Deﬁnition at line 144 of ﬁle lauxlib.h.

3.11.2.4size_t luaL_Buffer::n

Deﬁnition at line 143 of ﬁle lauxlib.h.

The Witchcraft Compiler Collection

18	Data Structure Documentation

3.11.2.5size_t luaL_Buffer::size

Deﬁnition at line 142 of ﬁle lauxlib.h.

The documentation for this struct was generated from the following ﬁle:

• wsh/include/lauxlib.h

3.12 luaL_Reg Struct Reference

#include <lauxlib.h>

Data Fields

•const char name

•lua_CFunction func

3.12.1Detailed Description

Deﬁnition at line 23 of ﬁle lauxlib.h.

3.12.2Field Documentation

3.12.2.1lua_CFunction luaL_Reg::func

Deﬁnition at line 25 of ﬁle lauxlib.h.

3.12.2.2const char luaL_Reg::name

Deﬁnition at line 24 of ﬁle lauxlib.h.

The documentation for this struct was generated from the following ﬁle:

• wsh/include/lauxlib.h

3.13 luaL_Stream Struct Reference

#include <lauxlib.h>

Data Fields

•FILE f

•lua_CFunction closef

3.13.1Detailed Description

Deﬁnition at line 185 of ﬁle lauxlib.h.

The Witchcraft Compiler Collection

3.14 msec_t Struct Reference

3.13.2Field Documentation

3.13.2.1lua_CFunction luaL_Stream::closef

Deﬁnition at line 187 of ﬁle lauxlib.h.

3.13.2.2FILE luaL_Stream::f

Deﬁnition at line 186 of ﬁle lauxlib.h.

The documentation for this struct was generated from the following ﬁle:

• wsh/include/lauxlib.h

3.14 msec_t Struct Reference

Data Fields

•char name

•unsigned long int len

•unsigned char data

•char outoffset

•unsigned int ﬂags

•asection s_bfd

•Elf_Shdr s_elf

•struct msec_t prev

•struct msec_t next

3.14.1Detailed Description

Meta section header

Deﬁnition at line 229 of ﬁle wcc.c.

3.14.2Field Documentation

3.14.2.1unsigned char msec_t::data

Deﬁnition at line 232 of ﬁle wcc.c.

3.14.2.2unsigned int msec_t::ﬂags

Deﬁnition at line 234 of ﬁle wcc.c.

3.14.2.3unsigned long int msec_t::len

Deﬁnition at line 231 of ﬁle wcc.c.

3.14.2.4char msec_t::name

Deﬁnition at line 230 of ﬁle wcc.c.

The Witchcraft Compiler Collection

20	Data Structure Documentation

3.14.2.5struct msec_t msec_t::next

Deﬁnition at line 240 of ﬁle wcc.c.

3.14.2.6char msec_t::outoffset

Deﬁnition at line 233 of ﬁle wcc.c.

3.14.2.7struct msec_t msec_t::prev

Deﬁnition at line 239 of ﬁle wcc.c.

3.14.2.8asection msec_t::s_bfd

Deﬁnition at line 236 of ﬁle wcc.c.

3.14.2.9Elf_Shdr msec_t::s_elf

Deﬁnition at line 237 of ﬁle wcc.c.

The documentation for this struct was generated from the following ﬁle:

• wcc/wcc.c

3.15 mseg_t Struct Reference

Data Fields

•struct msec_t prev

•struct msec_t next

3.15.1Detailed Description

Meta segment header

Deﬁnition at line 248 of ﬁle wcc.c.

3.15.2Field Documentation

3.15.2.1struct msec_t mseg_t::next

Deﬁnition at line 259 of ﬁle wcc.c.

The Witchcraft Compiler Collection

3.16 preload_t Struct Reference

3.15.2.2Elf_Xword mseg_t::p_align

Deﬁnition at line 256 of ﬁle wcc.c.

3.15.2.3Elf_Xword mseg_t::p_ﬁlesz

Deﬁnition at line 254 of ﬁle wcc.c.

3.15.2.4Elf_Word mseg_t::p_ﬂags

Deﬁnition at line 250 of ﬁle wcc.c.

3.15.2.5Elf_Xword mseg_t::p_memsz

Deﬁnition at line 255 of ﬁle wcc.c.

3.15.2.6Elf_Off mseg_t::p_offset

Deﬁnition at line 251 of ﬁle wcc.c.

3.15.2.7Elf_Addr mseg_t::p_paddr

Deﬁnition at line 253 of ﬁle wcc.c.

3.15.2.8Elf_Word mseg_t::p_type

Deﬁnition at line 249 of ﬁle wcc.c.

3.15.2.9Elf_Addr mseg_t::p_vaddr

Deﬁnition at line 252 of ﬁle wcc.c.

3.15.2.10struct msec_t mseg_t::prev

Deﬁnition at line 258 of ﬁle wcc.c.

The documentation for this struct was generated from the following ﬁle:

• wcc/wcc.c

3.16 preload_t Struct Reference

#include <wsh.h>

Data Fields

•char name

•struct preload_t prev

•struct preload_t next

The Witchcraft Compiler Collection

22	Data Structure Documentation

3.16.1Detailed Description

Libraries to be preloaded (before shell/script execution)

Deﬁnition at line 453 of ﬁle wsh.h.

3.16.2Field Documentation

3.16.2.1char preload_t::name

Deﬁnition at line 454 of ﬁle wsh.h.

3.16.2.2struct preload_t preload_t::next

Deﬁnition at line 457 of ﬁle wsh.h.

3.16.2.3struct preload_t preload_t::prev

Deﬁnition at line 456 of ﬁle wsh.h.

The documentation for this struct was generated from the following ﬁle:

• wsh/include/libwitch/wsh.h

3.17 range_t Struct Reference

#include <wsh.h>

Data Fields

•unsigned long long int min

•unsigned long long int max

3.17.1Detailed Description

Memory ranges

Deﬁnition at line 433 of ﬁle wsh.h.

3.17.2Field Documentation

3.17.2.1unsigned long long int range_t::max

Deﬁnition at line 435 of ﬁle wsh.h.

3.17.2.2unsigned long long int range_t::min

Deﬁnition at line 434 of ﬁle wsh.h.

The documentation for this struct was generated from the following ﬁle:

• wsh/include/libwitch/wsh.h

The Witchcraft Compiler Collection

3.18 script_t Struct Reference

#include <wsh.h>

Data Fields

•char name

•struct preload_t prev

•struct preload_t next

3.18.1Detailed Description

Scripts to be executed

Deﬁnition at line 464 of ﬁle wsh.h.

3.18.2Field Documentation

3.18.2.1char script_t::name

Deﬁnition at line 465 of ﬁle wsh.h.

3.18.2.2struct preload_t script_t::next

Deﬁnition at line 468 of ﬁle wsh.h.

3.18.2.3struct preload_t script_t::prev

Deﬁnition at line 467 of ﬁle wsh.h.

The documentation for this struct was generated from the following ﬁle:

• wsh/include/libwitch/wsh.h

3.19 section Struct Reference

#include <helper.h>

Data Fields

•unsigned long long int init

•unsigned long long int end

•int size

•int perms

•char name [255]

•char hperms [10]

•void next

•int num

•int proba

•int probableval

The Witchcraft Compiler Collection

24	Data Structure Documentation

3.19.1Detailed Description

Deﬁnition at line 11 of ﬁle helper.h.

3.19.2Field Documentation

3.19.2.1unsigned long long int section::end

Deﬁnition at line 13 of ﬁle helper.h.

3.19.2.2char section::hperms[10]

Deﬁnition at line 17 of ﬁle helper.h.

3.19.2.3unsigned long long int section::init

Deﬁnition at line 12 of ﬁle helper.h.

3.19.2.4char section::name[255]

Deﬁnition at line 16 of ﬁle helper.h.

3.19.2.5void section::next

Deﬁnition at line 18 of ﬁle helper.h.

3.19.2.6int section::num

Deﬁnition at line 20 of ﬁle helper.h.

3.19.2.7int section::perms

Deﬁnition at line 15 of ﬁle helper.h.

3.19.2.8int section::proba

Deﬁnition at line 21 of ﬁle helper.h.

3.19.2.9int section::probableval

Deﬁnition at line 22 of ﬁle helper.h.

3.19.2.10int section::size

Deﬁnition at line 14 of ﬁle helper.h.

The documentation for this struct was generated from the following ﬁle:

• wsh/include/libwitch/helper.h

The Witchcraft Compiler Collection

3.20 sections_t Struct Reference

#include <wsh.h>

Data Fields

•unsigned long int addr

•unsigned long int size

•char libname

•char name

•char perms

•int ﬂags

•struct sections_t prev

•struct sections_t next

3.20.1Detailed Description

Representation of ELF Sections

Deﬁnition at line 474 of ﬁle wsh.h.

3.20.2Field Documentation

3.20.2.1unsigned long int sections_t::addr

Deﬁnition at line 475 of ﬁle wsh.h.

3.20.2.2int sections_t::ﬂags

Deﬁnition at line 480 of ﬁle wsh.h.

3.20.2.3char sections_t::libname

Deﬁnition at line 477 of ﬁle wsh.h.

3.20.2.4char sections_t::name

Deﬁnition at line 478 of ﬁle wsh.h.

3.20.2.5struct sections_t sections_t::next

Deﬁnition at line 483 of ﬁle wsh.h.

3.20.2.6char sections_t::perms

Deﬁnition at line 479 of ﬁle wsh.h.

3.20.2.7struct sections_t sections_t::prev

Deﬁnition at line 482 of ﬁle wsh.h.

The Witchcraft Compiler Collection

26	Data Structure Documentation

3.20.2.8unsigned long int sections_t::size

Deﬁnition at line 476 of ﬁle wsh.h.

The documentation for this struct was generated from the following ﬁle:

• wsh/include/libwitch/wsh.h

3.21 segments_t Struct Reference

#include <wsh.h>

Data Fields

•unsigned long int addr

•unsigned long int size

•char libname

•char type

•char perms

•int ﬂags

•struct segments_t prev

•struct segments_t next

3.21.1Detailed Description

Representation of ELF Segments

Deﬁnition at line 490 of ﬁle wsh.h.

3.21.2Field Documentation

3.21.2.1unsigned long int segments_t::addr

Deﬁnition at line 491 of ﬁle wsh.h.

3.21.2.2int segments_t::ﬂags

Deﬁnition at line 496 of ﬁle wsh.h.

3.21.2.3char segments_t::libname

Deﬁnition at line 493 of ﬁle wsh.h.

3.21.2.4struct segments_t segments_t::next

Deﬁnition at line 499 of ﬁle wsh.h.

3.21.2.5char segments_t::perms

Deﬁnition at line 495 of ﬁle wsh.h.

The Witchcraft Compiler Collection

3.22 signame_t Struct Reference

3.21.2.6struct segments_t segments_t::prev

Deﬁnition at line 498 of ﬁle wsh.h.

3.21.2.7unsigned long int segments_t::size

Deﬁnition at line 492 of ﬁle wsh.h.

3.21.2.8char segments_t::type

Deﬁnition at line 494 of ﬁle wsh.h.

The documentation for this struct was generated from the following ﬁle:

• wsh/include/libwitch/wsh.h

3.22 signame_t Struct Reference

#include <sigs.h>

Data Fields

•int signal

•char name

3.22.1Detailed Description

Deﬁnition at line 1 of ﬁle sigs.h.

3.22.2Field Documentation

3.22.2.1char signame_t::name

Deﬁnition at line 3 of ﬁle sigs.h.

3.22.2.2int signame_t::signal

Deﬁnition at line 2 of ﬁle sigs.h.

The documentation for this struct was generated from the following ﬁle:

• wsh/include/libwitch/sigs.h

3.23 symaddr Struct Reference

Data Fields

•struct symaddr next

•char name

•int addr

The Witchcraft Compiler Collection

28	Data Structure Documentation

3.23.1Detailed Description

Deﬁnition at line 405 of ﬁle wcc.c.

3.23.2Field Documentation

3.23.2.1int symaddr::addr

Deﬁnition at line 408 of ﬁle wcc.c.

3.23.2.2char symaddr::name

Deﬁnition at line 407 of ﬁle wcc.c.

3.23.2.3struct symaddr symaddr::next

Deﬁnition at line 406 of ﬁle wcc.c.

The documentation for this struct was generated from the following ﬁle:

• wcc/wcc.c

3.24 symbols_t Struct Reference

#include <wsh.h>

Data Fields

•unsigned long int addr

•unsigned long int size

•char symbol

•char libname

•char htype

•char hbind

•unsigned long int value

•struct symbols_t prev

•struct symbols_t next

3.24.1Detailed Description

Representation of ELF Symbols

Deﬁnition at line 506 of ﬁle wsh.h.

3.24.2Field Documentation

3.24.2.1unsigned long int symbols_t::addr

Deﬁnition at line 507 of ﬁle wsh.h.

The Witchcraft Compiler Collection

3.25 tuple_t Struct Reference

3.24.2.2char symbols_t::hbind

Deﬁnition at line 512 of ﬁle wsh.h.

3.24.2.3char symbols_t::htype

Deﬁnition at line 511 of ﬁle wsh.h.

3.24.2.4char symbols_t::libname

Deﬁnition at line 510 of ﬁle wsh.h.

3.24.2.5struct symbols_t symbols_t::next

Deﬁnition at line 516 of ﬁle wsh.h.

3.24.2.6struct symbols_t symbols_t::prev

Deﬁnition at line 515 of ﬁle wsh.h.

3.24.2.7unsigned long int symbols_t::size

Deﬁnition at line 508 of ﬁle wsh.h.

3.24.2.8char symbols_t::symbol

Deﬁnition at line 509 of ﬁle wsh.h.

3.24.2.9unsigned long int symbols_t::value

Deﬁnition at line 513 of ﬁle wsh.h.

The documentation for this struct was generated from the following ﬁle:

• wsh/include/libwitch/wsh.h

3.25 tuple_t Struct Reference

#include <wsh.h>

Data Fields

•void addr

•char name

3.25.1Detailed Description

Deﬁnition at line 610 of ﬁle wsh.h.

The Witchcraft Compiler Collection

30	Data Structure Documentation

3.25.2Field Documentation

3.25.2.1void tuple_t::addr

Deﬁnition at line 611 of ﬁle wsh.h.

3.25.2.2char tuple_t::name

Deﬁnition at line 612 of ﬁle wsh.h.

The documentation for this struct was generated from the following ﬁle:

• wsh/include/libwitch/wsh.h

3.26 wsh_t Struct Reference

#include <wsh.h>

Data Fields

•lua_State L

•FILE scriptﬁle

•char scriptname

•char learnlog

•FILE learnﬁle

•unsigned int opt_verbose

•unsigned int opt_hollywood

•unsigned int mainhandle

•unsigned int opt_rescan

•unsigned int opt_verbosetrace

•unsigned int ﬁrsterrno

•unsigned int ﬁrstsicode

•unsigned int ﬁrstsignal

•unsigned int totsignals

•unsigned int globalsignals

•unsigned long int faultaddr

•void ﬁrstcontext

•unsigned int reason

•unsigned int is_stdinscript

•unsigned int bp_points

•void pltgot

•unsigned int pltsz

•ucontext_t errcontext

•unsigned long int btcaller

•breakpoint_t bp_array

•unsigned int bp_num

•unsigned int opt_argc

•char opt_argv

•char script_args

•unsigned int script_argnum

•unsigned int trace_unaligned

•unsigned int trace_singlestep

•unsigned int trace_singlebranch

The Witchcraft Compiler Collection

3.26 wsh_t Struct Reference

•unsigned int trace_rtrace

•unsigned int trace_strace

•unsigned int singlestep_count

•unsigned int singlebranch_count

•unsigned int sigbus_count

•unsigned long long int singlestep_hash

•unsigned long long int singlebranch_hash

•unsigned long long int sigbus_hash

•jmp_buf longjmp_ptr_high

•jmp_buf longjmp_ptr

•unsigned int interrupted

•unsigned int longjmp_ptr_high_cnt

•struct sections_t shdrs

•struct segments_t phdrs

•struct symbols_t symbols

•struct eps_t eps

•struct preload_t preload

•struct script_t scripts

3.26.1Detailed Description

wsh context

Deﬁnition at line 532 of ﬁle wsh.h.

3.26.2Field Documentation

3.26.2.1breakpoint_t wsh_t::bp_array

Deﬁnition at line 570 of ﬁle wsh.h.

3.26.2.2unsigned int wsh_t::bp_num

Deﬁnition at line 571 of ﬁle wsh.h.

3.26.2.3unsigned int wsh_t::bp_points

Deﬁnition at line 560 of ﬁle wsh.h.

3.26.2.4unsigned long int wsh_t::btcaller

Deﬁnition at line 568 of ﬁle wsh.h.

3.26.2.5struct eps_t wsh_t::eps

Deﬁnition at line 603 of ﬁle wsh.h.

3.26.2.6ucontext_t wsh_t::errcontext

Deﬁnition at line 565 of ﬁle wsh.h.

The Witchcraft Compiler Collection

32	Data Structure Documentation

3.26.2.7unsigned long int wsh_t::faultaddr

Deﬁnition at line 554 of ﬁle wsh.h.

3.26.2.8void wsh_t::ﬁrstcontext

Deﬁnition at line 556 of ﬁle wsh.h.

3.26.2.9unsigned int wsh_t::ﬁrsterrno

Deﬁnition at line 549 of ﬁle wsh.h.

3.26.2.10unsigned int wsh_t::ﬁrstsicode

Deﬁnition at line 550 of ﬁle wsh.h.

3.26.2.11unsigned int wsh_t::ﬁrstsignal

Deﬁnition at line 551 of ﬁle wsh.h.

3.26.2.12unsigned int wsh_t::globalsignals

Deﬁnition at line 553 of ﬁle wsh.h.

3.26.2.13unsigned int wsh_t::interrupted

Deﬁnition at line 597 of ﬁle wsh.h.

3.26.2.14unsigned int wsh_t::is_stdinscript

Deﬁnition at line 559 of ﬁle wsh.h.

3.26.2.15lua_State wsh_t::L

Deﬁnition at line 535 of ﬁle wsh.h.

3.26.2.16FILE wsh_t::learnﬁle

Deﬁnition at line 540 of ﬁle wsh.h.

3.26.2.17char wsh_t::learnlog

Deﬁnition at line 539 of ﬁle wsh.h.

3.26.2.18jmp_buf wsh_t::longjmp_ptr

Deﬁnition at line 595 of ﬁle wsh.h.

The Witchcraft Compiler Collection

3.26 wsh_t Struct Reference

3.26.2.19jmp_buf wsh_t::longjmp_ptr_high

Deﬁnition at line 594 of ﬁle wsh.h.

3.26.2.20unsigned int wsh_t::longjmp_ptr_high_cnt

Deﬁnition at line 598 of ﬁle wsh.h.

3.26.2.21unsigned int wsh_t::mainhandle

Deﬁnition at line 544 of ﬁle wsh.h.

3.26.2.22unsigned int wsh_t::opt_argc

Deﬁnition at line 573 of ﬁle wsh.h.

3.26.2.23char wsh_t::opt_argv

Deﬁnition at line 574 of ﬁle wsh.h.

3.26.2.24unsigned int wsh_t::opt_hollywood

Deﬁnition at line 543 of ﬁle wsh.h.

3.26.2.25unsigned int wsh_t::opt_rescan

Deﬁnition at line 545 of ﬁle wsh.h.

3.26.2.26unsigned int wsh_t::opt_verbose

Deﬁnition at line 542 of ﬁle wsh.h.

3.26.2.27unsigned int wsh_t::opt_verbosetrace

Deﬁnition at line 547 of ﬁle wsh.h.

3.26.2.28struct segments_t wsh_t::phdrs

Deﬁnition at line 601 of ﬁle wsh.h.

3.26.2.29void wsh_t::pltgot

Deﬁnition at line 562 of ﬁle wsh.h.

3.26.2.30unsigned int wsh_t::pltsz

Deﬁnition at line 563 of ﬁle wsh.h.

The Witchcraft Compiler Collection

34	Data Structure Documentation

3.26.2.31struct preload_t wsh_t::preload

Deﬁnition at line 605 of ﬁle wsh.h.

3.26.2.32unsigned int wsh_t::reason

Deﬁnition at line 557 of ﬁle wsh.h.

3.26.2.33unsigned int wsh_t::script_argnum

Deﬁnition at line 577 of ﬁle wsh.h.

3.26.2.34char wsh_t::script_args

Deﬁnition at line 576 of ﬁle wsh.h.

3.26.2.35FILE wsh_t::scriptﬁle

Deﬁnition at line 536 of ﬁle wsh.h.

3.26.2.36char wsh_t::scriptname

Deﬁnition at line 537 of ﬁle wsh.h.

3.26.2.37struct script_t wsh_t::scripts

Deﬁnition at line 606 of ﬁle wsh.h.

3.26.2.38struct sections_t wsh_t::shdrs

Deﬁnition at line 600 of ﬁle wsh.h.

3.26.2.39unsigned int wsh_t::sigbus_count

Deﬁnition at line 588 of ﬁle wsh.h.

3.26.2.40unsigned long long int wsh_t::sigbus_hash

Deﬁnition at line 592 of ﬁle wsh.h.

3.26.2.41unsigned int wsh_t::singlebranch_count

Deﬁnition at line 587 of ﬁle wsh.h.

3.26.2.42unsigned long long int wsh_t::singlebranch_hash

Deﬁnition at line 591 of ﬁle wsh.h.

The Witchcraft Compiler Collection

3.26 wsh_t Struct Reference

3.26.2.43unsigned int wsh_t::singlestep_count

Deﬁnition at line 586 of ﬁle wsh.h.

3.26.2.44unsigned long long int wsh_t::singlestep_hash

Deﬁnition at line 590 of ﬁle wsh.h.

3.26.2.45struct symbols_t wsh_t::symbols

Deﬁnition at line 602 of ﬁle wsh.h.

3.26.2.46unsigned int wsh_t::totsignals

Deﬁnition at line 552 of ﬁle wsh.h.

3.26.2.47unsigned int wsh_t::trace_rtrace

Deﬁnition at line 583 of ﬁle wsh.h.

3.26.2.48unsigned int wsh_t::trace_singlebranch

Deﬁnition at line 581 of ﬁle wsh.h.

3.26.2.49unsigned int wsh_t::trace_singlestep

Deﬁnition at line 580 of ﬁle wsh.h.

3.26.2.50unsigned int wsh_t::trace_strace

Deﬁnition at line 584 of ﬁle wsh.h.

3.26.2.51unsigned int wsh_t::trace_unaligned

Deﬁnition at line 579 of ﬁle wsh.h.

The documentation for this struct was generated from the following ﬁle:

• wsh/include/libwitch/wsh.h

The Witchcraft Compiler Collection

36	Data Structure Documentation

The Witchcraft Compiler Collection

Chapter 4

File Documentation

4.1 wcc/wcc.c File Reference

#include <bfd.h> #include <dlfcn.h> #include <elf.h> #include <errno.h> #include <fcntl.h> #include <getopt.h> #include <limits.h> #include <stdio.h> #include <stdlib.h> #include <string.h> #include <sys/mman.h> #include <sys/procfs.h> #include <sys/stat.h> #include <sys/types.h> #include <sys/ucontext.h> #include <unistd.h> #include <utlist.h> #include <ctype.h> #include <libelf.h> #include <gelf.h> #include <nametotype.h> #include <nametoalign.h> #include <nametoentsz.h> #include <nametolink.h> #include <nametoinfo.h> #include <arch.h> #include <inttypes.h> #include <config.h> #include <capstone/capstone.h>

Data Structures

•struct msec_t

•struct mseg_t

•struct ctx_t

•struct symaddr

•struct gimport_t

38	File Documentation

Macros

•#deﬁne __USE_GNU

•#deﬁne _GNU_SOURCE

•#deﬁne DEFAULT_STRNDX_SIZE 4096

•#deﬁne FLAG_BSS 1

•#deﬁne FLAG_NOBIT 2

•#deﬁne FLAG_NOWRITE 4

•#deﬁne FLAG_TEXT 8

•#deﬁne iﬁs(x) if(!strncmp(name, x, strlen(x)))

•#deﬁne elis(x) else if(!strncmp(name, x, strlen(x)))

•#deﬁne MAXPADLEN 20

•#deﬁne EXTRA_CREATED_SECTIONS 4

•#deﬁne RELOC_X86_64 1

•#deﬁne RELOC_X86_32 2

•#deﬁne Elf_Ehdr Elf32_Ehdr

•#deﬁne Elf_Shdr Elf32_Shdr

•#deﬁne Elf_Sym Elf32_Sym

•#deﬁne Elf_Addr Elf32_Addr

•#deﬁne Elf_Sword Elf64_Sword

•#deﬁne Elf_Section Elf32_Half

•#deﬁne ELF_ST_BIND ELF32_ST_BIND

•#deﬁne ELF_ST_TYPE ELF32_ST_TYPE

•#deﬁne Elf_Rel Elf32_Rel

•#deﬁne Elf_Rela Elf32_Rela

•#deﬁne ELF_R_SYM ELF32_R_SYM

•#deﬁne ELF_R_TYPE ELF32_R_TYPE

•#deﬁne ELF_R_INFO ELF32_R_INFO

•#deﬁne Elf_Phdr Elf32_Phdr

•#deﬁne Elf_Xword Elf32_Xword

•#deﬁne Elf_Word Elf32_Word

•#deﬁne Elf_Off Elf32_Off

•#deﬁne ELFCLASS ELFCLASS32

•#deﬁne ELFMACHINE EM_386

•#deﬁne CS_MODE CS_MODE_32

•#deﬁne RELOC_MODE RELOC_X86_32

•#deﬁne nullstr "\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"

Typedefs

•typedef struct msec_t msec_t

•typedef struct mseg_t mseg_t

•typedef struct ctx_t ctx_t

•typedef struct gimport_t gimport_t

Functions

•int craft_section (ctx_t ctx, msec_t m)

•unsigned int secindex_from_name (ctx_t ctx, const char name)

•msec_t section_from_name (ctx_t ctx, char name)

•msec_t section_from_addr (ctx_t ctx, unsigned long int addr)

•int print_bfd_sections (ctx_t ctx)

•msec_t section_from_index (ctx_t ctx, unsigned int index)

•unsigned int secindex_from_name_after_strip (ctx_t ctx, const char name)

The Witchcraft Compiler Collection

4.1 wcc/wcc.c File Reference

•int analyze_text (ctx_t ctx, char data, unsigned int datalen, unsigned long int addr)

•int save_reloc (ctx_t ctx, Elf_Rela r, unsigned int sindex, int has_addend)

•unsigned int protect_perms (unsigned int perms)

•void add_symaddr (ctx_t ctx, const char name, int addr, char symclass)

•int add_extra_symbols (ctx_t ctx)

•int rd_symbols (ctx_t ctx)

•int entszfromname (const char name)

•unsigned int max (unsigned int a, unsigned int b)

•char sec_name_from_index_after_strip (ctx_t ctx, unsigned int index)

•int link_from_name (ctx_t ctx, const char name)

•int info_from_name (ctx_t ctx, const char name)

•int typefromname (const char name)

•unsigned int alignfromname (const char name)

•unsigned int ptype_from_section (msec_t ms)

•unsigned int pﬂag_from_section (msec_t ms)

•int phdr_cmp_premerge (mseg_t a, mseg_t b)

•int phdr_cmp (mseg_t a, mseg_t b)

•int sort_phdrs (ctx_t ctx)

•int sort_phdrs_premerge (ctx_t ctx)

•mseg_t alloc_phdr (msec_t ms)

•int create_phdrs (ctx_t ctx)

•int merge_phdrs (ctx_t ctx)

•int adjust_baseaddress (ctx_t ctx)

•msec_t mk_section (void)

•char reloc_htype_x86_64 (int thetype)

•char reloc_htype_x86_32 (int thetype)

•char reloc_htype (int thetype)

•int ﬁxup_strtab_and_symtab (ctx_t ctx)

•int ﬁxup_text (ctx_t ctx)

•unsigned int append_sym (Elf_Sym s)

•unsigned int append_strtab (char str)

•void hexdump (unsigned char data, size_t size)

•unsigned int open_best (ctx_t ctx)

•int open_target (ctx_t ctx)

•int copy_body (ctx_t ctx)

•int load_binary (ctx_t ctx)

•int ﬂags_from_name (const char name)

•int print_msec (ctx_t ctx)

•int rd_sections (ctx_t ctx)

•int save_dynstr (ctx_t ctx, GElf_Shdr shdr, char binary)

•int save_dynsym (ctx_t ctx, GElf_Shdr shdr, char binary)

•int patch_symbol_index (ctx_t ctx, Elf_Sym s)

•int ﬁxup_symtab_section_index (ctx_t ctx)

•int append_reloc (Elf_Rela r)

•int save_global_import (ctx_t ctx, char sname, msec_t sec, Elf_Rela r, unsigned int sindex)

•int check_global_import (unsigned long int addr)

•int internal_function_store (ctx_t ctx, unsigned long long int addr)

•int rd_symtab (ctx_t ctx)

•int rm_section (ctx_t ctx, char name)

•int strip_binary_reloc (ctx_t ctx)

•unsigned int libify (ctx_t ctx)

•int print_maps (void)

•ctx_t ctx_init (void)

•int usage (char name)

•int print_version (void)

•int desired_arch (ctx_t ctx, char name)

•int ctx_getopt (ctx_t ctx, int argc, char argv)

•int main (int argc, char argv)

The Witchcraft Compiler Collection

40	File Documentation

Variables

•unsigned int maxoldsec = 0

•unsigned int maxnewsec = 0

•unsigned int deltastrtab = 0

•char allowed_sections [ ]

•char blnames [ ]

•char globalsymtab = 0

•int globalsymtablen = 0

•unsigned int globalsymtableoffset = 0

•char globalstrtab = 0

•unsigned int globalstrtablen = 0

•unsigned int globalstrtableoffset = 0

•unsigned int globalsymindex = 0

•char globalreloc = 0

•unsigned int globalreloclen = 0

•unsigned int globalrelocoffset = 0

•unsigned long int mintext = -1

•unsigned long int maxtext = 0

•unsigned long int textvma = 0

•unsigned long int mindata = -1

•unsigned long int maxdata = 0

•unsigned long int datavma = 0

•unsigned long int orig_text = 0

•unsigned long int orig_sz = 0

•struct symaddr symaddrs

•gimport_t gimports = 0

•unsigned int gimportslen = 0

4.1.1Macro Deﬁnition Documentation

4.1.1.1#deﬁne __USE_GNU

Witchcraft Compiler Collection

Author: Jonathan Brossard - [email protected]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation ﬁles (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INC- LUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Deﬁnition at line 31 of ﬁle wcc.c.

4.1.1.2#deﬁne _GNU_SOURCE

Deﬁnition at line 32 of ﬁle wcc.c.

The Witchcraft Compiler Collection

4.1 wcc/wcc.c File Reference

4.1.1.3#deﬁne CS_MODE CS_MODE_32

Deﬁnition at line 134 of ﬁle wcc.c.

4.1.1.4#deﬁne DEFAULT_STRNDX_SIZE 4096

Deﬁnition at line 72 of ﬁle wcc.c.

4.1.1.5#deﬁne Elf_Addr Elf32_Addr

Deﬁnition at line 118 of ﬁle wcc.c.

4.1.1.6#deﬁne Elf_Ehdr Elf32_Ehdr

Deﬁnition at line 115 of ﬁle wcc.c.

4.1.1.7#deﬁne Elf_Off Elf32_Off

Deﬁnition at line 131 of ﬁle wcc.c.

4.1.1.8#deﬁne Elf_Phdr Elf32_Phdr

Deﬁnition at line 128 of ﬁle wcc.c.

4.1.1.9#deﬁne ELF_R_INFO ELF32_R_INFO

Deﬁnition at line 127 of ﬁle wcc.c.

4.1.1.10#deﬁne ELF_R_SYM ELF32_R_SYM

Deﬁnition at line 125 of ﬁle wcc.c.

4.1.1.11#deﬁne ELF_R_TYPE ELF32_R_TYPE

Deﬁnition at line 126 of ﬁle wcc.c.

4.1.1.12#deﬁne Elf_Rel Elf32_Rel

Deﬁnition at line 123 of ﬁle wcc.c.

4.1.1.13#deﬁne Elf_Rela Elf32_Rela

Deﬁnition at line 124 of ﬁle wcc.c.

4.1.1.14#deﬁne Elf_Section Elf32_Half

Deﬁnition at line 120 of ﬁle wcc.c.

The Witchcraft Compiler Collection

42	File Documentation

4.1.1.15#deﬁne Elf_Shdr Elf32_Shdr

Deﬁnition at line 116 of ﬁle wcc.c.

4.1.1.16#deﬁne ELF_ST_BIND ELF32_ST_BIND

Deﬁnition at line 121 of ﬁle wcc.c.

4.1.1.17#deﬁne ELF_ST_TYPE ELF32_ST_TYPE

Deﬁnition at line 122 of ﬁle wcc.c.

4.1.1.18#deﬁne Elf_Sword Elf64_Sword

Deﬁnition at line 119 of ﬁle wcc.c.

4.1.1.19#deﬁne Elf_Sym Elf32_Sym

Deﬁnition at line 117 of ﬁle wcc.c.

4.1.1.20#deﬁne Elf_Word Elf32_Word

Deﬁnition at line 130 of ﬁle wcc.c.

4.1.1.21#deﬁne Elf_Xword Elf32_Xword

Deﬁnition at line 129 of ﬁle wcc.c.

4.1.1.22#deﬁne ELFCLASS ELFCLASS32

Deﬁnition at line 132 of ﬁle wcc.c.

4.1.1.23#deﬁne ELFMACHINE EM_386

Deﬁnition at line 133 of ﬁle wcc.c.

4.1.1.24#deﬁne elis( x ) else if(!strncmp(name, x, strlen(x)))

Deﬁnition at line 81 of ﬁle wcc.c.

4.1.1.25#deﬁne EXTRA_CREATED_SECTIONS 4

Deﬁnition at line 85 of ﬁle wcc.c.

4.1.1.26#deﬁne FLAG_BSS 1

Deﬁnition at line 75 of ﬁle wcc.c.

The Witchcraft Compiler Collection

4.1 wcc/wcc.c File Reference

4.1.1.27#deﬁne FLAG_NOBIT 2

Deﬁnition at line 76 of ﬁle wcc.c.

4.1.1.28#deﬁne FLAG_NOWRITE 4

Deﬁnition at line 77 of ﬁle wcc.c.

4.1.1.29#deﬁne FLAG_TEXT 8

Deﬁnition at line 78 of ﬁle wcc.c.

4.1.1.30#deﬁne iﬁs( x ) if(!strncmp(name, x, strlen(x)))

Deﬁnition at line 80 of ﬁle wcc.c.

4.1.1.31#deﬁne MAXPADLEN 20

Deﬁnition at line 83 of ﬁle wcc.c.

4.1.1.32#deﬁne nullstr "\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"

Deﬁnition at line 139 of ﬁle wcc.c.

4.1.1.33#deﬁne RELOC_MODE RELOC_X86_32

Deﬁnition at line 135 of ﬁle wcc.c.

4.1.1.34#deﬁne RELOC_X86_32 2

Deﬁnition at line 89 of ﬁle wcc.c.

4.1.1.35#deﬁne RELOC_X86_64 1

Deﬁnition at line 88 of ﬁle wcc.c.

4.1.2Typedef Documentation

4.1.2.1typedef struct ctx_t ctx_t

4.1.2.2typedef struct gimport_t gimport_t

4.1.2.3typedef struct msec_t msec_t

Meta section header

4.1.2.4typedef struct mseg_t mseg_t

Meta segment header

The Witchcraft Compiler Collection

44	File Documentation

4.1.3Function Documentation

4.1.3.1int add_extra_symbols ( ctx_t ctx )

Add extra symbols

Deﬁnition at line 561 of ﬁle wcc.c.

4.1.3.2void add_symaddr ( ctx_t ctx, const char name, int addr, char symclass )

Append name to global string table

Append symbol to global symbol table

Deﬁnition at line 423 of ﬁle wcc.c.

4.1.3.3int adjust_baseaddress ( ctx_t ctx )

Deﬁnition at line 1108 of ﬁle wcc.c.

4.1.3.4unsigned int alignfromname ( const char name )

Return a section alignment from its name

Deﬁnition at line 881 of ﬁle wcc.c.

4.1.3.5mseg_t alloc_phdr ( msec_t ms )

Allocate Phdr

Deﬁnition at line 1009 of ﬁle wcc.c.

4.1.3.6int analyze_text ( ctx_t ctx, char data, unsigned int datalen, unsigned long int addr )

Deﬁnition at line 3395 of ﬁle wcc.c.

4.1.3.7int append_reloc ( Elf_Rela r )

Deﬁnition at line 2740 of ﬁle wcc.c.

4.1.3.8unsigned int append_strtab ( char str )

Append a string to symbol table, reports offset in strtab where this symbol will start

Deﬁnition at line 1776 of ﬁle wcc.c.

4.1.3.9unsigned int append_sym ( Elf_Sym s )

Append a symbol to global symbol table

Deﬁnition at line 1755 of ﬁle wcc.c.

The Witchcraft Compiler Collection

4.1 wcc/wcc.c File Reference

4.1.3.10int check_global_import ( unsigned long int addr )

Return index in global import matching this address

Deﬁnition at line 2818 of ﬁle wcc.c.

4.1.3.11int copy_body ( ctx_t ctx )

Write sections to disk

Deﬁnition at line 2459 of ﬁle wcc.c.

4.1.3.12int craft_section ( ctx_t ctx, msec_t m )

Forwardd prototypes declarations

Craft Section header

Deﬁnition at line 2500 of ﬁle wcc.c.

4.1.3.13int create_phdrs ( ctx_t ctx )

Create Program Headers based on ELF section headers

Deﬁnition at line 1032 of ﬁle wcc.c.

4.1.3.14int ctx_getopt ( ctx_t ctx, int argc, char argv )

Deﬁnition at line 3847 of ﬁle wcc.c.

4.1.3.15ctx_t ctx_init ( void )

Initialize a reversing context Set default values

Deﬁnition at line 3775 of ﬁle wcc.c.

4.1.3.16int desired_arch ( ctx_t ctx, char name )

Deﬁnition at line 3827 of ﬁle wcc.c.

4.1.3.17int entszfromname ( const char name )

Return section entry size from name

Deﬁnition at line 682 of ﬁle wcc.c.

4.1.3.18int ﬁxup_strtab_and_symtab ( ctx_t ctx )

check if name is in blacklist

Deﬁnition at line 1638 of ﬁle wcc.c.

4.1.3.19int ﬁxup_symtab_section_index ( ctx_t ctx )

Deﬁnition at line 2720 of ﬁle wcc.c.

The Witchcraft Compiler Collection

46	File Documentation

4.1.3.20int ﬁxup_text ( ctx_t ctx )

Deﬁnition at line 1694 of ﬁle wcc.c.

4.1.3.21int ﬂags_from_name ( const char name )

Return section ﬂags from its name

Deﬁnition at line 2486 of ﬁle wcc.c.

4.1.3.22void hexdump ( unsigned char data, size_t size )

Simple hexdump routine

Deﬁnition at line 2346 of ﬁle wcc.c.

4.1.3.23int info_from_name ( ctx_t ctx, const char name )

Return a section info from its name

Deﬁnition at line 843 of ﬁle wcc.c.

4.1.3.24int internal_function_store ( ctx_t ctx, unsigned long long int addr )

Deﬁnition at line 3289 of ﬁle wcc.c.

4.1.3.25unsigned int libify ( ctx_t ctx )

Main routine LOAD OPERATIONS

Load each section of binary using bfd

Print BFD sections

Read .text segment boundaries

Open target binary

Read sections from disk

Read symtab + strtab : BFD doesn’t do this

Read symbols

Add extra symbols

Parse relocations

Fix section indexes in symtab

PROCESSING

Copy each section content in output ﬁle

Relocation stripping

Create Program Headers

FINAL WRITE OPERATIONS

Write strtab and symtab

Add section headers to output ﬁle

Add segment headers to output ﬁle

The Witchcraft Compiler Collection

4.1 wcc/wcc.c File Reference

Add ELF Header to output ﬁle

Finalize/Close/Cleanup

Deﬁnition at line 3597 of ﬁle wcc.c.

4.1.3.26int link_from_name ( ctx_t ctx, const char name )

Return a section link from its name

Deﬁnition at line 820 of ﬁle wcc.c.

4.1.3.27int load_binary ( ctx_t ctx )

Load a binary using bfd

Deﬁnition at line 2472 of ﬁle wcc.c.

4.1.3.28int main ( int argc, char argv )

Application Entry Point

Deﬁnition at line 4014 of ﬁle wcc.c.

4.1.3.29unsigned int max ( unsigned int a, unsigned int b )

Return max of two unsigned integers

Deﬁnition at line 697 of ﬁle wcc.c.

4.1.3.30int merge_phdrs ( ctx_t ctx )

Merge two consecutive Phdrs if:

•their vma ranges overlap

•Permissions match

•Type of segment matches

Note: assume phdrs have been sorted by increasing p_vaddr ﬁrst

Deﬁnition at line 1073 of ﬁle wcc.c.

4.1.3.31msec_t mk_section ( void )

Deﬁnition at line 1330 of ﬁle wcc.c.

4.1.3.32unsigned int open_best ( ctx_t ctx )

Open a binary the best way we can

Deﬁnition at line 2373 of ﬁle wcc.c.

The Witchcraft Compiler Collection

48	File Documentation

4.1.3.33int open_target ( ctx_t ctx )

Open destination binary

Deﬁnition at line 2405 of ﬁle wcc.c.

4.1.3.34int patch_symbol_index ( ctx_t ctx, Elf_Sym s )

Deﬁnition at line 2701 of ﬁle wcc.c.

4.1.3.35unsigned int pﬂag_from_section ( msec_t ms )

Return Segment ﬂags based on a section

Deﬁnition at line 943 of ﬁle wcc.c.

4.1.3.36int phdr_cmp ( mseg_t a, mseg_t b )

Helper sort routine for ELF Phdrs

Deﬁnition at line 982 of ﬁle wcc.c.

4.1.3.37int phdr_cmp_premerge ( mseg_t a, mseg_t b )

Helper sort routine for ELF Phdrs (pre-merge)

Deﬁnition at line 971 of ﬁle wcc.c.

4.1.3.38int print_bfd_sections ( ctx_t ctx )

Display BFD memory sections

Deﬁnition at line 2288 of ﬁle wcc.c.

4.1.3.39int print_maps ( void )

Print content of /proc/pid/maps

Deﬁnition at line 3763 of ﬁle wcc.c.

4.1.3.40int print_msec ( ctx_t ctx )

Display sections

Deﬁnition at line 2633 of ﬁle wcc.c.

4.1.3.41int print_version ( void )

Deﬁnition at line 3821 of ﬁle wcc.c.

4.1.3.42unsigned int protect_perms ( unsigned int perms )

Convert octal permissions into permissions consumable by mprotect()

Deﬁnition at line 381 of ﬁle wcc.c.

The Witchcraft Compiler Collection

4.1 wcc/wcc.c File Reference

4.1.3.43unsigned int ptype_from_section ( msec_t ms )

Return Segment ptype

Deﬁnition at line 896 of ﬁle wcc.c.

4.1.3.44int rd_sections ( ctx_t ctx )

Read sections from input binary

Deﬁnition at line 2650 of ﬁle wcc.c.

4.1.3.45int rd_symbols ( ctx_t ctx )

Read symbol table. This is a two stages process : allocate the table, then read it Process symbol table Process dynamic symbol table

Deﬁnition at line 574 of ﬁle wcc.c.

4.1.3.46int rd_symtab ( ctx_t ctx )

Read original symtab + strtab. BDF doesn’t do this

Deﬁnition at line 3443 of ﬁle wcc.c.

4.1.3.47char reloc_htype ( int thetype )

Deﬁnition at line 1535 of ﬁle wcc.c.

4.1.3.48char reloc_htype_x86_32 ( int thetype )

Deﬁnition at line 1474 of ﬁle wcc.c.

4.1.3.49char reloc_htype_x86_64 ( int thetype )

Deﬁnition at line 1391 of ﬁle wcc.c.

4.1.3.50int rm_section ( ctx_t ctx, char name )

Suppress a given section

Deﬁnition at line 3533 of ﬁle wcc.c.

4.1.3.51int save_dynstr ( ctx_t ctx, GElf_Shdr shdr, char binary )

Deﬁnition at line 2663 of ﬁle wcc.c.

4.1.3.52int save_dynsym ( ctx_t ctx, GElf_Shdr shdr, char binary )

Deﬁnition at line 2681 of ﬁle wcc.c.

The Witchcraft Compiler Collection

50	File Documentation

4.1.3.53int save_global_import ( ctx_t ctx, char sname, msec_t sec, Elf_Rela r, unsigned int sindex )

Deﬁnition at line 2781 of ﬁle wcc.c.

4.1.3.54int save_reloc ( ctx_t ctx, Elf_Rela r, unsigned int sindex, int has_addend )

Convert relocation depending on type and source section

Deﬁnition at line 2835 of ﬁle wcc.c.

4.1.3.55char sec_name_from_index_after_strip ( ctx_t ctx, unsigned int index )

Deﬁnition at line 791 of ﬁle wcc.c.

4.1.3.56unsigned int secindex_from_name ( ctx_t ctx, const char name )

Return a section index from its name

Deﬁnition at line 753 of ﬁle wcc.c.

4.1.3.57unsigned int secindex_from_name_after_strip ( ctx_t ctx, const char name )

Return a section index (after strip) from its name

Deﬁnition at line 770 of ﬁle wcc.c.

4.1.3.58msec_t section_from_addr ( ctx_t ctx, unsigned long int addr )

Return a section from its address

Deﬁnition at line 720 of ﬁle wcc.c.

4.1.3.59msec_t section_from_index ( ctx_t ctx, unsigned int index )

Return a section from its index

Deﬁnition at line 736 of ﬁle wcc.c.

4.1.3.60msec_t section_from_name ( ctx_t ctx, char name )

Return a section from its name

Deﬁnition at line 705 of ﬁle wcc.c.

4.1.3.61int sort_phdrs ( ctx_t ctx )

Reorganise Program Headers : sort by p_offset

Deﬁnition at line 991 of ﬁle wcc.c.

4.1.3.62int sort_phdrs_premerge ( ctx_t ctx )

Helper sort routine for ELF Phdrs

Deﬁnition at line 1000 of ﬁle wcc.c.

The Witchcraft Compiler Collection

4.1 wcc/wcc.c File Reference

4.1.3.63int strip_binary_reloc ( ctx_t ctx )

Strip binary relocation data

Deﬁnition at line 3560 of ﬁle wcc.c.

4.1.3.64int typefromname ( const char name )

Return a section type from its name

Deﬁnition at line 866 of ﬁle wcc.c.

4.1.3.65int usage ( char name )

Deﬁnition at line 3795 of ﬁle wcc.c.

4.1.4Variable Documentation

4.1.4.1char allowed_sections[ ]

Initial value:

".rodata", ".data", ".text", ".load", ".strtab", ".symtab", ".comment", ".note.GNU-stack", ".rsrc",

".bss",

}

Deﬁnition at line 143 of ﬁle wcc.c.

4.1.4.2char blnames[ ]

Deﬁnition at line 158 of ﬁle wcc.c.

4.1.4.3unsigned long int datavma = 0

Deﬁnition at line 358 of ﬁle wcc.c.

4.1.4.4unsigned int deltastrtab = 0

Deﬁnition at line 141 of ﬁle wcc.c.

4.1.4.5gimport_t gimports = 0

Deﬁnition at line 2778 of ﬁle wcc.c.

4.1.4.6unsigned int gimportslen = 0

Deﬁnition at line 2779 of ﬁle wcc.c.

The Witchcraft Compiler Collection

52	File Documentation

4.1.4.7char globalreloc = 0

Deﬁnition at line 348 of ﬁle wcc.c.

4.1.4.8unsigned int globalreloclen = 0

Deﬁnition at line 349 of ﬁle wcc.c.

4.1.4.9unsigned int globalrelocoffset = 0

Deﬁnition at line 350 of ﬁle wcc.c.

4.1.4.10char globalstrtab = 0

Deﬁnition at line 342 of ﬁle wcc.c.

4.1.4.11unsigned int globalstrtablen = 0

Deﬁnition at line 343 of ﬁle wcc.c.

4.1.4.12unsigned int globalstrtableoffset = 0

Deﬁnition at line 344 of ﬁle wcc.c.

4.1.4.13unsigned int globalsymindex = 0

Deﬁnition at line 346 of ﬁle wcc.c.

4.1.4.14char globalsymtab = 0

Globals

Deﬁnition at line 338 of ﬁle wcc.c.

4.1.4.15int globalsymtablen = 0

Deﬁnition at line 339 of ﬁle wcc.c.

4.1.4.16unsigned int globalsymtableoffset = 0

Deﬁnition at line 340 of ﬁle wcc.c.

4.1.4.17unsigned long int maxdata = 0

Deﬁnition at line 357 of ﬁle wcc.c.

4.1.4.18unsigned int maxnewsec = 0

Deﬁnition at line 140 of ﬁle wcc.c.

The Witchcraft Compiler Collection

4.2 wld/wld.c File Reference

4.1.4.19unsigned int maxoldsec = 0

Deﬁnition at line 140 of ﬁle wcc.c.

4.1.4.20unsigned long int maxtext = 0

Deﬁnition at line 353 of ﬁle wcc.c.

4.1.4.21unsigned long int mindata = -1

Deﬁnition at line 356 of ﬁle wcc.c.

4.1.4.22unsigned long int mintext = -1

Deﬁnition at line 352 of ﬁle wcc.c.

4.1.4.23unsigned long int orig_sz = 0

Deﬁnition at line 361 of ﬁle wcc.c.

4.1.4.24unsigned long int orig_text = 0

Deﬁnition at line 360 of ﬁle wcc.c.

4.1.4.25struct symaddr symaddrs

4.1.4.26unsigned long int textvma = 0

Deﬁnition at line 354 of ﬁle wcc.c.

4.2 wld/wld.c File Reference

#include <fcntl.h> #include <stdio.h> #include <stdlib.h> #include <sys/mman.h> #include <sys/stat.h> #include <unistd.h> #include <sys/types.h> #include <string.h> #include <limits.h> #include <errno.h> #include <elf.h> #include <config.h>

Macros

• #deﬁne DEFAULT_NAME "wld"

The Witchcraft Compiler Collection

54	File Documentation

Functions

•int mk_lib (char name)

•int print_version (void)

•int main (int argc, char argv)

4.2.1Macro Deﬁnition Documentation

4.2.1.1#deﬁne DEFAULT_NAME "wld"

Witchcraft Compiler Collection

Author: Jonathan Brossard - [email protected]

This code is published under the MIT License.

Deﬁnition at line 31 of ﬁle wld.c.

4.2.2Function Documentation

4.2.2.1int main ( int argc, char argv )

Deﬁnition at line 91 of ﬁle wld.c.

4.2.2.2int mk_lib ( char name )

Patch ELF ehdr->e_type to ET_DYN

Deﬁnition at line 36 of ﬁle wld.c.

4.2.2.3int print_version ( void )

Deﬁnition at line 85 of ﬁle wld.c.

4.3 wsh/helper.c File Reference

#include <math.h> #include <ctype.h> #include <stdio.h> #include <errno.h> #include <stdlib.h> #include <sys/types.h> #include <sys/stat.h> #include <fcntl.h> #include <limits.h> #include <regex.h> #include <sys/ptrace.h> #include <signal.h> #include <string.h> #include <libwitch/helper.h>

The Witchcraft Compiler Collection

4.3 wsh/helper.c File Reference

Macros

•#deﬁne _XOPEN_SOURCE 500

•#deﬁne _FILE_OFFSET_BITS 64

•#deﬁne HAS_ZFIRST 1

Functions

•int is_mapped (unsigned long int addr)

•int read_maps (int pid)

Variables

•unsigned int lastsignal

•struct section zﬁrst = 0

•int nsections =0

4.3.1Macro Deﬁnition Documentation

4.3.1.1#deﬁne _FILE_OFFSET_BITS 64

Deﬁnition at line 25 of ﬁle helper.c.

4.3.1.2#deﬁne _XOPEN_SOURCE 500

Deﬁnition at line 24 of ﬁle helper.c.

4.3.1.3#deﬁne HAS_ZFIRST 1

Deﬁnition at line 45 of ﬁle helper.c.

4.3.2Function Documentation

4.3.2.1int is_mapped ( unsigned long int addr )

Deﬁnition at line 56 of ﬁle helper.c.

4.3.2.2int read_maps ( int pid )

Deﬁnition at line 72 of ﬁle helper.c.

4.3.3Variable Documentation

4.3.3.1unsigned int lastsignal

4.3.3.2int nsections =0

Deﬁnition at line 47 of ﬁle helper.c.

The Witchcraft Compiler Collection

56	File Documentation

4.3.3.3struct section zﬁrst = 0

Deﬁnition at line 46 of ﬁle helper.c.

4.4 wsh/include/colors.h File Reference

Macros

•#deﬁne RED "\033[1;31m"

•#deﬁne CYAN "\033[1;36m"

•#deﬁne GREEN "\033[1;32m"

•#deﬁne BLUE "\033[1;34m"

•#deﬁne BLACK "\033[1;30m"

•#deﬁne BROWN "\033[1;33m"

•#deﬁne MAGENTA "\033[1;35m"

•#deﬁne GRAY "\033[1;37m"

•#deﬁne DARKGRAY "\033[1;30m"

•#deﬁne YELLOW "\033[1;33m"

•#deﬁne NORMAL "\033[0m" / ﬂush the previous properties /

•#deﬁne CLEAR "\033[2J"

4.4.1Macro Deﬁnition Documentation

4.4.1.1#deﬁne BLACK "\033[1;30m"

Deﬁnition at line 6 of ﬁle colors.h.

4.4.1.2#deﬁne BLUE "\033[1;34m"

Deﬁnition at line 5 of ﬁle colors.h.

4.4.1.3#deﬁne BROWN "\033[1;33m"

Deﬁnition at line 7 of ﬁle colors.h.

4.4.1.4#deﬁne CLEAR "\033[2J"

Deﬁnition at line 17 of ﬁle colors.h.

4.4.1.5#deﬁne CYAN "\033[1;36m"

Deﬁnition at line 3 of ﬁle colors.h.

4.4.1.6#deﬁne DARKGRAY "\033[1;30m"

Deﬁnition at line 10 of ﬁle colors.h.

4.4.1.7#deﬁne GRAY "\033[1;37m"

Deﬁnition at line 9 of ﬁle colors.h.

The Witchcraft Compiler Collection

4.5 wsh/include/lauxlib.h File Reference

4.4.1.8#deﬁne GREEN "\033[1;32m"

Deﬁnition at line 4 of ﬁle colors.h.

4.4.1.9#deﬁne MAGENTA "\033[1;35m"

Deﬁnition at line 8 of ﬁle colors.h.

4.4.1.10#deﬁne NORMAL "\033[0m" / ﬂush the previous properties /

Deﬁnition at line 14 of ﬁle colors.h.

4.4.1.11#deﬁne RED "\033[1;31m"

Deﬁnition at line 2 of ﬁle colors.h.

4.4.1.12#deﬁne YELLOW "\033[1;33m"

Deﬁnition at line 11 of ﬁle colors.h.

4.5 wsh/include/lauxlib.h File Reference

#include <stddef.h> #include <stdio.h> #include "lua.h"

Data Structures

•struct luaL_Reg

•struct luaL_Buffer

•struct luaL_Stream

Macros

•#deﬁne LUA_ERRFILE (LUA_ERRERR+1)

•#deﬁne LUAL_NUMSIZES (sizeof(lua_Integer)16 + sizeof(lua_Number))

•#deﬁne luaL_checkversion(L) luaL_checkversion_(L, LUA_VERSION_NUM, LUAL_NUMSIZES)

•#deﬁne LUA_NOREF (-2)

•#deﬁne LUA_REFNIL (-1)

•#deﬁne luaL_loadﬁle(L, f) luaL_loadﬁlex(L,f,NULL)

•#deﬁne luaL_newlibtable(L, l) lua_createtable(L, 0, sizeof(l)/sizeof((l)[0]) - 1)

•#deﬁne luaL_newlib(L, l) (luaL_checkversion(L), luaL_newlibtable(L,l), luaL_setfuncs(L,l,0))

•#deﬁne luaL_argcheck(L, cond, arg, extramsg) ((void)((cond) jj luaL_argerror(L, (arg), (extramsg))))

•#deﬁne luaL_checkstring(L, n) (luaL_checklstring(L, (n), NULL))

•#deﬁne luaL_optstring(L, n, d) (luaL_optlstring(L, (n), (d), NULL))

•#deﬁne luaL_typename(L, i) lua_typename(L, lua_type(L,(i)))

•#deﬁne luaL_doﬁle(L, fn) (luaL_loadﬁle(L, fn) jj lua_pcall(L, 0, LUA_MULTRET, 0))

•#deﬁne luaL_dostring(L, s) (luaL_loadstring(L, s) jj lua_pcall(L, 0, LUA_MULTRET, 0))

•#deﬁne luaL_getmetatable(L, n) (lua_getﬁeld(L, LUA_REGISTRYINDEX, (n)))

The Witchcraft Compiler Collection

58	File Documentation

•#deﬁne luaL_opt(L, f, n, d) (lua_isnoneornil(L,(n)) ? (d) : f(L,(n)))

•#deﬁne luaL_loadbuffer(L, s, sz, n) luaL_loadbufferx(L,s,sz,n,NULL)

•#deﬁne luaL_addchar(B, c)

•#deﬁne luaL_addsize(B, s) ((B)->n += (s))

•#deﬁne luaL_prepbuffer(B) luaL_prepbuffsize(B, LUAL_BUFFERSIZE)

•#deﬁne LUA_FILEHANDLE "FILE"

•#deﬁne lua_writestring(s, l) fwrite((s), sizeof(char), (l), stdout)

•#deﬁne lua_writeline() (lua_writestring("\n", 1), fﬂush(stdout))

•#deﬁne lua_writestringerror(s, p) (fprintf(stderr, (s), (p)), fﬂush(stderr))

Typedefs

•typedef struct luaL_Reg luaL_Reg

•typedef struct luaL_Buffer luaL_Buffer

•typedef struct luaL_Stream luaL_Stream

Functions

•LUALIB_API void() luaL_checkversion_ (lua_State L, lua_Number ver, size_t sz)

•LUALIB_API int() luaL_getmetaﬁeld (lua_State L, int obj, const char e)

•LUALIB_API int() luaL_callmeta (lua_State L, int obj, const char e)

•LUALIB_API const char () luaL_tolstring (lua_State L, int idx, size_t len)

•LUALIB_API int() luaL_argerror (lua_State L, int arg, const char extramsg)

•LUALIB_API const char () luaL_checklstring (lua_State L, int arg, size_t l)

•LUALIB_API const char () luaL_optlstring (lua_State L, int arg, const char def, size_t l)

•LUALIB_API lua_Number() luaL_checknumber (lua_State L, int arg)

•LUALIB_API lua_Number() luaL_optnumber (lua_State L, int arg, lua_Number def)

•LUALIB_API lua_Integer() luaL_checkinteger (lua_State L, int arg)

•LUALIB_API lua_Integer() luaL_optinteger (lua_State L, int arg, lua_Integer def)

•LUALIB_API void() luaL_checkstack (lua_State L, int sz, const char msg)

•LUALIB_API void() luaL_checktype (lua_State L, int arg, int t)

•LUALIB_API void() luaL_checkany (lua_State L, int arg)

•LUALIB_API int() luaL_newmetatable (lua_State L, const char tname)

•LUALIB_API void() luaL_setmetatable (lua_State L, const char tname)

•LUALIB_API void () luaL_testudata (lua_State L, int ud, const char tname)

•LUALIB_API void () luaL_checkudata (lua_State L, int ud, const char tname)

•LUALIB_API void() luaL_where (lua_State L, int lvl)

•LUALIB_API int() luaL_error (lua_State L, const char fmt,...)

• LUALIB_API int() luaL_checkoption (lua_State L, int arg, const char def, const char const lst[ ])

•LUALIB_API int() luaL_ﬁleresult (lua_State L, int stat, const char fname)

•LUALIB_API int() luaL_execresult (lua_State L, int stat)

•LUALIB_API int() luaL_ref (lua_State L, int t)

•LUALIB_API void() luaL_unref (lua_State L, int t, int ref)

•LUALIB_API int() luaL_loadﬁlex (lua_State L, const char ﬁlename, const char mode)

•LUALIB_API int() luaL_loadbufferx (lua_State L, const char buff, size_t sz, const char name, const char mode)

•LUALIB_API int() luaL_loadstring (lua_State L, const char s)

•LUALIB_API lua_State () luaL_newstate (void)

•LUALIB_API lua_Integer() luaL_len (lua_State L, int idx)

•LUALIB_API const char () luaL_gsub (lua_State L, const char s, const char p, const char r)

•LUALIB_API void() luaL_setfuncs (lua_State L, const luaL_Reg l, int nup)

•LUALIB_API int() luaL_getsubtable (lua_State L, int idx, const char fname)

•LUALIB_API void() luaL_traceback (lua_State L, lua_State L1, const char msg, int level)

•LUALIB_API void() luaL_requiref (lua_State L, const char modname, lua_CFunction openf, int glb)

The Witchcraft Compiler Collection

4.5 wsh/include/lauxlib.h File Reference

•LUALIB_API void() luaL_bufﬁnit (lua_State L, luaL_Buffer B)

•LUALIB_API char () luaL_prepbuffsize (luaL_Buffer B, size_t sz)

•LUALIB_API void() luaL_addlstring (luaL_Buffer B, const char s, size_t l)

•LUALIB_API void() luaL_addstring (luaL_Buffer B, const char s)

•LUALIB_API void() luaL_addvalue (luaL_Buffer B)

•LUALIB_API void() luaL_pushresult (luaL_Buffer B)

•LUALIB_API void() luaL_pushresultsize (luaL_Buffer B, size_t sz)

•LUALIB_API char () luaL_bufﬁnitsize (lua_State L, luaL_Buffer B, size_t sz)

4.5.1Macro Deﬁnition Documentation

4.5.1.1#deﬁne LUA_ERRFILE (LUA_ERRERR+1)

Deﬁnition at line 20 of ﬁle lauxlib.h.

4.5.1.2#deﬁne LUA_FILEHANDLE "FILE"

Deﬁnition at line 182 of ﬁle lauxlib.h.

4.5.1.3#deﬁne LUA_NOREF (-2)

Deﬁnition at line 69 of ﬁle lauxlib.h.

4.5.1.4#deﬁne LUA_REFNIL (-1)

Deﬁnition at line 70 of ﬁle lauxlib.h.

4.5.1.5 #deﬁne lua_writeline( ) (lua_writestring("\n", 1), fﬂush(stdout))

Deﬁnition at line 220 of ﬁle lauxlib.h.

4.5.1.6#deﬁne lua_writestring( s, l ) fwrite((s), sizeof(char), (l), stdout)

Deﬁnition at line 215 of ﬁle lauxlib.h.

4.5.1.7#deﬁne lua_writestringerror( s, p ) (fprintf(stderr, (s), (p)), fﬂush(stderr))

Deﬁnition at line 225 of ﬁle lauxlib.h.

4.5.1.8#deﬁne luaL_addchar( B, c )

Value:

((void)((B)->n < (B)->size || luaL_prepbuffsize((B), 1)), n ((B)->b[(B)->n++] = (c)))

Deﬁnition at line 149 of ﬁle lauxlib.h.

4.5.1.9#deﬁne luaL_addsize( B, s ) ((B)->n += (s))

Deﬁnition at line 153 of ﬁle lauxlib.h.

The Witchcraft Compiler Collection

60	File Documentation

4.5.1.10#deﬁne luaL_argcheck( L, cond, arg, extramsg ) ((void)((cond) jj luaL_argerror(L, (arg), (extramsg))))

Deﬁnition at line 114 of ﬁle lauxlib.h.

4.5.1.11#deﬁne luaL_checkstring( L, n ) (luaL_checklstring(L, (n), NULL))

Deﬁnition at line 116 of ﬁle lauxlib.h.

4.5.1.12#deﬁne luaL_checkversion( L ) luaL_checkversion_(L, LUA_VERSION_NUM, LUAL_NUMSIZES)

Deﬁnition at line 32 of ﬁle lauxlib.h.

4.5.1.13#deﬁne luaL_doﬁle( L, fn ) (luaL_loadﬁle(L, fn) jj lua_pcall(L, 0, LUA_MULTRET, 0))

Deﬁnition at line 121 of ﬁle lauxlib.h.

4.5.1.14#deﬁne luaL_dostring( L, s ) (luaL_loadstring(L, s) jj lua_pcall(L, 0, LUA_MULTRET, 0))

Deﬁnition at line 124 of ﬁle lauxlib.h.

4.5.1.15#deﬁne luaL_getmetatable( L, n ) (lua_getﬁeld(L, LUA_REGISTRYINDEX, (n)))

Deﬁnition at line 127 of ﬁle lauxlib.h.

4.5.1.16#deﬁne luaL_loadbuffer( L, s, sz, n ) luaL_loadbufferx(L,s,sz,n,NULL)

Deﬁnition at line 131 of ﬁle lauxlib.h.

4.5.1.17#deﬁne luaL_loadﬁle( L, f ) luaL_loadﬁlex(L,f,NULL)

Deﬁnition at line 78 of ﬁle lauxlib.h.

4.5.1.18#deﬁne luaL_newlib( L, l ) (luaL_checkversion(L), luaL_newlibtable(L,l), luaL_setfuncs(L,l,0))

Deﬁnition at line 111 of ﬁle lauxlib.h.

4.5.1.19#deﬁne luaL_newlibtable( L, l ) lua_createtable(L, 0, sizeof(l)/sizeof((l)[0]) - 1)

Deﬁnition at line 108 of ﬁle lauxlib.h.

4.5.1.20#deﬁne LUAL_NUMSIZES (sizeof(lua_Integer)16 + sizeof(lua_Number))

Deﬁnition at line 29 of ﬁle lauxlib.h.

4.5.1.21#deﬁne luaL_opt( L, f, n, d ) (lua_isnoneornil(L,(n)) ? (d) : f(L,(n)))

Deﬁnition at line 129 of ﬁle lauxlib.h.

The Witchcraft Compiler Collection

4.5 wsh/include/lauxlib.h File Reference

4.5.1.22#deﬁne luaL_optstring( L, n, d ) (luaL_optlstring(L, (n), (d), NULL))

Deﬁnition at line 117 of ﬁle lauxlib.h.

4.5.1.23#deﬁne luaL_prepbuffer( B ) luaL_prepbuffsize(B, LUAL_BUFFERSIZE)

Deﬁnition at line 164 of ﬁle lauxlib.h.

4.5.1.24#deﬁne luaL_typename( L, i ) lua_typename(L, lua_type(L,(i)))

Deﬁnition at line 119 of ﬁle lauxlib.h.

4.5.2Typedef Documentation

4.5.2.1typedef struct luaL_Buffer luaL_Buffer

4.5.2.2typedef struct luaL_Reg luaL_Reg

4.5.2.3typedef struct luaL_Stream luaL_Stream

4.5.3Function Documentation

4.5.3.1LUALIB_API void() luaL_addlstring ( luaL_Buffer B, const char s, size_t l )

4.5.3.2LUALIB_API void() luaL_addstring ( luaL_Buffer B, const char s )

4.5.3.3LUALIB_API void() luaL_addvalue ( luaL_Buffer B )

4.5.3.4LUALIB_API int() luaL_argerror ( lua_State L, int arg, const char extramsg )

4.5.3.5LUALIB_API void() luaL_bufﬁnit ( lua_State L, luaL_Buffer B )

4.5.3.6LUALIB_API char() luaL_bufﬁnitsize ( lua_State L, luaL_Buffer B, size_t sz )

4.5.3.7LUALIB_API int() luaL_callmeta ( lua_State L, int obj, const char e )

4.5.3.8LUALIB_API void() luaL_checkany ( lua_State L, int arg )

4.5.3.9LUALIB_API lua_Integer() luaL_checkinteger ( lua_State L, int arg )

4.5.3.10LUALIB_API const char() luaL_checklstring ( lua_State L, int arg, size_t l )

4.5.3.11LUALIB_API lua_Number() luaL_checknumber ( lua_State L, int arg )

4.5.3.12LUALIB_API int() luaL_checkoption ( lua_State L, int arg, const char def, const char const lst[ ] )

4.5.3.13LUALIB_API void() luaL_checkstack ( lua_State L, int sz, const char msg )

4.5.3.14LUALIB_API void() luaL_checktype ( lua_State L, int arg, int t )

4.5.3.15LUALIB_API void() luaL_checkudata ( lua_State L, int ud, const char tname )

4.5.3.16LUALIB_API void() luaL_checkversion_ ( lua_State L, lua_Number ver, size_t sz )

The Witchcraft Compiler Collection

62	File Documentation

4.5.3.17LUALIB_API int() luaL_error ( lua_State L, const char fmt, ... )

4.5.3.18LUALIB_API int() luaL_execresult ( lua_State L, int stat )

4.5.3.19LUALIB_API int() luaL_ﬁleresult ( lua_State L, int stat, const char fname )

4.5.3.20LUALIB_API int() luaL_getmetaﬁeld ( lua_State L, int obj, const char e )

4.5.3.21LUALIB_API int() luaL_getsubtable ( lua_State L, int idx, const char fname )

4.5.3.22LUALIB_API const char() luaL_gsub ( lua_State L, const char s, const char p, const char r )

4.5.3.23LUALIB_API lua_Integer() luaL_len ( lua_State L, int idx )

4.5.3.24LUALIB_API int() luaL_loadbufferx ( lua_State L, const char buff, size_t sz, const char name, const char mode )

4.5.3.25LUALIB_API int() luaL_loadﬁlex ( lua_State L, const char ﬁlename, const char mode )

4.5.3.26LUALIB_API int() luaL_loadstring ( lua_State L, const char s )

4.5.3.27LUALIB_API int() luaL_newmetatable ( lua_State L, const char tname )

4.5.3.28LUALIB_API lua_State() luaL_newstate ( void )

4.5.3.29LUALIB_API lua_Integer() luaL_optinteger ( lua_State L, int arg, lua_Integer def )

4.5.3.30LUALIB_API const char() luaL_optlstring ( lua_State L, int arg, const char def, size_t l )

4.5.3.31LUALIB_API lua_Number() luaL_optnumber ( lua_State L, int arg, lua_Number def )

4.5.3.32LUALIB_API char() luaL_prepbuffsize ( luaL_Buffer B, size_t sz )

4.5.3.33LUALIB_API void() luaL_pushresult ( luaL_Buffer B )

4.5.3.34LUALIB_API void() luaL_pushresultsize ( luaL_Buffer B, size_t sz )

4.5.3.35LUALIB_API int() luaL_ref ( lua_State L, int t )

4.5.3.36LUALIB_API void() luaL_requiref ( lua_State L, const char modname, lua_CFunction openf, int glb )

4.5.3.37LUALIB_API void() luaL_setfuncs ( lua_State L, const luaL_Reg l, int nup )

4.5.3.38LUALIB_API void() luaL_setmetatable ( lua_State L, const char tname )

4.5.3.39LUALIB_API void() luaL_testudata ( lua_State L, int ud, const char tname )

4.5.3.40LUALIB_API const char() luaL_tolstring ( lua_State L, int idx, size_t len )

4.5.3.41LUALIB_API void() luaL_traceback ( lua_State L, lua_State L1, const char msg, int level )

4.5.3.42LUALIB_API void() luaL_unref ( lua_State L, int t, int ref )

4.5.3.43LUALIB_API void() luaL_where ( lua_State L, int lvl )

The Witchcraft Compiler Collection

4.6 wsh/include/libwitch/helper.h File Reference

Data Structures

• struct section

Functions

•int read_maps (int pid)

•int is_mapped (unsigned long int addr)

Variables

•struct section zﬁrst

•int nsections

4.6.1Function Documentation

4.6.1.1int is_mapped ( unsigned long int addr )

Deﬁnition at line 56 of ﬁle helper.c.

4.6.1.2int read_maps ( int pid )

Deﬁnition at line 72 of ﬁle helper.c.

4.6.2Variable Documentation

4.6.2.1int nsections

Deﬁnition at line 47 of ﬁle helper.c.

4.6.2.2struct section zﬁrst

Deﬁnition at line 46 of ﬁle helper.c.

4.7 wsh/include/libwitch/mylaux.h File Reference

Macros

•#deﬁne luaL_newlibtable(L, l) lua_createtable(L, 0, sizeof(l)/sizeof((l)[0]) - 1)

•#deﬁne luaL_newlib(L, l) (luaL_checkversion(L), luaL_newlibtable(L,l), luaL_setfuncs(L,l,0))

•#deﬁne luaL_argcheck(L, cond, arg, extramsg) ((void)((cond) jj luaL_argerror(L, (arg), (extramsg))))

•#deﬁne luaL_checkstring(L, n) (luaL_checklstring(L, (n), NULL))

•#deﬁne luaL_optstring(L, n, d) (luaL_optlstring(L, (n), (d), NULL))

•#deﬁne luaL_typename(L, i) lua_typename(L, lua_type(L,(i)))

•#deﬁne luaL_doﬁle(L, fn) (luaL_loadﬁle(L, fn) jj lua_pcall(L, 0, LUA_MULTRET, 0))

•#deﬁne luaL_dostring(L, s) (luaL_loadstring(L, s) jj lua_pcall(L, 0, LUA_MULTRET, 0))

•#deﬁne luaL_getmetatable(L, n) (lua_getﬁeld(L, LUA_REGISTRYINDEX, (n)))

•#deﬁne luaL_opt(L, f, n, d) (lua_isnoneornil(L,(n)) ? (d) : f(L,(n)))

•#deﬁne luaL_loadbuffer(L, s, sz, n) luaL_loadbufferx(L,s,sz,n,NULL)

The Witchcraft Compiler Collection

64	File Documentation

4.7.1Macro Deﬁnition Documentation

4.7.1.1#deﬁne luaL_argcheck( L, cond, arg, extramsg ) ((void)((cond) jj luaL_argerror(L, (arg), (extramsg))))

Deﬁnition at line 15 of ﬁle mylaux.h.

4.7.1.2#deﬁne luaL_checkstring( L, n ) (luaL_checklstring(L, (n), NULL))

Deﬁnition at line 17 of ﬁle mylaux.h.

4.7.1.3#deﬁne luaL_doﬁle( L, fn ) (luaL_loadﬁle(L, fn) jj lua_pcall(L, 0, LUA_MULTRET, 0))

Deﬁnition at line 22 of ﬁle mylaux.h.

4.7.1.4#deﬁne luaL_dostring( L, s ) (luaL_loadstring(L, s) jj lua_pcall(L, 0, LUA_MULTRET, 0))

Deﬁnition at line 25 of ﬁle mylaux.h.

4.7.1.5#deﬁne luaL_getmetatable( L, n ) (lua_getﬁeld(L, LUA_REGISTRYINDEX, (n)))

Deﬁnition at line 28 of ﬁle mylaux.h.

4.7.1.6#deﬁne luaL_loadbuffer( L, s, sz, n ) luaL_loadbufferx(L,s,sz,n,NULL)

Deﬁnition at line 32 of ﬁle mylaux.h.

4.7.1.7#deﬁne luaL_newlib( L, l ) (luaL_checkversion(L), luaL_newlibtable(L,l), luaL_setfuncs(L,l,0))

Deﬁnition at line 12 of ﬁle mylaux.h.

4.7.1.8#deﬁne luaL_newlibtable( L, l ) lua_createtable(L, 0, sizeof(l)/sizeof((l)[0]) - 1)

Deﬁnition at line 9 of ﬁle mylaux.h.

4.7.1.9#deﬁne luaL_opt( L, f, n, d ) (lua_isnoneornil(L,(n)) ? (d) : f(L,(n)))

Deﬁnition at line 30 of ﬁle mylaux.h.

4.7.1.10#deﬁne luaL_optstring( L, n, d ) (luaL_optlstring(L, (n), (d), NULL))

Deﬁnition at line 18 of ﬁle mylaux.h.

4.7.1.11#deﬁne luaL_typename( L, i ) lua_typename(L, lua_type(L,(i)))

Deﬁnition at line 20 of ﬁle mylaux.h.

The Witchcraft Compiler Collection

4.8 wsh/include/libwitch/sigs.h File Reference

Data Structures

• struct signame_t

Typedefs

• typedef struct signame_t signame_t

Variables

•signame_t signames [ ]

4.8.1Typedef Documentation

4.8.1.1typedef struct signame_t signame_t

4.8.2Variable Documentation

4.8.2.1signame_t signames[ ]

Deﬁnition at line 6 of ﬁle sigs.h.

The Witchcraft Compiler Collection

66	File Documentation

4.9 wsh/include/libwitch/wsh.h File Reference

#include <sys/prctl.h> #include <setjmp.h> #include <link.h> #include <stdlib.h> #include <stdio.h> #include <fcntl.h> #include <sys/stat.h> #include <sys/types.h> #include <getopt.h> #include <dlfcn.h> #include <string.h> #include <unistd.h> #include <limits.h> #include <errno.h> #include <stdbool.h> #include <sys/wait.h> #include <poll.h> #include <stropts.h> #include <signal.h> #include <malloc.h> #include <sys/mman.h> #include <ucontext.h> #include <ctype.h> #include <execinfo.h> #include <pthread.h> #include <sys/resource.h> #include <sys/ptrace.h> #include <longjmp.h> #include <lua.h> #include <lauxlib.h> #include <lualib.h> #include <linenoise.h> #include "helper.h" #include <colors.h> #include <config.h> #include <utlist.h>

Data Structures

•struct elfdata_t

•struct range_t

•struct breakpoint_t

•struct preload_t

•struct script_t

•struct sections_t

•struct segments_t

•struct symbols_t

•struct eps_t

•struct wsh_t

•struct tuple_t

The Witchcraft Compiler Collection

4.9 wsh/include/libwitch/wsh.h File Reference

Macros

•#deﬁne _GNU_SOURCE

•#deﬁne USE_LUA 1

•#deﬁne DEFAULT_SCRIPT "/usr/share/wcc/scripts/debug"

•#deﬁne DEFAULT_SCRIPT_INDEX "/usr/share/wcc/scripts/INDEX"

•#deﬁne PROC_ASLR_PATH "/proc/sys/kernel/randomize_va_space"

•#deﬁne DEFAULT_LEARN_FILE "./learnwitch.log"

•#deﬁne MAX_SIGNALS 2000000

•#deﬁne MY_CPU 1

•#deﬁne BIND_FLAGS RTLD_NOW

•#deﬁne DMGL_PARAMS (1 << 0)

•#deﬁne DMGL_ANSI (1 << 1)

•#deﬁne DMGL_ARM (1 << 11)

•#deﬁne Elf_Dyn Elf32_Dyn

•#deﬁne Elf_Ehdr Elf32_Ehdr

•#deﬁne Elf_Phdr Elf32_Phdr

•#deﬁne Elf_Shdr Elf32_Shdr

•#deﬁne Elf_Sym Elf32_Sym

•#deﬁne HPERMSMAX 5

•#deﬁne ELF32_ST_BIND(val) (((unsigned char) (val)) >> 4)

•#deﬁne ELF32_ST_TYPE(val) ((val) & 0xf)

•#deﬁne ELF32_ST_INFO(bind, type) (((bind) << 4) + ((type) & 0xf))

•#deﬁne ELF64_ST_BIND(val) ELF32_ST_BIND (val)

•#deﬁne ELF64_ST_TYPE(val) ELF32_ST_TYPE (val)

•#deﬁne ELF64_ST_INFO(bind, type) ELF32_ST_INFO ((bind), (type))

•#deﬁne STB_LOCAL 0

•#deﬁne STB_GLOBAL 1

•#deﬁne STB_WEAK 2

•#deﬁne STB_GNU_UNIQUE 10

•#deﬁne STB_GNU_SECONDARY 11

•#deﬁne STT_NOTYPE 0

•#deﬁne STT_OBJECT 1

•#deﬁne STT_FUNC 2

•#deﬁne STT_SECTION 3

•#deﬁne STT_FILE 4

•#deﬁne STT_COMMON 5

•#deﬁne STT_TLS 6

•#deﬁne LINES_MAX 50

•#deﬁne read_arg1(arg1)

•#deﬁne read_arg2(arg2)

•#deﬁne read_arg3(arg3)

•#deﬁne read_arg4(arg4)

•#deﬁne read_arg(arg, j)

•#deﬁne SHELL_HISTORY_NAME ".wsh_history"

•#deﬁne luaL_reg luaL_Reg

•#deﬁne MIN_BIN_SIZE 10

•#deﬁne FAULT_READ 1

•#deﬁne FAULT_WRITE 2

•#deﬁne FAULT_EXEC 4

•#deﬁne default_poison 0x61

•#deﬁne SKIP_INIT 3

•#deﬁne SKIP_BOTTOM 13

The Witchcraft Compiler Collection

68	File Documentation

Typedefs

•typedef struct range_t range_t

•typedef struct breakpoint_t breakpoint_t

•typedef struct preload_t preload_t

•typedef struct script_t script_t

•typedef struct sections_t sections_t

•typedef struct segments_t segments_t

•typedef struct symbols_t symbols_t

•typedef struct eps_t eps_t

•typedef struct wsh_t wsh_t

•typedef struct tuple_t tuple_t

Functions

•char cplus_demangle (const char mangled, int options)

•int do_loadlib (char libname)

•int empty_phdrs (void)

•int empty_shdrs (void)

•int getsize (lua_State L)

•int newarray (lua_State L)

•int print_functions (lua_State L)

•int print_libs (lua_State L)

•int print_objects (lua_State L)

•int print_phdrs (void)

•int print_shdrs (void)

•int entrypoints (lua_State L)

•int print_symbols (lua_State L)

•int print_version (void)

•int setarray (lua_State L)

•int usage (char name)

•void set_align_ﬂag (void)

•void set_branch_ﬂag (void)

•void set_trace_ﬂag (void)

•void singlebranch (lua_State L)

•void singlestep (lua_State L)

•void traceunaligned (lua_State L)

•void unset_align_ﬂag (void)

•void unset_branch_ﬂag (void)

•void unset_trace_ﬂag (void)

•void unsinglebranch (lua_State L)

•void unsinglestep (lua_State L)

•void untraceunaligned (lua_State L)

•void unverbosetrace (lua_State L)

•void verbosetrace (lua_State L)

•void xfree (lua_State L)

•void systrace (lua_State L)

•void rtrace (lua_State L)

•void unsystrace (lua_State L)

•void unrtrace (lua_State L)

•int add_symbol (char symbol, char libname, char htype, char hbind, unsigned long value, unsigned int size, unsigned long int addr)

•void segment_add (unsigned long int addr, unsigned long int size, char perms, char fname, char ptype, int ﬂags)

The Witchcraft Compiler Collection

4.9 wsh/include/libwitch/wsh.h File Reference

•int alloccharbuf (lua_State L)

•int bfmap (lua_State L)

•int breakpoint (lua_State L)

•int execlib (lua_State L)

•int getcharbuf (lua_State L)

•int grep (lua_State L)

•int grepptr (lua_State L)

•int help (lua_State L)

•int hollywood (lua_State L)

•int info (lua_State L)

•int libcall (lua_State L)

•int loadbin (lua_State L)

•int man (lua_State L)

•int map (lua_State L)

•int phdrs (lua_State L)

•int priv_memcpy (lua_State L)

•int priv_strcat (lua_State L)

•int priv_strcpy (lua_State L)

•int rdnum (lua_State L)

•int rdstr (lua_State L)

•int setcharbuf (lua_State L)

•int shdrs (lua_State L)

•int verbose (lua_State L)

•int xalloc (lua_State L)

•int ralloc (lua_State L)

•int headers (lua_State L)

•int prototypes (lua_State L)

•int bsspolute (lua_State L)

•unsigned int ltrace (void)

•int procmap_lua (void)

•void rescan (void)

•void hexdump (uint8_t data, size_t size, size_t colorstart, size_t color_len)

•int disable_aslr (void)

•int enable_aslr (void)

•void script (char path)

•int enable_core (lua_State L)

•int disable_core (lua_State L)

•int gencore (lua_State L)

•char signaltoname (int signal)

•char sicode_strerror (int signal, siginfo_t s)

•int rawmemread (lua_State L)

•int rawmemwrite (lua_State L)

•int rawmemstr (lua_State L)

•int rawmemusage (lua_State L)

•int rawmemaddr (lua_State L)

•int rawmemstrlen (lua_State L)

•int wsh_init (void)

•int wsh_getopt (wsh_t wsh1, int argc, char argv)

•int wsh_loadlibs (void)

•int reload_elfs (void)

•int wsh_run (void)

Variables

• char __progname_full

The Witchcraft Compiler Collection

70	File Documentation

4.9.1Macro Deﬁnition Documentation

4.9.1.1#deﬁne _GNU_SOURCE

Deﬁnition at line 1 of ﬁle wsh.h.

4.9.1.2#deﬁne BIND_FLAGS RTLD_NOW

Deﬁnition at line 113 of ﬁle wsh.h.

4.9.1.3#deﬁne DEFAULT_LEARN_FILE "./learnwitch.log"

Deﬁnition at line 107 of ﬁle wsh.h.

4.9.1.4#deﬁne default_poison 0x61

Deﬁnition at line 287 of ﬁle wsh.h.

4.9.1.5#deﬁne DEFAULT_SCRIPT "/usr/share/wcc/scripts/debug"

Deﬁnition at line 103 of ﬁle wsh.h.

4.9.1.6#deﬁne DEFAULT_SCRIPT_INDEX "/usr/share/wcc/scripts/INDEX"

Deﬁnition at line 104 of ﬁle wsh.h.

4.9.1.7#deﬁne DMGL_ANSI (1 << 1)

Deﬁnition at line 123 of ﬁle wsh.h.

4.9.1.8#deﬁne DMGL_ARM (1 << 11)

Deﬁnition at line 124 of ﬁle wsh.h.

4.9.1.9#deﬁne DMGL_PARAMS (1 << 0)

Deﬁnition at line 122 of ﬁle wsh.h.

4.9.1.10#deﬁne ELF32_ST_BIND( val ) (((unsigned char) (val)) >> 4)

Deﬁnition at line 142 of ﬁle wsh.h.

4.9.1.11#deﬁne ELF32_ST_INFO( bind, type ) (((bind) << 4) + ((type) & 0xf))

Deﬁnition at line 144 of ﬁle wsh.h.

4.9.1.12#deﬁne ELF32_ST_TYPE( val ) ((val) & 0xf)

Deﬁnition at line 143 of ﬁle wsh.h.

The Witchcraft Compiler Collection

4.9 wsh/include/libwitch/wsh.h File Reference

4.9.1.13#deﬁne ELF64_ST_BIND( val ) ELF32_ST_BIND (val)

Deﬁnition at line 146 of ﬁle wsh.h.

4.9.1.14#deﬁne ELF64_ST_INFO( bind, type ) ELF32_ST_INFO ((bind), (type))

Deﬁnition at line 148 of ﬁle wsh.h.

4.9.1.15#deﬁne ELF64_ST_TYPE( val ) ELF32_ST_TYPE (val)

Deﬁnition at line 147 of ﬁle wsh.h.

4.9.1.16#deﬁne Elf_Dyn Elf32_Dyn

Deﬁnition at line 133 of ﬁle wsh.h.

4.9.1.17#deﬁne Elf_Ehdr Elf32_Ehdr

Deﬁnition at line 134 of ﬁle wsh.h.

4.9.1.18#deﬁne Elf_Phdr Elf32_Phdr

Deﬁnition at line 135 of ﬁle wsh.h.

4.9.1.19#deﬁne Elf_Shdr Elf32_Shdr

Deﬁnition at line 136 of ﬁle wsh.h.

4.9.1.20#deﬁne Elf_Sym Elf32_Sym

Deﬁnition at line 137 of ﬁle wsh.h.

4.9.1.21#deﬁne FAULT_EXEC 4

Deﬁnition at line 285 of ﬁle wsh.h.

4.9.1.22#deﬁne FAULT_READ 1

Deﬁnition at line 283 of ﬁle wsh.h.

4.9.1.23#deﬁne FAULT_WRITE 2

Deﬁnition at line 284 of ﬁle wsh.h.

4.9.1.24#deﬁne HPERMSMAX 5

Deﬁnition at line 140 of ﬁle wsh.h.

The Witchcraft Compiler Collection

72	File Documentation

4.9.1.25#deﬁne LINES_MAX 50

Deﬁnition at line 165 of ﬁle wsh.h.

4.9.1.26#deﬁne luaL_reg luaL_Reg

Deﬁnition at line 279 of ﬁle wsh.h.

4.9.1.27#deﬁne MAX_SIGNALS 2000000

Deﬁnition at line 109 of ﬁle wsh.h.

4.9.1.28#deﬁne MIN_BIN_SIZE 10

Deﬁnition at line 281 of ﬁle wsh.h.

4.9.1.29#deﬁne MY_CPU 1

Deﬁnition at line 111 of ﬁle wsh.h.

4.9.1.30#deﬁne PROC_ASLR_PATH "/proc/sys/kernel/randomize_va_space"

Deﬁnition at line 105 of ﬁle wsh.h.

4.9.1.31#deﬁne read_arg( arg, j )

Value:

if (lua_isnil(L, j)) { n arg = 0; n

}else if (lua_isnumber(L, j)) { n

arg = (unsigned long) lua_tonumber(L, j); n

}else if (lua_isstring(L, j)) { n

arg = luaL_checkstring(L, j); n

}else if (lua_istable(L, j)) { n

}else if (lua_isfunction(L, j)) { n arg = lua_tocfunction(L, j); n

}else if (lua_iscfunction(L, j)) { n arg = lua_touserdata(L, j); n

}else if (lua_isuserdata(L, j)) { n arg = lua_touserdata(L, j); n

}else { n

arg = 0; n

}

Read argument number j

Deﬁnition at line 259 of ﬁle wsh.h.

4.9.1.32#deﬁne read_arg1( arg1 )

Value:

if (lua_isnil(L, 1)) { n arg1 = 0; n

}else if (lua_isnumber(L, 1)) { n

arg1 = (unsigned long) lua_tonumber(L, 1); n

The Witchcraft Compiler Collection

4.9 wsh/include/libwitch/wsh.h File Reference

}else if (lua_isstring(L, 1)) { n

arg1 = luaL_checkstring(L, 1); n

}else if (lua_istable(L, 1)) { n

}else if (lua_isfunction(L, 1)) { n arg1 = lua_tocfunction(L, 1); n

}else if (lua_iscfunction(L, 1)) { n arg1 = lua_touserdata(L, 1); n

}else if (lua_isuserdata(L, 1)) { n arg1 = lua_touserdata(L, 1); n

}else { n

arg1 = 0; n

}

Read arg1

Deﬁnition at line 171 of ﬁle wsh.h.

4.9.1.33#deﬁne read_arg2( arg2 )

Value:

if (lua_isnil(L, 2)) { n arg2 = 0; n

}else if (lua_isnumber(L, 2)) { n

arg2 = (unsigned long) lua_tonumber(L, 2); n

}else if (lua_isstring(L, 2)) { n

arg2 = luaL_checkstring(L, 2); n

}else if (lua_istable(L, 2)) { n

}else if (lua_isfunction(L, 2)) { n arg2 = lua_tocfunction(L, 2); n

}else if (lua_iscfunction(L, 2)) { n arg2 = lua_touserdata(L, 2); n

}else if (lua_isuserdata(L, 2)) { n arg2 = lua_touserdata(L, 2); n

}else { n

arg2 = 0; n

}

Read arg2

Deﬁnition at line 193 of ﬁle wsh.h.

4.9.1.34#deﬁne read_arg3( arg3 )

Value:

if (lua_isnil(L, 3)) { n arg3 = 0; n

}else if (lua_isnumber(L, 3)) { n

arg3 = (unsigned long) lua_tonumber(L, 3); n

}else if (lua_isstring(L, 3)) { n

arg3 = luaL_checkstring(L, 3); n

}else if (lua_istable(L, 3)) { n

}else if (lua_isfunction(L, 3)) { n arg3 = lua_tocfunction(L, 3); n

}else if (lua_iscfunction(L, 3)) { n arg3 = lua_touserdata(L, 3); n

}else if (lua_isuserdata(L, 3)) { n arg3 = lua_touserdata(L, 3); n

}else { n

arg3 = 0; n

}

Read arg3

Deﬁnition at line 215 of ﬁle wsh.h.

The Witchcraft Compiler Collection

74	File Documentation

4.9.1.35#deﬁne read_arg4( arg4 )

Value:

if (lua_isnil(L, 4)) { n arg4 = 0; n

}else if (lua_isnumber(L, 4)) { n

arg4 = (unsigned long) lua_tonumber(L, 4); n

}else if (lua_isstring(L, 4)) { n

arg4 = luaL_checkstring(L, 4); n

}else if (lua_istable(L, 4)) { n

}else if (lua_isfunction(L, 4)) { n arg4 = lua_tocfunction(L, 4); n

}else if (lua_iscfunction(L, 4)) { n arg4 = lua_touserdata(L, 4); n

}else if (lua_isuserdata(L, 4)) { n arg4 = lua_touserdata(L, 4); n

}else { n

arg4 = 0; n

}

Read arg4

Deﬁnition at line 237 of ﬁle wsh.h.

4.9.1.36#deﬁne SHELL_HISTORY_NAME ".wsh_history"

Deﬁnition at line 278 of ﬁle wsh.h.

4.9.1.37#deﬁne SKIP_BOTTOM 13

Deﬁnition at line 297 of ﬁle wsh.h.

4.9.1.38#deﬁne SKIP_INIT 3

Backtrace parameters

Deﬁnition at line 296 of ﬁle wsh.h.

4.9.1.39#deﬁne STB_GLOBAL 1

Deﬁnition at line 151 of ﬁle wsh.h.

4.9.1.40#deﬁne STB_GNU_SECONDARY 11

Deﬁnition at line 154 of ﬁle wsh.h.

4.9.1.41#deﬁne STB_GNU_UNIQUE 10

Deﬁnition at line 153 of ﬁle wsh.h.

4.9.1.42#deﬁne STB_LOCAL 0

Deﬁnition at line 150 of ﬁle wsh.h.

The Witchcraft Compiler Collection

4.9 wsh/include/libwitch/wsh.h File Reference

4.9.1.43#deﬁne STB_WEAK 2

Deﬁnition at line 152 of ﬁle wsh.h.

4.9.1.44#deﬁne STT_COMMON 5

Deﬁnition at line 161 of ﬁle wsh.h.

4.9.1.45#deﬁne STT_FILE 4

Deﬁnition at line 160 of ﬁle wsh.h.

4.9.1.46#deﬁne STT_FUNC 2

Deﬁnition at line 158 of ﬁle wsh.h.

4.9.1.47#deﬁne STT_NOTYPE 0

Deﬁnition at line 156 of ﬁle wsh.h.

4.9.1.48#deﬁne STT_OBJECT 1

Deﬁnition at line 157 of ﬁle wsh.h.

4.9.1.49#deﬁne STT_SECTION 3

Deﬁnition at line 159 of ﬁle wsh.h.

4.9.1.50#deﬁne STT_TLS 6

Deﬁnition at line 162 of ﬁle wsh.h.

4.9.1.51#deﬁne USE_LUA 1

Deﬁnition at line 71 of ﬁle wsh.h.

4.9.2Typedef Documentation

4.9.2.1typedef struct breakpoint_t breakpoint_t

Breakpoint structure

4.9.2.2typedef struct eps_t eps_t

4.9.2.3typedef struct preload_t preload_t

Libraries to be preloaded (before shell/script execution)

The Witchcraft Compiler Collection

76	File Documentation

4.9.2.4typedef struct range_t range_t

Memory ranges

4.9.2.5typedef struct script_t script_t

Scripts to be executed

4.9.2.6typedef struct sections_t sections_t

Representation of ELF Sections

4.9.2.7typedef struct segments_t segments_t

Representation of ELF Segments

4.9.2.8typedef struct symbols_t symbols_t

Representation of ELF Symbols

4.9.2.9typedef struct tuple_t tuple_t

4.9.2.10typedef struct wsh_t wsh_t

wsh context

4.9.3Function Documentation

4.9.3.1int add_symbol ( char symbol, char libname, char htype, char hbind, unsigned long value, unsigned int size, unsigned long int addr )

Add a symbol to linked list

Deﬁnition at line 719 of ﬁle wsh.c.

4.9.3.2int alloccharbuf ( lua_State L )

Buffer management subroutines

Deﬁnition at line 1590 of ﬁle wsh.c.

4.9.3.3int bfmap ( lua_State L )

Bruteforce valid memory mapping ranges

Deﬁnition at line 100 of ﬁle wsh.c.

4.9.3.4int breakpoint ( lua_State L )

Set a breakpoint Make sure destination address is mapped

Change memory protections to RWX on destionation’s page

The Witchcraft Compiler Collection

4.9 wsh/include/libwitch/wsh.h File Reference

Backup byte at destination

Write Breakpoint

Save breakpoint informations

Deﬁnition at line 4218 of ﬁle wsh.c.

4.9.3.5int bsspolute ( lua_State L )

Pollute .bss sections

Deﬁnition at line 3712 of ﬁle wsh.c.

4.9.3.6char cplus_demangle ( const char mangled, int options )

Imported declarations prototypes

4.9.3.7int disable_aslr ( void )

Disable ASLR

Deﬁnition at line 455 of ﬁle wsh.c.

4.9.3.8int disable_core ( lua_State L )

Disable core ﬁles generation

Deﬁnition at line 4351 of ﬁle wsh.c.

4.9.3.9int do_loadlib ( char libname )

Forward prototypes declarations

Do load a shared binary into the address space

Deﬁnition at line 4581 of ﬁle wsh.c.

4.9.3.10int empty_phdrs ( void )

Empty linked list of segments

Deﬁnition at line 999 of ﬁle wsh.c.

4.9.3.11int empty_shdrs ( void )

Empty linked list of sections

Deﬁnition at line 1018 of ﬁle wsh.c.

4.9.3.12int enable_aslr ( void )

Enable ASLR

Deﬁnition at line 473 of ﬁle wsh.c.

The Witchcraft Compiler Collection

78	File Documentation

4.9.3.13int enable_core ( lua_State L )

Enable core ﬁles generation

Deﬁnition at line 4359 of ﬁle wsh.c.

4.9.3.14int entrypoints ( lua_State L )

Display ELF Entry points

Deﬁnition at line 1469 of ﬁle wsh.c.

4.9.3.15int execlib ( lua_State L )

Deﬁnition at line 2792 of ﬁle wsh.c.

4.9.3.16int gencore ( lua_State L )

Generate a core ﬁle

Deﬁnition at line 4340 of ﬁle wsh.c.

4.9.3.17int getcharbuf ( lua_State L )

Deﬁnition at line 1657 of ﬁle wsh.c.

4.9.3.18int getsize ( lua_State L )

4.9.3.19int grep ( lua_State L )

search a pattern over all sections mapped in memory Deﬁnition at line 4069 of ﬁle wsh.c.

4.9.3.20int grepptr ( lua_State L )

Search a given value in memory

grepptr(Pattern, patternlen, hexadumplen, nbytesbeforematch) Deﬁnition at line 3979 of ﬁle wsh.c.

4.9.3.21int headers ( lua_State L )

Generate headers generate headers for imported objects generate forward prototypes for imported functions Deﬁnition at line 931 of ﬁle wsh.c.

4.9.3.22int help ( lua_State L )

Display help

Deﬁnition at line 574 of ﬁle wsh.c.

The Witchcraft Compiler Collection

4.9 wsh/include/libwitch/wsh.h File Reference

4.9.3.23void hexdump ( uint8_t data, size_t size, size_t colorstart, size_t color_len )

Simple hexdump routine

Deﬁnition at line 184 of ﬁle wsh.c.

4.9.3.24int hollywood ( lua_State L )

Deﬁnition at line 3632 of ﬁle wsh.c.

4.9.3.25int info ( lua_State L )

Display information on an object/memory address Address is mapped

Search corresponding symbols

Search corresponding section

Search corresponding segment

Search corresponding symbols

Resolve symbol...

Deﬁnition at line 1495 of ﬁle wsh.c.

4.9.3.26int libcall ( lua_State L )

Main wrapper around a library call. This function returns 9 values: ret (returned by library call), errno, ﬁrstsignal, total number of signals, ﬁrstsicode, ﬁrsterrno, faultaddr, reason, context Handle (reverse-) system calls tracing

Make the library call

Analyse return value

Learn prototypes

Create output execution context table

Push errno to lua table

Push strerror(errno) to lua table

Push ﬁrst signal

Push ﬁrst signal name

Push total of signals emmited during this libcall

Push ﬁrst errno

Push ﬁrst sicode

Push ﬁrst sicode name

Address of last caller in backtrace

Push fault address

Push reason

Push mode

Push errctx

Push pointer to ucontext

Push arguments as a new table

Push number of non NULL arguments

The Witchcraft Compiler Collection

80	File Documentation

Push retval

Push libcall/libname

Invoke store running function on context

Deﬁnition at line 2087 of ﬁle wsh.c.

4.9.3.27int loadbin ( lua_State L )

Load a binary into the address space

Deﬁnition at line 4054 of ﬁle wsh.c.

4.9.3.28unsigned int ltrace ( void )

Deﬁnition at line 328 of ﬁle wsh.c.

4.9.3.29int man ( lua_State L )

Open a manual page

Deﬁnition at line 1478 of ﬁle wsh.c.

4.9.3.30int map ( lua_State L )

Display mapped sections

Deﬁnition at line 3658 of ﬁle wsh.c.

4.9.3.31int newarray ( lua_State L )

4.9.3.32int phdrs ( lua_State L )

Display Program headers (ELF Segments)

Deﬁnition at line 859 of ﬁle wsh.c.

4.9.3.33int print_functions ( lua_State L )

Display functions

Deﬁnition at line 1176 of ﬁle wsh.c.

4.9.3.34int print_libs ( lua_State L )

Display mapped librairies, return a list of library names

Deﬁnition at line 1308 of ﬁle wsh.c.

4.9.3.35int print_objects ( lua_State L )

Display objects (typically globals)

Deﬁnition at line 1255 of ﬁle wsh.c.

The Witchcraft Compiler Collection

4.9 wsh/include/libwitch/wsh.h File Reference

4.9.3.36int print_phdrs ( void )

Display program headers (ELF Segments)

Deﬁnition at line 1052 of ﬁle wsh.c.

4.9.3.37int print_shdrs ( void )

Display ELF sections

Deﬁnition at line 1344 of ﬁle wsh.c.

4.9.3.38int print_symbols ( lua_State L )

Display symbols

Deﬁnition at line 1108 of ﬁle wsh.c.

4.9.3.39int print_version ( void )

Deﬁnition at line 3821 of ﬁle wcc.c.

4.9.3.40int priv_memcpy ( lua_State L )

Our own version of memcpy callable from LUA

Deﬁnition at line 4154 of ﬁle wsh.c.

4.9.3.41int priv_strcat ( lua_State L )

Our own version of strcat callable from LUA

Deﬁnition at line 4197 of ﬁle wsh.c.

4.9.3.42int priv_strcpy ( lua_State L )

Our own version of strcpy callable from LUA

Deﬁnition at line 4176 of ﬁle wsh.c.

4.9.3.43int procmap_lua ( void )

Deﬁnition at line 2787 of ﬁle wsh.c.

4.9.3.44int prototypes ( lua_State L )

Display learned prototypes Read all the lines to learnt data structure

Sort learnt data structures

Deﬁnition at line 1885 of ﬁle wsh.c.

The Witchcraft Compiler Collection

82	File Documentation

4.9.3.45int ralloc ( lua_State L )

ralloc(unsigned int size, unsigned char poison); allocate 1 page set to 0x00, set size bytes to poison, remap the page R only

Deﬁnition at line 3755 of ﬁle wsh.c.

4.9.3.46int rawmemaddr ( lua_State L )

int addr rawmemaddr(obj)

Return the address in memory of the object passed as argument. Or returns an address itself if an address is given as argument.

Deﬁnition at line 4833 of ﬁle wsh.c.

4.9.3.47int rawmemread ( lua_State L )

string res rawmemread(addr, len)

Read len bytes at address addr and return them as a lua string.

Deﬁnition at line 4759 of ﬁle wsh.c.

4.9.3.48int rawmemstr ( lua_State L )

Returns a string, from an address passed as argument.

Deﬁnition at line 4797 of ﬁle wsh.c.

4.9.3.49int rawmemstrlen ( lua_State L )

int rawmemstrlen(addr) Returns the length of a string passed as argument Deﬁnition at line 4845 of ﬁle wsh.c.

4.9.3.50int rawmemusage ( lua_State L )

Display memory usage.

Deﬁnition at line 4811 of ﬁle wsh.c.

4.9.3.51int rawmemwrite ( lua_State L )

int written rawmemwrite(addr, data, len)

Raw write to addr of len bytes of data returns number of bytes written.

Deﬁnition at line 4778 of ﬁle wsh.c.

4.9.3.52int rdnum ( lua_State L )

Read a number (to a LUA number)

Deﬁnition at line 1642 of ﬁle wsh.c.

The Witchcraft Compiler Collection

4.9 wsh/include/libwitch/wsh.h File Reference

4.9.3.53int rdstr ( lua_State L )

Read a string (to a LUA string)

Deﬁnition at line 1621 of ﬁle wsh.c.

4.9.3.54int reload_elfs ( void )

Reload linked lists from ELFs binaries

Deﬁnition at line 1441 of ﬁle wsh.c.

4.9.3.55void rescan ( void )

Rescan address space

Deﬁnition at line 2752 of ﬁle wsh.c.

4.9.3.56void rtrace ( lua_State L )

Deﬁnition at line 3921 of ﬁle wsh.c.

4.9.3.57void script ( char path )

Run a script

Deﬁnition at line 166 of ﬁle wsh.c.

4.9.3.58void segment_add ( unsigned long int addr, unsigned long int size, char perms, char fname, char ptype, int ﬂags )

Add a segment to linked list

Deﬁnition at line 769 of ﬁle wsh.c.

4.9.3.59void set_align_ﬂag ( void ) [inline]

Deﬁnition at line 2904 of ﬁle wsh.c.

4.9.3.60void set_branch_ﬂag ( void ) [inline]

Deﬁnition at line 2999 of ﬁle wsh.c.

4.9.3.61void set_trace_ﬂag ( void ) [inline]

Deﬁnition at line 2931 of ﬁle wsh.c.

4.9.3.62int setarray ( lua_State L )

4.9.3.63int setcharbuf ( lua_State L )

Deﬁnition at line 1603 of ﬁle wsh.c.

The Witchcraft Compiler Collection

84	File Documentation

4.9.3.64int shdrs ( lua_State L )

Display section headers (ELF Sections)

Deﬁnition at line 1459 of ﬁle wsh.c.

4.9.3.65char sicode_strerror ( int signal, siginfo_t s )

Deﬁnition at line 3340 of ﬁle wsh.c.

4.9.3.66char signaltoname ( int signal )

Deﬁnition at line 2878 of ﬁle wsh.c.

4.9.3.67void singlebranch ( lua_State L )

Deﬁnition at line 3945 of ﬁle wsh.c.

4.9.3.68void singlestep ( lua_State L )

Deﬁnition at line 3903 of ﬁle wsh.c.

4.9.3.69void systrace ( lua_State L )

Deﬁnition at line 3916 of ﬁle wsh.c.

4.9.3.70void traceunaligned ( lua_State L )

Resize a xallocated memory zone

Deﬁnition at line 3891 of ﬁle wsh.c.

4.9.3.71void unrtrace ( lua_State L )

Deﬁnition at line 3931 of ﬁle wsh.c.

4.9.3.72void unset_align_ﬂag ( void ) [inline]

Deﬁnition at line 2890 of ﬁle wsh.c.

4.9.3.73void unset_branch_ﬂag ( void ) [inline]

Deﬁnition at line 3022 of ﬁle wsh.c.

4.9.3.74void unset_trace_ﬂag ( void ) [inline]

Deﬁnition at line 2917 of ﬁle wsh.c.

4.9.3.75void unsinglebranch ( lua_State L )

Deﬁnition at line 3967 of ﬁle wsh.c.

The Witchcraft Compiler Collection

4.9 wsh/include/libwitch/wsh.h File Reference

4.9.3.76void unsinglestep ( lua_State L )

Deﬁnition at line 3909 of ﬁle wsh.c.

4.9.3.77void unsystrace ( lua_State L )

Deﬁnition at line 3926 of ﬁle wsh.c.

4.9.3.78void untraceunaligned ( lua_State L )

Deﬁnition at line 3897 of ﬁle wsh.c.

4.9.3.79void unverbosetrace ( lua_State L )

Deﬁnition at line 3941 of ﬁle wsh.c.

4.9.3.80int usage ( char name )

Deﬁnition at line 3795 of ﬁle wcc.c.

4.9.3.81int verbose ( lua_State L )

Deﬁnition at line 3618 of ﬁle wsh.c.

4.9.3.82void verbosetrace ( lua_State L )

Deﬁnition at line 3937 of ﬁle wsh.c.

4.9.3.83int wsh_getopt ( wsh_t wsh1, int argc, char argv )

Parse command line

Deﬁnition at line 4629 of ﬁle wsh.c.

4.9.3.84int wsh_init ( void )

Deﬁnition at line 4364 of ﬁle wsh.c.

4.9.3.85int wsh_loadlibs ( void )

Load all preload libraries

Deﬁnition at line 4608 of ﬁle wsh.c.

4.9.3.86int wsh_run ( void )

Run a lua shell/script Run all the scripts speciﬁed in the command line

Run a lua shell

Deﬁnition at line 4475 of ﬁle wsh.c.

The Witchcraft Compiler Collection

86	File Documentation

4.9.3.87int xalloc ( lua_State L )

xalloc(unsigned int size, unsigned char poison, unsigned int perms); Allocate size bytes (% getpagesize()) The mapping auto-references itself, unless a poison byte is given

[page unmaped] [mapped][OURPTR, size] [page unmaped] Deﬁnition at line 3807 of ﬁle wsh.c.

4.9.3.88void xfree ( lua_State L )

Release a bloc allocated via xalloc()

Deﬁnition at line 3868 of ﬁle wsh.c.

4.9.4Variable Documentation

4.9.4.1char __progname_full

Imported globals

4.10 wsh/include/libwitch/wsh_functions.h File Reference

Variables

•char default_options [ ]

•char lua_default_functions [ ]

•char lua_blacklist [ ]

•tuple_t exposed [ ]

•range_t ranges [ ]

•unsigned int global_xalloc = 0

4.10.1Variable Documentation

4.10.1.1char default_options[ ]

Deﬁnition at line 6 of ﬁle wsh_functions.h.

4.10.1.2tuple_t exposed[ ]

Deﬁnition at line 277 of ﬁle wsh_functions.h.

4.10.1.3unsigned int global_xalloc = 0

Deﬁnition at line 352 of ﬁle wsh_functions.h.

4.10.1.4char lua_blacklist[ ]

Initial value:

The Witchcraft Compiler Collection

4.11 wsh/include/linenoise.h File Reference

"and", "break", "do", "else", "elseif", "end", "false", "for", "function", "if", "in", "local", "nil", "not", "or", "repeat", "return", "then", "true", "until", "while"

}

Deﬁnition at line 253 of ﬁle wsh_functions.h.

4.10.1.5char lua_default_functions[ ]

Deﬁnition at line 89 of ﬁle wsh_functions.h.

4.10.1.6range_t ranges[ ]

Initial value:

= {

{0x00000000, 0x100000000},

}

Deﬁnition at line 343 of ﬁle wsh_functions.h.

4.11 wsh/include/linenoise.h File Reference

Data Structures

• struct linenoiseCompletions

Typedefs

•typedef struct linenoiseCompletions linenoiseCompletions

•typedef void( linenoiseCompletionCallback )(const char , linenoiseCompletions )

Functions

•void linenoiseSetCompletionCallback (linenoiseCompletionCallback )

•void linenoiseAddCompletion (linenoiseCompletions , const char )

•char linenoise (const char prompt)

•int linenoiseHistoryAdd (const char line)

The Witchcraft Compiler Collection

88	File Documentation

•int linenoiseHistorySetMaxLen (int len)

•int linenoiseHistorySave (const char ﬁlename)

•int linenoiseHistoryLoad (const char ﬁlename)

•void linenoiseClearScreen (void)

•void linenoiseSetMultiLine (int ml)

•void linenoisePrintKeyCodes (void)

4.11.1Typedef Documentation

4.11.1.1typedef void( linenoiseCompletionCallback)(const char , linenoiseCompletions )

Deﬁnition at line 51 of ﬁle linenoise.h.

4.11.1.2typedef struct linenoiseCompletions linenoiseCompletions

4.11.2Function Documentation

4.11.2.1char linenoise ( const char prompt )

4.11.2.2void linenoiseAddCompletion ( linenoiseCompletions , const char )

4.11.2.3void linenoiseClearScreen ( void )

4.11.2.4int linenoiseHistoryAdd ( const char line )

4.11.2.5int linenoiseHistoryLoad ( const char ﬁlename )

4.11.2.6int linenoiseHistorySave ( const char ﬁlename )

4.11.2.7int linenoiseHistorySetMaxLen ( int len )

4.11.2.8void linenoisePrintKeyCodes ( void )

4.11.2.9void linenoiseSetCompletionCallback ( linenoiseCompletionCallback )

4.11.2.10void linenoiseSetMultiLine ( int ml )

4.12 wsh/include/longjmp.h File Reference

#include <stdio.h> #include <setjmp.h>

Macros

•#deﬁne TRY do { jmp_buf ex_buf__; switch( setjmp(ex_buf__) ) { case 0: while(1) {

•#deﬁne CATCH(x) break; case x:

•#deﬁne FINALLY break; } default: {

•#deﬁne ETRY break; } } }while(0)

•#deﬁne THROW(x) longjmp(ex_buf__, x)

The Witchcraft Compiler Collection

4.13 wsh/include/lua.h File Reference

4.12.1Macro Deﬁnition Documentation

4.12.1.1#deﬁne CATCH( x ) break; case x:

Deﬁnition at line 40 of ﬁle longjmp.h.

4.12.1.2#deﬁne ETRY break; } } }while(0)

Deﬁnition at line 42 of ﬁle longjmp.h.

4.12.1.3#deﬁne FINALLY break; } default: {

Deﬁnition at line 41 of ﬁle longjmp.h.

4.12.1.4#deﬁne THROW( x ) longjmp(ex_buf__, x)

Deﬁnition at line 43 of ﬁle longjmp.h.

4.12.1.5#deﬁne TRY do { jmp_buf ex_buf__; switch( setjmp(ex_buf__) ) { case 0: while(1) {

This code taken from http://www.di.unipi.it/nids/docs/longjump_try_trow_catch.- html Licensed under MIT License

Deﬁnition at line 39 of ﬁle longjmp.h.

4.13 wsh/include/lua.h File Reference

#include <stdarg.h> #include <stddef.h> #include "luaconf.h"

Data Structures

• struct lua_Debug

Macros

•#deﬁne LUA_VERSION_MAJOR "5"

•#deﬁne LUA_VERSION_MINOR "3"

•#deﬁne LUA_VERSION_NUM 503

•#deﬁne LUA_VERSION_RELEASE "2"

•#deﬁne LUA_VERSION "Lua " LUA_VERSION_MAJOR "." LUA_VERSION_MINOR

•#deﬁne LUA_RELEASE LUA_VERSION "." LUA_VERSION_RELEASE

•#deﬁne LUA_AUTHORS "R. Ierusalimschy, L. H. de Figueiredo, W. Celes"

•#deﬁne LUA_SIGNATURE "\x1bLua"

•#deﬁne LUA_MULTRET (-1)

•#deﬁne LUA_REGISTRYINDEX (-LUAI_MAXSTACK - 1000)

•#deﬁne lua_upvalueindex(i) (LUA_REGISTRYINDEX - (i))

•#deﬁne LUA_OK 0

The Witchcraft Compiler Collection

90	File Documentation

•#deﬁne LUA_YIELD 1

•#deﬁne LUA_ERRRUN 2

•#deﬁne LUA_ERRSYNTAX 3

•#deﬁne LUA_ERRMEM 4

•#deﬁne LUA_ERRGCMM 5

•#deﬁne LUA_ERRERR 6

•#deﬁne LUA_TNONE (-1)

•#deﬁne LUA_TNIL 0

•#deﬁne LUA_TBOOLEAN 1

•#deﬁne LUA_TLIGHTUSERDATA 2

•#deﬁne LUA_TNUMBER 3

•#deﬁne LUA_TSTRING 4

•#deﬁne LUA_TTABLE 5

•#deﬁne LUA_TFUNCTION 6

•#deﬁne LUA_TUSERDATA 7

•#deﬁne LUA_TTHREAD 8

•#deﬁne LUA_NUMTAGS 9

•#deﬁne LUA_MINSTACK 20

•#deﬁne LUA_RIDX_MAINTHREAD 1

•#deﬁne LUA_RIDX_GLOBALS 2

•#deﬁne LUA_RIDX_LAST LUA_RIDX_GLOBALS

•#deﬁne LUA_OPADD 0 / ORDER TM, ORDER OP /

•#deﬁne LUA_OPSUB 1

•#deﬁne LUA_OPMUL 2

•#deﬁne LUA_OPMOD 3

•#deﬁne LUA_OPPOW 4

•#deﬁne LUA_OPDIV 5

•#deﬁne LUA_OPIDIV 6

•#deﬁne LUA_OPBAND 7

•#deﬁne LUA_OPBOR 8

•#deﬁne LUA_OPBXOR 9

•#deﬁne LUA_OPSHL 10

•#deﬁne LUA_OPSHR 11

•#deﬁne LUA_OPUNM 12

•#deﬁne LUA_OPBNOT 13

•#deﬁne LUA_OPEQ 0

•#deﬁne LUA_OPLT 1

•#deﬁne LUA_OPLE 2

•#deﬁne lua_call(L, n, r) lua_callk(L, (n), (r), 0, NULL)

•#deﬁne lua_pcall(L, n, r, f) lua_pcallk(L, (n), (r), (f), 0, NULL)

•#deﬁne lua_yield(L, n) lua_yieldk(L, (n), 0, NULL)

•#deﬁne LUA_GCSTOP 0

•#deﬁne LUA_GCRESTART 1

•#deﬁne LUA_GCCOLLECT 2

•#deﬁne LUA_GCCOUNT 3

•#deﬁne LUA_GCCOUNTB 4

•#deﬁne LUA_GCSTEP 5

•#deﬁne LUA_GCSETPAUSE 6

•#deﬁne LUA_GCSETSTEPMUL 7

•#deﬁne LUA_GCISRUNNING 9

•#deﬁne lua_getextraspace(L) ((void )((char )(L) - LUA_EXTRASPACE))

•#deﬁne lua_tonumber(L, i) lua_tonumberx(L,(i),NULL)

•#deﬁne lua_tointeger(L, i) lua_tointegerx(L,(i),NULL)

•#deﬁne lua_pop(L, n) lua_settop(L, -(n)-1)

•#deﬁne lua_newtable(L) lua_createtable(L, 0, 0)

The Witchcraft Compiler Collection

4.13 wsh/include/lua.h File Reference

•#deﬁne lua_register(L, n, f) (lua_pushcfunction(L, (f)), lua_setglobal(L, (n)))

•#deﬁne lua_pushcfunction(L, f) lua_pushcclosure(L, (f), 0)

•#deﬁne lua_isfunction(L, n) (lua_type(L, (n)) == LUA_TFUNCTION)

•#deﬁne lua_istable(L, n) (lua_type(L, (n)) == LUA_TTABLE)

•#deﬁne lua_islightuserdata(L, n) (lua_type(L, (n)) == LUA_TLIGHTUSERDATA)

•#deﬁne lua_isnil(L, n) (lua_type(L, (n)) == LUA_TNIL)

•#deﬁne lua_isboolean(L, n) (lua_type(L, (n)) == LUA_TBOOLEAN)

•#deﬁne lua_isthread(L, n) (lua_type(L, (n)) == LUA_TTHREAD)

•#deﬁne lua_isnone(L, n) (lua_type(L, (n)) == LUA_TNONE)

•#deﬁne lua_isnoneornil(L, n) (lua_type(L, (n)) <= 0)

•#deﬁne lua_pushliteral(L, s) lua_pushstring(L, "" s)

•#deﬁne lua_pushglobaltable(L) lua_rawgeti(L, LUA_REGISTRYINDEX, LUA_RIDX_GLOBALS)

•#deﬁne lua_tostring(L, i) lua_tolstring(L, (i), NULL)

•#deﬁne lua_insert(L, idx) lua_rotate(L, (idx), 1)

•#deﬁne lua_remove(L, idx) (lua_rotate(L, (idx), -1), lua_pop(L, 1))

•#deﬁne lua_replace(L, idx) (lua_copy(L, -1, (idx)), lua_pop(L, 1))

•#deﬁne LUA_HOOKCALL 0

•#deﬁne LUA_HOOKRET 1

•#deﬁne LUA_HOOKLINE 2

•#deﬁne LUA_HOOKCOUNT 3

•#deﬁne LUA_HOOKTAILCALL 4

•#deﬁne LUA_MASKCALL (1 << LUA_HOOKCALL)

•#deﬁne LUA_MASKRET (1 << LUA_HOOKRET)

•#deﬁne LUA_MASKLINE (1 << LUA_HOOKLINE)

•#deﬁne LUA_MASKCOUNT (1 << LUA_HOOKCOUNT)

Typedefs

•typedef struct lua_State lua_State

•typedef LUA_NUMBER lua_Number

•typedef LUA_INTEGER lua_Integer

•typedef LUA_UNSIGNED lua_Unsigned

•typedef LUA_KCONTEXT lua_KContext

•typedef int( lua_CFunction )(lua_State L)

•typedef int( lua_KFunction )(lua_State L, int status, lua_KContext ctx)

•typedef const char ( lua_Reader )(lua_State L, void ud, size_t sz)

•typedef int( lua_Writer )(lua_State L, const void p, size_t sz, void ud)

•typedef void ( lua_Alloc )(void ud, void ptr, size_t osize, size_t nsize)

•typedef struct lua_Debug lua_Debug

•typedef void( lua_Hook )(lua_State L, lua_Debug ar)

Functions

•LUA_API lua_State () lua_newstate (lua_Alloc f, void ud)

•LUA_API void() lua_close (lua_State L)

•LUA_API lua_State () lua_newthread (lua_State L)

•LUA_API lua_CFunction() lua_atpanic (lua_State L, lua_CFunction panicf)

•LUA_API const lua_Number () lua_version (lua_State L)

•LUA_API int() lua_absindex (lua_State L, int idx)

•LUA_API int() lua_gettop (lua_State L)

•LUA_API void() lua_settop (lua_State L, int idx)

•LUA_API void() lua_pushvalue (lua_State L, int idx)

•LUA_API void() lua_rotate (lua_State L, int idx, int n)

•LUA_API void() lua_copy (lua_State L, int fromidx, int toidx)

The Witchcraft Compiler Collection

92	File Documentation

•LUA_API int() lua_checkstack (lua_State L, int n)

•LUA_API void() lua_xmove (lua_State from, lua_State to, int n)

•LUA_API int() lua_isnumber (lua_State L, int idx)

•LUA_API int() lua_isstring (lua_State L, int idx)

•LUA_API int() lua_iscfunction (lua_State L, int idx)

•LUA_API int() lua_isinteger (lua_State L, int idx)

•LUA_API int() lua_isuserdata (lua_State L, int idx)

•LUA_API int() lua_type (lua_State L, int idx)

•LUA_API const char () lua_typename (lua_State L, int tp)

•LUA_API lua_Number() lua_tonumberx (lua_State L, int idx, int isnum)

•LUA_API lua_Integer() lua_tointegerx (lua_State L, int idx, int isnum)

•LUA_API int() lua_toboolean (lua_State L, int idx)

•LUA_API const char () lua_tolstring (lua_State L, int idx, size_t len)

•LUA_API size_t() lua_rawlen (lua_State L, int idx)

•LUA_API lua_CFunction() lua_tocfunction (lua_State L, int idx)

•LUA_API void () lua_touserdata (lua_State L, int idx)

•LUA_API lua_State () lua_tothread (lua_State L, int idx)

•LUA_API const void () lua_topointer (lua_State L, int idx)

•LUA_API void() lua_arith (lua_State L, int op)

•LUA_API int() lua_rawequal (lua_State L, int idx1, int idx2)

•LUA_API int() lua_compare (lua_State L, int idx1, int idx2, int op)

•LUA_API void() lua_pushnil (lua_State L)

•LUA_API void() lua_pushnumber (lua_State L, lua_Number n)

•LUA_API void() lua_pushinteger (lua_State L, lua_Integer n)

•LUA_API const char () lua_pushlstring (lua_State L, const char s, size_t len)

•LUA_API const char () lua_pushstring (lua_State L, const char s)

•LUA_API const char () lua_pushvfstring (lua_State L, const char fmt, va_list argp)

•LUA_API const char () lua_pushfstring (lua_State L, const char fmt,...)

•LUA_API void() lua_pushcclosure (lua_State L, lua_CFunction fn, int n)

•LUA_API void() lua_pushboolean (lua_State L, int b)

•LUA_API void() lua_pushlightuserdata (lua_State L, void p)

•LUA_API int() lua_pushthread (lua_State L)

•LUA_API int() lua_getglobal (lua_State L, const char name)

•LUA_API int() lua_gettable (lua_State L, int idx)

•LUA_API int() lua_getﬁeld (lua_State L, int idx, const char k)

•LUA_API int() lua_geti (lua_State L, int idx, lua_Integer n)

•LUA_API int() lua_rawget (lua_State L, int idx)

•LUA_API int() lua_rawgeti (lua_State L, int idx, lua_Integer n)

•LUA_API int() lua_rawgetp (lua_State L, int idx, const void p)

•LUA_API void() lua_createtable (lua_State L, int narr, int nrec)

•LUA_API void () lua_newuserdata (lua_State L, size_t sz)

•LUA_API int() lua_getmetatable (lua_State L, int objindex)

•LUA_API int() lua_getuservalue (lua_State L, int idx)

•LUA_API void() lua_setglobal (lua_State L, const char name)

•LUA_API void() lua_settable (lua_State L, int idx)

•LUA_API void() lua_setﬁeld (lua_State L, int idx, const char k)

•LUA_API void() lua_seti (lua_State L, int idx, lua_Integer n)

•LUA_API void() lua_rawset (lua_State L, int idx)

•LUA_API void() lua_rawseti (lua_State L, int idx, lua_Integer n)

•LUA_API void() lua_rawsetp (lua_State L, int idx, const void p)

•LUA_API int() lua_setmetatable (lua_State L, int objindex)

•LUA_API void() lua_setuservalue (lua_State L, int idx)

•LUA_API void() lua_callk (lua_State L, int nargs, int nresults, lua_KContext ctx, lua_KFunction k)

•LUA_API int() lua_pcallk (lua_State L, int nargs, int nresults, int errfunc, lua_KContext ctx, lua_KFunction k)

The Witchcraft Compiler Collection

4.13 wsh/include/lua.h File Reference

•LUA_API int() lua_load (lua_State L, lua_Reader reader, void dt, const char chunkname, const char mode)

•LUA_API int() lua_dump (lua_State L, lua_Writer writer, void data, int strip)

•LUA_API int() lua_yieldk (lua_State L, int nresults, lua_KContext ctx, lua_KFunction k)

•LUA_API int() lua_resume (lua_State L, lua_State from, int narg)

•LUA_API int() lua_status (lua_State L)

•LUA_API int() lua_isyieldable (lua_State L)

•LUA_API int() lua_gc (lua_State L, int what, int data)

•LUA_API int() lua_error (lua_State L)

•LUA_API int() lua_next (lua_State L, int idx)

•LUA_API void() lua_concat (lua_State L, int n)

•LUA_API void() lua_len (lua_State L, int idx)

•LUA_API size_t() lua_stringtonumber (lua_State L, const char s)

•LUA_API lua_Alloc() lua_getallocf (lua_State L, void ud)

•LUA_API void() lua_setallocf (lua_State L, lua_Alloc f, void ud)

•LUA_API int() lua_getstack (lua_State L, int level, lua_Debug ar)

•LUA_API int() lua_getinfo (lua_State L, const char what, lua_Debug ar)

•LUA_API const char () lua_getlocal (lua_State L, const lua_Debug ar, int n)

•LUA_API const char () lua_setlocal (lua_State L, const lua_Debug ar, int n)

•LUA_API const char () lua_getupvalue (lua_State L, int funcindex, int n)

•LUA_API const char () lua_setupvalue (lua_State L, int funcindex, int n)

•LUA_API void () lua_upvalueid (lua_State L, int ﬁdx, int n)

•LUA_API void() lua_upvaluejoin (lua_State L, int ﬁdx1, int n1, int ﬁdx2, int n2)

•LUA_API void() lua_sethook (lua_State L, lua_Hook func, int mask, int count)

•LUA_API lua_Hook() lua_gethook (lua_State L)

•LUA_API int() lua_gethookmask (lua_State L)

•LUA_API int() lua_gethookcount (lua_State L)

Variables

• const char lua_ident [ ]

4.13.1Macro Deﬁnition Documentation

4.13.1.1#deﬁne LUA_AUTHORS "R. Ierusalimschy, L. H. de Figueiredo, W. Celes"

Deﬁnition at line 27 of ﬁle lua.h.

4.13.1.2#deﬁne lua_call( L, n, r ) lua_callk(L, (n), (r), 0, NULL)

Deﬁnition at line 274 of ﬁle lua.h.

Deﬁnition at line 26 of ﬁle lua.h.

4.13.1.4#deﬁne LUA_ERRERR 6

Deﬁnition at line 53 of ﬁle lua.h.

The Witchcraft Compiler Collection

94	File Documentation

4.13.1.5#deﬁne LUA_ERRGCMM 5

Deﬁnition at line 52 of ﬁle lua.h.

4.13.1.6#deﬁne LUA_ERRMEM 4

Deﬁnition at line 51 of ﬁle lua.h.

4.13.1.7#deﬁne LUA_ERRRUN 2

Deﬁnition at line 49 of ﬁle lua.h.

4.13.1.8#deﬁne LUA_ERRSYNTAX 3

Deﬁnition at line 50 of ﬁle lua.h.

4.13.1.9#deﬁne LUA_GCCOLLECT 2

Deﬁnition at line 304 of ﬁle lua.h.

4.13.1.10#deﬁne LUA_GCCOUNT 3

Deﬁnition at line 305 of ﬁle lua.h.

4.13.1.11#deﬁne LUA_GCCOUNTB 4

Deﬁnition at line 306 of ﬁle lua.h.

4.13.1.12#deﬁne LUA_GCISRUNNING 9

Deﬁnition at line 310 of ﬁle lua.h.

4.13.1.13#deﬁne LUA_GCRESTART 1

Deﬁnition at line 303 of ﬁle lua.h.

4.13.1.14#deﬁne LUA_GCSETPAUSE 6

Deﬁnition at line 308 of ﬁle lua.h.

4.13.1.15#deﬁne LUA_GCSETSTEPMUL 7

Deﬁnition at line 309 of ﬁle lua.h.

4.13.1.16#deﬁne LUA_GCSTEP 5

Deﬁnition at line 307 of ﬁle lua.h.

The Witchcraft Compiler Collection

4.13 wsh/include/lua.h File Reference

4.13.1.17#deﬁne LUA_GCSTOP 0

Deﬁnition at line 302 of ﬁle lua.h.

4.13.1.18#deﬁne lua_getextraspace( L ) ((void )((char )(L) - LUA_EXTRASPACE))

Deﬁnition at line 339 of ﬁle lua.h.

4.13.1.19#deﬁne LUA_HOOKCALL 0

Deﬁnition at line 402 of ﬁle lua.h.

4.13.1.20#deﬁne LUA_HOOKCOUNT 3

Deﬁnition at line 405 of ﬁle lua.h.

4.13.1.21#deﬁne LUA_HOOKLINE 2

Deﬁnition at line 404 of ﬁle lua.h.

4.13.1.22#deﬁne LUA_HOOKRET 1

Deﬁnition at line 403 of ﬁle lua.h.

4.13.1.23#deﬁne LUA_HOOKTAILCALL 4

Deﬁnition at line 406 of ﬁle lua.h.

4.13.1.24#deﬁne lua_insert( L, idx ) lua_rotate(L, (idx), 1)

Deﬁnition at line 369 of ﬁle lua.h.

4.13.1.25#deﬁne lua_isboolean( L, n ) (lua_type(L, (n)) == LUA_TBOOLEAN)

Deﬁnition at line 356 of ﬁle lua.h.

4.13.1.26#deﬁne lua_isfunction( L, n ) (lua_type(L, (n)) == LUA_TFUNCTION)

Deﬁnition at line 352 of ﬁle lua.h.

4.13.1.27#deﬁne lua_islightuserdata( L, n ) (lua_type(L, (n)) == LUA_TLIGHTUSERDATA)

Deﬁnition at line 354 of ﬁle lua.h.

4.13.1.28#deﬁne lua_isnil( L, n ) (lua_type(L, (n)) == LUA_TNIL)

Deﬁnition at line 355 of ﬁle lua.h.

The Witchcraft Compiler Collection

96	File Documentation

4.13.1.29#deﬁne lua_isnone( L, n ) (lua_type(L, (n)) == LUA_TNONE)

Deﬁnition at line 358 of ﬁle lua.h.

4.13.1.30#deﬁne lua_isnoneornil( L, n ) (lua_type(L, (n)) <= 0)

Deﬁnition at line 359 of ﬁle lua.h.

4.13.1.31#deﬁne lua_istable( L, n ) (lua_type(L, (n)) == LUA_TTABLE)

Deﬁnition at line 353 of ﬁle lua.h.

4.13.1.32#deﬁne lua_isthread( L, n ) (lua_type(L, (n)) == LUA_TTHREAD)

Deﬁnition at line 357 of ﬁle lua.h.

4.13.1.33#deﬁne LUA_MASKCALL (1 << LUA_HOOKCALL)

Deﬁnition at line 412 of ﬁle lua.h.

4.13.1.34#deﬁne LUA_MASKCOUNT (1 << LUA_HOOKCOUNT)

Deﬁnition at line 415 of ﬁle lua.h.

4.13.1.35#deﬁne LUA_MASKLINE (1 << LUA_HOOKLINE)

Deﬁnition at line 414 of ﬁle lua.h.

4.13.1.36#deﬁne LUA_MASKRET (1 << LUA_HOOKRET)

Deﬁnition at line 413 of ﬁle lua.h.

4.13.1.37#deﬁne LUA_MINSTACK 20

Deﬁnition at line 79 of ﬁle lua.h.

4.13.1.38#deﬁne LUA_MULTRET (-1)

Deﬁnition at line 34 of ﬁle lua.h.

4.13.1.39#deﬁne lua_newtable( L ) lua_createtable(L, 0, 0)

Deﬁnition at line 346 of ﬁle lua.h.

4.13.1.40#deﬁne LUA_NUMTAGS 9

Deﬁnition at line 74 of ﬁle lua.h.

The Witchcraft Compiler Collection

4.13 wsh/include/lua.h File Reference

4.13.1.41#deﬁne LUA_OK 0

Deﬁnition at line 47 of ﬁle lua.h.

4.13.1.42#deﬁne LUA_OPADD 0 / ORDER TM, ORDER OP /

Deﬁnition at line 196 of ﬁle lua.h.

4.13.1.43#deﬁne LUA_OPBAND 7

Deﬁnition at line 203 of ﬁle lua.h.

4.13.1.44#deﬁne LUA_OPBNOT 13

Deﬁnition at line 209 of ﬁle lua.h.

4.13.1.45#deﬁne LUA_OPBOR 8

Deﬁnition at line 204 of ﬁle lua.h.

4.13.1.46#deﬁne LUA_OPBXOR 9

Deﬁnition at line 205 of ﬁle lua.h.

4.13.1.47#deﬁne LUA_OPDIV 5

Deﬁnition at line 201 of ﬁle lua.h.

4.13.1.48#deﬁne LUA_OPEQ 0

Deﬁnition at line 213 of ﬁle lua.h.

4.13.1.49#deﬁne LUA_OPIDIV 6

Deﬁnition at line 202 of ﬁle lua.h.

4.13.1.50#deﬁne LUA_OPLE 2

Deﬁnition at line 215 of ﬁle lua.h.

4.13.1.51#deﬁne LUA_OPLT 1

Deﬁnition at line 214 of ﬁle lua.h.

4.13.1.52#deﬁne LUA_OPMOD 3

Deﬁnition at line 199 of ﬁle lua.h.

The Witchcraft Compiler Collection

98	File Documentation

4.13.1.53#deﬁne LUA_OPMUL 2

Deﬁnition at line 198 of ﬁle lua.h.

4.13.1.54#deﬁne LUA_OPPOW 4

Deﬁnition at line 200 of ﬁle lua.h.

4.13.1.55#deﬁne LUA_OPSHL 10

Deﬁnition at line 206 of ﬁle lua.h.

4.13.1.56#deﬁne LUA_OPSHR 11

Deﬁnition at line 207 of ﬁle lua.h.

4.13.1.57#deﬁne LUA_OPSUB 1

Deﬁnition at line 197 of ﬁle lua.h.

4.13.1.58#deﬁne LUA_OPUNM 12

Deﬁnition at line 208 of ﬁle lua.h.

4.13.1.59#deﬁne lua_pcall( L, n, r, f ) lua_pcallk(L, (n), (r), (f), 0, NULL)

Deﬁnition at line 278 of ﬁle lua.h.

4.13.1.60#deﬁne lua_pop( L, n ) lua_settop(L, -(n)-1)

Deﬁnition at line 344 of ﬁle lua.h.

4.13.1.61#deﬁne lua_pushcfunction( L, f ) lua_pushcclosure(L, (f), 0)

Deﬁnition at line 350 of ﬁle lua.h.

4.13.1.62#deﬁne lua_pushglobaltable( L ) lua_rawgeti(L, LUA_REGISTRYINDEX, LUA_RIDX_GLOBALS)

Deﬁnition at line 363 of ﬁle lua.h.

4.13.1.63#deﬁne lua_pushliteral( L, s ) lua_pushstring(L, "" s)

Deﬁnition at line 361 of ﬁle lua.h.

4.13.1.64#deﬁne lua_register( L, n, f ) (lua_pushcfunction(L, (f)), lua_setglobal(L, (n)))

Deﬁnition at line 348 of ﬁle lua.h.

The Witchcraft Compiler Collection

4.13 wsh/include/lua.h File Reference

4.13.1.65#deﬁne LUA_REGISTRYINDEX (-LUAI_MAXSTACK - 1000)

Deﬁnition at line 42 of ﬁle lua.h.

4.13.1.66#deﬁne LUA_RELEASE LUA_VERSION "." LUA_VERSION_RELEASE

Deﬁnition at line 25 of ﬁle lua.h.

4.13.1.67#deﬁne lua_remove( L, idx ) (lua_rotate(L, (idx), -1), lua_pop(L, 1))

Deﬁnition at line 371 of ﬁle lua.h.

4.13.1.68#deﬁne lua_replace( L, idx ) (lua_copy(L, -1, (idx)), lua_pop(L, 1))

Deﬁnition at line 373 of ﬁle lua.h.

4.13.1.69#deﬁne LUA_RIDX_GLOBALS 2

Deﬁnition at line 84 of ﬁle lua.h.

4.13.1.70#deﬁne LUA_RIDX_LAST LUA_RIDX_GLOBALS

Deﬁnition at line 85 of ﬁle lua.h.

4.13.1.71#deﬁne LUA_RIDX_MAINTHREAD 1

Deﬁnition at line 83 of ﬁle lua.h.

4.13.1.72#deﬁne LUA_SIGNATURE "\x1bLua"

Deﬁnition at line 31 of ﬁle lua.h.

4.13.1.73#deﬁne LUA_TBOOLEAN 1

Deﬁnition at line 65 of ﬁle lua.h.

4.13.1.74#deﬁne LUA_TFUNCTION 6

Deﬁnition at line 70 of ﬁle lua.h.

4.13.1.75#deﬁne LUA_TLIGHTUSERDATA 2

Deﬁnition at line 66 of ﬁle lua.h.

4.13.1.76#deﬁne LUA_TNIL 0

Deﬁnition at line 64 of ﬁle lua.h.

The Witchcraft Compiler Collection

100	File Documentation

4.13.1.77#deﬁne LUA_TNONE (-1)

Deﬁnition at line 62 of ﬁle lua.h.

4.13.1.78#deﬁne LUA_TNUMBER 3

Deﬁnition at line 67 of ﬁle lua.h.

4.13.1.79#deﬁne lua_tointeger( L, i ) lua_tointegerx(L,(i),NULL)

Deﬁnition at line 342 of ﬁle lua.h.

4.13.1.80#deﬁne lua_tonumber( L, i ) lua_tonumberx(L,(i),NULL)

Deﬁnition at line 341 of ﬁle lua.h.

4.13.1.81#deﬁne lua_tostring( L, i ) lua_tolstring(L, (i), NULL)

Deﬁnition at line 366 of ﬁle lua.h.

4.13.1.82#deﬁne LUA_TSTRING 4

Deﬁnition at line 68 of ﬁle lua.h.

4.13.1.83#deﬁne LUA_TTABLE 5

Deﬁnition at line 69 of ﬁle lua.h.

4.13.1.84#deﬁne LUA_TTHREAD 8

Deﬁnition at line 72 of ﬁle lua.h.

4.13.1.85#deﬁne LUA_TUSERDATA 7

Deﬁnition at line 71 of ﬁle lua.h.

4.13.1.86#deﬁne lua_upvalueindex( i ) (LUA_REGISTRYINDEX - (i))

Deﬁnition at line 43 of ﬁle lua.h.

4.13.1.87#deﬁne LUA_VERSION "Lua " LUA_VERSION_MAJOR "." LUA_VERSION_MINOR

Deﬁnition at line 24 of ﬁle lua.h.

4.13.1.88#deﬁne LUA_VERSION_MAJOR "5"

Deﬁnition at line 19 of ﬁle lua.h.

The Witchcraft Compiler Collection

4.13 wsh/include/lua.h File Reference

101

4.13.1.89#deﬁne LUA_VERSION_MINOR "3"

Deﬁnition at line 20 of ﬁle lua.h.

4.13.1.90#deﬁne LUA_VERSION_NUM 503

Deﬁnition at line 21 of ﬁle lua.h.

4.13.1.91#deﬁne LUA_VERSION_RELEASE "2"

Deﬁnition at line 22 of ﬁle lua.h.

4.13.1.92#deﬁne LUA_YIELD 1

Deﬁnition at line 48 of ﬁle lua.h.

4.13.1.93#deﬁne lua_yield( L, n ) lua_yieldk(L, (n), 0, NULL)

Deﬁnition at line 295 of ﬁle lua.h.

4.13.2Typedef Documentation

4.13.2.1typedef void( lua_Alloc)(void ud, void ptr, size_t osize, size_t nsize)

Deﬁnition at line 124 of ﬁle lua.h.

4.13.2.2typedef int( lua_CFunction)(lua_State L)

Deﬁnition at line 105 of ﬁle lua.h.

4.13.2.3typedef struct lua_Debug lua_Debug

Deﬁnition at line 417 of ﬁle lua.h.

4.13.2.4typedef void( lua_Hook)(lua_State L, lua_Debug ar)

Deﬁnition at line 421 of ﬁle lua.h.

4.13.2.5typedef LUA_INTEGER lua_Integer

Deﬁnition at line 93 of ﬁle lua.h.

4.13.2.6typedef LUA_KCONTEXT lua_KContext

Deﬁnition at line 99 of ﬁle lua.h.

4.13.2.7typedef int( lua_KFunction)(lua_State L, int status, lua_KContext ctx)

Deﬁnition at line 110 of ﬁle lua.h.

The Witchcraft Compiler Collection

102	File Documentation

4.13.2.8typedef LUA_NUMBER lua_Number

Deﬁnition at line 89 of ﬁle lua.h.

4.13.2.9typedef const char( lua_Reader)(lua_State L, void ud, size_t sz)

Deﬁnition at line 116 of ﬁle lua.h.

4.13.2.10typedef struct lua_State lua_State

Deﬁnition at line 56 of ﬁle lua.h.

4.13.2.11typedef LUA_UNSIGNED lua_Unsigned

Deﬁnition at line 96 of ﬁle lua.h.

4.13.2.12typedef int( lua_Writer)(lua_State L, const void p, size_t sz, void ud)

Deﬁnition at line 118 of ﬁle lua.h.

4.13.3Function Documentation

4.13.3.1LUA_API int() lua_absindex ( lua_State L, int idx )

4.13.3.2LUA_API void() lua_arith ( lua_State L, int op )

4.13.3.3LUA_API lua_CFunction() lua_atpanic ( lua_State L, lua_CFunction panicf )

4.13.3.4LUA_API void() lua_callk ( lua_State L, int nargs, int nresults, lua_KContext ctx, lua_KFunction k )

4.13.3.5LUA_API int() lua_checkstack ( lua_State L, int n )

4.13.3.6LUA_API void() lua_close ( lua_State L )

4.13.3.7LUA_API int() lua_compare ( lua_State L, int idx1, int idx2, int op )

4.13.3.8LUA_API void() lua_concat ( lua_State L, int n )

4.13.3.9LUA_API void() lua_copy ( lua_State L, int fromidx, int toidx )

4.13.3.10LUA_API void() lua_createtable ( lua_State L, int narr, int nrec )

4.13.3.11LUA_API int() lua_dump ( lua_State L, lua_Writer writer, void data, int strip )

4.13.3.12LUA_API int() lua_error ( lua_State L )

4.13.3.13LUA_API int() lua_gc ( lua_State L, int what, int data )

4.13.3.14LUA_API lua_Alloc() lua_getallocf ( lua_State L, void ud )

4.13.3.15LUA_API int() lua_getﬁeld ( lua_State L, int idx, const char k )

The Witchcraft Compiler Collection

4.13 wsh/include/lua.h File Reference

103

4.13.3.16LUA_API int() lua_getglobal ( lua_State L, const char name )

4.13.3.17LUA_API lua_Hook() lua_gethook ( lua_State L )

4.13.3.18LUA_API int() lua_gethookcount ( lua_State L )

4.13.3.19LUA_API int() lua_gethookmask ( lua_State L )

4.13.3.20LUA_API int() lua_geti ( lua_State L, int idx, lua_Integer n )

4.13.3.21LUA_API int() lua_getinfo ( lua_State L, const char what, lua_Debug ar )

4.13.3.22LUA_API const char() lua_getlocal ( lua_State L, const lua_Debug ar, int n )

4.13.3.23LUA_API int() lua_getmetatable ( lua_State L, int objindex )

4.13.3.24LUA_API int() lua_getstack ( lua_State L, int level, lua_Debug ar )

4.13.3.25LUA_API int() lua_gettable ( lua_State L, int idx )

4.13.3.26LUA_API int() lua_gettop ( lua_State L )

4.13.3.27LUA_API const char() lua_getupvalue ( lua_State L, int funcindex, int n )

4.13.3.28LUA_API int() lua_getuservalue ( lua_State L, int idx )

4.13.3.29LUA_API int() lua_iscfunction ( lua_State L, int idx )

4.13.3.30LUA_API int() lua_isinteger ( lua_State L, int idx )

4.13.3.31LUA_API int() lua_isnumber ( lua_State L, int idx )

4.13.3.32LUA_API int() lua_isstring ( lua_State L, int idx )

4.13.3.33LUA_API int() lua_isuserdata ( lua_State L, int idx )

4.13.3.34LUA_API int() lua_isyieldable ( lua_State L )

4.13.3.35LUA_API void() lua_len ( lua_State L, int idx )

4.13.3.36LUA_API int() lua_load ( lua_State L, lua_Reader reader, void dt, const char chunkname, const char mode )

4.13.3.37LUA_API lua_State() lua_newstate ( lua_Alloc f, void ud )

4.13.3.38LUA_API lua_State() lua_newthread ( lua_State L )

4.13.3.39LUA_API void() lua_newuserdata ( lua_State L, size_t sz )

4.13.3.40LUA_API int() lua_next ( lua_State L, int idx )

4.13.3.41LUA_API int() lua_pcallk ( lua_State L, int nargs, int nresults, int errfunc, lua_KContext ctx, lua_KFunction k )

4.13.3.42LUA_API void() lua_pushboolean ( lua_State L, int b )

The Witchcraft Compiler Collection

104	File Documentation

4.13.3.43LUA_API void() lua_pushcclosure ( lua_State L, lua_CFunction fn, int n )

4.13.3.44LUA_API const char() lua_pushfstring ( lua_State L, const char fmt, ... )

4.13.3.45LUA_API void() lua_pushinteger ( lua_State L, lua_Integer n )

4.13.3.46LUA_API void() lua_pushlightuserdata ( lua_State L, void p )

4.13.3.47LUA_API const char() lua_pushlstring ( lua_State L, const char s, size_t len )

4.13.3.48LUA_API void() lua_pushnil ( lua_State L )

4.13.3.49LUA_API void() lua_pushnumber ( lua_State L, lua_Number n )

4.13.3.50LUA_API const char() lua_pushstring ( lua_State L, const char s )

4.13.3.51LUA_API int() lua_pushthread ( lua_State L )

4.13.3.52LUA_API void() lua_pushvalue ( lua_State L, int idx )

4.13.3.53LUA_API const char() lua_pushvfstring ( lua_State L, const char fmt, va_list argp )

4.13.3.54LUA_API int() lua_rawequal ( lua_State L, int idx1, int idx2 )

4.13.3.55LUA_API int() lua_rawget ( lua_State L, int idx )

4.13.3.56LUA_API int() lua_rawgeti ( lua_State L, int idx, lua_Integer n )

4.13.3.57LUA_API int() lua_rawgetp ( lua_State L, int idx, const void p )

4.13.3.58LUA_API size_t() lua_rawlen ( lua_State L, int idx )

4.13.3.59LUA_API void() lua_rawset ( lua_State L, int idx )

4.13.3.60LUA_API void() lua_rawseti ( lua_State L, int idx, lua_Integer n )

4.13.3.61LUA_API void() lua_rawsetp ( lua_State L, int idx, const void p )

4.13.3.62LUA_API int() lua_resume ( lua_State L, lua_State from, int narg )

4.13.3.63LUA_API void() lua_rotate ( lua_State L, int idx, int n )

4.13.3.64LUA_API void() lua_setallocf ( lua_State L, lua_Alloc f, void ud )

4.13.3.65LUA_API void() lua_setﬁeld ( lua_State L, int idx, const char k )

4.13.3.66LUA_API void() lua_setglobal ( lua_State L, const char name )

4.13.3.67LUA_API void() lua_sethook ( lua_State L, lua_Hook func, int mask, int count )

4.13.3.68LUA_API void() lua_seti ( lua_State L, int idx, lua_Integer n )

4.13.3.69LUA_API const char() lua_setlocal ( lua_State L, const lua_Debug ar, int n )

4.13.3.70LUA_API int() lua_setmetatable ( lua_State L, int objindex )

The Witchcraft Compiler Collection

4.14 wsh/include/luaconf.h File Reference

105

4.13.3.71LUA_API void() lua_settable ( lua_State L, int idx )

4.13.3.72LUA_API void() lua_settop ( lua_State L, int idx )

4.13.3.73LUA_API const char() lua_setupvalue ( lua_State L, int funcindex, int n )

4.13.3.74LUA_API void() lua_setuservalue ( lua_State L, int idx )

4.13.3.75LUA_API int() lua_status ( lua_State L )

4.13.3.76LUA_API size_t() lua_stringtonumber ( lua_State L, const char s )

4.13.3.77LUA_API int() lua_toboolean ( lua_State L, int idx )

4.13.3.78LUA_API lua_CFunction() lua_tocfunction ( lua_State L, int idx )

4.13.3.79LUA_API lua_Integer() lua_tointegerx ( lua_State L, int idx, int isnum )

4.13.3.80LUA_API const char() lua_tolstring ( lua_State L, int idx, size_t len )

4.13.3.81LUA_API lua_Number() lua_tonumberx ( lua_State L, int idx, int isnum )

4.13.3.82LUA_API const void() lua_topointer ( lua_State L, int idx )

4.13.3.83LUA_API lua_State() lua_tothread ( lua_State L, int idx )

4.13.3.84LUA_API void() lua_touserdata ( lua_State L, int idx )

4.13.3.85LUA_API int() lua_type ( lua_State L, int idx )

4.13.3.86LUA_API const char() lua_typename ( lua_State L, int tp )

4.13.3.87LUA_API void() lua_upvalueid ( lua_State L, int ﬁdx, int n )

4.13.3.88LUA_API void() lua_upvaluejoin ( lua_State L, int ﬁdx1, int n1, int ﬁdx2, int n2 )

4.13.3.89LUA_API const lua_Number() lua_version ( lua_State L )

4.13.3.90LUA_API void() lua_xmove ( lua_State from, lua_State to, int n )

4.13.3.91LUA_API int() lua_yieldk ( lua_State L, int nresults, lua_KContext ctx, lua_KFunction k )

4.13.4Variable Documentation

4.13.4.1const char lua_ident[ ]

4.14 wsh/include/luaconf.h File Reference

#include <limits.h> #include <stddef.h>

Macros

• #deﬁne LUAI_BITSINT 16

The Witchcraft Compiler Collection

106	File Documentation

•#deﬁne LUA_INT_INT 1

•#deﬁne LUA_INT_LONG 2

•#deﬁne LUA_INT_LONGLONG 3

•#deﬁne LUA_FLOAT_FLOAT 1

•#deﬁne LUA_FLOAT_DOUBLE 2

•#deﬁne LUA_FLOAT_LONGDOUBLE 3

•#deﬁne LUA_INT_TYPE LUA_INT_LONGLONG

•#deﬁne LUA_FLOAT_TYPE LUA_FLOAT_DOUBLE

•#deﬁne LUA_VDIR LUA_VERSION_MAJOR "." LUA_VERSION_MINOR

•#deﬁne LUA_ROOT "/usr/local/"

•#deﬁne LUA_LDIR LUA_ROOT "share/lua/" LUA_VDIR "/"

•#deﬁne LUA_CDIR LUA_ROOT "lib/lua/" LUA_VDIR "/"

•#deﬁne LUA_PATH_DEFAULT

•#deﬁne LUA_CPATH_DEFAULT LUA_CDIR"?.so;" LUA_CDIR"loadall.so;" "./?.so"

•#deﬁne LUA_DIRSEP "/"

•#deﬁne LUA_API extern

•#deﬁne LUALIB_API LUA_API

•#deﬁne LUAMOD_API LUALIB_API

•#deﬁne LUAI_FUNC extern

•#deﬁne LUAI_DDEC LUAI_FUNC

•#deﬁne LUAI_DDEF / empty /

•#deﬁne l_ﬂoor(x) (l_mathop(ﬂoor)(x))

•#deﬁne lua_number2str(s, sz, n) l_sprintf((s), sz, LUA_NUMBER_FMT, (n))

•#deﬁne lua_numbertointeger(n, p)

•#deﬁne LUA_NUMBER double

•#deﬁne l_mathlim(n) (DBL_##n)

•#deﬁne LUAI_UACNUMBER double

•#deﬁne LUA_NUMBER_FRMLEN ""

•#deﬁne LUA_NUMBER_FMT "%.14g"

•#deﬁne l_mathop(op) op

•#deﬁne lua_str2number(s, p) strtod((s), (p))

•#deﬁne LUA_INTEGER_FMT "%" LUA_INTEGER_FRMLEN "d"

•#deﬁne lua_integer2str(s, sz, n) l_sprintf((s), sz, LUA_INTEGER_FMT, (n))

•#deﬁne LUAI_UACINT LUA_INTEGER

•#deﬁne LUA_UNSIGNED unsigned LUAI_UACINT

•#deﬁne l_sprintf(s, sz, f, i) snprintf(s,sz,f,i)

•#deﬁne lua_strx2number(s, p) lua_str2number(s,p)

•#deﬁne lua_number2strx(L, b, sz, f, n) l_sprintf(b,sz,f,n)

•#deﬁne LUA_KCONTEXT ptrdiff_t

•#deﬁne lua_getlocaledecpoint() (localeconv()->decimal_point[0])

•#deﬁne LUAI_MAXSTACK 15000

•#deﬁne LUA_EXTRASPACE (sizeof(void ))

•#deﬁne LUA_IDSIZE 60

•#deﬁne LUAL_BUFFERSIZE 8192

•#deﬁne LUA_QL(x) "’" x "’"

•#deﬁne LUA_QS LUA_QL("%s")

4.14.1Macro Deﬁnition Documentation

4.14.1.1#deﬁne l_ﬂoor( x ) (l_mathop(ﬂoor)(x))

Deﬁnition at line 422 of ﬁle luaconf.h.

The Witchcraft Compiler Collection

4.14 wsh/include/luaconf.h File Reference

107

4.14.1.2#deﬁne l_mathlim( n ) (DBL_##n)

Deﬁnition at line 477 of ﬁle luaconf.h.

4.14.1.3#deﬁne l_mathop( op ) op

Deﬁnition at line 484 of ﬁle luaconf.h.

4.14.1.4#deﬁne l_sprintf( s, sz, f, i ) snprintf(s,sz,f,i)

Deﬁnition at line 591 of ﬁle luaconf.h.

4.14.1.5#deﬁne LUA_API extern

Deﬁnition at line 242 of ﬁle luaconf.h.

4.14.1.6#deﬁne LUA_CDIR LUA_ROOT "lib/lua/" LUA_VDIR "/"

Deﬁnition at line 193 of ﬁle luaconf.h.

4.14.1.7#deﬁne LUA_CPATH_DEFAULT LUA_CDIR"?.so;" LUA_CDIR"loadall.so;" "./?.so"

Deﬁnition at line 198 of ﬁle luaconf.h.

4.14.1.8#deﬁne LUA_DIRSEP "/"

Deﬁnition at line 211 of ﬁle luaconf.h.

4.14.1.9#deﬁne LUA_EXTRASPACE (sizeof(void ))

Deﬁnition at line 717 of ﬁle luaconf.h.

4.14.1.10#deﬁne LUA_FLOAT_DOUBLE 2

Deﬁnition at line 115 of ﬁle luaconf.h.

4.14.1.11#deﬁne LUA_FLOAT_FLOAT 1

Deﬁnition at line 114 of ﬁle luaconf.h.

4.14.1.12#deﬁne LUA_FLOAT_LONGDOUBLE 3

Deﬁnition at line 116 of ﬁle luaconf.h.

4.14.1.13#deﬁne LUA_FLOAT_TYPE LUA_FLOAT_DOUBLE

Deﬁnition at line 147 of ﬁle luaconf.h.

The Witchcraft Compiler Collection

108	File Documentation

4.14.1.14#deﬁne lua_getlocaledecpoint( ) (localeconv()->decimal_point[0])

Deﬁnition at line 657 of ﬁle luaconf.h.

4.14.1.15#deﬁne LUA_IDSIZE 60

Deﬁnition at line 725 of ﬁle luaconf.h.

4.14.1.16#deﬁne LUA_INT_INT 1

Deﬁnition at line 109 of ﬁle luaconf.h.

4.14.1.17#deﬁne LUA_INT_LONG 2

Deﬁnition at line 110 of ﬁle luaconf.h.

4.14.1.18#deﬁne LUA_INT_LONGLONG 3

Deﬁnition at line 111 of ﬁle luaconf.h.

4.14.1.19#deﬁne LUA_INT_TYPE LUA_INT_LONGLONG

Deﬁnition at line 143 of ﬁle luaconf.h.

4.14.1.20#deﬁne lua_integer2str( s, sz, n ) l_sprintf((s), sz, LUA_INTEGER_FMT, (n))

Deﬁnition at line 514 of ﬁle luaconf.h.

4.14.1.21#deﬁne LUA_INTEGER_FMT "%" LUA_INTEGER_FRMLEN "d"

Deﬁnition at line 513 of ﬁle luaconf.h.

4.14.1.22#deﬁne LUA_KCONTEXT ptrdiff_t

Deﬁnition at line 639 of ﬁle luaconf.h.

4.14.1.23#deﬁne LUA_LDIR LUA_ROOT "share/lua/" LUA_VDIR "/"

Deﬁnition at line 192 of ﬁle luaconf.h.

4.14.1.24#deﬁne LUA_NUMBER double

Deﬁnition at line 475 of ﬁle luaconf.h.

4.14.1.25#deﬁne lua_number2str( s, sz, n ) l_sprintf((s), sz, LUA_NUMBER_FMT, (n))

Deﬁnition at line 424 of ﬁle luaconf.h.

The Witchcraft Compiler Collection

4.14 wsh/include/luaconf.h File Reference

109

4.14.1.26#deﬁne lua_number2strx( L, b, sz, f, n ) l_sprintf(b,sz,f,n)

Deﬁnition at line 615 of ﬁle luaconf.h.

4.14.1.27#deﬁne LUA_NUMBER_FMT "%.14g"

Deﬁnition at line 482 of ﬁle luaconf.h.

4.14.1.28#deﬁne LUA_NUMBER_FRMLEN ""

Deﬁnition at line 481 of ﬁle luaconf.h.

4.14.1.29#deﬁne lua_numbertointeger( n, p )

Value:

((n) >= (LUA_NUMBER)(LUA_MININTEGER) && n

(n)< -(LUA_NUMBER)(LUA_MININTEGER) && n (*(p) = (LUA_INTEGER)(n), 1))

Deﬁnition at line 434 of ﬁle luaconf.h.

4.14.1.30#deﬁne LUA_PATH_DEFAULT

Value:

LUA_LDIR"?.lua;" LUA_LDIR"?/init.lua;" n LUA_CDIR"?.lua;" LUA_CDIR"?/init.lua;" n "./?.lua;" "./?/init.lua"

Deﬁnition at line 194 of ﬁle luaconf.h.

4.14.1.31#deﬁne LUA_QL( x ) "’" x "’"

Deﬁnition at line 749 of ﬁle luaconf.h.

4.14.1.32#deﬁne LUA_QS LUA_QL("%s")

Deﬁnition at line 750 of ﬁle luaconf.h.

4.14.1.33#deﬁne LUA_ROOT "/usr/local/"

Deﬁnition at line 191 of ﬁle luaconf.h.

4.14.1.34#deﬁne lua_str2number( s, p ) strtod((s), (p))

Deﬁnition at line 486 of ﬁle luaconf.h.

4.14.1.35#deﬁne lua_strx2number( s, p ) lua_str2number(s,p)

Deﬁnition at line 604 of ﬁle luaconf.h.

The Witchcraft Compiler Collection

110	File Documentation

4.14.1.36#deﬁne LUA_UNSIGNED unsigned LUAI_UACINT

Deﬁnition at line 522 of ﬁle luaconf.h.

4.14.1.37#deﬁne LUA_VDIR LUA_VERSION_MAJOR "." LUA_VERSION_MINOR

Deﬁnition at line 170 of ﬁle luaconf.h.

4.14.1.38#deﬁne LUAI_BITSINT 16

Deﬁnition at line 94 of ﬁle luaconf.h.

4.14.1.39#deﬁne LUAI_DDEC LUAI_FUNC

Deﬁnition at line 273 of ﬁle luaconf.h.

4.14.1.40#deﬁne LUAI_DDEF / empty /

Deﬁnition at line 274 of ﬁle luaconf.h.

4.14.1.41#deﬁne LUAI_FUNC extern

Deﬁnition at line 270 of ﬁle luaconf.h.

4.14.1.42#deﬁne LUAI_MAXSTACK 15000

Deﬁnition at line 708 of ﬁle luaconf.h.

4.14.1.43#deﬁne LUAI_UACINT LUA_INTEGER

Deﬁnition at line 516 of ﬁle luaconf.h.

4.14.1.44#deﬁne LUAI_UACNUMBER double

Deﬁnition at line 479 of ﬁle luaconf.h.

4.14.1.45#deﬁne LUAL_BUFFERSIZE 8192

Deﬁnition at line 736 of ﬁle luaconf.h.

4.14.1.46#deﬁne LUALIB_API LUA_API

Deﬁnition at line 248 of ﬁle luaconf.h.

4.14.1.47#deﬁne LUAMOD_API LUALIB_API

Deﬁnition at line 249 of ﬁle luaconf.h.

The Witchcraft Compiler Collection

4.15 wsh/include/lualib.h File Reference

111

4.15 wsh/include/lualib.h File Reference

#include "lua.h"

Macros

•#deﬁne LUA_COLIBNAME "coroutine"

•#deﬁne LUA_TABLIBNAME "table"

•#deﬁne LUA_IOLIBNAME "io"

•#deﬁne LUA_OSLIBNAME "os"

•#deﬁne LUA_STRLIBNAME "string"

•#deﬁne LUA_UTF8LIBNAME "utf8"

•#deﬁne LUA_BITLIBNAME "bit32"

•#deﬁne LUA_MATHLIBNAME "math"

•#deﬁne LUA_DBLIBNAME "debug"

•#deﬁne LUA_LOADLIBNAME "package"

•#deﬁne lua_assert(x) ((void)0)

Functions

•LUAMOD_API int() luaopen_base (lua_State L)

•LUAMOD_API int() luaopen_coroutine (lua_State L)

•LUAMOD_API int() luaopen_table (lua_State L)

•LUAMOD_API int() luaopen_io (lua_State L)

•LUAMOD_API int() luaopen_os (lua_State L)

•LUAMOD_API int() luaopen_string (lua_State L)

•LUAMOD_API int() luaopen_utf8 (lua_State L)

•LUAMOD_API int() luaopen_bit32 (lua_State L)

•LUAMOD_API int() luaopen_math (lua_State L)

•LUAMOD_API int() luaopen_debug (lua_State L)

•LUAMOD_API int() luaopen_package (lua_State L)

•LUALIB_API void() luaL_openlibs (lua_State L)

4.15.1Macro Deﬁnition Documentation

4.15.1.1#deﬁne lua_assert( x ) ((void)0)

Deﬁnition at line 54 of ﬁle lualib.h.

4.15.1.2#deﬁne LUA_BITLIBNAME "bit32"

Deﬁnition at line 35 of ﬁle lualib.h.

4.15.1.3#deﬁne LUA_COLIBNAME "coroutine"

Deﬁnition at line 17 of ﬁle lualib.h.

4.15.1.4#deﬁne LUA_DBLIBNAME "debug"

Deﬁnition at line 41 of ﬁle lualib.h.

The Witchcraft Compiler Collection

112	File Documentation

4.15.1.5#deﬁne LUA_IOLIBNAME "io"

Deﬁnition at line 23 of ﬁle lualib.h.

4.15.1.6#deﬁne LUA_LOADLIBNAME "package"

Deﬁnition at line 44 of ﬁle lualib.h.

4.15.1.7#deﬁne LUA_MATHLIBNAME "math"

Deﬁnition at line 38 of ﬁle lualib.h.

4.15.1.8#deﬁne LUA_OSLIBNAME "os"

Deﬁnition at line 26 of ﬁle lualib.h.

4.15.1.9#deﬁne LUA_STRLIBNAME "string"

Deﬁnition at line 29 of ﬁle lualib.h.

4.15.1.10#deﬁne LUA_TABLIBNAME "table"

Deﬁnition at line 20 of ﬁle lualib.h.

4.15.1.11#deﬁne LUA_UTF8LIBNAME "utf8"

Deﬁnition at line 32 of ﬁle lualib.h.

4.15.2Function Documentation

4.15.2.1LUALIB_API void() luaL_openlibs ( lua_State L )

4.15.2.2LUAMOD_API int() luaopen_base ( lua_State L )

4.15.2.3LUAMOD_API int() luaopen_bit32 ( lua_State L )

4.15.2.4LUAMOD_API int() luaopen_coroutine ( lua_State L )

4.15.2.5LUAMOD_API int() luaopen_debug ( lua_State L )

4.15.2.6LUAMOD_API int() luaopen_io ( lua_State L )

4.15.2.7LUAMOD_API int() luaopen_math ( lua_State L )

4.15.2.8LUAMOD_API int() luaopen_os ( lua_State L )

4.15.2.9LUAMOD_API int() luaopen_package ( lua_State L )

4.15.2.10LUAMOD_API int() luaopen_string ( lua_State L )

4.15.2.11LUAMOD_API int() luaopen_table ( lua_State L )

The Witchcraft Compiler Collection

4.16 wsh/wsh.c File Reference

113

4.15.2.12LUAMOD_API int() luaopen_utf8 ( lua_State L )

4.16 wsh/wsh.c File Reference

#include <libwitch/wsh.h>

#include <libwitch/wsh_functions.h> #include <libwitch/sigs.h> #include <uthash.h>

Data Structures

•struct help_t

•struct learn_key_t

•struct learn_t

Macros

•#deﬁne REG_RIP 16

•#deﬁne Elf_Ehdr Elf32_Ehdr

•#deﬁne Elf_Shdr Elf32_Shdr

•#deﬁne Elf_Sym Elf32_Sym

•#deﬁne Elf_Addr Elf32_Addr

•#deﬁne Elf_Sword Elf64_Sword

•#deﬁne Elf_Section Elf32_Half

•#deﬁne ELF_ST_BIND ELF32_ST_BIND

•#deﬁne ELF_ST_TYPE ELF32_ST_TYPE

•#deﬁne Elf_Rel Elf32_Rel

•#deﬁne Elf_Rela Elf32_Rela

•#deﬁne ELF_R_SYM ELF32_R_SYM

•#deﬁne ELF_R_TYPE ELF32_R_TYPE

•#deﬁne ELF_R_INFO ELF32_R_INFO

•#deﬁne Elf_Phdr Elf32_Phdr

•#deﬁne Elf_Xword Elf32_Xword

•#deﬁne Elf_Word Elf32_Word

•#deﬁne Elf_Off Elf32_Off

•#deﬁne ELFCLASS ELFCLASS32

•#deﬁne ELFMACHINE EM_386

•#deﬁne CS_MODE CS_MODE_32

•#deﬁne RELOC_MODE RELOC_X86_32

Typedefs

•typedef struct help_t help_t

•typedef struct learn_key_t learn_key_t

•typedef struct learn_t learn_t

The Witchcraft Compiler Collection

114	File Documentation

Functions

•int bfmap (lua_State L)

•int ptoh (int perms, char hperms[ ])

•void info_function (void addr)

•void fatal_error (lua_State L, char msg)

•void script (char path)

•void hexdump (uint8_t data, size_t size, size_t colorstart, size_t color_len)

•char symbol_tobind (int n)

•char symbol_totype (int n)

•unsigned int ltrace (void)

•int scan_symbol (char symbol, char libname)

•void completion (const char buf, linenoiseCompletions lc)

•int disable_aslr (void)

•int enable_aslr (void)

•int detailed_help (char name)

•int help (lua_State L)

•char decode_ﬂags (unsigned int ﬂags)

•char decode_type (unsigned int type)

•int phdr_callback (struct dl_phdr_info info, size_t size, void data)

•int add_symbol (char symbol, char libname, char htype, char hbind, unsigned long value, unsigned int size, unsigned long int addr)

•void section_add (unsigned long int addr, unsigned long int size, char libname, char name, char perms, int ﬂags)

•void segment_add (unsigned long int addr, unsigned long int size, char perms, char fname, char ptype, int ﬂags)

•void entry_point_add (unsigned long int addr, char fname)

•void scan_section (Elf_Shdr shdr, char strTab, int shnum, char fname, unsigned long int baseaddr)

•int scan_sections (char fname, unsigned long int baseaddr)

•int shdr_callback (struct dl_phdr_info info, size_t size, void data)

•int phdrs (lua_State L)

•sections_t section_from_addr (unsigned long int addr)

•segments_t segment_from_addr (unsigned long int addr)

•sections_t symbol_from_addr (unsigned long int addr)

•sections_t symbol_from_name (char fname)

•int headers (lua_State L)

•int empty_symbols (void)

•int empty_phdrs (void)

•int empty_shdrs (void)

•int empty_eps (void)

•int print_phdrs (void)

•int print_symbols (lua_State L)

•int print_functions (lua_State L)

•int print_objects (lua_State L)

•int print_libs (lua_State L)

•int print_shdrs (void)

•int print_eps (void)

•int shdr_cmp (sections_t a, sections_t b)

•int phdr_cmp (segments_t a, segments_t b)

•int reload_elfs (void)

•int shdrs (lua_State L)

•int entrypoints (lua_State L)

•int man (lua_State L)

•int info (lua_State L)

•int alloccharbuf (lua_State L)

The Witchcraft Compiler Collection

4.16 wsh/wsh.c File Reference

115

•int setcharbuf (lua_State L)

•int rdstr (lua_State L)

•int rdnum (lua_State L)

•int getcharbuf (lua_State L)

•int run_shell (lua_State L)

•int learn_proto (unsigned long arg, unsigned long int faultaddr, int reason)

•int sort_learnt (learn_t a, learn_t b)

•int prototypes (lua_State L)

•int libcall (lua_State L)

•void scan_syms (char dynstr, Elf_Sym sym, unsigned long int sz, char libname)

•void parse_dyn (struct link_map map)

•void parse_link_map_dyn (struct link_map map)

•void rescan (void)

•int print_procmap (unsigned int pid)

•int procmap_lua (void)

•int execlib (lua_State L)

•int traceback (lua_State L)

•void print_backtrace (void)

•char sicodetoname (int code)

•char signaltoname (int signal)

•void unset_align_ﬂag (void)

•void set_align_ﬂag (void)

•void unset_trace_ﬂag (void)

•void set_trace_ﬂag (void)

•void afﬁnity (int procnum)

•void btr_enable (int procnum)

•void btr_disable (int procnum)

•void set_branch_ﬂag (void)

•void unset_branch_ﬂag (void)

•void bushandler (int signal, siginfo_t s, void ptr)

•void alarmhandler (int signal, siginfo_t s, void u)

•void inthandler (int signal, siginfo_t s, void u)

•int mk_backtrace (void)

•void restore_exit (void)

•void exit (int status)

•void _exit (int status)

•void exit_group (int status)

•int printarg (unsigned long int val)

•void traphandler (int signal, siginfo_t s, void ptr)

•char sicode_strerror (int signal, siginfo_t s)

•void sighandler (int signal, siginfo_t s, void ptr)

•int set_sighandlers (void)

•int test_stdin (void)

•int verbose (lua_State L)

•int hollywood (lua_State L)

•int map (lua_State L)

•int bsspolute (lua_State L)

•int ralloc (lua_State L)

•int xalloc (lua_State L)

•void xfree (lua_State L)

•void traceunaligned (lua_State L)

•void untraceunaligned (lua_State L)

•void singlestep (lua_State L)

•void unsinglestep (lua_State L)

•void systrace (lua_State L)

The Witchcraft Compiler Collection

116	File Documentation

•void rtrace (lua_State L)

•void unsystrace (lua_State L)

•void unrtrace (lua_State L)

•void verbosetrace (lua_State L)

•void unverbosetrace (lua_State L)

•void singlebranch (lua_State L)

•void unsinglebranch (lua_State L)

•int grepptr (lua_State L)

•int loadbin (lua_State L)

•int grep (lua_State L)

•int priv_memcpy (lua_State L)

•int priv_strcpy (lua_State L)

•int priv_strcat (lua_State L)

•int breakpoint (lua_State L)

•void declare_func (void addr, char name)

•void declare_num (int val, char name)

•void declare_internals (void)

•struct link_map loadlibrary (char libname)

•int set_alloc_opt (void)

•int gencore (lua_State L)

•int disable_core (lua_State L)

•int enable_core (lua_State L)

•int wsh_init (void)

•int lua_strerror (int err)

•int run_script (char name)

•unsigned int read_elf_sig (char fname, struct stat sb)

•int wsh_run (void)

•int add_script_arguments (int argc, char argv, unsigned int i)

•int add_script_exec (char name)

•int add_binary_preload (char name)

•int do_loadlib (char libname)

•int wsh_loadlibs (void)

•int wsh_getopt (wsh_t wsh1, int argc, char argv)

•int wsh_print_version (void)

•int wsh_usage (char name)

•int rawmemread (lua_State L)

•int rawmemwrite (lua_State L)

•int rawmemstr (lua_State L)

•int rawmemusage (lua_State L)

•int rawmemaddr (lua_State L)

•int rawmemstrlen (lua_State L)

Variables

•wsh_t wsh

•help_t cmdhelp [ ]

•help_t fcnhelp [ ]

•learn_t protorecords = NULL

4.16.1Macro Deﬁnition Documentation

4.16.1.1#deﬁne CS_MODE CS_MODE_32

Deﬁnition at line 88 of ﬁle wsh.c.

The Witchcraft Compiler Collection

4.16 wsh/wsh.c File Reference

117

4.16.1.2#deﬁne Elf_Addr Elf32_Addr

Deﬁnition at line 72 of ﬁle wsh.c.

4.16.1.3#deﬁne Elf_Ehdr Elf32_Ehdr

Deﬁnition at line 69 of ﬁle wsh.c.

4.16.1.4#deﬁne Elf_Off Elf32_Off

Deﬁnition at line 85 of ﬁle wsh.c.

4.16.1.5#deﬁne Elf_Phdr Elf32_Phdr

Deﬁnition at line 82 of ﬁle wsh.c.

4.16.1.6#deﬁne ELF_R_INFO ELF32_R_INFO

Deﬁnition at line 81 of ﬁle wsh.c.

4.16.1.7#deﬁne ELF_R_SYM ELF32_R_SYM

Deﬁnition at line 79 of ﬁle wsh.c.

4.16.1.8#deﬁne ELF_R_TYPE ELF32_R_TYPE

Deﬁnition at line 80 of ﬁle wsh.c.

4.16.1.9#deﬁne Elf_Rel Elf32_Rel

Deﬁnition at line 77 of ﬁle wsh.c.

4.16.1.10#deﬁne Elf_Rela Elf32_Rela

Deﬁnition at line 78 of ﬁle wsh.c.

4.16.1.11#deﬁne Elf_Section Elf32_Half

Deﬁnition at line 74 of ﬁle wsh.c.

4.16.1.12#deﬁne Elf_Shdr Elf32_Shdr

Deﬁnition at line 70 of ﬁle wsh.c.

4.16.1.13#deﬁne ELF_ST_BIND ELF32_ST_BIND

Deﬁnition at line 75 of ﬁle wsh.c.

The Witchcraft Compiler Collection

118	File Documentation

4.16.1.14#deﬁne ELF_ST_TYPE ELF32_ST_TYPE

Deﬁnition at line 76 of ﬁle wsh.c.

4.16.1.15#deﬁne Elf_Sword Elf64_Sword

Deﬁnition at line 73 of ﬁle wsh.c.

4.16.1.16#deﬁne Elf_Sym Elf32_Sym

Deﬁnition at line 71 of ﬁle wsh.c.

4.16.1.17#deﬁne Elf_Word Elf32_Word

Deﬁnition at line 84 of ﬁle wsh.c.

4.16.1.18#deﬁne Elf_Xword Elf32_Xword

Deﬁnition at line 83 of ﬁle wsh.c.

4.16.1.19#deﬁne ELFCLASS ELFCLASS32

Deﬁnition at line 86 of ﬁle wsh.c.

4.16.1.20#deﬁne ELFMACHINE EM_386

Deﬁnition at line 87 of ﬁle wsh.c.

4.16.1.21#deﬁne REG_RIP 16

Witchcraft Compiler Collection

Author: Jonathan Brossard - [email protected]

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

Deﬁnition at line 38 of ﬁle wsh.c.

The Witchcraft Compiler Collection

4.16 wsh/wsh.c File Reference

119

4.16.1.22#deﬁne RELOC_MODE RELOC_X86_32

Deﬁnition at line 89 of ﬁle wsh.c.

4.16.2Typedef Documentation

4.16.2.1typedef struct help_t help_t

4.16.2.2typedef struct learn_key_t learn_key_t

4.16.2.3typedef struct learn_t learn_t

4.16.3Function Documentation

4.16.3.1void _exit ( int status )

Deﬁnition at line 3143 of ﬁle wsh.c.

4.16.3.2int add_binary_preload ( char name )

Add a binary to the list of binaries to preload

Deﬁnition at line 4566 of ﬁle wsh.c.

4.16.3.3int add_script_arguments ( int argc, char argv, unsigned int i )

Deﬁnition at line 4530 of ﬁle wsh.c.

4.16.3.4int add_script_exec ( char name )

Add a script to the execution queue

Deﬁnition at line 4552 of ﬁle wsh.c.

4.16.3.5int add_symbol ( char symbol, char libname, char htype, char hbind, unsigned long value, unsigned int size, unsigned long int addr )

Add a symbol to linked list

Deﬁnition at line 719 of ﬁle wsh.c.

4.16.3.6void afﬁnity ( int procnum )

Set afﬁnity of a thread to a given CPU

Deﬁnition at line 2947 of ﬁle wsh.c.

4.16.3.7void alarmhandler ( int signal, siginfo_t s, void u )

Deﬁnition at line 3083 of ﬁle wsh.c.

The Witchcraft Compiler Collection

120	File Documentation

4.16.3.8int alloccharbuf ( lua_State L )

Buffer management subroutines

Deﬁnition at line 1590 of ﬁle wsh.c.

4.16.3.9int bfmap ( lua_State L )

Bruteforce valid memory mapping ranges

Deﬁnition at line 100 of ﬁle wsh.c.

4.16.3.10int breakpoint ( lua_State L )

Set a breakpoint Make sure destination address is mapped

Change memory protections to RWX on destionation’s page

Backup byte at destination

Write Breakpoint

Save breakpoint informations

Deﬁnition at line 4218 of ﬁle wsh.c.

4.16.3.11int bsspolute ( lua_State L )

Pollute .bss sections

Deﬁnition at line 3712 of ﬁle wsh.c.

4.16.3.12void btr_disable ( int procnum )

Disable Branch Tracing

Deﬁnition at line 2981 of ﬁle wsh.c.

4.16.3.13void btr_enable ( int procnum )

Enable Branch Tracing

Deﬁnition at line 2961 of ﬁle wsh.c.

4.16.3.14void bushandler ( int signal, siginfo_t s, void ptr )

SIGBUS handler

Deﬁnition at line 3031 of ﬁle wsh.c.

4.16.3.15void completion ( const char buf, linenoiseCompletions lc )

Shell autocompletion routine We want to add the next word uppon ’tab’ completion, exposing all the internally available keywords dynamically

Deﬁnition at line 377 of ﬁle wsh.c.

The Witchcraft Compiler Collection

4.16 wsh/wsh.c File Reference

121

4.16.3.16void declare_func ( void addr, char name )

Deﬁnition at line 4269 of ﬁle wsh.c.

4.16.3.17void declare_internals ( void )

Export functions to lua Create deﬁnitions for internal functions

Create a wrapper functions for other internal functions

Deﬁnition at line 4282 of ﬁle wsh.c.

4.16.3.18void declare_num ( int val, char name )

Deﬁnition at line 4274 of ﬁle wsh.c.

4.16.3.19char decode_ﬂags ( unsigned int ﬂags )

Decode Segment ﬂags

Deﬁnition at line 602 of ﬁle wsh.c.

4.16.3.20char decode_type ( unsigned int type )

Decode Segment type

Deﬁnition at line 631 of ﬁle wsh.c.

4.16.3.21int detailed_help ( char name )

Display detailed help Search command

Search function

Deﬁnition at line 541 of ﬁle wsh.c.

4.16.3.22int disable_aslr ( void )

Disable ASLR

Deﬁnition at line 455 of ﬁle wsh.c.

4.16.3.23int disable_core ( lua_State L )

Disable core ﬁles generation

Deﬁnition at line 4351 of ﬁle wsh.c.

4.16.3.24int do_loadlib ( char libname )

Do load a shared binary into the address space

Deﬁnition at line 4581 of ﬁle wsh.c.

The Witchcraft Compiler Collection

122	File Documentation

4.16.3.25int empty_eps ( void )

Empty linked list of entry points

Deﬁnition at line 1036 of ﬁle wsh.c.

4.16.3.26int empty_phdrs ( void )

Empty linked list of segments

Deﬁnition at line 999 of ﬁle wsh.c.

4.16.3.27int empty_shdrs ( void )

Empty linked list of sections

Deﬁnition at line 1018 of ﬁle wsh.c.

4.16.3.28int empty_symbols ( void )

Empty linked list of symbols

Deﬁnition at line 980 of ﬁle wsh.c.

4.16.3.29int enable_aslr ( void )

Enable ASLR

Deﬁnition at line 473 of ﬁle wsh.c.

4.16.3.30int enable_core ( lua_State L )

Enable core ﬁles generation

Deﬁnition at line 4359 of ﬁle wsh.c.

4.16.3.31void entry_point_add ( unsigned long int addr, char fname )

Add an entry point to linked list

Deﬁnition at line 789 of ﬁle wsh.c.

4.16.3.32int entrypoints ( lua_State L )

Display ELF Entry points

Deﬁnition at line 1469 of ﬁle wsh.c.

4.16.3.33int execlib ( lua_State L )

Deﬁnition at line 2792 of ﬁle wsh.c.

4.16.3.34void exit ( int status )

Deﬁnition at line 3137 of ﬁle wsh.c.

The Witchcraft Compiler Collection

4.16 wsh/wsh.c File Reference

123

4.16.3.35void exit_group ( int status )

Deﬁnition at line 3149 of ﬁle wsh.c.

4.16.3.36void fatal_error ( lua_State L, char msg )

Fatal error : print an error message and exit with error

Deﬁnition at line 157 of ﬁle wsh.c.

4.16.3.37int gencore ( lua_State L )

Generate a core ﬁle

Deﬁnition at line 4340 of ﬁle wsh.c.

4.16.3.38int getcharbuf ( lua_State L )

Deﬁnition at line 1657 of ﬁle wsh.c.

4.16.3.39int grep ( lua_State L )

search a pattern over all sections mapped in memory Deﬁnition at line 4069 of ﬁle wsh.c.

4.16.3.40int grepptr ( lua_State L )

Search a given value in memory

grepptr(Pattern, patternlen, hexadumplen, nbytesbeforematch) Deﬁnition at line 3979 of ﬁle wsh.c.

4.16.3.41int headers ( lua_State L )

Generate headers generate headers for imported objects generate forward prototypes for imported functions Deﬁnition at line 931 of ﬁle wsh.c.

4.16.3.42int help ( lua_State L )

Display help

Deﬁnition at line 574 of ﬁle wsh.c.

4.16.3.43void hexdump ( uint8_t data, size_t size, size_t colorstart, size_t color_len )

Simple hexdump routine

Deﬁnition at line 184 of ﬁle wsh.c.

The Witchcraft Compiler Collection

124	File Documentation

4.16.3.44int hollywood ( lua_State L )

Deﬁnition at line 3632 of ﬁle wsh.c.

4.16.3.45int info ( lua_State L )

Display information on an object/memory address Address is mapped

Search corresponding symbols

Search corresponding section

Search corresponding segment

Search corresponding symbols

Resolve symbol...

Deﬁnition at line 1495 of ﬁle wsh.c.

4.16.3.46void info_function ( void addr )

Print information on a given function

Deﬁnition at line 147 of ﬁle wsh.c.

4.16.3.47void inthandler ( int signal, siginfo_t s, void u )

Deﬁnition at line 3094 of ﬁle wsh.c.

4.16.3.48int learn_proto ( unsigned long arg, unsigned long int faultaddr, int reason )

Deﬁnition at line 1801 of ﬁle wsh.c.

4.16.3.49int libcall ( lua_State L )

Make the library call

Analyse return value

Learn prototypes

Create output execution context table

Push errno to lua table

Push strerror(errno) to lua table

Push ﬁrst signal

Push ﬁrst signal name

Push total of signals emmited during this libcall

Push ﬁrst errno

Push ﬁrst sicode

Push ﬁrst sicode name

Address of last caller in backtrace

The Witchcraft Compiler Collection

4.16 wsh/wsh.c File Reference

125

Push fault address

Push reason

Push mode

Push errctx

Push pointer to ucontext

Push arguments as a new table

Push number of non NULL arguments

Push retval

Push libcall/libname

Invoke store running function on context

Deﬁnition at line 2087 of ﬁle wsh.c.

4.16.3.50int loadbin ( lua_State L )

Load a binary into the address space

Deﬁnition at line 4054 of ﬁle wsh.c.

4.16.3.51struct link_map loadlibrary ( char libname )

Deﬁnition at line 4311 of ﬁle wsh.c.

4.16.3.52unsigned int ltrace ( void )

Deﬁnition at line 328 of ﬁle wsh.c.

4.16.3.53int lua_strerror ( int err )

Deﬁnition at line 4395 of ﬁle wsh.c.

4.16.3.54int man ( lua_State L )

Open a manual page

Deﬁnition at line 1478 of ﬁle wsh.c.

4.16.3.55int map ( lua_State L )

Display mapped sections

Deﬁnition at line 3658 of ﬁle wsh.c.

4.16.3.56int mk_backtrace ( void )

Deﬁnition at line 3110 of ﬁle wsh.c.

4.16.3.57void parse_dyn ( struct link_map map )

Walk the array of ELF_Dyn once looking for critical sections

The Witchcraft Compiler Collection

126	File Documentation

Deﬁnition at line 2625 of ﬁle wsh.c.

4.16.3.58void parse_link_map_dyn ( struct link_map map )

Deﬁnition at line 2724 of ﬁle wsh.c.

4.16.3.59int phdr_callback ( struct dl_phdr_info info, size_t size, void data )

Callback function to parse Program headers (ELF Segments)

Deﬁnition at line 683 of ﬁle wsh.c.

4.16.3.60int phdr_cmp ( segments_t a, segments_t b )

Sort function helper for segments

Deﬁnition at line 1434 of ﬁle wsh.c.

4.16.3.61int phdrs ( lua_State L )

Display Program headers (ELF Segments)

Deﬁnition at line 859 of ﬁle wsh.c.

4.16.3.62void print_backtrace ( void )

Deﬁnition at line 2847 of ﬁle wsh.c.

4.16.3.63int print_eps ( void )

Display Entry points

Deﬁnition at line 1409 of ﬁle wsh.c.

4.16.3.64int print_functions ( lua_State L )

Display functions

Deﬁnition at line 1176 of ﬁle wsh.c.

4.16.3.65int print_libs ( lua_State L )

Display mapped librairies, return a list of library names

Deﬁnition at line 1308 of ﬁle wsh.c.

4.16.3.66int print_objects ( lua_State L )

Display objects (typically globals)

Deﬁnition at line 1255 of ﬁle wsh.c.

The Witchcraft Compiler Collection

4.16 wsh/wsh.c File Reference

127

4.16.3.67int print_phdrs ( void )

Display program headers (ELF Segments)

Deﬁnition at line 1052 of ﬁle wsh.c.

4.16.3.68int print_procmap ( unsigned int pid )

Display content of /proc/self/maps

Deﬁnition at line 2765 of ﬁle wsh.c.

4.16.3.69int print_shdrs ( void )

Display ELF sections

Deﬁnition at line 1344 of ﬁle wsh.c.

4.16.3.70int print_symbols ( lua_State L )

Display symbols

Deﬁnition at line 1108 of ﬁle wsh.c.

4.16.3.71int printarg ( unsigned long int val )

Deﬁnition at line 3155 of ﬁle wsh.c.

4.16.3.72int priv_memcpy ( lua_State L )

Our own version of memcpy callable from LUA

Deﬁnition at line 4154 of ﬁle wsh.c.

4.16.3.73int priv_strcat ( lua_State L )

Our own version of strcat callable from LUA

Deﬁnition at line 4197 of ﬁle wsh.c.

4.16.3.74int priv_strcpy ( lua_State L )

Our own version of strcpy callable from LUA

Deﬁnition at line 4176 of ﬁle wsh.c.

4.16.3.75int procmap_lua ( void )

Deﬁnition at line 2787 of ﬁle wsh.c.

4.16.3.76int prototypes ( lua_State L )

Display learned prototypes Read all the lines to learnt data structure

Sort learnt data structures

The Witchcraft Compiler Collection

128	File Documentation

Deﬁnition at line 1885 of ﬁle wsh.c.

4.16.3.77int ptoh ( int perms, char hperms[ ] )

Get permissions in human readable format

Deﬁnition at line 138 of ﬁle wsh.c.

4.16.3.78int ralloc ( lua_State L )

ralloc(unsigned int size, unsigned char poison); allocate 1 page set to 0x00, set size bytes to poison, remap the page R only

Deﬁnition at line 3755 of ﬁle wsh.c.

4.16.3.79int rawmemaddr ( lua_State L )

int addr rawmemaddr(obj)

Return the address in memory of the object passed as argument. Or returns an address itself if an address is given as argument.

Deﬁnition at line 4833 of ﬁle wsh.c.

4.16.3.80int rawmemread ( lua_State L )

string res rawmemread(addr, len)

Read len bytes at address addr and return them as a lua string.

Deﬁnition at line 4759 of ﬁle wsh.c.

4.16.3.81int rawmemstr ( lua_State L )

Returns a string, from an address passed as argument.

Deﬁnition at line 4797 of ﬁle wsh.c.

4.16.3.82int rawmemstrlen ( lua_State L )

int rawmemstrlen(addr) Returns the length of a string passed as argument Deﬁnition at line 4845 of ﬁle wsh.c.

4.16.3.83int rawmemusage ( lua_State L )

Display memory usage.

Deﬁnition at line 4811 of ﬁle wsh.c.

4.16.3.84int rawmemwrite ( lua_State L )

int written rawmemwrite(addr, data, len)

Raw write to addr of len bytes of data returns number of bytes written.

Deﬁnition at line 4778 of ﬁle wsh.c.

The Witchcraft Compiler Collection

4.16 wsh/wsh.c File Reference

129

4.16.3.85int rdnum ( lua_State L )

Read a number (to a LUA number)

Deﬁnition at line 1642 of ﬁle wsh.c.

4.16.3.86int rdstr ( lua_State L )

Read a string (to a LUA string)

Deﬁnition at line 1621 of ﬁle wsh.c.

4.16.3.87unsigned int read_elf_sig ( char fname, struct stat sb )

Verify ELF signature in a binary

Deﬁnition at line 4452 of ﬁle wsh.c.

4.16.3.88int reload_elfs ( void )

Reload linked lists from ELFs binaries

Deﬁnition at line 1441 of ﬁle wsh.c.

4.16.3.89void rescan ( void )

Rescan address space

Deﬁnition at line 2752 of ﬁle wsh.c.

4.16.3.90void restore_exit ( void )

generic function to restore from exit()

Deﬁnition at line 3132 of ﬁle wsh.c.

4.16.3.91void rtrace ( lua_State L )

Deﬁnition at line 3921 of ﬁle wsh.c.

4.16.3.92int run_script ( char name )

Run a lua script

Deﬁnition at line 4418 of ﬁle wsh.c.

4.16.3.93int run_shell ( lua_State L )

Run minimal LUA shell Set handlers for tab completion

Prepare history full log name

Load shell history

Main loop

Command analysis/execution

Deﬁnition at line 1689 of ﬁle wsh.c.

The Witchcraft Compiler Collection

130	File Documentation

4.16.3.94void scan_section ( Elf_Shdr shdr, char strTab, int shnum, char fname, unsigned long int baseaddr )

Parse a section from an ELF

Deﬁnition at line 803 of ﬁle wsh.c.

4.16.3.95int scan_sections ( char fname, unsigned long int baseaddr )

Parse all sections from an ELF

Deﬁnition at line 821 of ﬁle wsh.c.

4.16.3.96int scan_symbol ( char symbol, char libname )

Scan a symbol, save it to linked list

Deﬁnition at line 338 of ﬁle wsh.c.

4.16.3.97void scan_syms ( char dynstr, Elf_Sym sym, unsigned long int sz, char libname )

Walk symbol table

If function name is blackslisted, skip...

Add function/object to linked list

Deﬁnition at line 2507 of ﬁle wsh.c.

4.16.3.98void script ( char path )

Run a script

Deﬁnition at line 166 of ﬁle wsh.c.

4.16.3.99void section_add ( unsigned long int addr, unsigned long int size, char libname, char name, char perms, int ﬂags )

Add a section to linked list

Deﬁnition at line 751 of ﬁle wsh.c.

4.16.3.100 sections_t section_from_addr ( unsigned long int addr )

Find section from address

Deﬁnition at line 869 of ﬁle wsh.c.

4.16.3.101 void segment_add ( unsigned long int addr, unsigned long int size, char perms, char fname, char ptype, int

ﬂags )

Add a segment to linked list

Deﬁnition at line 769 of ﬁle wsh.c.

The Witchcraft Compiler Collection

4.16 wsh/wsh.c File Reference

131

4.16.3.102 segments_t segment_from_addr ( unsigned long int addr )

Find segment from address

Deﬁnition at line 884 of ﬁle wsh.c.

4.16.3.103 void set_align_ﬂag ( void ) [inline]

Deﬁnition at line 2904 of ﬁle wsh.c.

4.16.3.104 int set_alloc_opt ( void )

Deﬁnition at line 4331 of ﬁle wsh.c.

4.16.3.105 void set_branch_ﬂag ( void ) [inline]

Deﬁnition at line 2999 of ﬁle wsh.c.

4.16.3.106 int set_sighandlers ( void )

Set all signal handlers

Deﬁnition at line 3542 of ﬁle wsh.c.

4.16.3.107 void set_trace_ﬂag ( void ) [inline]

Deﬁnition at line 2931 of ﬁle wsh.c.

4.16.3.108 int setcharbuf ( lua_State L )

Deﬁnition at line 1603 of ﬁle wsh.c.

4.16.3.109 int shdr_callback ( struct dl_phdr_info info, size_t size, void data )

Callback function to parse Section headers (ELF Sections)

Deﬁnition at line 846 of ﬁle wsh.c.

4.16.3.110 int shdr_cmp ( sections_t a, sections_t b )

Sort function helper for sections

Deﬁnition at line 1427 of ﬁle wsh.c.

4.16.3.111 int shdrs ( lua_State L )

Display section headers (ELF Sections)

Deﬁnition at line 1459 of ﬁle wsh.c.

4.16.3.112 char sicode_strerror ( int signal, siginfo_t s )

Deﬁnition at line 3340 of ﬁle wsh.c.

The Witchcraft Compiler Collection

132	File Documentation

4.16.3.113 char sicodetoname ( int code )

Deﬁnition at line 2872 of ﬁle wsh.c.

4.16.3.114 void sighandler ( int signal, siginfo_t s, void ptr )

Get access type

Get signal name

Get signal code

Restore execution from known good point

Deﬁnition at line 3454 of ﬁle wsh.c.

4.16.3.115 char signaltoname ( int signal )

Deﬁnition at line 2878 of ﬁle wsh.c.

4.16.3.116 void singlebranch ( lua_State L )

Deﬁnition at line 3945 of ﬁle wsh.c.

4.16.3.117 void singlestep ( lua_State L )

Deﬁnition at line 3903 of ﬁle wsh.c.

4.16.3.118 int sort_learnt ( learn_t a, learn_t b )

Deﬁnition at line 1878 of ﬁle wsh.c.

4.16.3.119 sections_t symbol_from_addr ( unsigned long int addr )

Return a symbol from an address

Deﬁnition at line 899 of ﬁle wsh.c.

4.16.3.120 sections_t symbol_from_name ( char fname )

Return a symbol from its name

Deﬁnition at line 914 of ﬁle wsh.c.

4.16.3.121 char symbol_tobind ( int n )

Return symbol binding type in human readable format

Deﬁnition at line 279 of ﬁle wsh.c.

4.16.3.122 char symbol_totype ( int n )

Return symbol type in human readable format

Deﬁnition at line 303 of ﬁle wsh.c.

The Witchcraft Compiler Collection

4.16 wsh/wsh.c File Reference

133

4.16.3.123 void systrace ( lua_State L )

Deﬁnition at line 3916 of ﬁle wsh.c.

4.16.3.124 int test_stdin ( void )

Set global variable is_stdinscript to 1 if there is data on stdin

Deﬁnition at line 3599 of ﬁle wsh.c.

4.16.3.125 int traceback ( lua_State L )

Deﬁnition at line 2836 of ﬁle wsh.c.

4.16.3.126 void traceunaligned ( lua_State L )

Resize a xallocated memory zone

Deﬁnition at line 3891 of ﬁle wsh.c.

4.16.3.127 void traphandler ( int signal, siginfo_t s, void ptr )

Search corresponding Breakpoint

This is a breakpoint

We are single branching

We are single stepping

We are tracing unaligned access via SIGBUS, single step once

This is an unhandled exception : exit

Deﬁnition at line 3175 of ﬁle wsh.c.

4.16.3.128 void unrtrace ( lua_State L )

Deﬁnition at line 3931 of ﬁle wsh.c.

4.16.3.129 void unset_align_ﬂag ( void ) [inline]

Deﬁnition at line 2890 of ﬁle wsh.c.

4.16.3.130 void unset_branch_ﬂag ( void ) [inline]

Deﬁnition at line 3022 of ﬁle wsh.c.

4.16.3.131 void unset_trace_ﬂag ( void ) [inline]

Deﬁnition at line 2917 of ﬁle wsh.c.

4.16.3.132 void unsinglebranch ( lua_State L )

Deﬁnition at line 3967 of ﬁle wsh.c.

The Witchcraft Compiler Collection

134	File Documentation
4.16.3.133	void unsinglestep ( lua_State L )

Deﬁnition at line 3909 of ﬁle wsh.c.

4.16.3.134 void unsystrace ( lua_State L )

Deﬁnition at line 3926 of ﬁle wsh.c.

4.16.3.135 void untraceunaligned ( lua_State L )

Deﬁnition at line 3897 of ﬁle wsh.c.

4.16.3.136 void unverbosetrace ( lua_State L )

Deﬁnition at line 3941 of ﬁle wsh.c.

4.16.3.137 int verbose ( lua_State L )

Deﬁnition at line 3618 of ﬁle wsh.c.

4.16.3.138 void verbosetrace ( lua_State L )

Deﬁnition at line 3937 of ﬁle wsh.c.

4.16.3.139 int wsh_getopt ( wsh_t wsh1, int argc, char argv )

Parse command line

Deﬁnition at line 4629 of ﬁle wsh.c.

4.16.3.140 int wsh_init ( void )

Deﬁnition at line 4364 of ﬁle wsh.c.

4.16.3.141 int wsh_loadlibs ( void )

Load all preload libraries

Deﬁnition at line 4608 of ﬁle wsh.c.

4.16.3.142 int wsh_print_version ( void )

Print software version

Deﬁnition at line 4720 of ﬁle wsh.c.

4.16.3.143 int wsh_run ( void )

Run a lua shell/script Run all the scripts speciﬁed in the command line

Run a lua shell

Deﬁnition at line 4475 of ﬁle wsh.c.

The Witchcraft Compiler Collection

4.16 wsh/wsh.c File Reference

135

4.16.3.144 int wsh_usage ( char name )

Print usage

Deﬁnition at line 4729 of ﬁle wsh.c.

4.16.3.145 int xalloc ( lua_State L )

xalloc(unsigned int size, unsigned char poison, unsigned int perms); Allocate size bytes (% getpagesize()) The mapping auto-references itself, unless a poison byte is given

[page unmaped] [mapped][OURPTR, size] [page unmaped] Deﬁnition at line 3807 of ﬁle wsh.c.

4.16.3.146 void xfree ( lua_State L )

Release a bloc allocated via xalloc()

Deﬁnition at line 3868 of ﬁle wsh.c.

4.16.4Variable Documentation

4.16.4.1help_t cmdhelp[ ]

Initial value:

{"quit", "", "Exit wsh.", "", "Does not return : exit wshnn"},

{"exit", "", "Exit wsh.", "", "Does not return : exit wshnn"},

{"shell", "[command]", "Run a /bin/sh shell.", "", "None. Returns uppon shell termination."}, {"exec", "<command>", "Run <command> via the system() library call.", "", "None. Returns uppon <command> termination."},

{"clear", "", "Clear terminal.", "", "None."},

}

Deﬁnition at line 497 of ﬁle wsh.c.

4.16.4.2help_t fcnhelp[ ]

Initial value:

{"help", "[topic]","Display help on [topic]. If [topic] is ommitted, display general help.", "", " None"},

{"man", "[page]", "Display system manual page for [page].", "", "None"},

{"hexdump", "<address>, <num>", "Display <num> bytes from memory <address> in enhanced hexadecimal form.", "", "None"},

{"hex", "<object>", "Display lua <object> in enhanced hexadecimal form.", "", "None"},

{"phdrs", "", "Display ELF program headers from all binaries loaded in address space.", "", "None"}

{"shdrs", "", "Display ELF section headers from all binaries loaded in address space.", "", "None"}

{"map", "", "Display a table of all the memory ranges mapped in memory in the address space.", "", "None"},

{"procmap", "", "Display a table of all the memory ranges mapped in memory in the address space as displayed in /proc/<pid>/maps.", "", "None"},

{"bfmap", "", "Bruteforce valid mapped memory ranges in address space.", "", "None"},

{"symbols", "[sympattern], [libpattern], [mode]", "Display all the symbols in memory matching [sympattern], from library [libpattern]. If [mode] is set to 1 or 2, do not wait user input between pagers. [mode] = 2 provides a shorter output.", "", "None"},

{"functions","[sympattern], [libpattern], [mode]", "Display all the functions in memory matching [sympattern], from library [libpattern]. If [mode] is set to 1 or 2, do not wait user input between pagers. [mode] = 2 provides a shorter output.", "table func = ", "Return 1 lua table _func_ whose keys are valid function names in address space, and values are pointers to them in memory."}, {"objects","[pattern]", "Display all the functions in memory matching [sympattern]", "", "None"},

The Witchcraft Compiler Collection

136	File Documentation
	{"info", "[address] \| [name]", "Display various informations about the [address] or [name] provided
	: if it is mapped, and if so from which library and in which section if available.", "", "None"},
	{"search", "<pattern>", "Search all object names matching <pattern> in address space.", "", "None"}
	,
	{"headers", "", "Display C headers suitable for linking against the API loaded in address space.",
	"", "None"},
	{"grep", "<pattern>, [patternlen], [dumplen], [before]","Search <pattern> in all ELF sections in
	memory. Match [patternlen] bytes, then display [dumplen] bytes, optionally including [before] bytes before the
	match. Results are displayed in enhanced decimal form", "table match = ", "Returns 1 lua table containing
	matching memory addresses."},
	{"grepptr", "<pattern>, [patternlen], [dumplen], [before]","Search pointer <pattern> in all ELF
	sections in memory. Match [patternlen] bytes, then display [dumplen] bytes, optionally including [before] bytes
	before the match. Results are displayed in enhanced decimal form", "table match = ", "Returns 1 lua table
	containing matching memory addresses."},
	{"loadbin","<pathname>","Load binary to memory from <pathname>.", "", "None"},
	{"libs", "", "Display all libraries loaded in address space.", "table libraries = ", "Returns 1
	value: a lua table _libraries_ whose values contain valid binary names (executable/libraries) mapped in memory.
	"},
	{"entrypoints", "", "Display entry points for each binary loaded in address space.", "", "None"},
	{"rescan", "", "Re-perform address space scan.", "", "None"},
	{"libcall", "<function>, [arg1], [arg2], ... arg[6]", "Call binary <function> with provided
	arguments.", "void *ret, table ctx = ", "Returns 2 return values: _ret_ is the return value of the binary function
	(nill if none), _ctx_ a lua table representing the execution context of the library call.nn"},
	{"enableaslr", "", "Enable Address Space Layout Randomization (requires root privileges).", "", "
	None"},
	{"disableaslr", "", "Disable Address Space Layout Randomization (requires root privileges).", "", "
	None"},
	{"verbose", "<verbosity>", "Change verbosity setting to <verbosity>.", "", "None"},
	{"breakpoint", "<address>, [weight]", "Set a breakpoint at memory <address>. Optionally add a
	<weight> to breakpoint score if hit.", "", "None"},
	{"bp", "<address>, [weight]", "Set a breakpoint at memory <address>. Optionally add a <weight> to
	breakpoint score if hit. Alias for breakpoint() function.", "", "None"},
	{"hollywood", "<level>", "Change hollywood (fun) display setting to <level>, impacting color
	display (enable/disable).", "", "None"},
}

Deﬁnition at line 506 of ﬁle wsh.c.

4.16.4.3learn_t protorecords = NULL

Deﬁnition at line 1876 of ﬁle wsh.c.

4.16.4.4wsh_t wsh

Main wsh context

Witchcraft Compiler Collection

Author: Jonathan Brossard - [email protected]

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

Deﬁnition at line 37 of ﬁle wshmain.c.

The Witchcraft Compiler Collection

4.17 wsh/wshmain.c File Reference

137

4.17 wsh/wshmain.c File Reference

#include <libwitch/wsh.h>

Functions

• int main (int argc, char argv, char envp)

Variables

•wsh_t wsh

4.17.1Function Documentation

4.17.1.1int main ( int argc, char argv, char envp )

Application entry point

Deﬁnition at line 42 of ﬁle wshmain.c.

4.17.2Variable Documentation

4.17.2.1wsh_t wsh

Witchcraft Compiler Collection

Author: Jonathan Brossard - [email protected]

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

Deﬁnition at line 37 of ﬁle wshmain.c.

The Witchcraft Compiler Collection

Index

_FILE_OFFSET_BITS	wcc.c, 51
helper.c, 55	analyze_text
_GNU_SOURCE	wcc.c, 44
wcc.c, 40	append_reloc
wsh.h, 70	wcc.c, 44
_XOPEN_SOURCE	append_strtab
helper.c, 55	wcc.c, 44
__USE_GNU	append_sym
wcc.c, 40	wcc.c, 44
__progname_full	archsz
wsh.h, 86	ctx_t, 6
_exit	b
wsh.c, 119	b
	luaL_Buffer, 17
abfd	BIND_FLAGS
ctx_t, 6	wsh.h, 70
add_binary_preload	BLACK
wsh.c, 119	colors.h, 56
add_extra_symbols	BLUE
wcc.c, 44	colors.h, 56
add_script_arguments	BROWN
wsh.c, 119	colors.h, 56
add_script_exec	backup
wsh.c, 119	breakpoint_t, 5
add_symaddr	base
wcc.c, 44	elfdata_t, 10
add_symbol	base_address
wsh.c, 119	ctx_t, 6
wsh.h, 76	bfmap
addr	wsh.c, 120
eps_t, 11	wsh.h, 76
sections_t, 25	binname
segments_t, 26	ctx_t, 7
symaddr, 28	blnames
symbols_t, 28	wcc.c, 51
tuple_t, 30	bp_array
adjust_baseaddress	wsh_t, 31
wcc.c, 44	bp_num
afﬁnity	wsh_t, 31
wsh.c, 119	bp_points
alarmhandler	wsh_t, 31
wsh.c, 119	breakpoint
alignfromname	wsh.c, 120
wcc.c, 44	wsh.h, 76
alloc_phdr	breakpoint_t, 5
wcc.c, 44	backup, 5
alloccharbuf	ptr, 5
wsh.c, 119	weight, 5
wsh.h, 76	wsh.h, 75
allowed_sections	bsspolute

INDEX

139

wsh.c, 120 wsh.h, 77

btcaller wsh_t, 31

btr_disable wsh.c, 120

btr_enable wsh.c, 120

bushandler wsh.c, 120

CATCH longjmp.h, 89

CLEAR colors.h, 56

CS_MODE wcc.c, 40 wsh.c, 116

CYAN colors.h, 56

check_global_import wcc.c, 44

closef luaL_Stream, 19

cmdhelp wsh.c, 135

colors.h BLACK, 56 BLUE, 56 BROWN, 56 CLEAR, 56 CYAN, 56 DARKGRAY, 56 GRAY, 56 GREEN, 56 MAGENTA, 57 NORMAL, 57 RED, 57 YELLOW, 57

completion wsh.c, 120

copy_body wcc.c, 45

coreﬁle ctx_t, 7

cplus_demangle wsh.h, 77

craft_section wcc.c, 45

create_phdrs wcc.c, 45

ctx_getopt wcc.c, 45

ctx_init wcc.c, 45

ctx_t, 5 abfd, 6 archsz, 6

base_address, 6

binname, 7 coreﬁle, 7 fdout, 7

has_relativerelocations, 7 mphdrs, 7

mphnum, 7 mshdrs, 7 mshnum, 7 opt_arch, 7 opt_asmdebug, 7 opt_binname, 7 opt_core, 7 opt_debug, 8 opt_entrypoint, 8 opt_exec, 8 opt_ﬂags, 8 opt_interp, 8 opt_original, 8 opt_poison, 8 opt_reloc, 8 opt_shared, 8 opt_sstrip, 8 opt_static, 8 opt_strip, 8 opt_verbose, 9 phnum, 9 shnum, 9 start_phdrs, 9 start_shdrs, 9 strndx, 9 strndx_index, 9 strndx_len, 9 wcc.c, 43

currentline lua_Debug, 16

cvec

linenoiseCompletions, 15

DARKGRAY colors.h, 56

DEFAULT_LEARN_FILE wsh.h, 70

DEFAULT_NAME wld.c, 54

DEFAULT_SCRIPT

wsh.h, 70

DEFAULT_SCRIPT_INDEX wsh.h, 70

DEFAULT_STRNDX_SIZE wcc.c, 41

DMGL_ANSI wsh.h, 70

DMGL_ARM wsh.h, 70

DMGL_PARAMS wsh.h, 70

data

msec_t, 19 datavma

The Witchcraft Compiler Collection

140

INDEX

wcc.c, 51

declare_func wsh.c, 120

declare_internals wsh.c, 121

declare_num wsh.c, 121

decode_ﬂags wsh.c, 121

decode_type wsh.c, 121

default_options wsh_functions.h, 86

default_poison wsh.h, 70

deltastrtab wcc.c, 51

descr help_t, 13

desired_arch wcc.c, 45

detailed_help wsh.c, 121

disable_aslr wsh.c, 121 wsh.h, 77

disable_core wsh.c, 121 wsh.h, 77

do_loadlib wsh.c, 121 wsh.h, 77

dyn_index elfdata_t, 10

dyns

elfdata_t, 10

ELF32_ST_BIND wsh.h, 70 ELF32_ST_INFO wsh.h, 70 ELF32_ST_TYPE wsh.h, 70 ELF64_ST_BIND wsh.h, 70 ELF64_ST_INFO wsh.h, 71 ELF64_ST_TYPE wsh.h, 71

ELF_R_INFO wcc.c, 41 wsh.c, 117

ELF_R_SYM wcc.c, 41 wsh.c, 117

ELF_R_TYPE wcc.c, 41 wsh.c, 117

ELF_ST_BIND

wcc.c, 42 wsh.c, 117

ELF_ST_TYPE wcc.c, 42 wsh.c, 117

ELFCLASS wcc.c, 42 wsh.c, 118

ELFMACHINE wcc.c, 42 wsh.c, 118

ETRY longjmp.h, 89

ehdr

elfdata_t, 10 Elf_Addr

wcc.c, 41 wsh.c, 116

Elf_Dyn wsh.h, 71

Elf_Ehdr wcc.c, 41 wsh.c, 117 wsh.h, 71

Elf_Off wcc.c, 41 wsh.c, 117

Elf_Phdr wcc.c, 41 wsh.c, 117 wsh.h, 71

Elf_Rel wcc.c, 41 wsh.c, 117

Elf_Rela wcc.c, 41 wsh.c, 117

Elf_Section wcc.c, 41 wsh.c, 117

Elf_Shdr wcc.c, 41 wsh.c, 117 wsh.h, 71

Elf_Sword wcc.c, 42 wsh.c, 118

Elf_Sym wcc.c, 42 wsh.c, 118 wsh.h, 71

Elf_Word wcc.c, 42 wsh.c, 118

Elf_Xword wcc.c, 42 wsh.c, 118

elfdata_t, 9

The Witchcraft Compiler Collection

INDEX

141

base, 10

dyn_index, 10 dyns, 10 ehdr, 10 et_dyn, 10 limit, 10 link_map, 10 p_pltgot, 10 phdrs, 10 r_debug, 10

elis

wcc.c, 42

empty_eps wsh.c, 121

empty_phdrs wsh.c, 122 wsh.h, 77

empty_shdrs wsh.c, 122 wsh.h, 77

empty_symbols wsh.c, 122

enable_aslr wsh.c, 122 wsh.h, 77

enable_core wsh.c, 122 wsh.h, 77

end

section, 24 entry_point_add wsh.c, 122

entrypoints wsh.c, 122 wsh.h, 78

entszfromname wcc.c, 45

eps

wsh_t, 31 eps_t, 11

addr, 11 name, 11 next, 11 prev, 11 wsh.h, 75

errcontext wsh_t, 31

et_dyn elfdata_t, 10

event lua_Debug, 16

execlib wsh.c, 122 wsh.h, 78

exit

wsh.c, 122 exit_group

wsh.c, 122

exposed wsh_functions.h, 86

luaL_Stream, 19

FAULT_EXEC wsh.h, 71

FAULT_READ wsh.h, 71

FAULT_WRITE wsh.h, 71

FINALLY longjmp.h, 89

FLAG_BSS wcc.c, 42

FLAG_NOBIT wcc.c, 42

FLAG_NOWRITE wcc.c, 43

FLAG_TEXT wcc.c, 43

fatal_error wsh.c, 123

faultaddr wsh_t, 31

fcnhelp wsh.c, 135

fdout ctx_t, 7

ﬁrstcontext wsh_t, 32

ﬁrsterrno wsh_t, 32

ﬁrstsicode wsh_t, 32

ﬁrstsignal wsh_t, 32

ﬁxup_strtab_and_symtab wcc.c, 45

ﬁxup_symtab_section_index wcc.c, 45

ﬁxup_text wcc.c, 45

ﬂags

msec_t, 19 sections_t, 25 segments_t, 26

ﬂags_from_name wcc.c, 46

func

luaL_Reg, 18

GRAY colors.h, 56

GREEN colors.h, 56

gencore wsh.c, 123 wsh.h, 78

The Witchcraft Compiler Collection

	142	INDEX
	getcharbuf	wsh.c, 123
	wsh.c, 123	wsh.h, 78
	wsh.h, 78	help_t, 12
	getsize	descr, 13
	wsh.h, 78	name, 13
	gimport_t, 11	proto, 13
	r, 12	protopreﬁx, 13
	rtype, 12	retval, 13
	sec, 12	wsh.c, 119
	sindex, 12	helper.c
	sname, 12	_FILE_OFFSET_BITS, 55
	wcc.c, 43	_XOPEN_SOURCE, 55
	gimports	HAS_ZFIRST, 55
	wcc.c, 51	is_mapped, 55
	gimportslen	lastsignal, 55
	wcc.c, 51	nsections, 55
	global_xalloc	read_maps, 55
	wsh_functions.h, 86	zﬁrst, 55
	globalreloc	helper.h
	wcc.c, 51	is_mapped, 63
	globalreloclen	nsections, 63
	wcc.c, 52	read_maps, 63
	globalrelocoffset	zﬁrst, 63
	wcc.c, 52	hexdump
	globalsignals	wcc.c, 46
	wsh_t, 32	wsh.c, 123
	globalstrtab	wsh.h, 78
	wcc.c, 52	hh
	globalstrtablen	learn_t, 14
	wcc.c, 52	hollywood
	globalstrtableoffset	wsh.c, 123
	wcc.c, 52	wsh.h, 79
	globalsymindex	hperms
	wcc.c, 52	section, 24
	globalsymtab	htype
	wcc.c, 52	symbols_t, 29
	globalsymtablen	i_ci
	wcc.c, 52	i_ci
	wcc.c, 52	lua_Debug, 16
	globalsymtableoffset	lua_Debug, 16
	globalsymtableoffset	iﬁs
	wcc.c, 52	iﬁs
	wcc.c, 52	wcc.c, 43
	grep	wcc.c, 43
	grep	info
	wsh.c, 123	info
	wsh.c, 123	wsh.c, 124
	wsh.h, 78	wsh.c, 124
	wsh.h, 78	wsh.h, 79
	grepptr	wsh.h, 79
	grepptr	info_from_name
	wsh.c, 123	info_from_name
	wsh.c, 123	wcc.c, 46
	wsh.h, 78	wcc.c, 46
	wsh.h, 78	info_function
		info_function
	HAS_ZFIRST	wsh.c, 124
	helper.c, 55	init
	HPERMSMAX	section, 24
	wsh.h, 71	initb
	has_relativerelocations	luaL_Buffer, 17
	ctx_t, 7	internal_function_store
	hbind	wcc.c, 46
	symbols_t, 28	interrupted
	headers	wsh_t, 32
	wsh.c, 123	inthandler
	wsh.h, 78	wsh.c, 124
	help	is_mapped

The Witchcraft Compiler Collection

INDEX

143

helper.c, 55 helper.h, 63

is_stdinscript wsh_t, 32

istailcall lua_Debug, 16

isvararg lua_Debug, 16

key

learn_t, 14

luaL_Buffer, 17 wsh_t, 32

l_ﬂoor luaconf.h, 106

l_mathlim luaconf.h, 106

l_mathop luaconf.h, 107

l_sprintf luaconf.h, 107

LINES_MAX wsh.h, 71

LUA_API luaconf.h, 107

LUA_AUTHORS lua.h, 93

LUA_BITLIBNAME lualib.h, 111

LUA_CDIR luaconf.h, 107

LUA_COLIBNAME lualib.h, 111

LUA_COPYRIGHT lua.h, 93

LUA_CPATH_DEFAULT luaconf.h, 107

LUA_DBLIBNAME lualib.h, 111

LUA_DIRSEP luaconf.h, 107

LUA_ERRERR lua.h, 93

LUA_ERRFILE lauxlib.h, 59

LUA_ERRGCMM lua.h, 93

LUA_ERRMEM lua.h, 94

LUA_ERRRUN lua.h, 94

LUA_ERRSYNTAX lua.h, 94

LUA_EXTRASPACE luaconf.h, 107

LUA_FILEHANDLE lauxlib.h, 59

LUA_FLOAT_DOUBLE luaconf.h, 107

LUA_FLOAT_FLOAT luaconf.h, 107

LUA_FLOAT_TYPE luaconf.h, 107

LUA_GCCOLLECT lua.h, 94

LUA_GCCOUNT lua.h, 94

LUA_GCCOUNTB

lua.h, 94

LUA_GCISRUNNING lua.h, 94

LUA_GCRESTART lua.h, 94

LUA_GCSETPAUSE lua.h, 94

LUA_GCSETSTEPMUL lua.h, 94

LUA_GCSTEP lua.h, 94

LUA_GCSTOP lua.h, 94

LUA_HOOKCALL lua.h, 95

LUA_HOOKCOUNT lua.h, 95

LUA_HOOKLINE lua.h, 95

LUA_HOOKRET lua.h, 95

LUA_HOOKTAILCALL lua.h, 95

LUA_IDSIZE luaconf.h, 108

LUA_INT_INT luaconf.h, 108

LUA_INT_LONG luaconf.h, 108

LUA_INT_LONGLONG luaconf.h, 108

LUA_INT_TYPE luaconf.h, 108

LUA_INTEGER_FMT luaconf.h, 108

LUA_IOLIBNAME lualib.h, 111

LUA_KCONTEXT luaconf.h, 108

LUA_LDIR luaconf.h, 108

LUA_LOADLIBNAME lualib.h, 112

LUA_MASKCALL lua.h, 96

LUA_MASKCOUNT lua.h, 96

The Witchcraft Compiler Collection

144		INDEX
LUA_MASKLINE	LUA_PATH_DEFAULT
lua.h, 96	luaconf.h, 109
LUA_MASKRET	LUA_QL
lua.h, 96	luaconf.h, 109
LUA_MATHLIBNAME	LUA_QS
lualib.h, 112	luaconf.h, 109
LUA_MINSTACK	LUA_REFNIL
lua.h, 96	lauxlib.h, 59
LUA_MULTRET	LUA_REGISTRYINDEX
lua.h, 96	lua.h,	98
LUA_NOREF	LUA_RELEASE
lauxlib.h, 59	lua.h,	99
LUA_NUMBER	LUA_RIDX_GLOBALS
luaconf.h, 108	lua.h,	99
LUA_NUMBER_FMT	LUA_RIDX_LAST
luaconf.h, 109	lua.h,	99
LUA_NUMBER_FRMLEN	LUA_RIDX_MAINTHREAD
luaconf.h, 109	lua.h,	99
LUA_NUMTAGS	LUA_ROOT
lua.h, 96	luaconf.h, 109
LUA_OK	LUA_SIGNATURE
lua.h, 96	lua.h,	99
LUA_OPADD	LUA_STRLIBNAME
lua.h, 97	lualib.h, 112
LUA_OPBAND	LUA_TABLIBNAME
lua.h, 97	lualib.h, 112
LUA_OPBNOT	LUA_TBOOLEAN
lua.h, 97	lua.h,	99
LUA_OPBOR	LUA_TFUNCTION
lua.h, 97	lua.h,	99
LUA_OPBXOR	LUA_TLIGHTUSERDATA
lua.h, 97	lua.h,	99
LUA_OPDIV	LUA_TNIL
lua.h, 97	lua.h,	99
LUA_OPEQ	LUA_TNONE
lua.h, 97	lua.h,	99
LUA_OPIDIV	LUA_TNUMBER
lua.h, 97	lua.h,	100
LUA_OPLE	LUA_TSTRING
lua.h, 97	lua.h,	100
LUA_OPLT	LUA_TTABLE
lua.h, 97	lua.h,	100
LUA_OPMOD	LUA_TTHREAD
lua.h, 97	lua.h,	100
LUA_OPMUL	LUA_TUSERDATA
lua.h, 97	lua.h,	100
LUA_OPPOW	LUA_UNSIGNED
lua.h, 98	luaconf.h, 109
LUA_OPSHL	LUA_UTF8LIBNAME
lua.h, 98	lualib.h, 112
LUA_OPSHR	LUA_VDIR
lua.h, 98	luaconf.h, 110
LUA_OPSUB	LUA_VERSION
lua.h, 98	lua.h,	100
LUA_OPUNM	LUA_VERSION_MAJOR
lua.h, 98	lua.h,	100
LUA_OSLIBNAME	LUA_VERSION_MINOR
lualib.h, 112	lua.h,	100

The Witchcraft Compiler Collection

INDEX

145

LUA_VERSION_NUM lua.h, 101

LUA_VERSION_RELEASE lua.h, 101

LUA_YIELD lua.h, 101

LUAI_BITSINT luaconf.h, 110

LUAI_DDEC luaconf.h, 110

LUAI_DDEF luaconf.h, 110

LUAI_FUNC luaconf.h, 110

LUAI_MAXSTACK luaconf.h, 110

LUAI_UACINT luaconf.h, 110

LUAI_UACNUMBER luaconf.h, 110

LUAL_BUFFERSIZE luaconf.h, 110

LUAL_NUMSIZES lauxlib.h, 60

LUALIB_API luaconf.h, 110

LUAMOD_API luaconf.h, 110

lastlinedeﬁned lua_Debug, 16

lastsignal helper.c, 55

lauxlib.h LUA_ERRFILE, 59 LUA_FILEHANDLE, 59 LUA_NOREF, 59 LUA_REFNIL, 59 LUAL_NUMSIZES, 60 lua_writeline, 59 lua_writestring, 59 lua_writestringerror, 59 luaL_Buffer, 61 luaL_Reg, 61 luaL_Stream, 61 luaL_addchar, 59 luaL_addlstring, 61 luaL_addsize, 59 luaL_addstring, 61 luaL_addvalue, 61 luaL_argcheck, 59 luaL_argerror, 61 luaL_bufﬁnit, 61 luaL_bufﬁnitsize, 61 luaL_callmeta, 61 luaL_checkany, 61 luaL_checkinteger, 61 luaL_checklstring, 61 luaL_checknumber, 61

luaL_checkoption, 61 luaL_checkstack, 61 luaL_checkstring, 60 luaL_checktype, 61 luaL_checkudata, 61 luaL_checkversion, 60 luaL_checkversion_, 61 luaL_doﬁle, 60 luaL_dostring, 60 luaL_error, 61 luaL_execresult, 62 luaL_ﬁleresult, 62 luaL_getmetaﬁeld, 62 luaL_getmetatable, 60 luaL_getsubtable, 62 luaL_gsub, 62 luaL_len, 62 luaL_loadbuffer, 60 luaL_loadbufferx, 62 luaL_loadﬁle, 60 luaL_loadﬁlex, 62 luaL_loadstring, 62 luaL_newlib, 60 luaL_newlibtable, 60 luaL_newmetatable, 62 luaL_newstate, 62 luaL_opt, 60 luaL_optinteger, 62 luaL_optlstring, 62 luaL_optnumber, 62 luaL_optstring, 60 luaL_prepbuffer, 61 luaL_prepbuffsize, 62 luaL_pushresult, 62 luaL_pushresultsize, 62 luaL_ref, 62 luaL_requiref, 62 luaL_setfuncs, 62 luaL_setmetatable, 62 luaL_testudata, 62 luaL_tolstring, 62 luaL_traceback, 62 luaL_typename, 61 luaL_unref, 62 luaL_where, 62

learn_key_t, 13 targ, 13 tfunction, 13 tlib, 13 ttype, 14 tvalue, 14 wsh.c, 119

learn_proto wsh.c, 124

learn_t, 14 hh, 14 key, 14 toffset, 14

The Witchcraft Compiler Collection

146	INDEX
wsh.c, 119	linenoiseSetMultiLine
learnﬁle	linenoise.h, 88
wsh_t, 32	link_from_name
learnlog	wcc.c, 47
wsh_t, 32	link_map
len	elfdata_t, 10
linenoiseCompletions, 15	load_binary
msec_t, 19	wcc.c, 47
libcall	loadbin
wsh.c, 124	wsh.c, 125
wsh.h, 79	wsh.h, 80
libify	loadlibrary
wcc.c, 46	wsh.c, 125
libname	longjmp.h
sections_t, 25	CATCH, 89
segments_t, 26	ETRY, 89
symbols_t, 29	FINALLY, 89
limit	THROW, 89
elfdata_t, 10	TRY, 89
linedeﬁned	longjmp_ptr
lua_Debug, 16	wsh_t, 32
linenoise	longjmp_ptr_high
linenoise.h, 88	wsh_t, 32
linenoise.h	longjmp_ptr_high_cnt
linenoise, 88	wsh_t, 33
linenoiseAddCompletion, 88	ltrace
linenoiseClearScreen, 88	wsh.c, 125
linenoiseCompletionCallback, 88	wsh.h, 80
linenoiseCompletions, 88	lua.h
linenoiseHistoryAdd, 88	LUA_AUTHORS, 93
linenoiseHistoryLoad, 88	LUA_COPYRIGHT, 93
linenoiseHistorySave, 88	LUA_ERRERR, 93
linenoiseHistorySetMaxLen, 88	LUA_ERRGCMM, 93
linenoisePrintKeyCodes, 88	LUA_ERRMEM, 94
linenoiseSetCompletionCallback, 88	LUA_ERRRUN, 94
linenoiseSetMultiLine, 88	LUA_ERRSYNTAX, 94
linenoiseAddCompletion	LUA_GCCOLLECT, 94
linenoise.h, 88	LUA_GCCOUNT, 94
linenoiseClearScreen	LUA_GCCOUNTB, 94
linenoise.h, 88	LUA_GCISRUNNING, 94
linenoiseCompletionCallback	LUA_GCRESTART, 94
linenoise.h, 88	LUA_GCSETPAUSE, 94
linenoiseCompletions, 14	LUA_GCSETSTEPMUL, 94
cvec, 15	LUA_GCSTEP, 94
len, 15	LUA_GCSTOP, 94
linenoise.h, 88	LUA_HOOKCALL, 95
linenoiseHistoryAdd	LUA_HOOKCOUNT, 95
linenoise.h, 88	LUA_HOOKLINE, 95
linenoiseHistoryLoad	LUA_HOOKRET, 95
linenoise.h, 88	LUA_HOOKTAILCALL, 95
linenoiseHistorySave	LUA_MASKCALL, 96
linenoise.h, 88	LUA_MASKCOUNT, 96
linenoiseHistorySetMaxLen	LUA_MASKLINE, 96
linenoise.h, 88	LUA_MASKRET, 96
linenoisePrintKeyCodes	LUA_MINSTACK, 96
linenoise.h, 88	LUA_MULTRET, 96
linenoiseSetCompletionCallback	LUA_NUMTAGS, 96
linenoise.h, 88	LUA_OK, 96

The Witchcraft Compiler Collection

INDEX

147

LUA_OPADD, 97

LUA_OPBAND, 97

LUA_OPBNOT, 97

LUA_OPBOR, 97

LUA_OPBXOR, 97 LUA_OPDIV, 97 LUA_OPEQ, 97 LUA_OPIDIV, 97 LUA_OPLE, 97 LUA_OPLT, 97 LUA_OPMOD, 97 LUA_OPMUL, 97 LUA_OPPOW, 98 LUA_OPSHL, 98 LUA_OPSHR, 98 LUA_OPSUB, 98 LUA_OPUNM, 98 LUA_REGISTRYINDEX, 98 LUA_RELEASE, 99 LUA_RIDX_GLOBALS, 99 LUA_RIDX_LAST, 99 LUA_RIDX_MAINTHREAD, 99 LUA_SIGNATURE, 99 LUA_TBOOLEAN, 99 LUA_TFUNCTION, 99 LUA_TLIGHTUSERDATA, 99 LUA_TNIL, 99 LUA_TNONE, 99 LUA_TNUMBER, 100 LUA_TSTRING, 100 LUA_TTABLE, 100 LUA_TTHREAD, 100 LUA_TUSERDATA, 100 LUA_VERSION, 100 LUA_VERSION_MAJOR, 100 LUA_VERSION_MINOR, 100 LUA_VERSION_NUM, 101 LUA_VERSION_RELEASE, 101 LUA_YIELD, 101

lua_Alloc, 101

lua_CFunction, 101 lua_Debug, 101 lua_Hook, 101 lua_Integer, 101 lua_KContext, 101 lua_KFunction, 101 lua_Number, 101 lua_Reader, 102 lua_State, 102 lua_Unsigned, 102 lua_Writer, 102 lua_absindex, 102 lua_arith, 102 lua_atpanic, 102 lua_call, 93 lua_callk, 102 lua_checkstack, 102 lua_close, 102

lua_compare, 102 lua_concat, 102 lua_copy, 102 lua_createtable, 102 lua_dump, 102 lua_error, 102 lua_gc, 102 lua_getallocf, 102 lua_getextraspace, 95 lua_getﬁeld, 102 lua_getglobal, 102 lua_gethook, 103 lua_gethookcount, 103 lua_gethookmask, 103 lua_geti, 103 lua_getinfo, 103 lua_getlocal, 103 lua_getmetatable, 103 lua_getstack, 103 lua_gettable, 103 lua_gettop, 103 lua_getupvalue, 103 lua_getuservalue, 103 lua_ident, 105 lua_insert, 95 lua_isboolean, 95 lua_iscfunction, 103 lua_isfunction, 95 lua_isinteger, 103 lua_islightuserdata, 95 lua_isnil, 95 lua_isnone, 95 lua_isnoneornil, 96 lua_isnumber, 103 lua_isstring, 103 lua_istable, 96 lua_isthread, 96 lua_isuserdata, 103 lua_isyieldable, 103 lua_len, 103 lua_load, 103 lua_newstate, 103 lua_newtable, 96 lua_newthread, 103 lua_newuserdata, 103 lua_next, 103 lua_pcall, 98 lua_pcallk, 103 lua_pop, 98 lua_pushboolean, 103 lua_pushcclosure, 103 lua_pushcfunction, 98 lua_pushfstring, 104 lua_pushglobaltable, 98 lua_pushinteger, 104

lua_pushlightuserdata, 104 lua_pushliteral, 98 lua_pushlstring, 104

The Witchcraft Compiler Collection

148

INDEX

lua_pushnil, 104

lua_pushnumber, 104 lua_pushstring, 104 lua_pushthread, 104 lua_pushvalue, 104 lua_pushvfstring, 104 lua_rawequal, 104 lua_rawget, 104 lua_rawgeti, 104 lua_rawgetp, 104 lua_rawlen, 104 lua_rawset, 104 lua_rawseti, 104 lua_rawsetp, 104 lua_register, 98 lua_remove, 99 lua_replace, 99 lua_resume, 104 lua_rotate, 104 lua_setallocf, 104 lua_setﬁeld, 104 lua_setglobal, 104 lua_sethook, 104 lua_seti, 104 lua_setlocal, 104 lua_setmetatable, 104 lua_settable, 104 lua_settop, 105 lua_setupvalue, 105 lua_setuservalue, 105 lua_status, 105 lua_stringtonumber, 105 lua_toboolean, 105 lua_tocfunction, 105 lua_tointeger, 100 lua_tointegerx, 105 lua_tolstring, 105 lua_tonumber, 100 lua_tonumberx, 105 lua_topointer, 105 lua_tostring, 100 lua_tothread, 105 lua_touserdata, 105 lua_type, 105 lua_typename, 105 lua_upvalueid, 105 lua_upvalueindex, 100 lua_upvaluejoin, 105 lua_version, 105 lua_xmove, 105 lua_yield, 101 lua_yieldk, 105

lua_Alloc lua.h, 101

lua_CFunction lua.h, 101 lua_Debug, 15

currentline, 16

event, 16 i_ci, 16 istailcall, 16 isvararg, 16 lastlinedeﬁned, 16 linedeﬁned, 16 lua.h, 101 name, 16 namewhat, 16 nparams, 16 nups, 16 short_src, 16 source, 16 what, 17

lua_Hook lua.h, 101

lua_Integer lua.h, 101

lua_KContext lua.h, 101

lua_KFunction lua.h, 101

lua_Number lua.h, 101

lua_Reader lua.h, 102

lua_State lua.h, 102

lua_Unsigned lua.h, 102

lua_Writer lua.h, 102

lua_absindex lua.h, 102

lua_arith lua.h, 102

lua_assert lualib.h, 111

lua_atpanic lua.h, 102

lua_blacklist wsh_functions.h, 86

lua_call lua.h, 93

lua_callk lua.h, 102

lua_checkstack lua.h, 102

lua_close lua.h, 102

lua_compare lua.h, 102

lua_concat lua.h, 102

lua_copy lua.h, 102

lua_createtable lua.h, 102

The Witchcraft Compiler Collection

INDEX		149
lua_default_functions		lua_isnil
wsh_functions.h, 87		lua.h, 95
lua_dump		lua_isnone
lua.h,	102	lua.h, 95
lua_error		lua_isnoneornil
lua.h,	102	lua.h, 96
lua_gc		lua_isnumber
lua.h,	102	lua.h, 103
lua_getallocf		lua_isstring
lua.h,	102	lua.h, 103
lua_getextraspace		lua_istable
lua.h,	95	lua.h, 96
lua_getﬁeld		lua_isthread
lua.h,	102	lua.h, 96
lua_getglobal		lua_isuserdata
lua.h,	102	lua.h, 103
lua_gethook		lua_isyieldable
lua.h,	103	lua.h, 103
lua_gethookcount		lua_len
lua.h,	103	lua.h, 103
lua_gethookmask		lua_load
lua.h,	103	lua.h, 103
lua_geti		lua_newstate
lua.h,	103	lua.h, 103
lua_getinfo		lua_newtable
lua.h,	103	lua.h, 96
lua_getlocal		lua_newthread
lua.h,	103	lua.h, 103
lua_getlocaledecpoint		lua_newuserdata
luaconf.h, 107		lua.h, 103
lua_getmetatable		lua_next
lua.h,	103	lua.h, 103
lua_getstack		lua_number2str
lua.h,	103	luaconf.h, 108
lua_gettable		lua_number2strx
lua.h,	103	luaconf.h, 108
lua_gettop		lua_numbertointeger
lua.h,	103	luaconf.h, 109
lua_getupvalue		lua_pcall
lua.h,	103	lua.h, 98
lua_getuservalue		lua_pcallk
lua.h,	103	lua.h, 103
lua_ident		lua_pop
lua.h,	105	lua.h, 98
lua_insert		lua_pushboolean
lua.h,	95	lua.h, 103
lua_integer2str		lua_pushcclosure
luaconf.h, 108		lua.h, 103
lua_isboolean		lua_pushcfunction
lua.h,	95	lua.h, 98
lua_iscfunction		lua_pushfstring
lua.h,	103	lua.h, 104
lua_isfunction		lua_pushglobaltable
lua.h,	95	lua.h, 98
lua_isinteger		lua_pushinteger
lua.h,	103	lua.h, 104
lua_islightuserdata		lua_pushlightuserdata
lua.h,	95	lua.h, 104

The Witchcraft Compiler Collection

150	INDEX
lua_pushliteral	lua_settop
lua.h, 98	lua.h, 105
lua_pushlstring	lua_setupvalue
lua.h, 104	lua.h, 105
lua_pushnil	lua_setuservalue
lua.h, 104	lua.h, 105
lua_pushnumber	lua_status
lua.h, 104	lua.h, 105
lua_pushstring	lua_str2number
lua.h, 104	luaconf.h, 109
lua_pushthread	lua_strerror
lua.h, 104	wsh.c, 125
lua_pushvalue	lua_stringtonumber
lua.h, 104	lua.h, 105
lua_pushvfstring	lua_strx2number
lua.h, 104	luaconf.h, 109
lua_rawequal	lua_toboolean
lua.h, 104	lua.h, 105
lua_rawget	lua_tocfunction
lua.h, 104	lua.h, 105
lua_rawgeti	lua_tointeger
lua.h, 104	lua.h, 100
lua_rawgetp	lua_tointegerx
lua.h, 104	lua.h, 105
lua_rawlen	lua_tolstring
lua.h, 104	lua.h, 105
lua_rawset	lua_tonumber
lua.h, 104	lua.h, 100
lua_rawseti	lua_tonumberx
lua.h, 104	lua.h, 105
lua_rawsetp	lua_topointer
lua.h, 104	lua.h, 105
lua_register	lua_tostring
lua.h, 98	lua.h, 100
lua_remove	lua_tothread
lua.h, 99	lua.h, 105
lua_replace	lua_touserdata
lua.h, 99	lua.h, 105
lua_resume	lua_type
lua.h, 104	lua.h, 105
lua_rotate	lua_typename
lua.h, 104	lua.h, 105
lua_setallocf	lua_upvalueid
lua.h, 104	lua.h, 105
lua_setﬁeld	lua_upvalueindex
lua.h, 104	lua.h, 100
lua_setglobal	lua_upvaluejoin
lua.h, 104	lua.h, 105
lua_sethook	lua_version
lua.h, 104	lua.h, 105
lua_seti	lua_writeline
lua.h, 104	lauxlib.h, 59
lua_setlocal	lua_writestring
lua.h, 104	lauxlib.h, 59
lua_setmetatable	lua_writestringerror
lua.h, 104	lauxlib.h, 59
lua_settable	lua_xmove
lua.h, 104	lua.h, 105

The Witchcraft Compiler Collection

INDEX	151
lua_yield	lauxlib.h, 61
lua.h, 101	luaL_checkversion
lua_yieldk	lauxlib.h, 60
lua.h, 105	luaL_checkversion_
luaL_Buffer, 17	lauxlib.h, 61
b, 17	luaL_doﬁle
initb, 17	lauxlib.h, 60
L, 17	mylaux.h, 64
lauxlib.h, 61	luaL_dostring
n, 17	lauxlib.h, 60
size, 17	mylaux.h, 64
luaL_Reg, 18	luaL_error
func, 18	lauxlib.h, 61
lauxlib.h, 61	luaL_execresult
name, 18	lauxlib.h, 62
luaL_Stream, 18	luaL_ﬁleresult
closef, 19	lauxlib.h, 62
f, 19	luaL_getmetaﬁeld
lauxlib.h, 61	lauxlib.h, 62
luaL_addchar	luaL_getmetatable
lauxlib.h, 59	lauxlib.h, 60
luaL_addlstring	mylaux.h, 64
lauxlib.h, 61	luaL_getsubtable
luaL_addsize	lauxlib.h, 62
lauxlib.h, 59	luaL_gsub
luaL_addstring	lauxlib.h, 62
lauxlib.h, 61	luaL_len
luaL_addvalue	lauxlib.h, 62
lauxlib.h, 61	luaL_loadbuffer
luaL_argcheck	lauxlib.h, 60
lauxlib.h, 59	mylaux.h, 64
mylaux.h, 64	luaL_loadbufferx
luaL_argerror	lauxlib.h, 62
lauxlib.h, 61	luaL_loadﬁle
luaL_bufﬁnit	lauxlib.h, 60
lauxlib.h, 61	luaL_loadﬁlex
luaL_bufﬁnitsize	lauxlib.h, 62
lauxlib.h, 61	luaL_loadstring
luaL_callmeta	lauxlib.h, 62
lauxlib.h, 61	luaL_newlib
luaL_checkany	lauxlib.h, 60
lauxlib.h, 61	mylaux.h, 64
luaL_checkinteger	luaL_newlibtable
lauxlib.h, 61	lauxlib.h, 60
luaL_checklstring	mylaux.h, 64
lauxlib.h, 61	luaL_newmetatable
luaL_checknumber	lauxlib.h, 62
lauxlib.h, 61	luaL_newstate
luaL_checkoption	lauxlib.h, 62
lauxlib.h, 61	luaL_openlibs
luaL_checkstack	lualib.h, 112
lauxlib.h, 61	luaL_opt
luaL_checkstring	lauxlib.h, 60
lauxlib.h, 60	mylaux.h, 64
mylaux.h, 64	luaL_optinteger
luaL_checktype	lauxlib.h, 62
lauxlib.h, 61	luaL_optlstring
luaL_checkudata	lauxlib.h, 62

The Witchcraft Compiler Collection

152

INDEX

luaL_optnumber lauxlib.h, 62

luaL_optstring lauxlib.h, 60 mylaux.h, 64

luaL_prepbuffer lauxlib.h, 61

luaL_prepbuffsize lauxlib.h, 62

luaL_pushresult lauxlib.h, 62

luaL_pushresultsize lauxlib.h, 62

luaL_ref lauxlib.h, 62

luaL_reg wsh.h, 72

luaL_requiref lauxlib.h, 62

luaL_setfuncs lauxlib.h, 62

luaL_setmetatable lauxlib.h, 62

luaL_testudata lauxlib.h, 62

luaL_tolstring lauxlib.h, 62

luaL_traceback lauxlib.h, 62

luaL_typename lauxlib.h, 61 mylaux.h, 64

luaL_unref lauxlib.h, 62

luaL_where lauxlib.h, 62

luaconf.h l_ﬂoor, 106

l_mathlim, 106 l_mathop, 107 l_sprintf, 107 LUA_API, 107 LUA_CDIR, 107

LUA_CPATH_DEFAULT, 107 LUA_DIRSEP, 107 LUA_EXTRASPACE, 107 LUA_FLOAT_DOUBLE, 107 LUA_FLOAT_FLOAT, 107 LUA_FLOAT_TYPE, 107 LUA_IDSIZE, 108 LUA_INT_INT, 108 LUA_INT_LONG, 108 LUA_INT_LONGLONG, 108 LUA_INT_TYPE, 108 LUA_INTEGER_FMT, 108 LUA_KCONTEXT, 108 LUA_LDIR, 108 LUA_NUMBER, 108

LUA_NUMBER_FMT, 109 LUA_NUMBER_FRMLEN, 109 LUA_PATH_DEFAULT, 109 LUA_QL, 109

LUA_QS, 109 LUA_ROOT, 109 LUA_UNSIGNED, 109 LUA_VDIR, 110 LUAI_BITSINT, 110 LUAI_DDEC, 110 LUAI_DDEF, 110 LUAI_FUNC, 110 LUAI_MAXSTACK, 110 LUAI_UACINT, 110 LUAI_UACNUMBER, 110 LUAL_BUFFERSIZE, 110 LUALIB_API, 110 LUAMOD_API, 110 lua_getlocaledecpoint, 107 lua_integer2str, 108 lua_number2str, 108 lua_number2strx, 108 lua_numbertointeger, 109 lua_str2number, 109 lua_strx2number, 109

lualib.h LUA_BITLIBNAME, 111 LUA_COLIBNAME, 111 LUA_DBLIBNAME, 111 LUA_IOLIBNAME, 111 LUA_LOADLIBNAME, 112 LUA_MATHLIBNAME, 112 LUA_OSLIBNAME, 112 LUA_STRLIBNAME, 112 LUA_TABLIBNAME, 112 LUA_UTF8LIBNAME, 112 lua_assert, 111 luaL_openlibs, 112 luaopen_base, 112 luaopen_bit32, 112 luaopen_coroutine, 112 luaopen_debug, 112 luaopen_io, 112 luaopen_math, 112 luaopen_os, 112 luaopen_package, 112 luaopen_string, 112 luaopen_table, 112 luaopen_utf8, 112

luaopen_base lualib.h, 112

luaopen_bit32 lualib.h, 112

luaopen_coroutine lualib.h, 112

luaopen_debug lualib.h, 112

luaopen_io

The Witchcraft Compiler Collection

INDEX

153

lualib.h, 112

luaopen_math lualib.h, 112

luaopen_os lualib.h, 112

luaopen_package lualib.h, 112

luaopen_string lualib.h, 112

luaopen_table lualib.h, 112

luaopen_utf8 lualib.h, 112

MAGENTA colors.h, 57

MAX_SIGNALS wsh.h, 72

MAXPADLEN wcc.c, 43

MIN_BIN_SIZE wsh.h, 72

MY_CPU wsh.h, 72

main

wcc.c, 47 wld.c, 54 wshmain.c, 137

mainhandle wsh_t, 33

man

wsh.c, 125 wsh.h, 80

map

wsh.c, 125 wsh.h, 80

max

range_t, 22 wcc.c, 47

maxdata wcc.c, 52

maxnewsec wcc.c, 52

maxoldsec wcc.c, 52

maxtext wcc.c, 53

merge_phdrs wcc.c, 47

min

range_t, 22 mindata

wcc.c, 53 mintext

wcc.c, 53 mk_backtrace

wsh.c, 125 mk_lib

wld.c, 54

mk_section wcc.c, 47

mphdrs ctx_t, 7

mphnum ctx_t, 7

msec_t, 19 data, 19 ﬂags, 19 len, 19 name, 19 next, 19 outoffset, 20 prev, 20 s_bfd, 20 s_elf, 20 wcc.c, 43

mseg_t, 20 next, 20 p_align, 20 p_ﬁlesz, 21 p_ﬂags, 21

p_memsz, 21 p_offset, 21 p_paddr, 21 p_type, 21 p_vaddr, 21 prev, 21 wcc.c, 43

mshdrs ctx_t, 7

mshnum ctx_t, 7

mylaux.h luaL_argcheck, 64 luaL_checkstring, 64 luaL_doﬁle, 64 luaL_dostring, 64 luaL_getmetatable, 64 luaL_loadbuffer, 64 luaL_newlib, 64 luaL_newlibtable, 64 luaL_opt, 64 luaL_optstring, 64 luaL_typename, 64

luaL_Buffer, 17

NORMAL colors.h, 57

name eps_t, 11 help_t, 13

lua_Debug, 16 luaL_Reg, 18 msec_t, 19 preload_t, 22 script_t, 23 section, 24

The Witchcraft Compiler Collection

	154	INDEX
	sections_t, 25	opt_original
	signame_t, 27	ctx_t, 8
	symaddr, 28	opt_poison
	tuple_t, 30	ctx_t, 8
	namewhat	opt_reloc
	lua_Debug, 16	ctx_t, 8
	newarray	opt_rescan
	wsh.h, 80	wsh_t, 33
	next	opt_shared
	eps_t, 11	ctx_t, 8
	msec_t, 19	opt_sstrip
	mseg_t, 20	ctx_t, 8
	preload_t, 22	opt_static
	script_t, 23	ctx_t, 8
	section, 24	opt_strip
	sections_t, 25	ctx_t, 8
	segments_t, 26	opt_verbose
	symaddr, 28	ctx_t, 9
	symbols_t, 29	wsh_t, 33
	nparams	opt_verbosetrace
	lua_Debug, 16	wsh_t, 33
	nsections	orig_sz
	helper.c, 55	wcc.c, 53
	helper.h, 63	orig_text
	nullstr	wcc.c, 53
	wcc.c, 43	outoffset
	num	msec_t, 20
	section, 24	p_align
	nups	p_align
	nups	mseg_t, 20
	lua_Debug, 16	mseg_t, 20
	lua_Debug, 16	p_ﬁlesz
		p_ﬁlesz
	open_best	mseg_t, 21
	wcc.c, 47	p_ﬂags
	open_target	mseg_t, 21
	wcc.c, 47	p_memsz
	opt_arch	mseg_t, 21
	ctx_t, 7	p_offset
	opt_argc	mseg_t, 21
	wsh_t, 33	p_paddr
	opt_argv	mseg_t, 21
	wsh_t, 33	p_pltgot
	opt_asmdebug	elfdata_t, 10
	ctx_t, 7	p_type
	opt_binname	mseg_t, 21
	ctx_t, 7	p_vaddr
	opt_core	mseg_t, 21
	ctx_t, 7	PROC_ASLR_PATH
	opt_debug	wsh.h, 72
	ctx_t, 8	parse_dyn
	opt_entrypoint	wsh.c, 125
	ctx_t, 8	parse_link_map_dyn
	opt_exec	wsh.c, 126
	ctx_t, 8	patch_symbol_index
	opt_ﬂags	wcc.c, 48
	ctx_t, 8	perms
	opt_hollywood	section, 24
	wsh_t, 33	sections_t, 25
	opt_interp	segments_t, 26
	ctx_t, 8	pﬂag_from_section

The Witchcraft Compiler Collection

INDEX

155

wcc.c, 48 phdr_callback

wsh.c, 126 phdr_cmp

wcc.c, 48 wsh.c, 126 phdr_cmp_premerge wcc.c, 48

phdrs elfdata_t, 10 wsh.c, 126 wsh.h, 80 wsh_t, 33

phnum ctx_t, 9

pltgot wsh_t, 33

pltsz

wsh_t, 33 preload

wsh_t, 33

preload_t, 21 name, 22 next, 22 prev, 22 wsh.h, 75

eps_t, 11 msec_t, 20 mseg_t, 21 preload_t, 22 script_t, 23 sections_t, 25 segments_t, 26 symbols_t, 29

print_backtrace wsh.c, 126

print_bfd_sections wcc.c, 48

print_eps wsh.c, 126

print_functions wsh.c, 126 wsh.h, 80

print_libs wsh.c, 126 wsh.h, 80

print_maps wcc.c, 48

print_msec wcc.c, 48

print_objects wsh.c, 126 wsh.h, 80

print_phdrs wsh.c, 126 wsh.h, 80

print_procmap

wsh.c, 127

print_shdrs wsh.c, 127 wsh.h, 81

print_symbols wsh.c, 127 wsh.h, 81

print_version wcc.c, 48 wld.c, 54 wsh.h, 81

printarg wsh.c, 127

priv_memcpy wsh.c, 127 wsh.h, 81

priv_strcat wsh.c, 127 wsh.h, 81

priv_strcpy wsh.c, 127 wsh.h, 81

proba section, 24

probableval section, 24

procmap_lua wsh.c, 127 wsh.h, 81

protect_perms wcc.c, 48

proto help_t, 13

protopreﬁx help_t, 13

protorecords wsh.c, 136

prototypes wsh.c, 127 wsh.h, 81

ptoh

wsh.c, 128

ptr

breakpoint_t, 5 ptype_from_section

wcc.c, 48

gimport_t, 12 r_debug

elfdata_t, 10

RED

colors.h, 57

REG_RIP wsh.c, 118

RELOC_MODE wcc.c, 43 wsh.c, 118

RELOC_X86_32

The Witchcraft Compiler Collection

156

INDEX

wcc.c, 43 RELOC_X86_64

wcc.c, 43 ralloc

wsh.c, 128 wsh.h, 81

range_t, 22 max, 22 min, 22 wsh.h, 75

ranges wsh_functions.h, 87

rawmemaddr wsh.c, 128 wsh.h, 82

rawmemread wsh.c, 128 wsh.h, 82

rawmemstr wsh.c, 128 wsh.h, 82

rawmemstrlen wsh.c, 128 wsh.h, 82

rawmemusage wsh.c, 128 wsh.h, 82

rawmemwrite wsh.c, 128 wsh.h, 82

rd_sections wcc.c, 49

rd_symbols wcc.c, 49

rd_symtab wcc.c, 49

rdnum wsh.c, 128 wsh.h, 82

rdstr

wsh.c, 129 wsh.h, 82

read_arg wsh.h, 72

read_arg1 wsh.h, 72

read_arg2 wsh.h, 73

read_arg3 wsh.h, 73

read_arg4 wsh.h, 73

read_elf_sig wsh.c, 129

read_maps helper.c, 55 helper.h, 63

reason

wsh_t, 34

reload_elfs wsh.c, 129 wsh.h, 83

reloc_htype wcc.c, 49

reloc_htype_x86_32 wcc.c, 49 reloc_htype_x86_64 wcc.c, 49

rescan wsh.c, 129 wsh.h, 83

restore_exit wsh.c, 129

retval help_t, 13

rm_section wcc.c, 49

rtrace

wsh.c, 129 wsh.h, 83

rtype gimport_t, 12

run_script wsh.c, 129

run_shell wsh.c, 129

s_bfd msec_t, 20

s_elf

msec_t, 20

SHELL_HISTORY_NAME wsh.h, 74

SKIP_BOTTOM wsh.h, 74

SKIP_INIT wsh.h, 74

STB_GLOBAL wsh.h, 74

STB_GNU_SECONDARY wsh.h, 74

STB_GNU_UNIQUE wsh.h, 74

STB_LOCAL wsh.h, 74

STB_WEAK wsh.h, 74

STT_COMMON wsh.h, 75

STT_FILE wsh.h, 75

STT_FUNC wsh.h, 75

STT_NOTYPE wsh.h, 75

STT_OBJECT wsh.h, 75

The Witchcraft Compiler Collection

INDEX	157
STT_SECTION	wsh.c, 130
wsh.h, 75	section_from_addr
STT_TLS	wcc.c, 50
wsh.h, 75	wsh.c, 130
save_dynstr	section_from_index
wcc.c, 49	wcc.c, 50
save_dynsym	section_from_name
wcc.c, 49	wcc.c, 50
save_global_import	sections_t, 25
wcc.c, 49	addr, 25
save_reloc	ﬂags, 25
wcc.c, 50	libname, 25
scan_section	name, 25
wsh.c, 129	next, 25
scan_sections	perms, 25
wsh.c, 130	prev, 25
scan_symbol	size, 25
wsh.c, 130	wsh.h, 76
scan_syms	segment_add
wsh.c, 130	wsh.c, 130
script	wsh.h, 83
wsh.c, 130	segment_from_addr
wsh.h, 83	wsh.c, 130
script_argnum	segments_t, 26
wsh_t, 34	addr, 26
script_args	ﬂags, 26
wsh_t, 34	libname, 26
script_t, 23	next, 26
name, 23	perms, 26
next, 23	prev, 26
prev, 23	size, 27
wsh.h, 76	type, 27
scriptﬁle	wsh.h, 76
wsh_t, 34	set_align_ﬂag
scriptname	wsh.c, 131
wsh_t, 34	wsh.h, 83
scripts	set_alloc_opt
wsh_t, 34	wsh.c, 131
sec	set_branch_ﬂag
gimport_t, 12	wsh.c, 131
sec_name_from_index_after_strip	wsh.h, 83
wcc.c, 50	set_sighandlers
secindex_from_name	wsh.c, 131
wcc.c, 50	set_trace_ﬂag
secindex_from_name_after_strip	wsh.c, 131
wcc.c, 50	wsh.h, 83
section, 23	setarray
end, 24	wsh.h, 83
hperms, 24	setcharbuf
init, 24	wsh.c, 131
name, 24	wsh.h, 83
next, 24	shdr_callback
num, 24	wsh.c, 131
perms, 24	shdr_cmp
proba, 24	wsh.c, 131
probableval, 24	shdrs
size, 24	wsh.c, 131
section_add	wsh.h, 83

The Witchcraft Compiler Collection

158

INDEX

wsh_t, 34 shnum

ctx_t, 9

short_src lua_Debug, 16

sicode_strerror wsh.c, 131 wsh.h, 84

sicodetoname wsh.c, 131

sigbus_count wsh_t, 34

sigbus_hash wsh_t, 34

sighandler wsh.c, 132

signal signame_t, 27

signaltoname wsh.c, 132 wsh.h, 84

signame_t, 27 name, 27 signal, 27 sigs.h, 65

signames sigs.h, 65

sigs.h signame_t, 65 signames, 65

sindex gimport_t, 12

singlebranch wsh.c, 132 wsh.h, 84

singlebranch_count

wsh_t, 34 singlebranch_hash wsh_t, 34

singlestep wsh.c, 132 wsh.h, 84

singlestep_count wsh_t, 34

singlestep_hash wsh_t, 35

size

luaL_Buffer, 17 section, 24 sections_t, 25 segments_t, 27 symbols_t, 29

sname gimport_t, 12

sort_learnt wsh.c, 132

sort_phdrs wcc.c, 50

sort_phdrs_premerge wcc.c, 50

source lua_Debug, 16

start_phdrs ctx_t, 9 start_shdrs ctx_t, 9

strip_binary_reloc wcc.c, 50

strndx ctx_t, 9

strndx_index ctx_t, 9

strndx_len ctx_t, 9

symaddr, 27 addr, 28 name, 28 next, 28

symaddrs wcc.c, 53

symbol symbols_t, 29

symbol_from_addr wsh.c, 132 symbol_from_name wsh.c, 132

symbol_tobind wsh.c, 132

symbol_totype wsh.c, 132

symbols wsh_t, 35

symbols_t, 28 addr, 28 hbind, 28 htype, 29 libname, 29 next, 29 prev, 29 size, 29 symbol, 29 value, 29 wsh.h, 76

systrace wsh.c, 132 wsh.h, 84

THROW longjmp.h, 89

TRY

longjmp.h, 89

targ

learn_key_t, 13 test_stdin

wsh.c, 133 textvma

wcc.c, 53

The Witchcraft Compiler Collection

INDEX

159

tfunction learn_key_t, 13

tlib

learn_key_t, 13 toffset

learn_t, 14 totsignals

wsh_t, 35

trace_rtrace wsh_t, 35

trace_singlebranch wsh_t, 35

trace_singlestep wsh_t, 35

trace_strace wsh_t, 35

trace_unaligned wsh_t, 35

traceback wsh.c, 133

traceunaligned wsh.c, 133 wsh.h, 84

traphandler wsh.c, 133

ttype

learn_key_t, 14 tuple_t, 29

addr, 30 name, 30 wsh.h, 76

tvalue learn_key_t, 14

type

segments_t, 27 typefromname

wcc.c, 51

USE_LUA wsh.h, 75

unrtrace wsh.c, 133 wsh.h, 84

unset_align_ﬂag wsh.c, 133 wsh.h, 84

unset_branch_ﬂag wsh.c, 133 wsh.h, 84 unset_trace_ﬂag wsh.c, 133

wsh.h, 84 unsinglebranch wsh.c, 133 wsh.h, 84

unsinglestep wsh.c, 133 wsh.h, 84

unsystrace

wsh.c, 134 wsh.h, 85

untraceunaligned wsh.c, 134 wsh.h, 85

unverbosetrace wsh.c, 134 wsh.h, 85

usage wcc.c, 51 wsh.h, 85

value symbols_t, 29

verbose wsh.c, 134 wsh.h, 85

verbosetrace wsh.c, 134 wsh.h, 85

wcc.c _GNU_SOURCE, 40 __USE_GNU, 40 add_extra_symbols, 44 add_symaddr, 44 adjust_baseaddress, 44 alignfromname, 44 alloc_phdr, 44 allowed_sections, 51 analyze_text, 44 append_reloc, 44 append_strtab, 44 append_sym, 44 blnames, 51 CS_MODE, 40 check_global_import, 44 copy_body, 45 craft_section, 45 create_phdrs, 45 ctx_getopt, 45 ctx_init, 45

ctx_t, 43

DEFAULT_STRNDX_SIZE, 41 datavma, 51

deltastrtab, 51 desired_arch, 45 ELF_R_INFO, 41 ELF_R_SYM, 41 ELF_R_TYPE, 41 ELF_ST_BIND, 42 ELF_ST_TYPE, 42 ELFCLASS, 42 ELFMACHINE, 42 Elf_Addr, 41 Elf_Ehdr, 41 Elf_Off, 41 Elf_Phdr, 41 Elf_Rel, 41

The Witchcraft Compiler Collection

160	INDEX
Elf_Rela, 41	phdr_cmp_premerge, 48
Elf_Section, 41	print_bfd_sections, 48
Elf_Shdr, 41	print_maps, 48
Elf_Sword, 42	print_msec, 48
Elf_Sym, 42	print_version, 48
Elf_Word, 42	protect_perms, 48
Elf_Xword, 42	ptype_from_section, 48
elis, 42	RELOC_MODE, 43
entszfromname, 45	RELOC_X86_32, 43
FLAG_BSS, 42	RELOC_X86_64, 43
FLAG_NOBIT, 42	rd_sections, 49
FLAG_NOWRITE, 43	rd_symbols, 49
FLAG_TEXT, 43	rd_symtab, 49
ﬁxup_strtab_and_symtab, 45	reloc_htype, 49
ﬁxup_symtab_section_index, 45	reloc_htype_x86_32, 49
ﬁxup_text, 45	reloc_htype_x86_64, 49
ﬂags_from_name, 46	rm_section, 49
gimport_t, 43	save_dynstr, 49
gimports, 51	save_dynsym, 49
gimportslen, 51	save_global_import, 49
globalreloc, 51	save_reloc, 50
globalreloclen, 52	sec_name_from_index_after_strip, 50
globalrelocoffset, 52	secindex_from_name, 50
globalstrtab, 52	secindex_from_name_after_strip, 50
globalstrtablen, 52	section_from_addr, 50
globalstrtableoffset, 52	section_from_index, 50
globalsymindex, 52	section_from_name, 50
globalsymtab, 52	sort_phdrs, 50
globalsymtablen, 52	sort_phdrs_premerge, 50
globalsymtableoffset, 52	strip_binary_reloc, 50
hexdump, 46	symaddrs, 53
iﬁs, 43	textvma, 53
info_from_name, 46	typefromname, 51
internal_function_store, 46	usage, 51
libify, 46	wcc/wcc.c, 37
link_from_name, 47	weight
load_binary, 47	breakpoint_t, 5
MAXPADLEN, 43	what
main, 47	lua_Debug, 17
max, 47	wld.c
maxdata, 52	DEFAULT_NAME, 54
maxnewsec, 52	main, 54
maxoldsec, 52	mk_lib, 54
maxtext, 53	print_version, 54
merge_phdrs, 47	wld/wld.c, 53
mindata, 53	wsh
mintext, 53	wsh.c, 136
mk_section, 47	wshmain.c, 137
msec_t, 43	wsh.c
mseg_t, 43	_exit, 119
nullstr, 43	add_binary_preload, 119
open_best, 47	add_script_arguments, 119
open_target, 47	add_script_exec, 119
orig_sz, 53	add_symbol, 119
orig_text, 53	afﬁnity, 119
patch_symbol_index, 48	alarmhandler, 119
pﬂag_from_section, 48	alloccharbuf, 119
phdr_cmp, 48	bfmap, 120

The Witchcraft Compiler Collection

INDEX	161
breakpoint, 120	info, 124
bsspolute, 120	info_function, 124
btr_disable, 120	inthandler, 124
btr_enable, 120	learn_key_t, 119
bushandler, 120	learn_proto, 124
CS_MODE, 116	learn_t, 119
cmdhelp, 135	libcall, 124
completion, 120	loadbin, 125
declare_func, 120	loadlibrary, 125
declare_internals, 121	ltrace, 125
declare_num, 121	lua_strerror, 125
decode_ﬂags, 121	man, 125
decode_type, 121	map, 125
detailed_help, 121	mk_backtrace, 125
disable_aslr, 121	parse_dyn, 125
disable_core, 121	parse_link_map_dyn, 126
do_loadlib, 121	phdr_callback, 126
ELF_R_INFO, 117	phdr_cmp, 126
ELF_R_SYM, 117	phdrs, 126
ELF_R_TYPE, 117	print_backtrace, 126
ELF_ST_BIND, 117	print_eps, 126
ELF_ST_TYPE, 117	print_functions, 126
ELFCLASS, 118	print_libs, 126
ELFMACHINE, 118	print_objects, 126
Elf_Addr, 116	print_phdrs, 126
Elf_Ehdr, 117	print_procmap, 127
Elf_Off, 117	print_shdrs, 127
Elf_Phdr, 117	print_symbols, 127
Elf_Rel, 117	printarg, 127
Elf_Rela, 117	priv_memcpy, 127
Elf_Section, 117	priv_strcat, 127
Elf_Shdr, 117	priv_strcpy, 127
Elf_Sword, 118	procmap_lua, 127
Elf_Sym, 118	protorecords, 136
Elf_Word, 118	prototypes, 127
Elf_Xword, 118	ptoh, 128
empty_eps, 121	REG_RIP, 118
empty_phdrs, 122	RELOC_MODE, 118
empty_shdrs, 122	ralloc, 128
empty_symbols, 122	rawmemaddr, 128
enable_aslr, 122	rawmemread, 128
enable_core, 122	rawmemstr, 128
entry_point_add, 122	rawmemstrlen, 128
entrypoints, 122	rawmemusage, 128
execlib, 122	rawmemwrite, 128
exit, 122	rdnum, 128
exit_group, 122	rdstr, 129
fatal_error, 123	read_elf_sig, 129
fcnhelp, 135	reload_elfs, 129
gencore, 123	rescan, 129
getcharbuf, 123	restore_exit, 129
grep, 123	rtrace, 129
grepptr, 123	run_script, 129
headers, 123	run_shell, 129
help, 123	scan_section, 129
help_t, 119	scan_sections, 130
hexdump, 123	scan_symbol, 130
hollywood, 123	scan_syms, 130

The Witchcraft Compiler Collection

162

INDEX

script, 130 section_add, 130 section_from_addr, 130 segment_add, 130 segment_from_addr, 130 set_align_ﬂag, 131 set_alloc_opt, 131 set_branch_ﬂag, 131 set_sighandlers, 131 set_trace_ﬂag, 131 setcharbuf, 131 shdr_callback, 131 shdr_cmp, 131

shdrs, 131

sicode_strerror, 131 sicodetoname, 131 sighandler, 132 signaltoname, 132 singlebranch, 132 singlestep, 132 sort_learnt, 132 symbol_from_addr, 132 symbol_from_name, 132 symbol_tobind, 132 symbol_totype, 132 systrace, 132 test_stdin, 133 traceback, 133 traceunaligned, 133 traphandler, 133 unrtrace, 133 unset_align_ﬂag, 133 unset_branch_ﬂag, 133 unset_trace_ﬂag, 133 unsinglebranch, 133 unsinglestep, 133 unsystrace, 134 untraceunaligned, 134 unverbosetrace, 134 verbose, 134 verbosetrace, 134 wsh, 136 wsh_getopt, 134 wsh_init, 134 wsh_loadlibs, 134 wsh_print_version, 134 wsh_run, 134 wsh_usage, 134 xalloc, 135

xfree, 135 wsh.h

_GNU_SOURCE, 70 __progname_full, 86 add_symbol, 76 alloccharbuf, 76 BIND_FLAGS, 70 bfmap, 76 breakpoint, 76

breakpoint_t, 75 bsspolute, 77 cplus_demangle, 77 DEFAULT_LEARN_FILE, 70 DEFAULT_SCRIPT, 70 DMGL_ANSI, 70 DMGL_ARM, 70 DMGL_PARAMS, 70 default_poison, 70 disable_aslr, 77 disable_core, 77 do_loadlib, 77 ELF32_ST_BIND, 70 ELF32_ST_INFO, 70 ELF32_ST_TYPE, 70 ELF64_ST_BIND, 70 ELF64_ST_INFO, 71 ELF64_ST_TYPE, 71 Elf_Dyn, 71

Elf_Ehdr, 71

Elf_Phdr, 71

Elf_Shdr, 71

Elf_Sym, 71 empty_phdrs, 77 empty_shdrs, 77 enable_aslr, 77 enable_core, 77 entrypoints, 78 eps_t, 75 execlib, 78 FAULT_EXEC, 71 FAULT_READ, 71 FAULT_WRITE, 71 gencore, 78 getcharbuf, 78 getsize, 78

grep, 78 grepptr, 78 HPERMSMAX, 71 headers, 78 help, 78 hexdump, 78 hollywood, 79 info, 79 LINES_MAX, 71 libcall, 79 loadbin, 80 ltrace, 80 luaL_reg, 72 MAX_SIGNALS, 72 MIN_BIN_SIZE, 72 MY_CPU, 72 man, 80

map, 80 newarray, 80 PROC_ASLR_PATH, 72 phdrs, 80

preload_t, 75

The Witchcraft Compiler Collection

INDEX	163
print_functions, 80	singlebranch, 84
print_libs, 80	singlestep, 84
print_objects, 80	symbols_t, 76
print_phdrs, 80	systrace, 84
print_shdrs, 81	traceunaligned, 84
print_symbols, 81	tuple_t, 76
print_version, 81	USE_LUA, 75
priv_memcpy, 81	unrtrace, 84
priv_strcat, 81	unset_align_ﬂag, 84
priv_strcpy, 81	unset_branch_ﬂag, 84
procmap_lua, 81	unset_trace_ﬂag, 84
prototypes, 81	unsinglebranch, 84
ralloc, 81	unsinglestep, 84
range_t, 75	unsystrace, 85
rawmemaddr, 82	untraceunaligned, 85
rawmemread, 82	unverbosetrace, 85
rawmemstr, 82	usage, 85
rawmemstrlen, 82	verbose, 85
rawmemusage, 82	verbosetrace, 85
rawmemwrite, 82	wsh_getopt, 85
rdnum, 82	wsh_init, 85
rdstr, 82	wsh_loadlibs, 85
read_arg, 72	wsh_run, 85
read_arg1, 72	wsh_t, 76
read_arg2, 73	xalloc, 85
read_arg3, 73	xfree, 86
read_arg4, 73	wsh/helper.c, 54
reload_elfs, 83	wsh/include/colors.h, 56
rescan, 83	wsh/include/lauxlib.h, 57
rtrace, 83	wsh/include/libwitch/helper.h, 63
SHELL_HISTORY_NAME, 74	wsh/include/libwitch/mylaux.h, 63
SKIP_BOTTOM, 74	wsh/include/libwitch/sigs.h, 65
SKIP_INIT, 74	wsh/include/libwitch/wsh.h, 66
STB_GLOBAL, 74	wsh/include/libwitch/wsh_functions.h, 86
STB_GNU_SECONDARY, 74	wsh/include/linenoise.h, 87
STB_GNU_UNIQUE, 74	wsh/include/longjmp.h, 88
STB_LOCAL, 74	wsh/include/lua.h, 89
STB_WEAK, 74	wsh/include/luaconf.h, 105
STT_COMMON, 75	wsh/include/lualib.h, 111
STT_FILE, 75	wsh/wsh.c, 113
STT_FUNC, 75	wsh/wshmain.c, 137
STT_NOTYPE, 75	wsh_functions.h
STT_OBJECT, 75	default_options, 86
STT_SECTION, 75	exposed, 86
STT_TLS, 75	global_xalloc, 86
script, 83	lua_blacklist, 86
script_t, 76	lua_default_functions, 87
sections_t, 76	ranges, 87
segment_add, 83	wsh_getopt
segments_t, 76	wsh.c, 134
set_align_ﬂag, 83	wsh.h, 85
set_branch_ﬂag, 83	wsh_init
set_trace_ﬂag, 83	wsh.c, 134
setarray, 83	wsh.h, 85
setcharbuf, 83	wsh_loadlibs
shdrs, 83	wsh.c, 134
sicode_strerror, 84	wsh.h, 85
signaltoname, 84	wsh_print_version

The Witchcraft Compiler Collection

164

INDEX

wsh.c, 134 wsh_run

wsh.c, 134 wsh.h, 85

wsh_t, 30 bp_array, 31 bp_num, 31 bp_points, 31 btcaller, 31 eps, 31 errcontext, 31 faultaddr, 31 ﬁrstcontext, 32 ﬁrsterrno, 32 ﬁrstsicode, 32 ﬁrstsignal, 32 globalsignals, 32 interrupted, 32 is_stdinscript, 32 L, 32 learnﬁle, 32 learnlog, 32 longjmp_ptr, 32 longjmp_ptr_high, 32 longjmp_ptr_high_cnt, 33 mainhandle, 33 opt_argc, 33 opt_argv, 33 opt_hollywood, 33 opt_rescan, 33 opt_verbose, 33 opt_verbosetrace, 33 phdrs, 33

pltgot, 33 pltsz, 33 preload, 33 reason, 34 script_argnum, 34 script_args, 34 scriptﬁle, 34 scriptname, 34 scripts, 34 shdrs, 34 sigbus_count, 34 sigbus_hash, 34 singlebranch_count, 34 singlebranch_hash, 34 singlestep_count, 34 singlestep_hash, 35 symbols, 35 totsignals, 35 trace_rtrace, 35 trace_singlebranch, 35 trace_singlestep, 35 trace_strace, 35 trace_unaligned, 35 wsh.h, 76

wsh_usage

wsh.c, 134 wshmain.c

main, 137 wsh, 137

xalloc

wsh.c, 135 wsh.h, 85

xfree

wsh.c, 135 wsh.h, 86

YELLOW colors.h, 57

zﬁrst

helper.c, 55 helper.h, 63

The Witchcraft Compiler Collection