Blame opae-libs/tests/opae-c/test_object_c.cpp

Packit 534379
// Copyright(c) 2018, Intel Corporation
Packit 534379
//
Packit 534379
// Redistribution  and  use  in source  and  binary  forms,  with  or  without
Packit 534379
// modification, are permitted provided that the following conditions are met:
Packit 534379
//
Packit 534379
// * Redistributions of  source code  must retain the  above copyright notice,
Packit 534379
//   this list of conditions and the following disclaimer.
Packit 534379
// * Redistributions in binary form must reproduce the above copyright notice,
Packit 534379
//   this list of conditions and the following disclaimer in the documentation
Packit 534379
//   and/or other materials provided with the distribution.
Packit 534379
// * Neither the name  of Intel Corporation  nor the names of its contributors
Packit 534379
//   may be used to  endorse or promote  products derived  from this  software
Packit 534379
//   without specific prior written permission.
Packit 534379
//
Packit 534379
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
Packit 534379
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING,  BUT NOT LIMITED TO,  THE
Packit 534379
// IMPLIED WARRANTIES OF  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
Packit 534379
// ARE DISCLAIMED.  IN NO EVENT  SHALL THE COPYRIGHT OWNER  OR CONTRIBUTORS BE
Packit 534379
// LIABLE  FOR  ANY  DIRECT,  INDIRECT,  INCIDENTAL,  SPECIAL,  EXEMPLARY,  OR
Packit 534379
// CONSEQUENTIAL  DAMAGES  (INCLUDING,  BUT  NOT LIMITED  TO,  PROCUREMENT  OF
Packit 534379
// SUBSTITUTE GOODS OR SERVICES;  LOSS OF USE,  DATA, OR PROFITS;  OR BUSINESS
Packit 534379
// INTERRUPTION)  HOWEVER CAUSED  AND ON ANY THEORY  OF LIABILITY,  WHETHER IN
Packit 534379
// CONTRACT,  STRICT LIABILITY,  OR TORT  (INCLUDING NEGLIGENCE  OR OTHERWISE)
Packit 534379
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,  EVEN IF ADVISED OF THE
Packit 534379
// POSSIBILITY OF SUCH DAMAGE.
Packit 534379
Packit 534379
extern "C" {
Packit 534379
Packit 534379
#include <json-c/json.h>
Packit 534379
#include <uuid/uuid.h>
Packit 534379
#include "opae_int.h"
Packit 534379
Packit 534379
}
Packit 534379
Packit 534379
#include <opae/fpga.h>
Packit 534379
#include "intel-fpga.h"
Packit 534379
#include <linux/ioctl.h>
Packit 534379
Packit 534379
#include <array>
Packit 534379
#include <cstdlib>
Packit 534379
#include <cstdarg>
Packit 534379
#include <map>
Packit 534379
#include <memory>
Packit 534379
#include <string>
Packit 534379
#include <vector>
Packit 534379
#include "gtest/gtest.h"
Packit 534379
#include "mock/test_system.h"
Packit 534379
Packit 534379
using namespace opae::testing;
Packit 534379
Packit 534379
class object_c_p : public ::testing::TestWithParam<std::string> {
Packit 534379
 protected:
Packit 534379
  object_c_p()
Packit 534379
  : tokens_accel_{{nullptr, nullptr}},
Packit 534379
    tokens_device_{{nullptr, nullptr}} {}
Packit 534379
Packit 534379
  virtual void SetUp() override {
Packit 534379
    ASSERT_TRUE(test_platform::exists(GetParam()));
Packit 534379
    platform_ = test_platform::get(GetParam());
Packit 534379
    system_ = test_system::instance();
Packit 534379
    system_->initialize();
Packit 534379
    system_->prepare_syfs(platform_);
Packit 534379
Packit 534379
    filter_ = nullptr;
Packit 534379
    ASSERT_EQ(fpgaInitialize(NULL), FPGA_OK);
Packit 534379
    ASSERT_EQ(fpgaGetProperties(nullptr, &filter_), FPGA_OK);
Packit 534379
    ASSERT_EQ(fpgaPropertiesSetDeviceID(filter_, platform_.devices[0].device_id), FPGA_OK);
Packit 534379
    ASSERT_EQ(fpgaPropertiesSetObjectType(filter_, FPGA_ACCELERATOR), FPGA_OK);
Packit 534379
    num_matches_accel_ = 0;
Packit 534379
    ASSERT_EQ(fpgaEnumerate(&filter_, 1, tokens_accel_.data(), tokens_accel_.size(),
Packit 534379
                            &num_matches_accel_), FPGA_OK);
Packit 534379
    EXPECT_GT(num_matches_accel_, 0);
Packit 534379
Packit 534379
    accel_ = nullptr;
Packit 534379
    ASSERT_EQ(fpgaOpen(tokens_accel_[0], &accel_, 0), FPGA_OK);
Packit 534379
Packit 534379
    ASSERT_EQ(fpgaPropertiesSetObjectType(filter_, FPGA_DEVICE), FPGA_OK);
Packit 534379
    num_matches_device_ = 0;
Packit 534379
    ASSERT_EQ(fpgaEnumerate(&filter_, 1, tokens_device_.data(), tokens_device_.size(),
Packit 534379
                            &num_matches_device_), FPGA_OK);
Packit 534379
    EXPECT_GT(num_matches_device_, 0);
Packit 534379
Packit 534379
    EXPECT_EQ(fpgaTokenGetObject(tokens_device_[0], "ports_num", &token_obj_, 0),
Packit 534379
		    FPGA_OK);
Packit 534379
    EXPECT_EQ(fpgaHandleGetObject(accel_, "afu_id", &handle_obj_, 0),
Packit 534379
		    FPGA_OK);
Packit 534379
    afu_guid_ = platform_.devices[0].afu_guid;
Packit 534379
    system_->normalize_guid(afu_guid_, false);
Packit 534379
  }
Packit 534379
Packit 534379
  virtual void TearDown() override {
Packit 534379
    EXPECT_EQ(fpgaDestroyObject(&handle_obj_), FPGA_OK);
Packit 534379
    EXPECT_EQ(fpgaDestroyObject(&token_obj_), FPGA_OK);
Packit 534379
    EXPECT_EQ(fpgaDestroyProperties(&filter_), FPGA_OK);
Packit 534379
    if (accel_) {
Packit 534379
        EXPECT_EQ(fpgaClose(accel_), FPGA_OK);
Packit 534379
        accel_ = nullptr;
Packit 534379
    }
Packit 534379
    for (auto &t : tokens_accel_) {
Packit 534379
      if (t) {
Packit 534379
        EXPECT_EQ(fpgaDestroyToken(&t), FPGA_OK);
Packit 534379
        t = nullptr;
Packit 534379
      }
Packit 534379
    }
Packit 534379
    for (auto &t : tokens_device_) {
Packit 534379
      if (t) {
Packit 534379
        EXPECT_EQ(fpgaDestroyToken(&t), FPGA_OK);
Packit 534379
        t = nullptr;
Packit 534379
      }
Packit 534379
    }
Packit 534379
    fpgaFinalize();
Packit 534379
    system_->finalize();
Packit 534379
  }
Packit 534379
Packit 534379
  std::array<fpga_token, 2> tokens_accel_;
Packit 534379
  std::array<fpga_token, 2> tokens_device_;
Packit 534379
  fpga_object token_obj_;
Packit 534379
  fpga_object handle_obj_;
Packit 534379
  fpga_properties filter_;
Packit 534379
  fpga_handle accel_;
Packit 534379
  uint32_t num_matches_accel_;
Packit 534379
  uint32_t num_matches_device_;
Packit 534379
  test_platform platform_;
Packit 534379
  test_system *system_;
Packit 534379
  std::string afu_guid_;
Packit 534379
};
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       obj_read
Packit 534379
 * @brief      Test: fpgaObjectRead
