openeuler/hyperscan

Hyperscan Docker镜像文档

镜像概述和主要用途

官方Hyperscan Docker镜像，基于openEuler构建，提供高性能多正则表达式匹配能力。Hyperscan是遵循libpcre正则语法的独立C库，适用于需要高效处理多正则表达式匹配的场景，该镜像免费使用且无用户速率限制。

核心功能和特性

• 高性能多正则表达式匹配引擎，支持复杂模式匹配
• 基于openEuler系统构建，兼容主流架构（amd64、arm64）
• 内置默认单元测试，可直接验证功能完整性
• 支持交互式shell，便于开发调试和运行自定义代码

支持的标签及对应Dockerfile链接

Hyperscan Docker镜像标签由Hyperscan版本和基础镜像版本组成，具体信息如下：

使用方法和配置说明

拉取镜像

根据需求选择对应的{Tag}标签，从Docker仓库拉取镜像：

bash
docker pull openeuler/hyperscan:{Tag}

运行默认单元测试

若启动容器时未指定命令，默认会自动运行单元测试：

bash
docker run -it --rm openeuler/hyperscan:{Tag}

启动交互式shell

通过交互式shell启动容器，可运行自定义代码：

bash
docker run -it --rm openeuler/hyperscan:{Tag} bash

示例：最小Hyperscan程序

创建测试文件

创建test.cpp文件，内容如下：

cpp
#include <hs.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

// 匹配回调函数
static int eventHandler(unsigned int id, unsigned long long from,
                        unsigned long long to, unsigned int flags, void *ctx) {
    printf("Match for pattern ID %u at offset %llu - %llu\n", id, from, to);
    return 0; // 继续扫描
}

int main() {
    const char *pattern = "foo.*bar";    // 正则表达式模式
    const char *input = "some foo stuff and then bar finally";

    hs_database_t *database;
    hs_compile_error_t *compile_err;

    // 编译正则表达式
    if (hs_compile(pattern, HS_FLAG_DOTALL, HS_MODE_BLOCK, NULL, &database, &compile_err) != HS_SUCCESS) {
        fprintf(stderr, "ERROR: Unable to compile pattern \"%s\": %s\n",
                pattern, compile_err->message);
        hs_free_compile_error(compile_err);
        return -1;
    }

    hs_scratch_t *scratch = NULL;

    // 分配临时空间
    if (hs_alloc_scratch(database, &scratch) != HS_SUCCESS) {
        fprintf(stderr, "ERROR: Unable to allocate scratch space.\n");
        hs_free_database(database);
        return -1;
    }

    // 扫描输入缓冲区
    if (hs_scan(database, input, strlen(input), 0, scratch, eventHandler, NULL) != HS_SUCCESS) {
        fprintf(stderr, "ERROR: Unable to scan input buffer.\n");
        hs_free_scratch(scratch);
        hs_free_database(database);
        return -1;
    }

    // 释放资源
    hs_free_scratch(scratch);
    hs_free_database(database);

    return 0;
}

编译程序

使用g++编译并链接Hyperscan库：

bash
g++ test.cpp -o test \
 -I/usr/local/include/hs \
 -L/usr/local/lib \
 -lhs

运行程序

bash
$ ./test
Match for pattern ID 0 at offset 0 - 27

问题与反馈

如有疑问或需使用特殊功能，请在openeuler-docker-images提交issue或pull request。