Add s3-benchrunner-c for testing aws-c-s3

benchmarks/Test.json

@@ -0,0 +1,11 @@
+{
+    "version": 1,
+    "comment": "Test benchmark",
+    "maxRepeatCount": 3,
+    "maxRepeatSecs": 10,
+    "checksum": "none",
+    "filesOnDisk": true,
+    "tasks": [
+        {"type": "download", "key": "1MiB/1", "size": "1MiB"}
+    ]
+}

runners/README.md

@@ -0,0 +1,21 @@
+# Benchmark Runners
+
+A runner must be built for each library we want to test.
+For example, [s3-benchrunner-c](s3-benchrunner-c/) tests the
+[aws-c-s3](https://github.com/awslabs/aws-c-s3/) library.
+
+# Running
+
+All runners have the same command line interface:
+
+`runner-cmd <benchmark.json> <bucket> <region> <target-throughput-Gbps>`
+
+*   `runner-cmd`: Command to launch runner (e.g. `java -jar target/s3-benchrunner.java`)
+*   `<benchmark.json>`: Path to benchmark JSON file (see: [benchmarks/](../benchmarks))
+*   `<bucket>`: S3 bucket name (e.g. "my-test-bucket")
+*   `<region>`: AWS Region (e.g. "us-west-2")
+*   `<target-throughput-Gbps>`: Target throughput, in gigabits per second. Floating point allowed. Enter the EC2 type's "Network Bandwidth (Gbps)" (e.g. "100.0" for [c5n.18xlarge](https://aws.amazon.com/ec2/instance-types/c5/))
+
+Your machine must have AWS credentials for accessing the bucket.
+Most runners should search for AWS credentials
+[something like this](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html#configure-precedence).

runners/s3-benchrunner-c/CMakeLists.txt

@@ -0,0 +1,26 @@
+cmake_minimum_required(VERSION 3.22)
+cmake_policy(VERSION 3.22...3.24)
+project(s3-benchrunner-c CXX)
+
+add_executable(${PROJECT_NAME} benchrunner.cpp)
+
+install(TARGETS ${PROJECT_NAME}
+    DESTINATION ${CMAKE_INSTALL_BINDIR})
+
+set_target_properties(${PROJECT_NAME} PROPERTIES
+    CXX_STANDARD 20)
+
+if(NOT MSVC)
+    target_compile_options(${PROJECT_NAME} PRIVATE "-fno-exceptions;-fno-rtti")
+endif()
+
+# dependencies
+include(FetchContent)
+
+# using this JSON library because it's simple, and they documented how to integrate with CMake
+FetchContent_Declare(json URL https://github.com/nlohmann/json/releases/download/v3.11.2/json.tar.xz)
+FetchContent_MakeAvailable(json)
+
+find_package(aws-c-s3 REQUIRED)
+
+target_link_libraries(${PROJECT_NAME} AWS::aws-c-s3 nlohmann_json)

runners/s3-benchrunner-c/README.md

@@ -0,0 +1,22 @@
+# s3-benchrunner-c
+
+s3-benchrunner for [aws-c-s3](https://github.com/awslabs/aws-c-s3)
+
+## Building
+
+First, follow the build/install directions for [aws-c-s3](https://github.com/awslabs/aws-c-s3#building).
+
+Build with `-DCMAKE_BUILD_TYPE=Release` for performance testing or `Debug` for debugging.
+
+If you didn't install to a system directory, you'll need to set
+`CMAKE_PREFIX_PATH=<s3-install-dir>` in the following steps:
+
+```sh
+cd aws-crt-s3-benchmarks/runners/s3-benchrunner-c
+cmake -S . -B build -DCMAKE_PREFIX_PATH={aws-c-s3-install-dir} -DCMAKE_BUILD_TYPE={Release,RelWithDebInfo,Debug}
+cmake --build build
+```
+
+## Running
+
+See [instructions here](../README.md)