2016-12-17 17:30:33 +13:00
# libsam3
2016-12-18 16:07:31 +13:00
[](https://travis-ci.org/i2p/libsam3)
2016-12-17 17:30:33 +13:00
A C library for the [SAM v3 API ](https://geti2p.net/en/docs/api/samv3 ).
2016-12-17 18:11:14 +13:00
2017-04-02 08:53:48 +12:00
## Development Status
2020-11-20 11:53:26 -05:00
Maintained by idk, PRs are accepted on [I2P gitlab ](https://i2pgit.org/i2p-hackers/libsam3 )/[I2P gitlab ](http://git.idk.i2p/i2p-hackers/libsam3 ), and on github at the official mirror repository: [i2p/libsam3 ](https://github.com/i2p/libsam3 ).
2017-04-02 08:53:48 +12:00
2016-12-17 18:11:14 +13:00
## Usage
Copy the two files from one of the following locations into your codebase:
- `src/libsam3` - Synchronous implementation.
- `src/libsam3a` - Asynchronous implementation.
See `examples/` for how to use various parts of the API.
2020-11-18 15:02:44 -05:00
## Cross-Compiling for Windows from debian:
Set your cross-compiler up:
``` sh
export CC=x86_64-w64-mingw32-gcc
export CFLAGS='-Wall -O2 '
export LDFLAGS='-lmingw32 -lws2_32 -lwsock32 -mwindows'
```
2020-11-18 15:13:57 -05:00
and run `make build` . Only libsam3 is available for Windows, libsam3a will be
made available at a later date.
2020-11-20 11:53:26 -05:00
`
## Linker(Windows)
When building for Windows remember to set the flags to link to the Winsock and Windows
libraries.
`-lmingw32 -lws2_32 -lwsock32 -mwindows`
This may apply when cross-compiling or compiling from Windows with mingw.
## Cool Projects using libsam3
Are you using libsam3 to provide an a cool I2P based feature to your project? Let us know about it(and how
it uses libsam3) and we'll think about adding it here*!
1. [Retroshare ](https://retroshare.cc )
*Projects which are listed here must be actively maintained. Those which intentionally violate
the law or the rights of a person or persons directly won't be considered. Neither will obvious
trolling. The maintainer will make the final decision.