fault.h

Go to the documentation of this file.

#ifndef _IPXE_FAULT_H
#define _IPXE_FAULT_H

/** @file
 *
 * Fault injection
 *
 */

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
FILE_SECBOOT ( PERMITTED );

#include <stdint.h>
#include <config/fault.h>

extern int inject_fault_nonzero ( unsigned int rate );
extern void inject_corruption_nonzero ( unsigned int rate, const void *data,
                                        size_t len );

/**
 * Inject fault with a specified probability
 *
 * @v rate              Reciprocal of fault probability (zero for no faults)
 * @ret rc              Return status code
 */
static inline __attribute__ (( always_inline )) int
inject_fault ( unsigned int rate ) {

        /* Force dead code elimination in non-fault-injecting builds */
        if ( rate == 0 )
                return 0;

        return inject_fault_nonzero ( rate );
}

/**
 * Corrupt data with a specified probability
 *
 * @v rate              Reciprocal of fault probability (zero for no faults)
 * @v data              Data
 * @v len               Length of data
 * @ret rc              Return status code
 */
static inline __attribute__ (( always_inline )) void
inject_corruption ( unsigned int rate, const void *data, size_t len ) {

        /* Force dead code elimination in non-fault-injecting builds */
        if ( rate == 0 )
                return;

        return inject_corruption_nonzero ( rate, data, len );
}

#endif /* _IPXE_FAULT_H */