internal.c File Reference

#include "allocate.h"
#include "backtrack.h"
#include "error.h"
#include "import.h"
#include "inline.h"
#include "inlineframes.h"
#include "print.h"
#include "propsearch.h"
#include "require.h"
#include "resize.h"
#include "resources.h"
#include "search.h"
#include <assert.h>
#include <inttypes.h>
#include <limits.h>
#include <stdio.h>
#include <stdlib.h>

Include dependency graph for internal.c:

Go to the source code of this file.

Macros
#define	DEALLOC_GENERIC(NAME, ELEMENTS_PER_BLOCK)
#define	DEALLOC_VARIABLE_INDEXED(NAME)
#define	DEALLOC_LITERAL_INDEXED(NAME)
#define	RELEASE_LITERAL_INDEXED_STACKS(NAME, ACCESS)

Functions
ABC_NAMESPACE_IMPL_START void	kissat_reset_last_learned (kissat *solver)
kissat *	kissat_init (void)
void	kissat_set_prefix (kissat *solver, const char *prefix)
void	kissat_release (kissat *solver)
void	kissat_reserve (kissat *solver, int max_var)
int	kissat_get_option (kissat *solver, const char *name)
int	kissat_set_option (kissat *solver, const char *name, int new_value)
void	kissat_set_decision_limit (kissat *solver, unsigned limit)
void	kissat_set_conflict_limit (kissat *solver, unsigned limit)
void	kissat_print_statistics (kissat *solver)
void	kissat_add (kissat *solver, int elit)
int	kissat_solve (kissat *solver)
void	kissat_terminate (kissat *solver)
void	kissat_set_terminate (kissat *solver, void *state, int(*terminate)(void *))
int	kissat_value (kissat *solver, int elit)
int	kissat_is_inconsistent (kissat *solver)

Macro Definition Documentation

DEALLOC_GENERIC

#define DEALLOC_GENERIC	(		NAME,
			ELEMENTS_PER_BLOCK )

Value:

  do { \
    const size_t block_size = ELEMENTS_PER_BLOCK * sizeof *solver->NAME; \
    kissat_dealloc (solver, solver->NAME, solver->size, block_size); \
    solver->NAME = 0; \
  } while (0)

Definition at line 59 of file internal.c.

#define DEALLOC_GENERIC(NAME, ELEMENTS_PER_BLOCK) \
  do { \
    const size_t block_size = ELEMENTS_PER_BLOCK * sizeof *solver->NAME; \
    kissat_dealloc (solver, solver->NAME, solver->size, block_size); \
    solver->NAME = 0; \
  } while (0)

DEALLOC_LITERAL_INDEXED

#define DEALLOC_LITERAL_INDEXED

(

NAME

)

Value:

DEALLOC_GENERIC (NAME, 2)

Definition at line 68 of file internal.c.

DEALLOC_VARIABLE_INDEXED

#define DEALLOC_VARIABLE_INDEXED

(

NAME

)

Value:

DEALLOC_GENERIC (NAME, 1)

Definition at line 66 of file internal.c.

RELEASE_LITERAL_INDEXED_STACKS

#define RELEASE_LITERAL_INDEXED_STACKS	(		NAME,
			ACCESS )

Value:

  do { \
    for (all_stack (unsigned, IDX_RILIS, solver->active)) { \
      const unsigned LIT_RILIS = LIT (IDX_RILIS); \
      const unsigned NOT_LIT_RILIS = NOT (LIT_RILIS); \
      RELEASE_STACK (ACCESS (LIT_RILIS)); \
      RELEASE_STACK (ACCESS (NOT_LIT_RILIS)); \
    } \
    DEALLOC_LITERAL_INDEXED (NAME); \
  } while (0)

Definition at line 70 of file internal.c.

