package conan

You can search for identifiers within the package.

in-package search v0.2.0

On This Page

recognition.

conan
- Conan
  - Arithmetic
  - Comparison
  - Fmt
    
    Hmap
    
    Key
    
    Map
    
    Tid
  - Integer
  - Metadata
  - Number
  - Offset
  - Parse
  - Process
  - Serialize
  - Sigs
  - Size
  - Test
  - Tree
    
    Unsafe
  - Ty
conan.string
- Conan_string

Legend:
Library
Module
Module type
Parameter
Class
Class type

recognition.

Conan_string is a system-free implementation of the file recognition. This implementation does not uses any syscalls - and it can be safely used into a MirageOS example.

So Conan_string does not have an access to a database. The user must rebuild a Conan.Tree.t by himself via tree_of_string for example. Then, from this tree, the user is able to recognize a payload as a simple string with run:

let v =
  {file|0       byte    0x66
>1      byte    0x6f
>>1     byte    0x6f    foo header
|file}

let tree = match Conan_string.tree_of_string v with
  | Ok tree -> tree
  | Error (`Msg err) -> failwith err

let database = Conan.Tree.database ~tree

let m = match Conan_string.run ~database contents with
  | Ok m -> m
  | Error (`Msg err) -> failwith err

val tree_of_string : string -> (Conan.Tree.t, [> `Msg of string ]) result

tree_of_string str tries to parse the given str as a decision tree according to the libmagic format.

val run : 
  database:Conan.Process.database ->
  string ->
  (Conan.Metadata.t, [> `Msg of string ]) result

run ~database contents tries to recognize the given contents with the help of database. The databse can be made via Conan.Process.database. Indeed, a Conan.Tree.t can have some indirect decision paths so we must pre-process the tree to agglomerate such indirections.