Obtaining the sources
=====================
Source tarballs for nss_wrapper can be downloaded from
https://ftp.samba.org/pub/cwrap/
The source code repository for socket wrapper is located under
git://git.samba.org/nss_wrapper.git
To create a local copy, run
$ git clone git://git.samba.org/nss_wrapper.git
$ cd nss_wrapper
Building from sources
=====================
nss_wrapper uses cmake (www.cmake.org) as its build system.
In an unpacked sources base directory, create a directory to
contain the build results, e.g.
$ mkdir obj
$ cd obj
Note that "obj" is just an example. The directory can
be named arbitrarily.
Next, run cmake to configure the build, e.g.
$ cmake -DCMAKE_INSTALL_PREFIX=<prefix> ..
or on a 64 bit red hat system:
$ cmake -DCMAKE_INSTALL_PREFIX=<prefix> -DLIB_SUFFIX=64 ..
The "<prefix>" should be replaced by the intended installation
target prefix directory, typically /usr or /usr/local.
Note that the target directory does not have to be a direct
or indirect subdirectory of the source base directory: It can
be an arbitrary directory in the system. In the general case,
".." has to be replaced by a relative or absolute path of the
source base directory in the "cmake" command line.
One can control the build type with "-DCMAKE_BUILD_TYPE=<mode>"
where <mode> can be one of Debug, Release, RelWithDebInfo, and
some more (see cmake.org). The default is "RelWithDebInfo".
After configuring with cmake, run the build with
$ make
Unit testing
============
In order to support running the test suite after building,
the cmocka unit test framework needs to be installed (cmocka.org),
and you need to specify
-DUNIT_TESTING=ON
in the cmake run. After running "make",
$ make test
runs the test suite.
Installing
==========
nss_wrapper is installed into the prefix directory
after running "cmake" and "make" with
$ make install