[WIP] Write Rust Bindings

[YangLiuWillow]

#125 Work in progress.
I created a new directory libcachesim-rs that looks like:

-- libcachesim-rs
     -- bindings
         -- bindings.rs
         -- libwrap_static_fns.a
         -- wrap_static_fns.c
         -- wrap_static_fns.o
     -- src
         -- lib.rs
         -- main.rs
         -- wrapper.rs
     -- build.rs
     -- cargo.toml

In the libcachesim-rs directory, if we run cargo build, the build.rs script will generate the bindings directory and all the files inside this directory. Then we can include the bindings.rs to our lib.rs and write safe Rust wrappers in wrapper.rs. For now, I have pub struct Cache, pub struct Reader, and pub struct Request with all corresponding methods. With these, I write a Rust equivalent test.c file in main.rs.

More Rust wrappers to come.

[1a1a11a]

Awesome! Please let me know if you need me to take a look.

[YangLiuWillow]

I have some questions when testing things out.

How should I create a VSCSI file? I've been trying to run test.c but I can't seem to figure out how to create a VSCSI file other than copy paste the existing ones in data directory and rename them :O.
When I run ./test.out, it gives me this error

[WARN]  03-23-2025 19:34:11    csv.c:61   (tid=8633382976): in_buf_size 1024 is smaller than the first line size 18446744073709551615, the first line will be truncatedAssertion failed: (buf_size < 1024), function csv_detect_header, file csv.c, line 125.
zsh: abort      ../test.out

When running cargo run for main.rs, I get the same error

[WARN]  03-23-2025 19:56:08    csv.c:61   (tid=8633382976): in_buf_size 1024 is smaller than the first line size 18446744073709551615, the first line will be truncatedAssertion failed: (buf_size < 1024), function csv_detect_header, file csv.c, line 125.
zsh: abort      cargo run

I guess I am not as familiar with the code base, but I cannot seem to figure out why for now.

[1a1a11a]

We can use csv and oracleGeneral trace formats for testing. The test.c might be outdated.
Take a look at https://github.com/1a1a11a/libCacheSim/tree/develop/libCacheSim/bin/cachesim
and https://github.com/1a1a11a/libCacheSim/blob/develop/doc/quickstart_cachesim.md#use-different-trace-types

csv traces are easy to generate, to generate oracleGeneral trace, you can use traceConv tool