kea/src/bin/dhcp6/tests/marker_file.h.in

// Copyright (C) 2013-2015 Internet Systems Consortium, Inc. ("ISC")
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at http://mozilla.org/MPL/2.0/.

#ifndef MARKER_FILE_H
#define MARKER_FILE_H

/// @file
/// Define a marker file that is used in tests to prove that an "unload"
/// function has been called

namespace {
const char* const LOAD_MARKER_FILE = "@abs_builddir@/load_marker.txt";
const char* const UNLOAD_MARKER_FILE = "@abs_builddir@/unload_marker.txt";
}

namespace isc {
namespace dhcp {
namespace test {

/// @brief Check marker file
///
/// This function is used in some of the DHCP server tests.
///
/// Marker files are used by the load/unload functions in the hooks
/// libraries in these tests to signal whether they have been loaded or
/// unloaded.  The file (if present) contains a single line holding
/// a set of characters.
///
/// This convenience function checks the file to see if the characters
/// are those expected.
///
/// @param name Name of the marker file.
/// @param expected Characters expected.  If a marker file is present,
///        it is expected to contain characters.
///
/// @return true if all tests pass, false if not (in which case a failure
///         will have been logged).
bool
checkMarkerFile(const char* name, const char* expected);

/// @brief Check marker file exists
///
/// This function is used in some of the DHCP server tests.
///
/// Checkes that the specified file does NOT exist.
///
/// @param name Name of the marker file.
///
/// @return true if file exists, false if not.
bool
checkMarkerFileExists(const char* name);

} // namespace test
} // namespace dhcp
} // namespace isc

#endif // MARKER_FILE_H