rename run -> call

Signed-off-by: Jorge Prendes <[email protected]>

Author: jprendes

README.md

@@ -58,7 +58,7 @@ fn main() -> hyperlight_host::Result<()> {
     let message = "Hello, World! I am executing inside of a VM :)\n".to_string();
     // in order to call a function it first must be defined in the guest and exposed so that
     // the host can call it
-    multi_use_sandbox.run::<i32>(
+    multi_use_sandbox.call::<i32>(
         "PrintOutput",
         message,
     )?;

fuzz/fuzz_targets/host_print.rs

@@ -27,7 +27,7 @@ fuzz_target!(
 
     |data: String| -> Corpus {
         let mut sandbox = SANDBOX.get().unwrap().lock().unwrap();
-        let len: i32 = sandbox.run::<i32>(
+        let len: i32 = sandbox.call::<i32>(
             "PrintOutput",
             data,
         )

src/hyperlight_host/benches/benchmarks.rs

@@ -36,7 +36,7 @@ fn guest_call_benchmark(c: &mut Criterion) {
     group.bench_function("guest_call", |b| {
         let mut sbox = create_multiuse_sandbox();
 
-        b.iter(|| sbox.run::<String>("Echo", "hello\n".to_string()).unwrap());
+        b.iter(|| sbox.call::<String>("Echo", "hello\n".to_string()).unwrap());
     });
 
     // Benchmarks a single guest function call.
@@ -46,7 +46,7 @@ fn guest_call_benchmark(c: &mut Criterion) {
         let snapshot = sbox.snapshot().unwrap();
 
         b.iter(|| {
-            sbox.run::<String>("Echo", "hello\n".to_string()).unwrap();
+            sbox.call::<String>("Echo", "hello\n".to_string()).unwrap();
             sbox.restore(&snapshot).unwrap();
         });
     });
@@ -63,7 +63,11 @@ fn guest_call_benchmark(c: &mut Criterion) {
 
         let mut multiuse_sandbox: MultiUseSandbox = uninitialized_sandbox.evolve().unwrap();
 
-        b.iter(|| multiuse_sandbox.run::<i32>("Add", (1_i32, 41_i32)).unwrap());
+        b.iter(|| {
+            multiuse_sandbox
+                .call::<i32>("Add", (1_i32, 41_i32))
+                .unwrap()
+        });
     });
 
     group.finish();
@@ -93,7 +97,7 @@ fn guest_call_benchmark_large_param(c: &mut Criterion) {
 
         b.iter(|| {
             sandbox
-                .run::<()>("LargeParameters", (large_vec.clone(), large_string.clone()))
+                .call::<()>("LargeParameters", (large_vec.clone(), large_string.clone()))
                 .unwrap()
         });
     });

src/hyperlight_host/examples/func_ctx/main.rs

@@ -29,9 +29,9 @@ fn main() {
 
     // Do several calls against a sandbox running the `simpleguest.exe` binary,
     // and print their results
-    let res: String = sbox.run("Echo", "hello".to_string()).unwrap();
+    let res: String = sbox.call("Echo", "hello".to_string()).unwrap();
     println!("got Echo res: {res}");
 
-    let res: i32 = sbox.run("CallMalloc", 200_i32).unwrap();
+    let res: i32 = sbox.call("CallMalloc", 200_i32).unwrap();
     println!("got CallMalloc res: {res}");
 }

src/hyperlight_host/examples/guest-debugging/main.rs

@@ -75,7 +75,7 @@ fn main() -> hyperlight_host::Result<()> {
     let message =
         "Hello, World! I am executing inside of a VM with debugger attached :)\n".to_string();
     multi_use_sandbox_dbg
-        .run::<i32>(
+        .call::<i32>(
             "PrintOutput", // function must be defined in the guest binary
             message.clone(),
         )
@@ -84,7 +84,7 @@ fn main() -> hyperlight_host::Result<()> {
     let message =
         "Hello, World! I am executing inside of a VM without debugger attached :)\n".to_string();
     multi_use_sandbox
-        .run::<i32>(
+        .call::<i32>(
             "PrintOutput", // function must be defined in the guest binary
             message.clone(),
         )

src/hyperlight_host/examples/hello-world/main.rs

@@ -40,7 +40,7 @@ fn main() -> hyperlight_host::Result<()> {
     // Call guest function
     let message = "Hello, World! I am executing inside of a VM :)\n".to_string();
     multi_use_sandbox
-        .run::<i32>(
+        .call::<i32>(
             "PrintOutput", // function must be defined in the guest binary
             message,
         )

src/hyperlight_host/examples/logging/main.rs

@@ -50,7 +50,7 @@ fn main() -> Result<()> {
             // Call a guest function 5 times to generate some log entries.
             for _ in 0..5 {
                 multiuse_sandbox
-                    .run::<String>("Echo", "a".to_string())
+                    .call::<String>("Echo", "a".to_string())
                     .unwrap();
             }
 
@@ -61,7 +61,7 @@ fn main() -> Result<()> {
             // Call a guest function that calls the HostPrint host function 5 times to generate some log entries.
             for _ in 0..5 {
                 multiuse_sandbox
-                    .run::<i32>("PrintOutput", msg.clone())
+                    .call::<i32>("PrintOutput", msg.clone())
                     .unwrap();
             }
             Ok(())
@@ -94,7 +94,7 @@ fn main() -> Result<()> {
 
     for _ in 0..NUM_CALLS {
         barrier.wait();
-        multiuse_sandbox.run::<()>("Spin", ()).unwrap_err();
+        multiuse_sandbox.call::<()>("Spin", ()).unwrap_err();
     }
     thread.join().unwrap();
 

src/hyperlight_host/examples/metrics/main.rs

@@ -61,7 +61,7 @@ fn do_hyperlight_stuff() {
             // Call a guest function 5 times to generate some metrics.
             for _ in 0..5 {
                 multiuse_sandbox
-                    .run::<String>("Echo", "a".to_string())
+                    .call::<String>("Echo", "a".to_string())
                     .unwrap();
             }
 
@@ -72,7 +72,7 @@ fn do_hyperlight_stuff() {
             // Call a guest function that calls the HostPrint host function 5 times to generate some metrics.
             for _ in 0..5 {
                 multiuse_sandbox
-                    .run::<i32>("PrintOutput", msg.clone())
+                    .call::<i32>("PrintOutput", msg.clone())
                     .unwrap();
             }
             Ok(())
@@ -108,7 +108,7 @@ fn do_hyperlight_stuff() {
 
     for _ in 0..NUM_CALLS {
         barrier.wait();
-        multiuse_sandbox.run::<()>("Spin", ()).unwrap_err();
+        multiuse_sandbox.call::<()>("Spin", ()).unwrap_err();
     }
 
     for join_handle in join_handles {

src/hyperlight_host/examples/tracing-chrome/main.rs

@@ -36,7 +36,7 @@ fn main() -> Result<()> {
 
     // do the function call
     let current_time = std::time::Instant::now();
-    let res: String = sbox.run("Echo", "Hello, World!".to_string())?;
+    let res: String = sbox.call("Echo", "Hello, World!".to_string())?;
     let elapsed = current_time.elapsed();
     println!("Function call finished in {:?}.", elapsed);
     assert_eq!(res, "Hello, World!");

src/hyperlight_host/examples/tracing-otlp/main.rs

@@ -136,7 +136,7 @@ fn run_example(wait_input: bool) -> HyperlightResult<()> {
                 // Call a guest function 5 times to generate some log entries.
                 for _ in 0..5 {
                     multiuse_sandbox
-                        .run::<String>("Echo", "a".to_string())
+                        .call::<String>("Echo", "a".to_string())
                         .unwrap();
                 }
 
@@ -147,7 +147,7 @@ fn run_example(wait_input: bool) -> HyperlightResult<()> {
                 // Call a guest function that calls the HostPrint host function 5 times to generate some log entries.
                 for _ in 0..5 {
                     multiuse_sandbox
-                        .run::<i32>("PrintOutput", msg.clone())
+                        .call::<i32>("PrintOutput", msg.clone())
                         .unwrap();
                 }
 
@@ -179,7 +179,7 @@ fn run_example(wait_input: bool) -> HyperlightResult<()> {
                     );
                     let _entered = span.enter();
                     barrier.wait();
-                    multiuse_sandbox.run::<()>("Spin", ()).unwrap_err();
+                    multiuse_sandbox.call::<()>("Spin", ()).unwrap_err();
                 }
                 thread.join().expect("Thread panicked");
             }