ext/include/fault_mitigation.h

26  * while the protected function or one of the ftmn_*() functions are
45  *	this by relying on the called function to update a state in
46  *	struct ftmn_func_arg which is checked when the function has returned.
62  * While a function is executed it can update its state as a way of keeping
63  * track of important passages inside the function. When the function
76  * struct ftmn_func_arg - track a called function
80  * When the call of a function is tracked @hash is initialized to hash of
81  * caller xored with hash of called function. Before the called function
83  * restore @hash to the hash of the calling function. This allows the
84  * calling function to confirm that the correct function has been called.
94  * @arg:	argument for the next called tracked function
95  * @saved_arg:	pointer to an optional argument passed to this function
97  * @my_hash:	the hash of the calling function
98  * @called_hash:the hash of the called function
101  * struct ftmn_func_arg passed to this function is saved in @saved_arg
140  * FTMN_PANIC() - FTMN specific panic function
142  * This function is called whenever the FTMN function detects an
391  * FTMN_FUNC_HASH() - "hash" a function name
393  * Function names are "hashed" into an unsigned long. The "hashing" is done
394  * by xoring each 32/64 bit word of the function name producing a bit
395  * pattern that should be mostly unique for each function. Only the first
405  * @called_func_hash:	The hash of the called function
423  * This macro is called just after a checked linked function has returned.
424  * The return value from the function is copied from the struct ftmn_func_arg
425  * passed to the called function into the local checked state. The checked
427  * of the called function.
441  * FTMN_CALL_FUNC() - Do a linked call to a function
442  * @res:	Variable to be assigned the result of the called function
445  * @func:	Function to be called
448  * This macro can be used to make a linked call to another function, the
470  * supplied by the caller. This function must only be called once by the
473  * Note that this function is somewhat dangerous as any passed value will
485  * supplied by the caller. This function must only be called once by the
488  * Note that this function is somewhat dangerous as any passed value will
506  * supplied by the caller. This function must only be called once by the
519  * @my_memcmp:		Function pointer of custom memcmp()
525  * This function must only be called once by the callee.
538  * supplied by the caller. This function can be called any number of times
542  * Note that this function is somewhat dangerous as any passed value will
555  * This macro replaces the old expected function hash with the hash of the
556  * current function.
558  * If a function is called using an alias the caller uses the hash of the
559  * alias not the real function name. This hash is recoded in the field
563  * The FTMN_CALLE_* functions only work with the real function name so the
565  * function to be able to verify the result.
577  * Note that this function is somewhat dangerous as any passed value will
591  * Note that this function is somewhat dangerous as any passed value will
631  * can be checked at a later point in the calling function, for instance
640 		 * in the calling function.  in ftmn_checkpoint()