54 lines
1.3 KiB
Markdown
54 lines
1.3 KiB
Markdown
# Pact #
|
|
This library will provided the binding for the standard 'C' functions.
|
|
Later, as a stretch goal, this library will attempt to implement those
|
|
functions in Rust.
|
|
|
|
## Features ##
|
|
This library handles several different ways of providing what is needed
|
|
at the 'C' binding level.
|
|
|
|
### Standard C Library ###
|
|
|
|
This is the default feature set.
|
|
|
|
It will provide a link to the 'C' standard library. This will make it so
|
|
that your code is executable and can call functions and use structures from
|
|
the standard 'C' library.
|
|
|
|
### Rust C Library ###
|
|
|
|
```
|
|
default-features = false
|
|
features = ["rust_lib"]
|
|
```
|
|
|
|
Currently, this does not work. Later, this will provide a Rust version of
|
|
all the 'C' standard library functions. This is a **huge** stretch goal.
|
|
It may not happen, or it may take a really long time to get this done.
|
|
This will require alot of platform specific work.
|
|
|
|
### No Memory Manipulation ###
|
|
|
|
```
|
|
default-features = false
|
|
features = ["no_mem_manip"]
|
|
```
|
|
|
|
This feature tells the library to not define the memory manipulation
|
|
functions that Rust requires for LLVM. These are:
|
|
|
|
* memcpy
|
|
* memmove
|
|
* memcmp
|
|
* memset
|
|
|
|
### Weak ###
|
|
|
|
```
|
|
default-features = false
|
|
features = ["no_mem_manip", "weak"]
|
|
```
|
|
|
|
Activates weak linkage on ELF objects. This is only useful when combined with
|
|
the 'no_mem_manip' feature.
|