source: icGREP/icgrep-devel/README-icgrep-0.9.txt @ 4151

Last change on this file since 4151 was 4151, checked in by linmengl, 5 years ago

experimental support for BLOCK_SIZE 256 ready to test

File size: 2.2 KB
RevLine 
[4039]1README-icgrep-0.9.txt
[3915]2
[4151]3This is the open-source version of icgrep 0.9.   icgrep is a
[4039]4very fast regular expression search program, particularly
[4151]5for complex regular expressions.
[3915]6
[4039]7Normal usage to find lines in a file f matching a regexp r is:
8icgrep r f
9
10To produce a count of matching lines only, use the command:
11icgrep -c r f
12
13To read the regexp to be matched from file rf use the command:
14
15icgrep -f rf f
16
17icgrep supports standard egrep syntax, except for Posix character
[4151]18classes.   icgrep supports searches using ASCII or UTF-8.
[4039]19Unicode two letter classes are supported, e.g. \p{Ll} matching
20lower case Unicode letters and \P{Lu} matching all characters
21that are not upper case letters.
22
23Full Unicode level 1 support is planned for icgrep 1.0.
24
25BUILD
26
[3915]27To build icgrep, you need an installed LLVM system providing the
28core libraries.  The distribution includes a suitable source
29code version of LLVM.
30
[4151]31To build LLVM,
[3915]32(L1) open a terminal window and cd to the llvm-build directory
33(L2) enter the following command to build the makefiles
34cmake -DCMAKE_INSTALL_PREFIX=../libllvm -DLLVM_TARGETS_TO_BUILD=X86 -DLLVM_BUILD_TOOLS=OFF -DLLVM_BUILD_EXAMPLES=OFF -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_COMPILER:FILEPATH=/usr/bin/clang++ -DCMAKE_C_COMPILER:FILEPATH=/usr/bin/clang ../llvm-3.4.2.src
35(L3) Still in the llvm-build directory, enter the commands "make" and then "make install"
36
37Using the installed LLVM, building icgrep uses the CMake build
[4151]38system generator.
[3915]39(IC1)  open a terminal window and cd to the icgrep-build directory
40(IC2)  enter the following command to build the makefiles
[3916]41cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_COMPILER:FILEPATH=/usr/bin/clang++ -DCMAKE_C_COMPILER:FILEPATH=/usr/bin/clang ../icgrep
[4151]42(IC3) Enter the command "make"
[3915]43
44LLVM files are governed by the LLVM Release License in LLVM-LICENSE.txt.
45icgrep is governed by Open Software License 3.0 in OSL-3.0.txt.
46
[4151]47### Experimental 256-bit BLOCK_SIZE
48(IC1)  open a terminal window and cd to the icgrep-build directory
49(IC2)  enter the following command to build the makefiles
50cmake -DBLOCK_SIZE_256=on -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_COMPILER:FILEPATH=/usr/bin/g++ -DCMAKE_C_COMPILER:FILEPATH=/usr/bin/gcc ../icgrep
51(IC3) Enter the command "make"
[3915]52
[4151]53
Note: See TracBrowser for help on using the repository browser.