Packit 534379
 * @details    When fpgaObjectRead is called with valid params,
Packit 534379
 *             the fn retrieves the value of the targeted object
Packit 534379
 *             and returns FPGA_OK.
Packit 534379
 */
Packit 534379
TEST_P(object_c_p, obj_read) {
Packit 534379
  char afu_id[33];
Packit 534379
  EXPECT_EQ(fpgaObjectRead(handle_obj_, (uint8_t *) afu_id, 0,
Packit 534379
                           32, 0), FPGA_OK);
Packit 534379
  afu_id[32] = 0;
Packit 534379
  EXPECT_STREQ(afu_id, afu_guid_.c_str());
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       obj_read64
Packit 534379
 * @brief      Test: fpgaObjectRead64
Packit 534379
 * @details    When fpgaObjectRead64 is called with valid params,
Packit 534379
 *             the fn retrieves the value of the targeted object
Packit 534379
 *             and returns FPGA_OK.
Packit 534379
 */
Packit 534379
TEST_P(object_c_p, obj_read64) {
Packit 534379
  uint64_t val = 0;
Packit 534379
  EXPECT_EQ(fpgaObjectRead64(token_obj_, &val, 0), FPGA_OK);
Packit 534379
  EXPECT_EQ(val, 1ul);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       obj_write64
Packit 534379
 * @brief      Test: fpgaObjectWrite64
Packit 534379
 * @details    When fpgaObjectWrite64 is called with valid params,
Packit 534379
 *             the fn sets the value of the targeted object
Packit 534379
 *             and returns FPGA_OK.
Packit 534379
 */
Packit 534379
TEST_P(object_c_p, obj_write64) {
Packit 534379
  uint64_t errors = 0xbaddecaf;
Packit 534379
  fpga_object obj = nullptr;
Packit 534379
Packit 534379
  // read the port errors
Packit 534379
  ASSERT_EQ(fpgaHandleGetObject(accel_, "errors/errors", &obj, 0),
Packit 534379
		    FPGA_OK);
Packit 534379
  ASSERT_EQ(fpgaObjectRead64(obj, &errors, 0), FPGA_OK);
Packit 534379
  EXPECT_EQ(fpgaDestroyObject(&obj), FPGA_OK);
Packit 534379
Packit 534379
  // clear the port errors
Packit 534379
  ASSERT_EQ(fpgaHandleGetObject(accel_, "errors/clear", &obj, 0),
Packit 534379
		    FPGA_OK);
Packit 534379
  ASSERT_EQ(fpgaObjectWrite64(obj, errors, 0), FPGA_OK);
Packit 534379
  EXPECT_EQ(fpgaDestroyObject(&obj), FPGA_OK);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       obj_get_obj0
Packit 534379
 * @brief      Test: fpgaObjectGetObject
Packit 534379
 * @details    When fpgaObjectGetObject is called with valid parameters,
Packit 534379
 *             the fn opens the underlying object
Packit 534379
 *             and returns FPGA_OK.
Packit 534379
 */
Packit 534379
TEST_P(object_c_p, obj_get_obj0) {
Packit 534379
  fpga_object errors_obj = nullptr;
Packit 534379
  fpga_object clear_obj = nullptr;
Packit 534379
Packit 534379
  ASSERT_EQ(fpgaHandleGetObject(accel_, "errors", &errors_obj, 0),
Packit 534379
		    FPGA_OK);
Packit 534379
  ASSERT_EQ(fpgaObjectGetObject(errors_obj, "clear",
Packit 534379
                                &clear_obj, 0), FPGA_OK);
Packit 534379
  ASSERT_EQ(fpgaObjectWrite64(clear_obj, 0, 0), FPGA_OK);
Packit 534379
  EXPECT_EQ(fpgaDestroyObject(&clear_obj), FPGA_OK);
Packit 534379
  EXPECT_EQ(fpgaDestroyObject(&errors_obj), FPGA_OK);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       obj_get_obj1
Packit 534379
 * @brief      Test: fpgaObjectGetObject
Packit 534379
 * @details    When fpgaObjectGetObject is called with a name that has a null
Packit 534379
 *             byte, the function returns FPGA_NOT_FOUND. 
Packit 534379
 *             and returns FPGA_OK.
Packit 534379
 */
Packit 534379
TEST_P(object_c_p, obj_get_obj1) {
Packit 534379
  fpga_object errors_obj = nullptr;
Packit 534379
  fpga_object obj = nullptr;
Packit 534379
  const char *bad_name = "err\0rs";
Packit 534379
Packit 534379
  ASSERT_EQ(fpgaHandleGetObject(accel_, "errors", &errors_obj, 0), FPGA_OK);
Packit 534379
  EXPECT_EQ(fpgaObjectGetObject(errors_obj, bad_name, &obj, 0),FPGA_NOT_FOUND);
Packit 534379
Packit 534379
  ASSERT_NE(fpgaDestroyObject(&obj), FPGA_OK);
Packit 534379
  ASSERT_EQ(fpgaDestroyObject(&errors_obj), FPGA_OK);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       handle_get_obj
Packit 534379
 * @brief      Test: fpgaHandleGetObject
Packit 534379
 * @details    When fpgaHandleGetObject is called with a name that has a null
Packit 534379
 *             byte, the function returns FPGA_NOT_FOUND. 
Packit 534379
 */
Packit 534379
TEST_P(object_c_p, handle_get_obj) {
Packit 534379
  fpga_object obj = nullptr;
Packit 534379
  const char *bad_name = "err\0rs";
Packit 534379
Packit 534379
  EXPECT_EQ(fpgaHandleGetObject(accel_, bad_name, &obj, 0), FPGA_NOT_FOUND);
Packit 534379
  ASSERT_NE(fpgaDestroyObject(&obj), FPGA_OK);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       token_get_obj
Packit 534379
 * @brief      Test: fpgaTokenGetObject
Packit 534379
 * @details    When fpgaTokenGetObject is called with a name that has a null
Packit 534379
 *             byte, the function returns FPGA_NOT_FOUND. 
Packit 534379
 */
Packit 534379
TEST_P(object_c_p, token_get_obj) {
Packit 534379
  fpga_object obj = nullptr;
Packit 534379
  const char *bad_name = "err\0rs";
Packit 534379
Packit 534379
  EXPECT_EQ(fpgaTokenGetObject(tokens_device_[0], bad_name, &obj, 0), 
Packit 534379
                                FPGA_NOT_FOUND);
Packit 534379
  ASSERT_NE(fpgaDestroyObject(&obj), FPGA_OK);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       obj_get_size
Packit 534379
 * @brief      Test: fpgaObjectGetSize
Packit 534379
 * @details    Given an object created using name afu_id
Packit 534379
 *             When fpgaObjectGetSize is called with that object
Packit 534379
 *             Then the size retrieved equals the length of the afu_id
Packit 534379
 *             string + one for the new line character
Packit 534379
 */
Packit 534379
TEST_P(object_c_p, obj_get_size) {
Packit 534379
  uint32_t value = 0;
Packit 534379
  EXPECT_EQ(fpgaObjectGetSize(handle_obj_, &value, FPGA_OBJECT_SYNC), FPGA_OK);
Packit 534379
  EXPECT_EQ(value, afu_guid_.size() + 1);
Packit 534379
}
Packit 534379
Packit 534379
INSTANTIATE_TEST_CASE_P(object_c, object_c_p,
Packit 534379
                        ::testing::ValuesIn(test_platform::platforms({ "skx-p","dcp-rc","dcp-vc" })));
Packit 534379
Packit 534379
class object_c_mock_p : public object_c_p {
Packit 534379
  protected:
Packit 534379
    object_c_mock_p() {};
Packit 534379
};
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       tok_get_err
Packit 534379
 * @brief      Test: fpgaTokenGetObject
Packit 534379
 * @details    When the call to opae_allocate_wrapped_object fails,
Packit 534379
 *             fpgaTokenGetObject destroys the underlying object
Packit 534379
 *             and returns FPGA_NO_MEMORY.
Packit 534379
 */
Packit 534379
TEST_P(object_c_mock_p, tok_get_err) {
Packit 534379
  fpga_object obj = nullptr;
Packit 534379
  system_->invalidate_malloc(0, "opae_allocate_wrapped_object");
Packit 534379
  EXPECT_EQ(fpgaTokenGetObject(tokens_device_[0], "ports_num",
Packit 534379
                               &obj, 0), FPGA_NO_MEMORY);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       handle_get_err
Packit 534379
 * @brief      Test: fpgaHandleGetObject
Packit 534379
 * @details    When the call to opae_allocate_wrapped_object fails,
Packit 534379
 *             fpgaHandleGetObject destroys the underlying object
Packit 534379
 *             and returns FPGA_NO_MEMORY.
Packit 534379
 */
Packit 534379
TEST_P(object_c_mock_p, handle_get_err) {
Packit 534379
  fpga_object obj = nullptr;
Packit 534379
  system_->invalidate_malloc(0, "opae_allocate_wrapped_object");
Packit 534379
  EXPECT_EQ(fpgaHandleGetObject(accel_, "id",
Packit 534379
                               &obj, 0), FPGA_NO_MEMORY);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @test       obj_get_obj_err
Packit 534379
 * @brief      Test: fpgaObjectGetObject
Packit 534379
 * @details    When opae_allocate_wrapped_object fails,
Packit 534379
 *             fpgaObjectGetObject frees the underlying object
Packit 534379
 *             and returns FPGA_NO_MEMORY.
Packit 534379
 */
Packit 534379
TEST_P(object_c_mock_p, obj_get_obj_err) {
Packit 534379
  fpga_object errors_obj = nullptr;
Packit 534379
  fpga_object clear_obj = nullptr;
Packit 534379
Packit 534379
  ASSERT_EQ(fpgaHandleGetObject(accel_, "errors", &errors_obj, 0),
Packit 534379
		    FPGA_OK);
Packit 534379
Packit 534379
  system_->invalidate_malloc(0, "opae_allocate_wrapped_object");
Packit 534379
  ASSERT_EQ(fpgaObjectGetObject(errors_obj, "clear",
Packit 534379
                                &clear_obj, 0), FPGA_NO_MEMORY);
Packit 534379
Packit 534379
  EXPECT_EQ(fpgaDestroyObject(&errors_obj), FPGA_OK);
Packit 534379
}
Packit 534379
Packit 534379
INSTANTIATE_TEST_CASE_P(object_c, object_c_mock_p,
Packit 534379
                        ::testing::ValuesIn(test_platform::mock_platforms({ "skx-p","dcp-rc","dcp-vc"  })));
Packit 534379