selinux/libsemanage/tests
Nicolas Iooss e1c6df329c libsemanage: silence -Wextra-semi-stmt warning
On Ubuntu 20.04, when building with clang -Werror -Wextra-semi-stmt
(which is not the default build configuration), the compiler reports:

      genhomedircon.c:742:67: error: empty expression statement has no
      effect; remove unnecessary ';' to silence this warning
      [-Werror,-Wextra-semi-stmt]
              const semanage_seuser_t **u2 = (const semanage_seuser_t **) arg2;;
                                                                               ^

Signed-off-by: Nicolas Iooss <nicolas.iooss@m4x.org>
2021-07-06 11:08:11 -04:00
..
.gitignore libsemanage: add helper functions to tests 2019-06-19 09:01:48 -07:00
libsemanage-tests.c libsemanage: silence -Wextra-semi-stmt warning 2021-07-06 11:08:11 -04:00
Makefile libsemanage: add helper functions to tests 2019-06-19 09:01:48 -07:00
nc_sort_malformed
nc_sort_sorted
nc_sort_unsorted
README
test_bool.c Fix many misspellings 2019-09-18 22:47:35 +02:00
test_bool.cil libsemanage: test semanage_bool_* functions 2019-06-19 09:01:48 -07:00
test_bool.h libsemanage: test semanage_bool_* functions 2019-06-19 09:01:48 -07:00
test_fcontext.c libsemanage: test semanage_fcontext functions 2019-06-19 09:01:48 -07:00
test_fcontext.cil libsemanage: test semanage_fcontext functions 2019-06-19 09:01:48 -07:00
test_fcontext.h libsemanage: test semanage_fcontext functions 2019-06-19 09:01:48 -07:00
test_handle.c libsemanage: test semanage_handle_* functions 2019-06-19 09:01:48 -07:00
test_handle.cil libsemanage: test semanage_handle_* functions 2019-06-19 09:01:48 -07:00
test_handle.h libsemanage: test semanage_handle_* functions 2019-06-19 09:01:48 -07:00
test_ibendport.c libsemanage: test semanage_ibendport_* functions 2019-06-19 09:01:48 -07:00
test_ibendport.cil libsemanage: test semanage_ibendport_* functions 2019-06-19 09:01:48 -07:00
test_ibendport.h libsemanage: test semanage_ibendport_* functions 2019-06-19 09:01:48 -07:00
test_iface.c libsemanage: test semanage_iface_* functions 2019-06-19 09:01:48 -07:00
test_iface.cil libsemanage: test semanage_iface_* functions 2019-06-19 09:01:48 -07:00
test_iface.h libsemanage: test semanage_iface_* functions 2019-06-19 09:01:48 -07:00
test_node.c libsemanage: test semanage_node_* functions 2019-06-19 09:01:48 -07:00
test_node.cil libsemanage: test semanage_node_* functions 2019-06-19 09:01:48 -07:00
test_node.h libsemanage: test semanage_node_* functions 2019-06-19 09:01:48 -07:00
test_other.c libsemanage: test semanage_msg_default_handler 2019-06-19 09:01:48 -07:00
test_other.h libsemanage: test semanage_context_* functions 2019-06-19 09:01:48 -07:00
test_port.c libsemanage: test semanage_port_* functions 2019-06-19 09:01:48 -07:00
test_port.cil libsemanage: test semanage_port_* functions 2019-06-19 09:01:48 -07:00
test_port.h libsemanage: test semanage_port_* functions 2019-06-19 09:01:48 -07:00
test_semanage_store.c libsemanage: add helper functions to tests 2019-06-19 09:01:48 -07:00
test_semanage_store.h
test_user.c libsemanage: test semanage_user_* functions 2019-06-19 09:01:48 -07:00
test_user.cil libsemanage: test semanage_user_* functions 2019-06-19 09:01:48 -07:00
test_user.h libsemanage: test semanage_user_* functions 2019-06-19 09:01:48 -07:00
test_utilities.c libsemanage/tests: check that string pointers are not NULL before comparing them 2019-10-01 14:33:04 -04:00
test_utilities.h
utilities.c libsemanage: add helper functions to tests 2019-06-19 09:01:48 -07:00
utilities.h libsepol, libsemanage: add a macro to silence static analyzer warnings in tests 2019-09-30 08:43:41 -04:00

Notes on tests
============================
The semanage_access_check test in the semanage_store suite simulates a
read-only filesystem by using DAC permissions. Consequently, these tests
will fail if run as root, as root can override DAC permissions.


How to add and use unit tests 
=============================

We are using the CUnit unit testing framework.  This framework--and the
official documentation of the framework--may be found here:

http://cunit.sourceforge.net/

If you have not yet installed CUnit, first do that.  (There is an RPM,
or you can compile from source.)  Once installed, follow these steps to
add unit tests for your code:

1. Create a .h and .c file corresponding to the .c file you want to test.
   For example, test_semanage_store.c provides tests of the functions in
   semanage_store.c.   Your new .h/.c files represent a suite of related
   tests.

2. Write or add new tests to a suite.  Tests are simply functions that 
   take the form:

	void test_my_function(void)

   These tests are where you will make calls to the CUnit assertions.
 
   If you are making a new test suite, also add the suite init/cleanup
   functions.  These take the form:

   	int <suite_name>_test_init(void)
    int <suite_name>_cleanup(void)

   These functions will be called before and after the test functions
   in your suite, respectively.  They return 0 on success, 1 on failure.

3. Update libsemanage-tests.c to add your new suite and/or your new tests
   using the DECLARE_SUITE macro in do_tests().

4. Update the Makefile:
     + Make sure that the TESTSRC variable is set to the location
	   of the libsemanage source code you want to test.

5. Compile the libsemanage source code you will be testing, to ensure
   the object files are available and up to date.

6. Run your tests.  Rejoice or despair, as appropriate.


A note on the the utilities.c: Add functions that can be commonly used 
here.  For example, it is handy to have a dummy message callback 
function to silence error messages produced by libsemanage and keep 
your output pretty.  To do this, include utilities.h and specify the
callback like so:

        semanage_handle_t *sh;
        sh = semanage_handle_create();
        sh->msg_callback = test_msg_handler;

Feel free to add other such functions here as well.