Skip to content

m1lkweed/handy-headers

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

77 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Handy Headers

GCC is required for all headers

try/except blocks in C

Works with actual signals

int main(){
	int e;
	try{ //brackets optional
		__asm("ud2");
	}except(e){ //e is an optional argument, must be a modifiable lvalue if used
		printf("Caught a %d: %s\n", e, strsignal(e));
	}
}

throw(code): throws an exception without raising a signal, so it should be faster than raise(). Both will work for custom handlers automatically. SIGINT and some other signals are intentionally not caught, though they can be manually handled by adding the following:

void my_handler(int signum){
	if(except_handler.frame) //global
		longjmp(*except_handler.frame, signum); //siglongjmp also works
	exit(1);
}
...
signal(SIGINT, my_handler); //sigaction is preferred

Signal handlers are never overwritten unless they are SIG_DFL.

Hotpatching:

Redefining functions at runtime

patchable void foo(void){ //patchable is required
	puts("foo");
}

void bar(void){
	puts("bar");
}

int main(){
	foo(); //prints foo
	hotpatch(foo, bar);
	foo(); //prints bar
	hotpatch(foo, NULL);
	foo(); //prints foo, NULL resets the patch
}

hotpatch(target, replacement) replaces all calls to target with calls to replacement.

is_patchable(function) returns true if function can safely be patched.

is_patched(function) will return the address of the replacing function if function is patched, else NULL.

original_function(function) returns a callable pointer to the original code of a patched function.

Safety

Unless ALLOW_UNSAFE_HOTPATCH is defined, all calls to hotpatch() will ensure that target is patchable and that replacement and target have identical signatures.

Closures:

closeable int close_me(int a){ //'closeable' required on systems that do not use the SYSV ABI by default
	static int b = 0;
	return b += a;
}

int main(){
	int (*closure)(void) = closure_create(close_me, 1, 5); //increment by 5 each call
	for(int i = 0; i < 10; ++i)
		printf("%d\n", closure());
	closure_destroy(closure); //optional
}

Floats and variadics are not supported, closeable functions take advantage of the System V ABI.

closure_create(function, nargs, data) creates a closure around function, which has nargs arguments (max. 6). data can be any type but should match the final parameter of function.

Lambdas:

int(*foo)(int) = lambda(int, (int a), {printf("%d\n", a); return 5;});
foo(3); //prints 3

lambdas are functions that don't have a name. They are well-suited for replacing a patchable function (only with optimization flags) and can be turned into a closure. Note that trying to read or modify non-static local variables from the parent function is UB and will cause the stack to be marked as executable.