1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
|
# Building JSS
As of version 4.5.1, JSS has moved to a CMake build system. This is a modern
alternative to our legacy build system and gives us a standard framework for
building and testing JSS. This also allows us to support parallel builds
and tests; to take advantage of this, specify the `-j` flag when using
`make` or `ctest`.
Please make sure the required dependencies are installed prior to building
(see: [`docs/dependencies`](dependencies.md)).
## In-Source Build
To build JSS from the source release, use `cmake`; JSS behaves much like
a regular CMake project.
### Building JSS
To build JSS using CMake:
cd jss/build
cmake ..
make all
To later rebuild from scratch, remove the build directory and recreate it.
This ensures that any new dependencies are reflected in the build system.
cd jss
rm -rf build && mkdir build && cd build
cmake ..
make all
### Building Documentation
Optionally, build the javadocs:
cd jss/build
make javadoc
### Testing
To run the test suite:
cd jss/build
make test
Note that the test suite currently doesn't handling re-running without
clearing the results directory. To re-run the test suite:
cd jss/build
rm -rf results
mkdir -p results/tests results/fips
make test
Alternatively, use CTest to run the test suite:
ctest --output-on-failure
Helpful flags for ctest are `--verbose` and `--output-log`; for more
information, read `man ctest`.
### Installation
To install JSS, place `jss.jar` and `libjss.so` in places where the system
can find them. We recommend the following locations on a 64-bit system:
cd jss/build
sudo cp jss.jar /usr/lib/java/jss.jar
sudo chown root:root /usr/lib/java/jss.jar
sudo chmod 644 /usr/lib/java/jss.jar
sudo cp libjss.so /usr/lib64/jss/libjss.so
sudo chown root:root /usr/lib64/jss/libjss.so
sudo chmod 755 /usr/lib64/jss/libjss.so
To uninstall, simply remove the created files (`/usr/lib/java/jss.jar` and
`/usr/lib64/jss/libjss.so`).
Note that the preferred way to install JSS is from your distribution or via
an RPM built with `build.sh`.
## RPM Builds
To build a RPM release, please ensure all dependencies are installed:
sudo dnf install rpm-build
cd jss && sudo dnf builddep --spec jss.spec
Then, issue a build using the `build.sh` interface:
./build.sh rpm
This will build RPMS and place them in `$HOME/build/jss` by default. For more
information about this build script, refer to its help text:
./build.sh --help
|
