Tools
To interact with PaperCache, we have created two CLI tools: and .
paper-cli
The paper-cli tool allows you to send any of the described command in the wire protocol from the command line. This is useful for monitoring the cache (e.g., checking the statistics at runtime, or changing the eviction policy manually).
Installation
Usage
paper-benchmark
The paper-benchmark tool takes as input a path to a trace and sends the accesses in the trace to a PaperCache instance.
The access trace is in binary format and must be formatted as follows (all values are encoded in little-endian):
| Bytes | Type | Description |
|---|---|---|
| 8 | u64 | The UNIX timestamp in milliseconds. |
| 1 | u8 | The command type. 0 indicates a GET and 1 indicates a SET. |
| 8 | u64 | The access key. |
| 4 | u32 | The access size (i.e., the size of the object in bytes). |
| 4 | u32 | The TTL (a TTL of 0 indicates no expire time). |