#define RELEASE_LITERAL_INDEXED_STACKS(NAME, ACCESS) \
  do { \
    for (all_stack (unsigned, IDX_RILIS, solver->active)) { \
      const unsigned LIT_RILIS = LIT (IDX_RILIS); \
      const unsigned NOT_LIT_RILIS = NOT (LIT_RILIS); \
      RELEASE_STACK (ACCESS (LIT_RILIS)); \
      RELEASE_STACK (ACCESS (NOT_LIT_RILIS)); \
    } \
    DEALLOC_LITERAL_INDEXED (NAME); \
  } while (0)

Function Documentation

kissat_add()

void kissat_add	(	kissat *	solver,
		int	elit )

Definition at line 268 of file internal.c.

                                           {
  kissat_require_initialized (solver);
  kissat_require (!GET (searches), "incremental solving not supported");
#if !defined(KISSAT_NDEBUG) || !defined(KISSAT_NPROOFS) || defined(LOGGING)
  const int checking = kissat_checking (solver);
  const bool logging = kissat_logging (solver);
  const bool proving = kissat_proving (solver);
#endif
  if (elit) {
    kissat_require_valid_external_internal (elit);
#if !defined(KISSAT_NDEBUG) || !defined(KISSAT_NPROOFS) || defined(LOGGING)
    if (checking || logging || proving)
      PUSH_STACK (solver->original, elit);
#endif
    unsigned ilit = kissat_import_literal (solver, elit);
 
    const mark mark = MARK (ilit);
    if (!mark) {
      const value value = kissat_fixed (solver, ilit);
      if (value > 0) {
        if (!solver->clause_satisfied) {
          LOG ("adding root level satisfied literal %u(%d)@0=1", ilit,
               elit);
          solver->clause_satisfied = true;
        }
      } else if (value < 0) {
        LOG ("adding root level falsified literal %u(%d)@0=-1", ilit, elit);
        if (!solver->clause_shrink) {
          solver->clause_shrink = true;
          LOG ("thus original clause needs shrinking");
        }
      } else {
        MARK (ilit) = 1;
        MARK (NOT (ilit)) = -1;
        KISSAT_assert (SIZE_STACK (solver->clause) < UINT_MAX);
        PUSH_STACK (solver->clause, ilit);
      }
    } else if (mark < 0) {
      KISSAT_assert (mark < 0);
      if (!solver->clause_trivial) {
        LOG ("adding dual literal %u(%d) and %u(%d)", NOT (ilit), -elit,
             ilit, elit);
        solver->clause_trivial = true;
      }
    } else {
      KISSAT_assert (mark > 0);
      LOG ("adding duplicated literal %u(%d)", ilit, elit);
      if (!solver->clause_shrink) {
        solver->clause_shrink = true;
        LOG ("thus original clause needs shrinking");
      }
    }
  } else {
#if !defined(KISSAT_NDEBUG) || !defined(KISSAT_NPROOFS) || defined(LOGGING)
    const size_t offset = solver->offset_of_last_original_clause;
    size_t esize = SIZE_STACK (solver->original) - offset;
    int *elits = BEGIN_STACK (solver->original) + offset;
    KISSAT_assert (esize <= UINT_MAX);
#endif
    ADD_UNCHECKED_EXTERNAL (esize, elits);
    const size_t isize = SIZE_STACK (solver->clause);
    unsigned *ilits = BEGIN_STACK (solver->clause);
    KISSAT_assert (isize < (unsigned) INT_MAX);
 
    if (solver->inconsistent)
      LOG ("inconsistent thus skipping original clause");
    else if (solver->clause_satisfied)
      LOG ("skipping satisfied original clause");
    else if (solver->clause_trivial)
      LOG ("skipping trivial original clause");
    else {
      kissat_activate_literals (solver, isize, ilits);
 
      if (!isize) {
        if (solver->clause_shrink)
          LOG ("all original clause literals root level falsified");
        else
          LOG ("found empty original clause");
 
        if (!solver->inconsistent) {
          LOG ("thus solver becomes inconsistent");
          solver->inconsistent = true;
          CHECK_AND_ADD_EMPTY ();
          ADD_EMPTY_TO_PROOF ();
        }
      } else if (isize == 1) {
        unsigned unit = TOP_STACK (solver->clause);
 
        if (solver->clause_shrink)
          LOGUNARY (unit, "original clause shrinks to");
        else
          LOGUNARY (unit, "found original");
 
        kissat_original_unit (solver, unit);
 
        COVER (solver->level);
        if (!solver->level)
          (void) kissat_search_propagate (solver);
      } else {
        reference res = kissat_new_original_clause (solver);
 
        const unsigned a = ilits[0];
        const unsigned b = ilits[1];
 
        const value u = VALUE (a);
        const value v = VALUE (b);
 
        const unsigned k = u ? LEVEL (a) : UINT_MAX;
        const unsigned l = v ? LEVEL (b) : UINT_MAX;
 
        bool assign = false;
 
        if (!u && v < 0) {
          LOG ("original clause immediately forcing");
          assign = true;
        } else if (u < 0 && k == l) {
          LOG ("both watches falsified at level @%u", k);
          KISSAT_assert (v < 0);
          KISSAT_assert (k > 0);
          kissat_backtrack_without_updating_phases (solver, k - 1);
        } else if (u < 0) {
          LOG ("watches falsified at levels @%u and @%u", k, l);
          KISSAT_assert (v < 0);
          KISSAT_assert (k > l);
          KISSAT_assert (l > 0);
          assign = true;
        } else if (u > 0 && v < 0) {
          LOG ("first watch satisfied at level @%u "
               "second falsified at level @%u",
               k, l);
          KISSAT_assert (k <= l);
        } else if (!u && v > 0) {
          LOG ("first watch unassigned "
               "second falsified at level @%u",
               l);
          assign = true;
        } else {
          KISSAT_assert (!u);
          KISSAT_assert (!v);
        }
 
        if (assign) {
          KISSAT_assert (solver->level > 0);
 
          if (isize == 2) {
            KISSAT_assert (res == INVALID_REF);
            kissat_assign_binary (solver, a, b);
          } else {
            KISSAT_assert (res != INVALID_REF);
            clause *c = kissat_dereference_clause (solver, res);
            kissat_assign_reference (solver, a, res, c);
          }
        }
      }
    }
 
#if !defined(KISSAT_NDEBUG) || !defined(KISSAT_NPROOFS)
    if (solver->clause_satisfied || solver->clause_trivial) {
#ifndef KISSAT_NDEBUG
      if (checking > 1)
        kissat_remove_checker_external (solver, esize, elits);
#endif
#ifndef KISSAT_NPROOFS
      if (proving) {
        if (esize == 1)
          LOG ("skipping deleting unit from proof");
        else
          kissat_delete_external_from_proof (solver, esize, elits);
      }
#endif
    } else if (!solver->inconsistent && solver->clause_shrink) {
#ifndef KISSAT_NDEBUG
      if (checking > 1) {
        kissat_check_and_add_internal (solver, isize, ilits);
        kissat_remove_checker_external (solver, esize, elits);
      }
#endif
#ifndef KISSAT_NPROOFS
      if (proving) {
        kissat_add_lits_to_proof (solver, isize, ilits);
        kissat_delete_external_from_proof (solver, esize, elits);
      }
#endif
    }
#endif
 
#if !defined(KISSAT_NDEBUG) || !defined(KISSAT_NPROOFS) || defined(LOGGING)
    if (checking) {
      LOGINTS (esize, elits, "saved original");
      PUSH_STACK (solver->original, 0);
      solver->offset_of_last_original_clause =
          SIZE_STACK (solver->original);
    } else if (logging || proving) {
      LOGINTS (esize, elits, "reset original");
      CLEAR_STACK (solver->original);
      solver->offset_of_last_original_clause = 0;
    }
#endif
    for (all_stack (unsigned, lit, solver->clause))
      MARK (lit) = MARK (NOT (lit)) = 0;
 
    CLEAR_STACK (solver->clause);
 
    solver->clause_satisfied = false;
    solver->clause_trivial = false;
    solver->clause_shrink = false;
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

kissat_get_option()

int kissat_get_option	(	kissat *	solver,
		const char *	name )

Definition at line 184 of file internal.c.

                                                         {
  kissat_require_initialized (solver);
  kissat_require (name, "name zero pointer");
#ifndef KISSAT_NOPTIONS
  return kissat_options_get (&solver->options, name);
#else
  (void) solver;
  return kissat_options_get (name);
#endif
}

Here is the call graph for this function:

kissat_init()

kissat * kissat_init

(

void

)

Definition at line 27 of file internal.c.

                           {
  kissat *solver = (kissat*)kissat_calloc (0, 1, sizeof *solver);
#ifndef KISSAT_NOPTIONS
  kissat_init_options (&solver->options);
#else
  kissat_init_options ();
#endif
#ifndef KISSAT_QUIET
  kissat_init_profiles (&solver->profiles);
#endif
  START (total);
  kissat_init_queue (solver);
  KISSAT_assert (INTERNAL_MAX_LIT < UINT_MAX);
  kissat_push_frame (solver, UINT_MAX);
  solver->watching = true;
  solver->conflict.size = 2;
  solver->scinc = 1.0;
  solver->first_reducible = INVALID_REF;
  solver->last_irredundant = INVALID_REF;
  kissat_reset_last_learned (solver);
#ifndef KISSAT_NDEBUG
  kissat_init_checker (solver);
#endif
  solver->prefix = kissat_strdup (solver, "c ");
  return solver;
}

Here is the call graph for this function:

Here is the caller graph for this function:

kissat_is_inconsistent()

int kissat_is_inconsistent

(

kissat *

solver

)

Definition at line 524 of file internal.c.

                                           {
  return solver->inconsistent;
}

Here is the caller graph for this function:

kissat_print_statistics()

void kissat_print_statistics

(

kissat *

solver

)

Definition at line 234 of file internal.c.

                                              {
#ifndef KISSAT_QUIET
  kissat_require_initialized (solver);
  const int verbosity = kissat_verbosity (solver);
  if (verbosity < 0)
    return;
  if (GET_OPTION (profile)) {
    kissat_section (solver, "profiling");
    kissat_profiles_print (solver);
  }
  const bool complete = GET_OPTION (statistics);
  kissat_section (solver, "statistics");
  const bool verbose = (complete || verbosity > 0);
  kissat_statistics_print (solver, verbose);
#ifndef KISSAT_NPROOFS
  if (solver->proof) {
    kissat_section (solver, "proof");
    kissat_print_proof_statistics (solver, verbose);
  }
#endif
#ifndef KISSAT_NDEBUG
  if (GET_OPTION (check) > 1) {
    kissat_section (solver, "checker");
    kissat_print_checker_statistics (solver, verbose);
  }
#endif
  kissat_section (solver, "glue usage");
  kissat_print_glue_usage (solver);
  kissat_section (solver, "resources");
  kissat_print_resources (solver);
#endif
  (void) solver;
}

kissat_release()

void kissat_release

(

kissat *

solver

)

Definition at line 81 of file internal.c.

                                     {
  kissat_require_initialized (solver);
  kissat_release_heap (solver, SCORES);
  kissat_release_heap (solver, &solver->schedule);
  kissat_release_vectors (solver);
  kissat_release_phases (solver);
 
  RELEASE_STACK (solver->export_);
  RELEASE_STACK (solver->import);
 
  DEALLOC_VARIABLE_INDEXED (assigned);
  DEALLOC_VARIABLE_INDEXED (flags);
  DEALLOC_VARIABLE_INDEXED (links);
 
  DEALLOC_LITERAL_INDEXED (marks);
  DEALLOC_LITERAL_INDEXED (values);
  DEALLOC_LITERAL_INDEXED (watches);
 
  RELEASE_STACK (solver->import);
  RELEASE_STACK (solver->eliminated);
  RELEASE_STACK (solver->extend);
  RELEASE_STACK (solver->witness);
  RELEASE_STACK (solver->etrail);
 
  RELEASE_STACK (solver->delayed);
 
  RELEASE_STACK (solver->clause);
  RELEASE_STACK (solver->shadow);
#if defined(LOGGING) || !defined(KISSAT_NDEBUG)
  RELEASE_STACK (solver->resolvent);
#endif
 
  RELEASE_STACK (solver->arena);
 
  RELEASE_STACK (solver->units);
  RELEASE_STACK (solver->frames);
  RELEASE_STACK (solver->sorter);
 
  RELEASE_ARRAY (solver->trail, solver->size);
 
  RELEASE_STACK (solver->analyzed);
  RELEASE_STACK (solver->levels);
  RELEASE_STACK (solver->minimize);
  RELEASE_STACK (solver->poisoned);
  RELEASE_STACK (solver->promote);
  RELEASE_STACK (solver->removable);
  RELEASE_STACK (solver->shrinkable);
  RELEASE_STACK (solver->xorted[0]);
  RELEASE_STACK (solver->xorted[1]);
 
  RELEASE_STACK (solver->sweep_schedule);
 
  RELEASE_STACK (solver->ranks);
 
  RELEASE_STACK (solver->antecedents[0]);
  RELEASE_STACK (solver->antecedents[1]);
  RELEASE_STACK (solver->gates[0]);
  RELEASE_STACK (solver->gates[1]);
  RELEASE_STACK (solver->resolvents);
 
#if !defined(KISSAT_NDEBUG) || !defined(KISSAT_NPROOFS)
  RELEASE_STACK (solver->added);
  RELEASE_STACK (solver->removed);
#endif
 
#if !defined(KISSAT_NDEBUG) || !defined(KISSAT_NPROOFS) || defined(LOGGING)
  RELEASE_STACK (solver->original);
#endif
 
#ifndef KISSAT_QUIET
  RELEASE_STACK (solver->profiles.stack);
#endif
 
  kissat_freestr (solver, solver->prefix);
 
#ifndef KISSAT_NDEBUG
  kissat_release_checker (solver);
#endif
#if !defined(KISSAT_NDEBUG) && defined(METRICS)
  uint64_t leaked = solver->statistics_.allocated_current;
  if (leaked)
    if (!getenv ("LEAK"))
      kissat_fatal ("internally leaking %" PRIu64 " bytes", leaked);
#endif
 
  kissat_free (0, solver, sizeof *solver);
}

Here is the call graph for this function:

Here is the caller graph for this function:

kissat_reserve()

void kissat_reserve	(	kissat *	solver,
		int	max_var )

Definition at line 169 of file internal.c.

                                                  {
  kissat_require_initialized (solver);
  kissat_require (0 <= max_var, "negative maximum variable argument '%d'",
                  max_var);
  kissat_require (max_var <= EXTERNAL_MAX_VAR,
                  "invalid maximum variable argument '%d'", max_var);
  kissat_increase_size (solver, (unsigned) max_var);
  if (!GET_OPTION (tumble)) {
    for (int idx = 1; idx <= max_var; idx++)
      (void) kissat_import_literal (solver, idx);
    for (unsigned idx = 0; idx != (unsigned) max_var; idx++)
      kissat_activate_literal (solver, LIT (idx));
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

kissat_reset_last_learned()

ABC_NAMESPACE_IMPL_START void kissat_reset_last_learned

(

kissat *

solver

)

Definition at line 22 of file internal.c.

                                                {
  for (really_all_last_learned (p))
    *p = INVALID_REF;
}

Here is the caller graph for this function:

kissat_set_conflict_limit()

void kissat_set_conflict_limit	(	kissat *	solver,
		unsigned	limit )

Definition at line 222 of file internal.c.

                                                                {
  kissat_require_initialized (solver);
  limits *limits = &solver->limits;
  limited *limited = &solver->limited;
  statistics *statistics = &solver->statistics_;
  limited->conflicts = true;
  KISSAT_assert (UINT64_MAX - limit >= statistics->conflicts);
  limits->conflicts = statistics->conflicts + limit;
  LOG ("set conflict limit to %" PRIu64 " after %u conflicts",
       limits->conflicts, limit);
}

Here is the caller graph for this function:

kissat_set_decision_limit()

void kissat_set_decision_limit	(	kissat *	solver,
		unsigned	limit )

Definition at line 210 of file internal.c.

                                                                {
  kissat_require_initialized (solver);
  limits *limits = &solver->limits;
  limited *limited = &solver->limited;
  statistics *statistics = &solver->statistics_;
  limited->decisions = true;
  KISSAT_assert (UINT64_MAX - limit >= statistics->decisions);
  limits->decisions = statistics->decisions + limit;
  LOG ("set decision limit to %" PRIu64 " after %u decisions",
       limits->decisions, limit);
}

kissat_set_option()

int kissat_set_option	(	kissat *	solver,
		const char *	name,
		int	new_value )

Definition at line 195 of file internal.c.

                                                                        {
#ifndef KISSAT_NOPTIONS
  kissat_require_initialized (solver);
  kissat_require (name, "name zero pointer");
#ifndef KISSAT_NOPTIONS
  return kissat_options_set (&solver->options, name, new_value);
#else
  return kissat_options_set (name, new_value);
#endif
#else
  (void) solver, (void) new_value;
  return kissat_options_get (name);
#endif
}

Here is the call graph for this function:

kissat_set_prefix()

void kissat_set_prefix	(	kissat *	solver,
		const char *	prefix )

Definition at line 54 of file internal.c.

                                                            {
  kissat_freestr (solver, solver->prefix);
  solver->prefix = kissat_strdup (solver, prefix);
}

Here is the call graph for this function:

kissat_set_terminate()

void kissat_set_terminate	(	kissat *	solver,
		void *	state,
		int(*	terminate )(void *) )

Definition at line 491 of file internal.c.

                                                      {
  solver->termination.terminate = 0;
  solver->termination.state = state;
  solver->termination.terminate = terminate;
}

kissat_solve()

int kissat_solve

(

kissat *

solver

)

Definition at line 477 of file internal.c.

                                  {
  kissat_require_initialized (solver);
  kissat_require (EMPTY_STACK (solver->clause),
                  "incomplete clause (terminating zero not added)");
  kissat_require (!GET (searches), "incremental solving not supported");
  return kissat_search (solver);
}

Here is the call graph for this function:

Here is the caller graph for this function:

kissat_terminate()

void kissat_terminate

(

kissat *

solver

)

Definition at line 485 of file internal.c.

                                       {
  kissat_require_initialized (solver);
  solver->termination.flagged = ~(unsigned) 0;
  KISSAT_assert (solver->termination.flagged);
}

kissat_value()

int kissat_value	(	kissat *	solver,
		int	elit )

Definition at line 498 of file internal.c.

                                            {
  kissat_require_initialized (solver);
  kissat_require_valid_external_internal (elit);
  const unsigned eidx = ABS (elit);
  if (eidx >= SIZE_STACK (solver->import))
    return 0;
  const import *const import = &PEEK_STACK (solver->import, eidx);
  if (!import->imported)
    return 0;
  value tmp;
  if (import->eliminated) {
    if (!solver->extended && !EMPTY_STACK (solver->extend))
      kissat_extend (solver);
    const unsigned eliminated = import->lit;
    tmp = PEEK_STACK (solver->eliminated, eliminated);
  } else {
    const unsigned ilit = import->lit;
    tmp = VALUE (ilit);
  }
  if (!tmp)
    return 0;
  if (elit < 0)
    tmp = -tmp;
  return tmp < 0 ? -elit : elit;
}

Here is the call graph for this function:

Here is the caller graph for this function: