hypervectorscan-sys 0.1.12

Raw FFI bindings to [Hyperscan](https://github.com/intel/hyperscan) / [Vectorscan](https://github.com/VectorCamp/vectorscan).
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

# hypervectorscan-sys

[:us: English](README.md) | [:cn: 中文](README-cn.md)

Raw FFI bindings to [Hyperscan](https://github.com/intel/hyperscan) / [Vectorscan](https://github.com/VectorCamp/vectorscan).

## Build modes

| Feature            | Description                                        | System Dependencies                    |
|--------------------|----------------------------------------------------|----------------------------------------|
| `autobuild`        | Auto-detect: conan2 → vcpkg → system → vendored    | None required                          |
| `conan2`           | Force Conan package manager                        | conan CLI                              |
| `vcpkg`            | Force vcpkg package manager                        | vcpkg                                  |
| `system`           | Force system-installed library (pkg-config)        | pkg-config + libhs-dev / vectorscan-dev |
| `vendored`         | Force bundled source cmake build                   | cmake, C++ compiler, ragel, boost-dev  |
| `avx512`           | Enable AVX512 (vendored x86_64 only)               | —                                      |
| `avxvnni`          | Enable AVX512VBMI (vendored x86_64 only)           | —                                      |

### autobuild priority

```
detect conan  →  found → conan2 build
     ↓ not found
detect vcpkg  →  found → vcpkg build
     ↓ not found
detect system (pkg-config) → found → system build
     ↓ not found
vendored (bundled source cmake build)
```

### system mode support

| OS           | system mode | Installation                     |
|--------------|:-----------:|----------------------------------|
| **Linux**    | ✅          | `apt install libhyperscan-dev`   |
| **macOS**    | ✅          | `brew install hyperscan`         |
| **Windows**  | ❌ (skipped) | Use vcpkg instead               |

## Supported targets

| Architecture        | Hyperscan | Vectorscan | vendored backend  |
|---------------------|:--:|:--:|--------------------|
| x86_64              | ✅ | ✅ | hyperscan-src      |
| aarch64/arm64       | ❌ | ✅ | vectorscan-src     |
| ppc64/riscv/others  | ❌ | ❌ | vectorscan-src (SIMDe) |

## Backend selection

`build.rs` auto-selects based on the `TARGET` environment variable:

- **x86_64**: Hyperscan (all modes)
  - Prebuilt packages for Linux x86_64 include AVX-512 instructions, which may SIGILL on unsupported CPUs → force FAT_RUNTIME source build
- **Non-x86_64**: Vectorscan (Hyperscan only supports x86_64)

## Conanfiles

- `conanfile-hyperscan.txt` — Hyperscan 5.4.2
- `conanfile-vectorscan.txt` — Vectorscan 5.4.11

## publish

`cargo publish --dry-run  --features autobuild`