mbedtls-framework/tests/src/fork_helpers.c

/** \file fork_helpers.c
 *
 * \brief Helper functions for testing with subprocesses.
 */

/*
 *  Copyright The Mbed TLS Contributors
 *  SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later
 */

#include "test_common.h"
#include <test/helpers.h>
#include <test/macros.h>

#if defined(MBEDTLS_PLATFORM_IS_UNIXLIKE)

#include <test/fork_helpers.h>

#include <stdio.h>
#include <unistd.h>
#include <sys/wait.h>

/** Child exit code for mbedtls_test_fork_run_child().
 */
typedef enum {
    /** Reporting of the child output or the child test result through
     * the pipe succeeded.
     *
     * The content sent on the pipe has the following format:
     * - [1 byte] #mbedtls_test_result_t \c test_result
     * - Case \c test_result:
     *     - If \c test_result == #MBEDTLS_TEST_RESULT_SUCCESS:
     *       the output from the child body function.
     *     - Otherwise:
     *       the child failure (or skip) information, a direct write of
     *       a #mbedtls_test_result_t structure.
     */
    CHILD_EXIT_CODE_OK = 0,
    /** Something went wrong, e.g. a write error on the pipe. */
    CHILD_EXIT_CODE_REPORTING_FAILED = 122,
} child_exit_code_t;

#if defined(__GNUC__)
__attribute__((__noreturn__))
#endif
static void run_child(
    int write_fd,
    mbedtls_test_fork_child_callback_t *child_callback,
    void *param,
    unsigned char *buf, size_t size)
{
    /* If something goes wrong while trying to report what happened
     * in the child, exit with a nonzero status. */
    int child_exit_code = CHILD_EXIT_CODE_REPORTING_FAILED;
    /* We'll use stdio to write to the pipe, so we don't have to
     * manage EINTR and such. */
    FILE *file = fdopen(write_fd, "a");
    size_t length = 0;

    TEST_ASSERT_ERRNO(file != NULL);

    child_callback(param, buf, size, &length);

    char result_char = mbedtls_test_get_result();
    TEST_ASSERT(fputc(result_char, file) != EOF);

exit:
    if (mbedtls_test_get_result() == MBEDTLS_TEST_RESULT_SUCCESS) {
        if (fwrite(buf, length, 1, file) != 1) {
            goto write_done;
        }
    } else {
        mbedtls_test_info_t test_info;
        mbedtls_test_info_save(&test_info);
        if (fwrite(&test_info, sizeof(test_info), 1, file) != 1) {
            goto write_done;
        }
    }
    if (fflush(file) != 0) {
        goto write_done;
    }
    child_exit_code = CHILD_EXIT_CODE_OK;

write_done:
    _exit(child_exit_code);
}

int mbedtls_test_fork_run_child(
    mbedtls_test_fork_child_callback_t *child_callback,
    void *param,
    unsigned char *child_output, size_t child_output_size,
    size_t *child_output_length)
{
    *child_output_length = 0;

    int ret = -1;
    pid_t pid = -1;
    int pipe_fd[2] = { -1, -1 };

    /* Set up a pipe. The child will write to pipe_fd[1], and the
     * parent will read from pipe_fd[0]. */
    TEST_ASSERT_ERRNO(pipe(pipe_fd) != -1);

    pid = fork();
    TEST_ASSERT_ERRNO(pid != -1);

    if (pid == 0) {
        /* The child code */
        close(pipe_fd[0]);
        run_child(pipe_fd[1], child_callback, param,
                  child_output, child_output_size);
        /* Unreachable */
    }
    /* Beyond this point, we're in the parent (original) process. */

    close(pipe_fd[1]);
    pipe_fd[1] = -1;

    unsigned char result_char;
    struct {
        mbedtls_test_info_t child_test_info;
        unsigned char excess;
    } reading_on_failure;
    /* Normally, the child should give us a 1-byte result, then either
     * the child body's output or a test info. */
    ssize_t n = read(pipe_fd[0], &result_char, 1);
    TEST_EQUAL(n, 1);

    /* Tentatively read what we were promised. Don't commit to anything
     * until we have the child's exit status. */
    size_t bytes_read = 0;
    if (result_char == MBEDTLS_TEST_RESULT_SUCCESS) {
        do {
            n = read(pipe_fd[0],
                     child_output + bytes_read,
                     child_output_size - bytes_read);
            if (n > 0) {
                bytes_read += n;
            }
        } while (n > 0 && bytes_read < child_output_size);
        TEST_ASSERT_ERRNO(n != -1);
    } else {
        do {
            n = read(pipe_fd[0],
                     (unsigned char *) &reading_on_failure + bytes_read,
                     sizeof(reading_on_failure) - bytes_read);
            if (n > 0) {
                bytes_read += n;
            }
        } while (n > 0 && bytes_read < sizeof(reading_on_failure));
        TEST_ASSERT_ERRNO(n != -1);
        /* Check that the child wrote the amount of data that what we expect. */
        TEST_EQUAL(bytes_read, sizeof(reading_on_failure.child_test_info));
    }

    /* Close the pipe. If we left it open, there could be a deadlock if the
     * child tried to write more than it should, while the parent is just
     * waiting for the child to exit. */
    close(pipe_fd[0]);
    pipe_fd[0] = -1;

    int wstatus;
    TEST_ASSERT_ERRNO(waitpid(pid, &wstatus, 0) == pid);
    if (WIFEXITED(wstatus) && WEXITSTATUS(wstatus) == CHILD_EXIT_CODE_OK) {
        if (result_char == MBEDTLS_TEST_RESULT_SUCCESS) {
            *child_output_length = bytes_read;
            ret = 0;
        } else {
            mbedtls_test_info_overwrite(&reading_on_failure.child_test_info);
        }
    } else {
        /* Weird status, just report it. */
        TEST_EQUAL(wstatus, 0);
    }

exit:
    close(pipe_fd[0]);
    close(pipe_fd[1]);
    return ret;
}

#endif /* MBEDTLS_PLATFORM_IS_UNIXLIKE */