Simulate Time Faults

This document describes how to use Chaosd to simulate a time offset scenario. You can create experiments either in command-line mode or service mode.

Parameters for simulating time faults

Configuration item	Abbreviation	Service mode field	Description	Type	Value
time-offset	—	time-offset	Specifies the length of time offset.	string	string type, such as -5m. Required.
clock-ids-slice	—	clock-ids-slice	Specifies the ID of the clock that will be offset. Multiple clock IDs should be separated by a comma. See the clock_gettime documentation for details.	string	string type. The default value is "CLOCK_REALTIME".
pid	—	pid	The identifier of the process.	int	int type. Required.

Simulate time faults using the command-line mode

Before creating an experiment, you can run the following command to check the options of time faults:

chaosd attack clock -h

Quick Example

Prepare test program:

cat > time.c << EOF
#include <stdio.h>
#include <time.h>
#include <unistd.h>
#include <sys/types.h>

int main() {
    printf("PID : %ld\n", (long)getpid());
    struct  timespec ts;
    for(;;) {
        clock_gettime(CLOCK_REALTIME, &ts);
        printf("Time : %lld.%.9ld\n", (long long)ts.tv_sec, ts.tv_nsec);
        sleep(10);
    }
}
EOF

gcc -o get_time ./time.c

Then execute get_time and try to attack it. The following is an example:

chaosd attack clock -p $PID -t 11s

Simulate time faults using the service mode

Run the test program in Quick Example, and then use the following command to create a time fault experiment:

curl -X POST 172.16.112.130:31767/api/attack/clock -H "Content-Type:application/json" -d '{"pid":123, "time-offset":"11s"}'