diff options
| -rw-r--r-- | HOWTO | 25 | ||||
| -rw-r--r-- | Makefile | 1 | ||||
| -rw-r--r-- | engines/exec.c | 361 | ||||
| -rw-r--r-- | examples/exec.fio | 36 | ||||
| -rw-r--r-- | fio.1 | 28 | ||||
| -rw-r--r-- | os/os-windows.h | 1 |
6 files changed, 452 insertions, 0 deletions
@@ -2109,6 +2109,9 @@ I/O engine achieving higher concurrency and thus throughput than is possible via kernel NFS. + **exec** + Execute 3rd party tools. Could be used to perform monitoring during jobs runtime. + I/O engine specific parameters ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -2536,6 +2539,28 @@ with the caveat that when used on the command line, they must come after the URL in libnfs format, eg nfs://<server|ipv4|ipv6>/path[?arg=val[&arg=val]*] Refer to the libnfs README for more details. +.. option:: program=str : [exec] + + Specify the program to execute. + +.. option:: arguments=str : [exec] + + Specify arguments to pass to program. + Some special variables can be expanded to pass fio's job details to the program. + + **%r** + Replaced by the duration of the job in seconds. + **%n** + Replaced by the name of the job. + +.. option:: grace_time=int : [exec] + + Specify the time between the SIGTERM and SIGKILL signals. Default is 1 second. + +.. option:: std_redirect=boot : [exec] + + If set, stdout and stderr streams are redirected to files named from the job name. Default is true. + I/O depth ~~~~~~~~~ @@ -57,6 +57,7 @@ SOURCE := $(sort $(patsubst $(SRCDIR)/%,%,$(wildcard $(SRCDIR)/crc/*.c)) \ smalloc.c filehash.c profile.c debug.c engines/cpu.c \ engines/mmap.c engines/sync.c engines/null.c engines/net.c \ engines/ftruncate.c engines/filecreate.c engines/filestat.c engines/filedelete.c \ + engines/exec.c \ server.c client.c iolog.c backend.c libfio.c flow.c cconv.c \ gettime-thread.c helpers.c json.c idletime.c td_error.c \ profiles/tiobench.c profiles/act.c io_u_queue.c filelock.c \ diff --git a/engines/exec.c b/engines/exec.c new file mode 100644 index 00000000..e1cc0b83 --- /dev/null +++ b/engines/exec.c @@ -0,0 +1,361 @@ +/* + * Exec engine + * + * Doesn't transfer any data, merely run 3rd party tools + * + */ +#include "../fio.h" +#include "../optgroup.h" +#include <signal.h> + +struct exec_options { + void *pad; + char *program; + char *arguments; + int grace_time; + unsigned int std_redirect; + pid_t pid; +}; + +static struct fio_option options[] = { + { + .name = "program", + .lname = "Program", + .type = FIO_OPT_STR_STORE, + .off1 = offsetof(struct exec_options, program), + .help = "Program to execute", + .category = FIO_OPT_C_ENGINE, + .group = FIO_OPT_G_INVALID, + }, + { + .name = "arguments", + .lname = "Arguments", + .type = FIO_OPT_STR_STORE, + .off1 = offsetof(struct exec_options, arguments), + .help = "Arguments to pass", + .category = FIO_OPT_C_ENGINE, + .group = FIO_OPT_G_INVALID, + }, + { + .name = "grace_time", + .lname = "Grace time", + .type = FIO_OPT_INT, + .minval = 0, + .def = "1", + .off1 = offsetof(struct exec_options, grace_time), + .help = "Grace time before sending a SIGKILL", + .category = FIO_OPT_C_ENGINE, + .group = FIO_OPT_G_INVALID, + }, + { + .name = "std_redirect", + .lname = "Std redirect", + .type = FIO_OPT_BOOL, + .def = "1", + .off1 = offsetof(struct exec_options, std_redirect), + .help = "Redirect stdout & stderr to files", + .category = FIO_OPT_C_ENGINE, + .group = FIO_OPT_G_INVALID, + }, + { + .name = NULL, + }, +}; + +char *str_replace(char *orig, const char *rep, const char *with) +{ + /* + Replace a substring by another. + + Returns the new string if occurences were found + Returns orig if no occurence is found + */ + char *result, *insert, *tmp; + int len_rep, len_with, len_front, count; + + // sanity checks and initialization + if (!orig || !rep) + return orig; + + len_rep = strlen(rep); + if (len_rep == 0) + return orig; + + if (!with) + with = ""; + len_with = strlen(with); + + insert = orig; + for (count = 0; (tmp = strstr(insert, rep)); ++count) { + insert = tmp + len_rep; + } + + tmp = result = malloc(strlen(orig) + (len_with - len_rep) * count + 1); + + if (!result) + return orig; + + while (count--) { + insert = strstr(orig, rep); + len_front = insert - orig; + tmp = strncpy(tmp, orig, len_front) + len_front; + tmp = strcpy(tmp, with) + len_with; + orig += len_front + len_rep; + } + strcpy(tmp, orig); + return result; +} + +char *expand_variables(struct thread_options *o, char *arguments) +{ + char str[16]; + char *expanded_runtime, *expanded_name; + snprintf(str, sizeof(str), "%lld", o->timeout / 1000000); + + /* %r is replaced by the runtime in seconds */ + expanded_runtime = str_replace(arguments, "%r", str); + + /* %n is replaced by the name of the running job */ + expanded_name = str_replace(expanded_runtime, "%n", o->name); + + return expanded_name; +} + +static int exec_background(struct thread_options *o, struct exec_options *eo) +{ + char *outfilename = NULL, *errfilename = NULL; + int outfd = 0, errfd = 0; + pid_t pid; + char *expanded_arguments = NULL; + /* For the arguments splitting */ + char **arguments_array = NULL; + char *p; + char *exec_cmd = NULL; + size_t arguments_nb_items = 0, q; + + if (asprintf(&outfilename, "%s.stdout", o->name) < 0) + return -1; + + if (asprintf(&errfilename, "%s.stderr", o->name) < 0) { + free(outfilename); + return -1; + } + + /* If we have variables in the arguments, let's expand them */ + expanded_arguments = expand_variables(o, eo->arguments); + + if (eo->std_redirect) { + log_info("%s : Saving output of %s %s : stdout=%s stderr=%s\n", + o->name, eo->program, expanded_arguments, outfilename, + errfilename); + + /* Creating the stderr & stdout output files */ + outfd = open(outfilename, O_CREAT | O_WRONLY | O_TRUNC, 0644); + if (!outfd) { + log_err("fio: cannot open output file %s : %s\n", + outfilename, strerror(errno)); + free(outfilename); + free(errfilename); + return -1; + } + + errfd = open(errfilename, O_CREAT | O_WRONLY | O_TRUNC, 0644); + if (!errfd) { + log_err("fio: cannot open output file %s : %s\n", + errfilename, strerror(errno)); + free(outfilename); + free(errfilename); + return -1; + } + } else { + log_info("%s : Running %s %s\n", + o->name, eo->program, expanded_arguments); + } + + pid = fork(); + + /* We are on the control thread (parent side of the fork */ + if (pid > 0) { + eo->pid = pid; + if (eo->std_redirect) { + /* The output file is for the client side of the fork */ + close(outfd); + close(errfd); + free(outfilename); + free(errfilename); + } + return 0; + } + + /* If the fork failed */ + if (pid < 0) { + log_err("fio: forking failed %s \n", strerror(errno)); + if (eo->std_redirect) { + close(outfd); + close(errfd); + free(outfilename); + free(errfilename); + } + return -1; + } + + /* We are in the worker (child side of the fork) */ + if (pid == 0) { + if (eo->std_redirect) { + dup2(outfd, 1); // replace stdout by the output file we create + dup2(errfd, 2); // replace stderr by the output file we create + close(outfd); + close(errfd); + free(outfilename); + free(errfilename); + } + + /* Let's split the command line into a null terminated array to be passed to the exec'd program + But don't asprintf expanded_arguments if NULL as it would be converted + to a '(null)' argument, while we want no arguments at all. */ + if (expanded_arguments != NULL) { + if (asprintf(&exec_cmd, "%s %s", eo->program, expanded_arguments) < 0) + return -1; + } else { + if (asprintf(&exec_cmd, "%s", eo->program) < 0) + return -1; + } + + /* Let's build an argv array to based on the program name and arguments */ + p = exec_cmd; + for (;;) { + p += strspn(p, " "); + + if (!(q = strcspn(p, " "))) + break; + + if (q) { + arguments_array = + realloc(arguments_array, + (arguments_nb_items + + 1) * sizeof(char *)); + arguments_array[arguments_nb_items] = + malloc(q + 1); + strncpy(arguments_array[arguments_nb_items], p, + q); + arguments_array[arguments_nb_items][q] = 0; + arguments_nb_items++; + p += q; + } + } + + /* Adding a null-terminated item to close the list */ + arguments_array = + realloc(arguments_array, + (arguments_nb_items + 1) * sizeof(char *)); + arguments_array[arguments_nb_items] = NULL; + + /* Replace the fio program from the child fork by the target program */ + execvp(arguments_array[0], arguments_array); + } + // We never reach this place + return 0; +} + +static enum fio_q_status +fio_exec_queue(struct thread_data *td, struct io_u fio_unused * io_u) +{ + struct thread_options *o = &td->o; + struct exec_options *eo = td->eo; + + /* Let's execute the program the first time we get queued */ + if (eo->pid == -1) { + exec_background(o, eo); + } else { + /* The program is running in background, let's check on a regular basis + if the time is over and if we need to stop the tool */ + usleep(o->thinktime); + if (utime_since_now(&td->start) > o->timeout) { + /* Let's stop the child */ + kill(eo->pid, SIGTERM); + /* Let's give grace_time (1 sec by default) to the 3rd party tool to stop */ + sleep(eo->grace_time); + } + } + + return FIO_Q_COMPLETED; +} + +static int fio_exec_init(struct thread_data *td) +{ + struct thread_options *o = &td->o; + struct exec_options *eo = td->eo; + int td_previous_state; + + eo->pid = -1; + + if (!eo->program) { + td_vmsg(td, EINVAL, + "no program is defined, it is mandatory to define one", + "exec"); + return 1; + } + + log_info("%s : program=%s, arguments=%s\n", + td->o.name, eo->program, eo->arguments); + + /* Saving the current thread state */ + td_previous_state = td->runstate; + + /* Reporting that we are preparing the engine + * This is useful as the qsort() calibration takes time + * This prevents the job from starting before init is completed + */ + td_set_runstate(td, TD_SETTING_UP); + + /* + * set thinktime_sleep and thinktime_spin appropriately + */ + o->thinktime_blocks = 1; + o->thinktime_blocks_type = THINKTIME_BLOCKS_TYPE_COMPLETE; + o->thinktime_spin = 0; + o->thinktime = 50000; /* 50ms pause when waiting for the program to complete */ + + o->nr_files = o->open_files = 1; + + /* Let's restore the previous state. */ + td_set_runstate(td, td_previous_state); + return 0; +} + +static void fio_exec_cleanup(struct thread_data *td) +{ + struct exec_options *eo = td->eo; + /* Send a sigkill to ensure the job is well terminated */ + if (eo->pid > 0) + kill(eo->pid, SIGKILL); +} + +static int +fio_exec_open(struct thread_data fio_unused * td, + struct fio_file fio_unused * f) +{ + return 0; +} + +static struct ioengine_ops ioengine = { + .name = "exec", + .version = FIO_IOOPS_VERSION, + .queue = fio_exec_queue, + .init = fio_exec_init, + .cleanup = fio_exec_cleanup, + .open_file = fio_exec_open, + .flags = FIO_SYNCIO | FIO_DISKLESSIO | FIO_NOIO, + .options = options, + .option_struct_size = sizeof(struct exec_options), +}; + +static void fio_init fio_exec_register(void) +{ + register_ioengine(&ioengine); +} + +static void fio_exit fio_exec_unregister(void) +{ + unregister_ioengine(&ioengine); +} diff --git a/examples/exec.fio b/examples/exec.fio new file mode 100644 index 00000000..ac1bedfb --- /dev/null +++ b/examples/exec.fio @@ -0,0 +1,36 @@ +[global] +time_based +runtime=30 + +[monitoring_noop] +ioengine=exec +program=/usr/sbin/turbostat +arguments=-c package -qS --interval 5 -s Busy%,Bzy_MHz,Avg_MHz,CorWatt,PkgWatt,RAMWatt,PkgTmp + +[cpuload_noop] +ioengine=cpuio +cpuload=100 +numjobs=12 +cpumode=noop + +[sleep] +# Let the processor cooling down for a few seconds +stonewall +ioengine=exec +runtime=10 +program=/bin/sleep +arguments=%r +grace_time=0 +std_redirect=0 + +[monitoring_qsort] +stonewall +ioengine=exec +program=/usr/sbin/turbostat +arguments=-c package -qS --interval 5 -s Busy%,Bzy_MHz,Avg_MHz,CorWatt,PkgWatt,RAMWatt,PkgTmp + +[cpuload_qsort] +ioengine=cpuio +cpuload=100 +numjobs=12 +cpumode=qsort @@ -1912,6 +1912,9 @@ I/O engine supporting asynchronous read and write operations to NFS filesystems from userspace via libnfs. This is useful for achieving higher concurrency and thus throughput than is possible via kernel NFS. +.TP +.B exec +Execute 3rd party tools. Could be used to perform monitoring during jobs runtime. .SS "I/O engine specific parameters" In addition, there are some parameters which are only valid when a specific \fBioengine\fR is in use. These are used identically to normal parameters, @@ -2298,6 +2301,31 @@ Use DAOS container's object class by default. .BI (nfs)nfs_url URL in libnfs format, eg nfs://<server|ipv4|ipv6>/path[?arg=val[&arg=val]*] Refer to the libnfs README for more details. +.TP +.BI (exec)program\fR=\fPstr +Specify the program to execute. +Note the program will receive a SIGTERM when the job is reaching the time limit. +A SIGKILL is sent once the job is over. The delay between the two signals is defined by \fBgrace_time\fR option. +.TP +.BI (exec)arguments\fR=\fPstr +Specify arguments to pass to program. +Some special variables can be expanded to pass fio's job details to the program : +.RS +.RS +.TP +.B %r +replaced by the duration of the job in seconds +.TP +.BI %n +replaced by the name of the job +.RE +.RE +.TP +.BI (exec)grace_time\fR=\fPint +Defines the time between the SIGTERM and SIGKILL signals. Default is 1 second. +.TP +.BI (exec)std_redirect\fR=\fbool +If set, stdout and stderr streams are redirected to files named from the job name. Default is true. .SS "I/O depth" .TP .BI iodepth \fR=\fPint diff --git a/os/os-windows.h b/os/os-windows.h index ddfae413..59da9dba 100644 --- a/os/os-windows.h +++ b/os/os-windows.h @@ -77,6 +77,7 @@ #define SIGCONT 0 #define SIGUSR1 1 #define SIGUSR2 2 +#define SIGKILL 15 /* SIGKILL doesn't exists, let's use SIGTERM */ typedef int sigset_t; typedef int siginfo_t; |