libcruft-util/debug.cpp

/*
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 * Copyright 2010-2018 Danny Robson <danny@nerdcruft.net>
 */

#include "backtrace.hpp"
#include "debug.hpp"
#include "log.hpp"
#include "preprocessor.hpp"

#include <cstdlib>
#include <iostream>

using namespace util::debug;


////////////////////////////////////////////////////////////////////////////////
void
util::debug::detail::panic (const char *msg)
{
    std::cerr << "PANIC: " << msg << "\n" << ::debug::backtrace () << std::endl;
    breakpoint ();
    abort ();
}


////////////////////////////////////////////////////////////////////////////////
void
util::debug::detail::not_implemented (const char *msg)
{
    panic (msg);
}


//-----------------------------------------------------------------------------
void
util::debug::detail::unreachable (const char *msg)
{
    panic (msg);
}


////////////////////////////////////////////////////////////////////////////////
void
warn (void)
{
    warn ("Unusual code path found.");
}


//-----------------------------------------------------------------------------
void
warn (const std::string &msg)
{
    warn (msg.c_str ());
}


//-----------------------------------------------------------------------------
void
warn (const char *msg)
{
    LOG_WARN (msg);
}


////////////////////////////////////////////////////////////////////////////////
void
util::debug::init [[gnu::constructor]] (void)
{
    if (debug_enabled || getenv("DEBUG")) {
        LOG_INFO ("minimal debug setup");
        //enable_fpe ();
        force_console ();
        prepare_debugger ();

        if (getenv ("DEBUG_WAIT"))
            await_debugger ();
    }
}


///////////////////////////////////////////////////////////////////////////////
static void
debug_wait [[gnu::constructor]] (void)
{
    if (auto val = getenv ("DEBUG_WAIT")) {
        LOG_NOTICE ("awaiting debugger");

        if (std::string ("0") != val)
            await_debugger ();
    }
}


///////////////////////////////////////////////////////////////////////////////
template <>
bool
util::debug::validator<float>::is_valid (const float &val) noexcept
{
    return !std::isnan (val);
}


//-----------------------------------------------------------------------------
template <>
bool
util::debug::validator<double>::is_valid (const double &val) noexcept
{
    return !std::isnan (val);
}


///////////////////////////////////////////////////////////////////////////////
#include "std.hpp"


//-----------------------------------------------------------------------------
#define INSTANTIATE(KLASS)                              \
template <>                                             \
struct util::debug::validator<KLASS> {                  \
    static bool is_valid(KLASS const&);                 \
};                                                      \
                                                        \
bool                                                    \
util::debug::validator<KLASS>::is_valid(KLASS const&)   \
{                                                       \
    return true;                                        \
}


//-----------------------------------------------------------------------------
MAP0(INSTANTIATE,
    u08, u16, u32, u64,
    i08, i16, i32, i64,
    char
)