•  


GitHub - cloudflare/wirefilter: An execution engine for Wireshark-like filters
Skip to content

cloudflare/wirefilter

Wirefilter

Build status Crates.io License

This is an execution engine for Wireshark® -like filters.

It contains public APIs for parsing filter syntax, compiling them into an executable IR and, finally, executing filters against provided values.

Example

use
 wirefilter
::
{
ExecutionContext
,
 Scheme
,
 Type
}
;


fn
 main
(
)
 -> 
Result
<
(
)
,
 failure
::
Error
>
 {

    // Create a map of possible filter fields.

    let
 scheme = 
Scheme
!
 {

        http.method: 
Bytes
,
        http.ua: 
Bytes
,
        port: 
Int
,
    
}
;


    // Parse a Wireshark-like expression into an AST.

    let
 ast = scheme
.
parse
(
r#"

        http.method != "POST" &&

        not http.ua matches "(googlebot|facebook)" &&

        port in {80 443}

    "#
)
?
;


    println
!
(
"Parsed filter representation: {:?}"
, ast
)
;


    // Compile the AST into an executable filter.

    let
 filter = ast
.
compile
(
)
;


    // Set runtime field values to test the filter against.

    let
 mut
 ctx = 
ExecutionContext
::
new
(
&
scheme
)
;


    ctx
.
set_field_value
(
"http.method"
,
 "GET"
)
?
;


    ctx
.
set_field_value
(

        "http.ua"
,

        "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:66.0) Gecko/20100101 Firefox/66.0"
,

    )
?
;


    ctx
.
set_field_value
(
"port"
,
 443
)
?
;


    // Execute the filter with given runtime values.

    println
!
(
"Filter matches: {:?}"
, filter.execute
(
&ctx
)
?
)
;
 // true


    // Amend one of the runtime values and execute the filter again.

    ctx
.
set_field_value
(
"port"
,
 8080
)
?
;


    println
!
(
"Filter matches: {:?}"
, filter.execute
(
&ctx
)
?
)
;
 // false


    Ok
(
(
)
)

}

Licensing

Licensed under the MIT license. See the LICENSE file for details.

- "漢字路" 한글한자자동변환 서비스는 교육부 고전문헌국역지원사업의 지원으로 구축되었습니다.
- "漢字路" 한글한자자동변환 서비스는 전통문화연구회 "울산대학교한국어처리연구실 옥철영(IT융합전공)교수팀"에서 개발한 한글한자자동변환기를 바탕하여 지속적으로 공동 연구 개발하고 있는 서비스입니다.
- 현재 고유명사(인명, 지명등)을 비롯한 여러 변환오류가 있으며 이를 해결하고자 많은 연구 개발을 진행하고자 하고 있습니다. 이를 인지하시고 다른 곳에서 인용시 한자 변환 결과를 한번 더 검토하시고 사용해 주시기 바랍니다.
- 변환오류 및 건의,문의사항은 juntong@juntong.or.kr로 메일로 보내주시면 감사하겠습니다. .
Copyright ⓒ 2020 By '전통문화연구회(傳統文化硏究會)' All Rights reserved.
 한국   대만   중국   일본