|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 16-Dec-2021 | - |
| m4/ | H | 16-Dec-2021 | - | 26,218 | 21,069 |
| maint/ | H | 16-Dec-2021 | - | 70 | 54 |
| misc/ | H | 08-Jan-2019 | - | 18 | 13 |
| src/ | H | 16-Dec-2021 | - | 4,723 | 3,621 |
| test/ | H | 16-Dec-2021 | - | 11,564 | 9,870 |
| .gitignore | H A D | 08-Jan-2019 | 604 | 51 | 46 |
| .travis.yml | H A D | 08-Jan-2019 | 954 | 45 | 39 |
| COPYRIGHT | H A D | 08-Jan-2019 | 1.3 KiB | 34 | 24 |
| Doxyfile.in | H A D | 08-Jan-2019 | 73.9 KiB | 1,783 | 1,291 |
| Makefile.am | H A D | 08-Jan-2019 | 400 | 29 | 16 |
| Makefile.in | H A D | 16-Dec-2021 | 29.5 KiB | 929 | 821 |
| README | H A D | 16-Dec-2021 | 3.5 KiB | 141 | 86 |
| README.md | H A D | 08-Jan-2019 | 3.6 KiB | 141 | 86 |
| aclocal.m4 | H A D | 16-Dec-2021 | 44 KiB | 1,238 | 1,125 |
| autogen.sh | H A D | 08-Jan-2019 | 1.2 KiB | 47 | 26 |
| configure | H A D | 16-Dec-2021 | 589.1 KiB | 19,302 | 16,139 |
| configure.ac | H A D | 08-Jan-2019 | 12.4 KiB | 412 | 364 |
README
1[![Build Status](https://travis-ci.org/halimamer/izem.svg?branch=master)](https://travis-ci.org/halimamer/izem)
2
3 Izem Release 0.1
4
5Izem is a shared-memory synchronization library that offers several
6synchronization mechanisms (e.g. locks and conditional variables)
7and also concurrent data-structures (e.g. lists and queues).
8
91. Getting Started
102. Testing
113. Reporting Problems
124. Etymology
13
14-------------------------------------------------------------------------
15
161. Getting Started
17==================
18
19The following instructions take you through a sequence of steps to get
20the default configuration up and running.
21
22(a) You will need the following prerequisites.
23
24 - REQUIRED: This tar file izem-0.1.tar.gz
25
26 - REQUIRED: A C compiler (gcc is sufficient)
27
28 Also, you need to know what shell you are using since different shell
29 has different command syntax. Command "echo $SHELL" prints out the
30 current shell used by your terminal program.
31
32(b) Unpack the tar file and go to the top level directory:
33
34 tar xzf izem-0.1.tar.gz
35 cd izem-0.1
36
37 If your tar doesn't accept the z option, use
38
39 gunzip izem-0.1.tar.gz
40 tar xf izem-0.1.tar
41 cd izem-0.1
42
43(c) Choose an installation directory, say
44 /home/<USERNAME>/izem-install, which is assumed to non-existent
45 or empty.
46
47(d) Specify the installation directory:
48
49 for csh and tcsh:
50
51 ./configure --prefix=/home/<USERNAME>/izem-install |& tee c.txt
52
53 for bash and sh:
54
55 ./configure --prefix=/home/<USERNAME>/izem-install 2>&1 | tee c.txt
56
57 Bourne-like shells, sh and bash, accept "2>&1 |". Csh-like shell,
58 csh and tcsh, accept "|&". If a failure occurs, the configure
59 command will display the error. Most errors are straight-forward
60 to follow.
61
62(e) Build Izem:
63
64 for csh and tcsh:
65
66 make |& tee m.txt
67
68 for bash and sh:
69
70 make 2>&1 | tee m.txt
71
72 This step should succeed if there were no problems with the
73 preceding step. Check file m.txt. If there were problems, do a
74 "make clean" and then run make again with V=1.
75
76 make V=1 |& tee m.txt (for csh and tcsh)
77
78 OR
79
80 make V=1 2>&1 | tee m.txt (for bash and sh)
81
82 Then go to step (3) below, for reporting the issue to the Izem
83 developers and other users.
84
85(f) Install Izem:
86
87 for csh and tcsh:
88
89 make install |& tee mi.txt
90
91 for bash and sh:
92
93 make install 2>&1 | tee mi.txt
94
95 This step collects all required executables and scripts in the bin
96 subdirectory of the directory specified by the prefix argument to
97 configure.
98
99-------------------------------------------------------------------------
100
1012. Testing
102===================
103
104We package a test suite in the Izem distribution. You can run the test
105suite in the test directory using:
106
107 make check
108
109 OR
110
111 make testing
112
113The distribution also includes some Izem examples. You can run
114them in the examples directory using:
115
116 make check
117
118 OR
119
120 make testing
121
122If you run into any problems on running the test suite or examples,
123please follow step (3) below for reporting them to the Izem
124developers and other users.
125
126-------------------------------------------------------------------------
127
1283. Reporting Problems
129=====================
130
131If you have problems with the installation or usage of Izem, please
132contact Halim Amer at aamer (at) anl (dot) gov
133
134-------------------------------------------------------------------------
135
1364. Etymology
137=====================
138
139Izem means Lion in Berber. "I" here is pronounced "E" in English (the
140whole word will sound similar to "Eden").
141
README.md
1[![Build Status](https://travis-ci.org/halimamer/izem.svg?branch=master)](https://travis-ci.org/halimamer/izem)
2
3 Izem Release %VERSION%
4
5Izem is a shared-memory synchronization library that offers several
6synchronization mechanisms (e.g. locks and conditional variables)
7and also concurrent data-structures (e.g. lists and queues).
8
91. Getting Started
102. Testing
113. Reporting Problems
124. Etymology
13
14-------------------------------------------------------------------------
15
161. Getting Started
17==================
18
19The following instructions take you through a sequence of steps to get
20the default configuration up and running.
21
22(a) You will need the following prerequisites.
23
24 - REQUIRED: This tar file izem-%VERSION%.tar.gz
25
26 - REQUIRED: A C compiler (gcc is sufficient)
27
28 Also, you need to know what shell you are using since different shell
29 has different command syntax. Command "echo $SHELL" prints out the
30 current shell used by your terminal program.
31
32(b) Unpack the tar file and go to the top level directory:
33
34 tar xzf izem-%VERSION%.tar.gz
35 cd izem-%VERSION%
36
37 If your tar doesn't accept the z option, use
38
39 gunzip izem-%VERSION%.tar.gz
40 tar xf izem-%VERSION%.tar
41 cd izem-%VERSION%
42
43(c) Choose an installation directory, say
44 /home/<USERNAME>/izem-install, which is assumed to non-existent
45 or empty.
46
47(d) Specify the installation directory:
48
49 for csh and tcsh:
50
51 ./configure --prefix=/home/<USERNAME>/izem-install |& tee c.txt
52
53 for bash and sh:
54
55 ./configure --prefix=/home/<USERNAME>/izem-install 2>&1 | tee c.txt
56
57 Bourne-like shells, sh and bash, accept "2>&1 |". Csh-like shell,
58 csh and tcsh, accept "|&". If a failure occurs, the configure
59 command will display the error. Most errors are straight-forward
60 to follow.
61
62(e) Build Izem:
63
64 for csh and tcsh:
65
66 make |& tee m.txt
67
68 for bash and sh:
69
70 make 2>&1 | tee m.txt
71
72 This step should succeed if there were no problems with the
73 preceding step. Check file m.txt. If there were problems, do a
74 "make clean" and then run make again with V=1.
75
76 make V=1 |& tee m.txt (for csh and tcsh)
77
78 OR
79
80 make V=1 2>&1 | tee m.txt (for bash and sh)
81
82 Then go to step (3) below, for reporting the issue to the Izem
83 developers and other users.
84
85(f) Install Izem:
86
87 for csh and tcsh:
88
89 make install |& tee mi.txt
90
91 for bash and sh:
92
93 make install 2>&1 | tee mi.txt
94
95 This step collects all required executables and scripts in the bin
96 subdirectory of the directory specified by the prefix argument to
97 configure.
98
99-------------------------------------------------------------------------
100
1012. Testing
102===================
103
104We package a test suite in the Izem distribution. You can run the test
105suite in the test directory using:
106
107 make check
108
109 OR
110
111 make testing
112
113The distribution also includes some Izem examples. You can run
114them in the examples directory using:
115
116 make check
117
118 OR
119
120 make testing
121
122If you run into any problems on running the test suite or examples,
123please follow step (3) below for reporting them to the Izem
124developers and other users.
125
126-------------------------------------------------------------------------
127
1283. Reporting Problems
129=====================
130
131If you have problems with the installation or usage of Izem, please
132contact Halim Amer at aamer (at) anl (dot) gov
133
134-------------------------------------------------------------------------
135
1364. Etymology
137=====================
138
139Izem means Lion in Berber. "I" here is pronounced "E" in English (the
140whole word will sound similar to "Eden").
141