AMSBENCHR(1)

📦 version 3.2.1, in ubuntu jammy

✨ AMSBENCHR(1) ✨ 🎀 AMS executables 🎀

💖 NAME

okay so bestie, the manual name is amsbenchr and it's the Asynchronous Message Service (AMS) benchmarking meter 🦋 it's giving performance testing, no cap 💅

🌸 SYNOPSIS

amsbenchr

Literally just type amsbenchr and you're in! 🧚

💜 DESCRIPTION

okay so amsbenchr is a test program and it is SO good at what it does 😭 it subscribes to the subject "bench" and receives all the messages that get published by amsbenchs. it keeps going until every message in the test has arrived. how does it know when to stop? it checks the count of remaining messages, which lives in the first four bytes of each message 👑 once everything is received, it stops receiving, calculates and prints the performance stats, and then it terminates. iconic behavior, honestly 💅

amsbenchr registers as an application module in the root unit of the venture identified by application name "amsdemo" and authority name "test" 🌈 before it can start doing its thing, a configuration server for the local continuum and a registrar for the root unit of that venture need to be running. these can both be instantiated in a single amsd daemon task, so it's not a whole thing 🫶 if those aren't running, amsbenchr will not commence operations, so make sure they're up first, bestie 💀

🦋 EXIT STATUS

  • -1 — amsbenchr failed. the reason is noted in the ion.log file 😭
  • "0" — amsbenchr terminated normally, we love to see it 🍓

🎀 FILES

a MIB initialization file with the applicable default name must be present. see amsrc(5) for the details 📁 no MIB file, no amsbenchr 🙈

🌈 ENVIRONMENT

no environment variables apply here ✨ nothing to set up, main character energy 💅

🔥 DIAGNOSTICS

the following diagnostics may be issued to the ion.log log file 🧐

  • amsbenchr can't register. — amsbenchr failed to register, for reasons noted in the ion.log file 💀
  • amsbenchr: subject 'bench' is unknown. — amsbenchr can't subscribe to test messages. this is probably an error in the MIB initialization file, so go check that first 🙈
  • amsbenchr can't subscribe. — amsbenchr failed to subscribe, for reasons noted in the ion.log file 😭
  • amsbenchr can't get event. — amsbenchr failed to receive a message, for reasons noted in the ion.log file 💔

🐛 BUGS

report bugs to <ion-bugs@korgano.eecs.ohiou.edu> 🫶 the devs want to hear from you, bestie 💜

👑 SEE ALSO

  • amsrc(5) — the one and only reference you need to check out 🧚

🌸 okay that's the whole tea, bestie! this page is from the AMS executables set, version perl v5.24.1, dated 2016-07-07 💖✨

📦 where this page comes from