Imported Upstream version 0.9.1
[platform/upstream/iotivity.git] / resource / csdk / stack / test / README
index 0e3dfa4..7da8c21 100644 (file)
@@ -2,16 +2,19 @@
 //  NOTICE - Transition to SCONS
 //---------------------------------------------------------------------
 
-The IoTivity build system is transitioning to SCONS. Although the 
-makefiles are still available (until v1.0) and some developers are 
-still using them, they are currently no longer supported. To learn more 
-about building using SCONS see Readme.scons.txt in the repository root 
+The IoTivity build system is transitioning to SCONS. Although the
+makefiles are still available (until v1.0) and some developers are
+still using them, they are currently no longer supported. To learn more
+about building using SCONS see Readme.scons.txt in the repository root
 directory. The build steps used in continuous integration can be found
 in auto_build.sh which is also in the the repository root directory.
 
+To dynamically link with the Google Unit test library,
+add <src_dir>/extlibs/gtest/gtest-1.7.0/lib/.libs/ to LD_LIBRARY_PATH
+
 //---------------------------------------------------------------------
 
-stacktests.cpp is a unit test of the APIs in ocstack.c.  
+stacktests.cpp is a unit test of the APIs in ocstack.c.
 It uses Google Test for the unit tests.  Note that
 the unit tests are only to test the functionality of
 ocstack.c.  It is not a system or end-to-end test.
@@ -19,24 +22,25 @@ ocstack.c.  It is not a system or end-to-end test.
 Unit Test Requirements:
 
 1. Install Google Test on a Linux build machine
-2. Create a file called "local.properties" in the 
+2. Create a file called "local.properties" in the
    root/csdk/stack/test.  local.properties is used
-   by the makefile and specifies the path to the 
+   by the makefile and specifies the path to the
    Google Test directory on the build machine.
    Since local.properties is specific to each build
    system, do not add local.properties to the code repo.
 
    local.properties should contain GTEST_DIR.
    For example:
-   
+
 
    GTEST_DIR := /home/johndoe/utils/gtest-1.7.0
 
-3. The unit test assumes that the "eth0" interface is
-   available.  If not, the unit tests will FAIL.
+3. The unit test assumes that a network interface is available
+   (e.g. "eth0", "wlan0", etc.)
+   If no interface is available, the unit tests will FAIL.
 4. To run the unit test, first build the C OCStack.
    At the time of this writing this was done by running
-   
+
    root/csdk/make deepclean
    root/csdk/make BUILD=release    *default
    root/csdk/make BUILD=debug
@@ -50,3 +54,4 @@ Unit Test Requirements:
    root/csdk/stack/test/release/stacktests
    root/csdk/stack/test/debug/stacktests
 
+