source: icGREP/icgrep-devel/README-icgrep.txt @ 6081

Last change on this file since 6081 was 5178, checked in by cameron, 3 years ago

Simplify build to allow easier determination/selection of LLVM library

File size: 1.9 KB
RevLine 
[4573]1README-icgrep.txt
[3915]2
[4573]3This is the open-source version of icgrep 1.x.     
[3915]4
[4397]5icgrep is a very fast regular expression search program, particularly
6for complex regular expressions.  It is also a very capable engine,
7supporting most common regular expression syntax and many useful
8command line options.   
9
10icgrep 1.0 is designed to offer substantial Unicode support, meeting
11all the Unicode Level 1 requirements of UTS #18, the Unicode
12Technical Standard for regular expressions.
13
[4039]14Normal usage to find lines in a file f matching a regexp r is:
15icgrep r f
16
17To produce a count of matching lines only, use the command:
18icgrep -c r f
19
[4528]20To read the regexp to be matched from file regexpf use the command:
[4039]21
[4528]22icgrep -f regexpf f
[4039]23
[4528]24See http://parabix.costar.sfu.ca/wiki/ICgrep for more information.
[4039]25
26BUILD
27
[3915]28To build icgrep, you need an installed LLVM system providing the
29core libraries.  The distribution includes a suitable source
[4528]30code version of LLVM.   
[3915]31
[5043]32Boost development libraries are required.  Install via a suitable
33command for your OS, for example"
34sudo apt-get install libboost-all-dev
35
[5178]36
[4151]37To build LLVM,
[3915]38(L1) open a terminal window and cd to the llvm-build directory
39(L2) enter the following command to build the makefiles
[5178]40cmake -DCMAKE_INSTALL_PREFIX=../libllvm -DLLVM_TARGETS_TO_BUILD=X86 -DLLVM_BUILD_TOOLS=OFF -DLLVM_BUILD_EXAMPLES=OFF -DCMAKE_BUILD_TYPE=Release ../llvm-3.8.0.src
[3915]41(L3) Still in the llvm-build directory, enter the commands "make" and then "make install"
42
43Using the installed LLVM, building icgrep uses the CMake build
[4151]44system generator.
[3915]45(IC1)  open a terminal window and cd to the icgrep-build directory
[4953]46(IC2)  enter the following command to build the makefiles
[5178]47cmake -DCMAKE_PREFIX_PATH=../libllvm -DCMAKE_BUILD_TYPE=Release ../icgrep
[4151]48(IC3) Enter the command "make"
[3915]49
50LLVM files are governed by the LLVM Release License in LLVM-LICENSE.txt.
51icgrep is governed by Open Software License 3.0 in OSL-3.0.txt.
52
Note: See TracBrowser for help on using the repository browser.