danog/gllvm
1
0
Fork 0
mirror of https://github.com/danog/gllvm.git synced 2024-11-26 19:14:43 +01:00
Code Issues Packages Projects Releases Wiki Activity

Warming to the task of no longer relying on wllvm documentation.

Browse Source
This commit is contained in:
Ian A. Mason 2019-10-28 16:57:12 +00:00
parent 5b1c1b2752
commit 432a6ca326
2 changed files with 45 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
README.md
View File

@ -88,8 +88,10 @@ This should produce the executable `pkg-config`. To extract the bitcode:
get-bc pkg-config
```
which will produce the bitcode module `pkg-config.bc`.
which will produce the bitcode module `pkg-config.bc`. For more on this example
see [here](https://github.com/SRI-CSL/gllvm/tree/master/examples/pkg-config).
## Advanced Configuration
If clang and the llvm tools are not in your `PATH`, you will need to set some
environment variables.
@ -104,12 +106,25 @@ environment variables.
environment variables `LLVM_LINK_NAME` and `LLVM_AR_NAME` in an
analogous way.
Another useful environment variable is `WLLVM_CONFIGURE_ONLY`. Its use is explained in the
README of [wllvm](https://github.com/SRI-CSL/whole-program-llvm).
Another useful environment variable is `WLLVM_CONFIGURE_ONLY`.
`gllvm` does not support the dragonegg plugin. All other features of `wllvm`, such as logging, and the bitcode store,
* `WLLVM_CONFIGURE_ONLY` can be set to anything. If it is set, `gclang`
and `gclang++` behave like a normal C or C++ compiler. They do not
produce bitcode. Setting `WLLVM_CONFIGURE_ONLY` may prevent
configuration errors caused by the unexpected production of hidden
bitcode files. It is sometimes required when configuring a build.
For example:
```
WLLVM_CONFIGURE_ONLY=1 CC=gclang ./configure
make
```
All other features of `wllvm`, such as logging, and the bitcode store,
are supported in exactly the same fashion as documented [here](https://github.com/SRI-CSL/whole-program-llvm).
## Dragons Begone
`gllvm` does not support the dragonegg plugin.
## Under the hoods

26
examples/pkg-config/Makefile Normal file
View File

@ -0,0 +1,26 @@
VERSION=0.29.2
SRC=pkg-config-${VERSION}
TARBALL=${SRC}.tar.gz
URL=https://pkg-config.freedesktop.org/releases/${TARBALL}
all: pkg-config.bc
${TARBALL}:
wget ${URL}
${SRC}: ${TARBALL}
tar xvfz ${TARBALL}
touch ${SRC}
${SRC}/pkg-config:
cd ${SRC}; CC=gclang ./configure --with-internal-glib; make
pkg-config.bc: ${SRC}/pkg-config
get-bc -o pkg-config.bc ${SRC}/pkg-config
clean:
make -C ${SRC} clean
spotless:
rm -rf ${SRC} ${TARBALL} pkg-config.bc