00-sigusr1.t

#!/usr/bin/env bash
# THIS FILE IS PART OF THE CYLC WORKFLOW ENGINE.
# Copyright (C) NIWA & British Crown (Met Office) & Contributors.
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <http://www.gnu.org/licenses/>.
#-------------------------------------------------------------------------------
# Test handle of SIGUSR1. (Handle a mock job vacation.)
# Obviously, job vacation does not happen with background job, and the job
# will no longer be poll-able after the kill.
. "$(dirname "$0")/test_header"

skip_all "TODO decide whether to re-instate this"

run_tests() {
    set_test_number 5
    install_workflow "${TEST_NAME_BASE}" "${TEST_NAME_BASE}"
    TEST_NAME="${TEST_NAME_BASE}-validate"
    run_ok "${TEST_NAME}" cylc validate "${WORKFLOW_NAME}"
    TEST_NAME="${TEST_NAME_BASE}-run"
    # Needs to be detaching:
    workflow_run_ok "${TEST_NAME}" cylc play --reference-test "${WORKFLOW_NAME}"

    # Make sure 1/t1's status file is in place
    T1_STATUS_FILE="${WORKFLOW_RUN_DIR}/log/job/1/t1/01/job.status"

    poll_grep -E 'CYLC_JOB_ID=' "${T1_STATUS_FILE}"
    poll_grep -E 'CYLC_JOB_INIT_TIME=' "${T1_STATUS_FILE}"

    # Kill the job and see what happens
    T1_PID="$(awk -F= '$1=="CYLC_JOB_ID" {print $2}' "${T1_STATUS_FILE}")"
    kill -s 'USR1' "${T1_PID}"
    poll_grep -E 'WARNING|vacated/USR1' "${T1_STATUS_FILE}"
    poll_grep_workflow_log 'vacated/USR1'
    sleep 1  # a bit of extra time for workflow db update to complete
    sqlite3 "${WORKFLOW_RUN_DIR}/log/db" \
        "SELECT status FROM task_states WHERE name=='t1';" \
        >"${TEST_NAME}-db-t1" 2>'/dev/null'
    grep_ok "^\(submitted\|running\)$" "${TEST_NAME}-db-t1"
    # Start the job again and see what happens
    mkdir -p "${WORKFLOW_RUN_DIR}/work/1/t1/"
    touch "${WORKFLOW_RUN_DIR}/work/1/t1/file"  # Allow t1 to complete
    "${WORKFLOW_RUN_DIR}/log/job/1/t1/01/job" <'/dev/null' >'/dev/null' 2>&1 &
    # Wait for workflow to complete
    poll_workflow_stopped
    # Test t1 status in DB
    sqlite3 "${WORKFLOW_RUN_DIR}/log/db" \
        "SELECT status FROM task_states WHERE name=='t1';" >"${TEST_NAME}-db-t1"
    cmp_ok "${TEST_NAME}-db-t1" - <<<'succeeded'
    # Test reference
    grep_ok 'WORKFLOW REFERENCE TEST PASSED' "${WORKFLOW_RUN_DIR}/log/scheduler/log"
    purge
    exit
}

# Programs running in some environment is unable to trap SIGUSR1. E.g.:
# An environment documented in this comment:
# https://github.com/cylc/cylc-flow/pull/1648#issuecomment-149348410
trap 'run_tests' 'SIGUSR1'
kill -s 'SIGUSR1' "$$"
sleep 1
skip_all 'Program not receiving SIGUSR1'