runwhenidle/main.c

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <signal.h>
#include <time.h>
#include <errno.h>
#include <sys/wait.h>
#include <X11/extensions/scrnsaver.h>
#include <getopt.h>

#include "sleep_utils.h"
#include "time_utils.h"

int verbose;
int quiet;

void handle_kill_error(char *signal_name, pid_t pid) {
    const char *reason;
    if (errno == EPERM) {
        reason = "Operation not permitted";
    } else if (errno == EINVAL) {
        reason = "Invalid signal number";
    } else if (errno == ESRCH) {
        reason = "No such process";
    }

    printf("Failed to send %s signal to PID %i: %s\n", signal_name, pid, reason);
}

void pause_command(pid_t pid) {
    if (!quiet) {
        printf("User activity is detected, pausing PID %i\n", pid);
    }
    if (kill(pid, SIGTSTP) == -1) {
        handle_kill_error("SIGCONT", pid);
        exit(1);
    }
}

void resume_command(pid_t pid) {
    if (!quiet) {
        printf("Lack of user activity is detected, resuming PID %i\n", pid);
    }
    if (kill(pid, SIGCONT) == -1) {
        handle_kill_error("SIGCONT", pid);
        exit(1);
    }
}

void print_usage(char *binary_name) {
    printf("Usage: %s [--timeout|-t timeout_value_in_seconds] [--verbose|-v] [--quiet|-q] shell_command_to_run\n",
           binary_name);
}

pid_t run_shell_command(const char *shell_command_to_run, pid_t pid) {
    if (verbose) {
        printf("Starting \"%s\"\n", shell_command_to_run);
    }
    pid = fork();
    if (pid < 0) {
        perror("fork");
        exit(1);
    } else if (pid == 0) {
        // Child process
        execl("/bin/sh", "sh", "-c", shell_command_to_run, (char *) NULL);
        perror("execl");
        exit(1);
    }
    if (!quiet) {
        printf("Started \"%s\" with PID %i\n", shell_command_to_run, pid);
    }
    return pid;
}

void exit_if_pid_has_finished(pid_t pid) {
    int status;
    if (waitpid(pid, &status, WNOHANG + WUNTRACED) == pid && WIFEXITED(status)) {
        int exit_code = WEXITSTATUS(status);
        if (verbose) {
            fprintf(stderr, "PID %i has finished with exit code %u\n", pid, exit_code);
        }
        exit(exit_code);
    }
}

int main(int argc, char *argv[]) {
    pid_t pid;
    int user_idle_timeout_ms = 300000;

    // Define command line options
    struct option long_options[] = {
            {"timeout", required_argument, NULL, 't'},
            {"verbose", no_argument,       NULL, 'v'},
            {"quiet",   no_argument,       NULL, 'q'},
            {"help",    no_argument,       NULL, 'h'},
            {NULL,      0,                 NULL, 0}
    };

    // Parse command line options
    int option;
    while ((option = getopt_long(argc, argv, "hvqt:", long_options, NULL)) != -1) {
        switch (option) {
            case 't':
                user_idle_timeout_ms = atoi(optarg) * 1000;
                break;
            case 'v':
                verbose = 1;
                break;
            case 'q':
                quiet = 1;
                break;
            case 'h':
            default:
                print_usage(argv[0]);
                return 1;
        }
    }
    if (optind >= argc) {
        print_usage(argv[0]);
        return 1;
    }
    if (quiet && verbose) {
        printf("Incompatible options --quiet|-q and --verbose|-v used");
        print_usage(argv[0]);
        return 1;
    }

    //Open display and initialize XScreensaverInfo for querying idle time
    Display *dpy = XOpenDisplay(NULL);
    if (!dpy) {
        fprintf(stderr, "Couldn't open an X11 display!\n");
        return 1;
    }
    XScreenSaverInfo *info = XScreenSaverAllocInfo();

    pid = run_shell_command(argv[optind], pid);

    // Let command run for 300ms to give it a chance to error-out or provide initial output.
    // 300ms is chosen to avoid giving user a noticeable delay while giving most quick commands a chance to finish.
    sleep_for_milliseconds(300);

    int polling_interval_ms = 1000;
    int sleep_time_ms = polling_interval_ms;
    int command_paused = 0;

    // Monitor user activity
    while (1) {
        XScreenSaverQueryInfo(dpy, DefaultRootWindow(dpy), info);

        // Checking this after querying the screensaver timer so that the command is still running while
        // we're querying the screensaver and has a chance to do some work and finish,
        // but before potentially pausing the command to avoid trying to pause it if it completed.
        exit_if_pid_has_finished(pid);

        if (info->idle >= user_idle_timeout_ms) {
            // User is inactive
            if (command_paused) {
                sleep_time_ms = polling_interval_ms; //reset to default value
                if (verbose) {
                    fprintf(stderr, "Idle time: %lums\n", info->idle);
                }

                resume_command(pid);
                command_paused = 0;
            }
        } else {
            struct timespec time_when_starting_to_pause;
            int command_was_paused_this_iteration = 0;
            // User is active
            if (!command_paused) {
                clock_gettime(CLOCK_MONOTONIC, &time_when_starting_to_pause);
                if (verbose) {
                    fprintf(stderr, "Idle time: %lums\n", info->idle);
                }
                pause_command(pid);
                command_paused = 1;
                command_was_paused_this_iteration = 1;
            }
            sleep_time_ms = user_idle_timeout_ms - info->idle;

            if (command_was_paused_this_iteration) {
                struct timespec time_before_sleep;
                clock_gettime(CLOCK_MONOTONIC, &time_before_sleep);
                long long pausing_time_ms = get_elapsed_time_ms(time_when_starting_to_pause, time_before_sleep);
                sleep_time_ms = sleep_time_ms - pausing_time_ms;
            }

            if (sleep_time_ms < polling_interval_ms) {
                sleep_time_ms = polling_interval_ms;
            }
            if (verbose) {
                fprintf(stderr,
                        "Polling every second is temporarily disabled due to user activity, idle time: %lums, next activity check scheduled in %ums\n",
                        info->idle,
                        sleep_time_ms
                );
            }
        }
        sleep_for_milliseconds(sleep_time_ms);
    }
}