• Home
  • History
  • Annotate
Name Date Size #Lines LOC

..16-Dec-2021-

m4/H16-Dec-2021-26,21821,069

maint/H16-Dec-2021-7054

misc/H08-Jan-2019-1813

src/H16-Dec-2021-4,7233,621

test/H16-Dec-2021-11,5649,870

.gitignoreH A D08-Jan-2019604 5146

.travis.ymlH A D08-Jan-2019954 4539

COPYRIGHTH A D08-Jan-20191.3 KiB3424

Doxyfile.inH A D08-Jan-201973.9 KiB1,7831,291

Makefile.amH A D08-Jan-2019400 2916

Makefile.inH A D16-Dec-202129.5 KiB929821

READMEH A D16-Dec-20213.5 KiB14186

README.mdH A D08-Jan-20193.6 KiB14186

aclocal.m4H A D16-Dec-202144 KiB1,2381,125

autogen.shH A D08-Jan-20191.2 KiB4726

configureH A D16-Dec-2021589.1 KiB19,30216,139

configure.acH A D08-Jan-201912.4 KiB412364

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