dtestx(1)

📦 version 2.1.10.1.f1e05b7a, in debian bookworm, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💅 dtestx — like, the manual page, but make it make sense

okay bestie, gather round, because we're talking about dtestx(1) — it lives in the USER COMMANDS section, and honestly? it's giving niche but iconic. ✨

🦋 NAME 🦋

dtestx — a simple uDAPL extensions test. that's it, that's the whole name section, no notes. 💖

🎀 SYNOPSIS 🎀

dtestx [-vmpqc] [-u|-U ep num] [-P provider] [-b buf size] [ -s | -h HOSTNAME ]

like yes she's compact, she's cute, she's a little cryptic. we'll get into all of it, don't worry. 🫶

✨ DESCRIPTION ✨

so dtestx is a simple test that exists to test extensions to the DAT API. that's the whole assignment.

here's the thing though — you can't just run it once and call it a day. at least two instantiations of the test must be run. one of them acts as the server, and the other one is the client. that's the duo. the friendship bracelet of processes. 😌

the server side of the test, once you invoke it, just sits there listening for connection requests, until it times out or gets killed. very patient. very demure. 🧘

the moment it receives a cd connection request, the connection gets established, and then the server and client sides exchange all the info they need to perform the extensions test. slay. 💅

and the extensions tests themselves are:

  1. Post rdma write with immediate data
  2. Atomic compare and swap
  3. Atomic fetch and add
Note: in case -q is set, only the query test will run. that's it, that's the whole run. no extras.

🔥 OPTIONS 🔥

every single one, no skipping, because we don't do that here:

  • -P=PROVIDER — use PROVIDER to specify the uDAPL interface via /etc/dat.conf. the default is ofa-v2-mlx4_0-1u. 💫
  • -h=HOSTNAME — use HOSTNAME to specify the server hostname or IP address. default is none. 🫥
  • -b=BUFFER_SIZE — use buffer size BUFFER_SIZE for RDMA. default is 64. 🍓
  • -U=EP_COUNT — use EP_COUNT to specify an unreliable datagram test with EP_COUNT UD endpoints. default is none. 📮
  • -v — verbose output. default off. 🔊
  • -q — query only test. default off. 🔍
  • -u — unreliable datagram test. default no. 📡
  • -s — run as server. default — run as server. 🖥️
  • -c — run as client (for non UD tests, -h is always client). 📱
  • -p — print counters. provide IA, EP, or EVD and the call will print the appropriate counters. default off. 🧮
  • -m — multi ep. in ud test only. receive multi messages on a single EP. default off — which means receive one message across multiple EPs. 🌈

🌸 EXAMPLES 🌸

kay so here's how you'd actually use her:

dtestx -P ofa-v2-ib0 -v -s

starts a server process with debug verbosity, using provider ofa-v2-ib0. very demure, very server-coded. 👑

dtestx -P ofa-v2-ib0 -h server1-ib0

starts a client process, using the ofa-v2-ib0 provider to connect to hostname server1-ib0. the client has entered the chat. 🫶

⭐ SEE ALSO ⭐

go read these next, bestie, iykyk:

💜 AUTHORS 💜

the legends who made this happen:

  • Arlin Davis — <arlin.r.davis@intel.com>
  • Amir Hanania — <amir.hanania@intel.com>

and that's the whole page, babe. this one's from uDAPL 2.1, dated November 15, 2016 — old but still serving. periodt. 💅✨🎀

📦 where this page comes from