# Glossary

> The terms used in the docs of the benchmark image.

Acronyms and terms used on this image's pages. See the [site-wide glossary](https://docs.sparecores.com/glossary.md) for all terms.

## B {#letter-b}

### `brotli` {#brotli}

A lossless compression format by Google, standardized in RFC 7932. It combines LZ77-style matching, Huffman coding, and context modeling with a built-in dictionary of common web text, and is widely used to compress HTTP responses. Its quality levels range from 0 (fastest) to 11 (smallest output). See [RFC 7932](https://www.rfc-editor.org/rfc/rfc7932).

### `bw_mem` {#bw-mem}

The memory bandwidth tool of LMbench. It moves data through a buffer of a given size in one of several modes, such as `rd` (read and sum an array), `wr` (write a constant to each element), `rdwr` (read, then write the same location), and the copy modes `cp`, `fcp`, and `bcopy`. It reports the buffer size in MB and the bandwidth in MB/s; with `-P`, it runs several processes, each with its own buffer, and reports their total bandwidth. See [`bw_mem` manual](https://github.com/intel/lmbench/blob/master/doc/bw_mem.8).

### `bzip2` {#bzip2}

A lossless file compressor by Julian Seward, first released in 1996. It sorts each block of data with the Burrows-Wheeler transform, then encodes it with move-to-front and Huffman coding. It usually compresses better than gzip but runs slower; its levels 1 to 9 set the block size from 100 to 900 kB. See [bzip2](https://sourceware.org/bzip2/).

### `bzip3` {#bzip3}

A lossless compressor by Kamila Szewczyk that, like bzip2, is built on the Burrows-Wheeler transform, combined with context modeling. It typically compresses text better than bzip2, and its configurable block size trades memory use for compression ratio. See [bzip3 on GitHub](https://github.com/kspalaiologos/bzip3).

## C {#letter-c}

### container entrypoint {#container-entrypoint}

The executable that a container image runs when a container starts, set by the `ENTRYPOINT` instruction of its Dockerfile. The image's default command (`CMD`), or the arguments given after the image name in `docker run`, are passed to it as arguments, so an entrypoint can wrap any command, for example to set up the environment or record resource usage first. The `docker run --entrypoint` option replaces it. See [Dockerfile reference](https://docs.docker.com/reference/dockerfile/#entrypoint).

### CPU {#cpu}

**Central Processing Unit**: The general-purpose processor of a computer, which runs the operating system and programs. A CPU has one or more physical cores, and with SMT each core runs two or more hardware threads. See [Wikipedia](https://en.wikipedia.org/wiki/Central_processing_unit).

## G {#letter-g}

### Geekbench {#geekbench}

A cross-platform CPU and GPU compute benchmark by Primate Labs. Its CPU benchmark runs workloads modeled on real applications, such as file compression, image processing, and web browsing, first on one core and then on all cores, and reports a Single-Core and a Multi-Core score. Geekbench 6 scores are calibrated so that a baseline system scores 2500. See [Geekbench](https://www.geekbench.com/).

### Geekbench Browser {#benchmark-geekbench-browser}

The online database of Geekbench results run by Primate Labs. The free version of Geekbench uploads every result there, where it is public; the paid Pro version can also keep results offline. See [Geekbench Browser](https://browser.geekbench.com/).

### `gzip` {#gzip}

A lossless file compressor of the GNU Project, first released in 1992, and its file format, specified in RFC 1952. It uses the DEFLATE algorithm, which combines LZ77 matching and Huffman coding, and is the most widely supported compression format on Unix-like systems and the web. Its levels range from 1 (fastest) to 9 (smallest output). See [GNU gzip](https://www.gnu.org/software/gzip/).

## H {#letter-h}

### HTTPS {#https}

**Hypertext Transfer Protocol Secure**: HTTP, the protocol of the web, encrypted with TLS. It protects requests and responses from eavesdropping and tampering, and its certificates let clients verify the identity of the server. See [Wikipedia](https://en.wikipedia.org/wiki/HTTPS).

## J {#letter-j}

### JSON {#json}

**JavaScript Object Notation**: A text format for structured data, built from objects (key-value pairs), arrays, strings, numbers, booleans, and null. Most languages and tools read and write it, which makes it a common format for API responses and benchmark output. See [JSON](https://www.json.org/).

## L {#letter-l}

### LMbench {#lmbench}

A suite of portable micro-benchmarks for Unix-like systems, written by Larry McVoy and Carl Staelin. Its tools each measure one basic operation, such as memory bandwidth and latency, context switches, or system call overhead. See [LMbench](https://lmbench.sourceforge.net/).

### `lz4` {#lz4}

A lossless compression algorithm and format by Yann Collet from the LZ77 family, built for speed rather than compression ratio. It compresses and especially decompresses much faster than gzip, at a lower ratio; its higher levels use a slower high-compression mode that keeps decompression fast. See [LZ4](https://lz4.org/).

### `lzma` {#lzma}

**Lempel-Ziv-Markov chain Algorithm**: A lossless compression algorithm by Igor Pavlov, used in the 7z and xz formats. It combines LZ77 matching over a large dictionary with range coding, reaching high compression ratios with slow compression and fast decompression. Its presets range from 0 to 9. See [7-Zip LZMA SDK](https://www.7-zip.org/sdk.html).

## N {#letter-n}

### `nice` {#nice}

A Unix command that runs a program with a changed scheduling priority, from -20 (highest) to 19 (lowest). Raising a process's priority above the default needs the `CAP_SYS_NICE` capability, which root has. See [man page](https://man7.org/linux/man-pages/man1/nice.1.html).

## O {#letter-o}

### out-of-memory killer {#out-of-memory-killer}

The Linux kernel mechanism that frees memory when the system, or a cgroup, runs out of it and cannot reclaim enough. It picks a process by a badness score, mostly based on its memory use, and kills it. Container runtimes rely on it to enforce memory limits. See [Linux kernel docs](https://docs.kernel.org/admin-guide/mm/concepts.html#oom-killer).

## P {#letter-p}

### PyPI {#pypi}

**Python Package Index**: The official public repository of third-party Python packages, run by the Python Software Foundation. Tools such as pip download and install packages from it by default. See [PyPI](https://pypi.org/).

## R {#letter-r}

### `resource-tracker` {#resource-tracker}

An open-source Spare Cores tool that runs a command and samples resource usage while it runs, such as CPU, memory, disk, network, GPU, and GPU memory use. It can optionally stream the samples to the Spare Cores Sentinel platform, so that a run can be checked to see its aggregated and detailed resource utilization, e.g., whether it used all CPU or GPU cores as intended while running a Navigator benchmark workload. See [resource-tracker on GitHub](https://github.com/SpareCores/resource-tracker-rs).

## S {#letter-s}

### Silesia corpus {#silesia-corpus}

A set of 12 files, ~211 MB in total, compiled by Sebastian Deorowicz at the Silesian University of Technology to test lossless compression on a mix of data types: text, executables, databases, images, and XML. Its `dickens` file holds the collected works of Charles Dickens, ~10 MB of English text. See [Silesia corpus](https://sun.aei.polsl.pl/~sdeor/index.php?page=silesia).

### SMT {#smt}

**Simultaneous Multithreading**: A CPU technique that runs two (or more) hardware threads on one physical core, sharing its execution units, e.g. Intel Hyper-Threading. It raises throughput when a thread stalls, but the threads compete for the core. Cloud vendors usually sell each thread as a vCPU. See [Wikipedia](https://en.wikipedia.org/wiki/Simultaneous_multithreading).

### stderr {#stderr}

The standard error stream of a process, one of the three standard streams with stdin and stdout. Programs write logs, progress, and error messages to it, so that they stay separate from the output on stdout when the output is redirected to a file or another program. See [Wikipedia](https://en.wikipedia.org/wiki/Standard_streams).

### stdout {#stdout}

The standard output stream of a process, one of the three standard streams with stdin and stderr. Programs write their results to it; a shell can redirect it to a file or another program, such as `> results.jsonl`, while logs on stderr still reach the terminal. See [Wikipedia](https://en.wikipedia.org/wiki/Standard_streams).

### swappiness {#swappiness}

A Linux kernel setting, `vm.swappiness`, that sets how readily the kernel swaps out process memory compared with dropping cached file data when it needs free memory. Higher values swap more eagerly; 0 makes the kernel avoid swapping as long as it can. Container runtimes such as Docker can also set it per container. See [Linux kernel docs](https://docs.kernel.org/admin-guide/sysctl/vm.html#swappiness).

## U {#letter-u}

### URL {#url}

**Uniform Resource Locator**: The address of a resource on the web or a network, such as https://sparecores.com/, made of a scheme, a host, and a path.

## V {#letter-v}

### vCPU {#vcpu}

**virtual CPU**: A CPU of a virtual machine, the unit in which cloud vendors sell compute. It is usually one hardware thread of a physical core with SMT, so two vCPUs may share one physical core. See [Wikipedia](https://en.wikipedia.org/wiki/Virtual_CPU).

## Z {#letter-z}

### `zpaq` {#zpaq}

A lossless compressor and archive format by Matt Mahoney, based on context mixing, which predicts each bit from many models and combines their predictions. It reaches very high compression ratios, but compresses and decompresses slowly, at about the same speed in both directions. Its methods range from 1 (fastest) to 5 (smallest output). See [ZPAQ](https://mattmahoney.net/dc/zpaq.html).

### `zstd` {#zstd}

**Zstandard**: A lossless compression algorithm and format by Yann Collet at Facebook, released in 2016 and specified in RFC 8878. It combines LZ77 matching with fast entropy coding, and its levels, from 1 to 22, cover a wide range of trade-offs, from faster than gzip to ratios close to lzma. Decompression stays fast at every level. See [Zstandard on GitHub](https://github.com/facebook/zstd).
