PingPongClient(1)

πŸ’– PingPongClient β€” bestie edition πŸ’–

okay so real quick, this page lives in the General Commands Manual section (section 1, the "type this in your terminal" zone), and its whole government name is PingPongClient(1). Sit with me for a sec, because this one is genuinely fun πŸ“


✨ NAME ✨

pingpongclient β€” the RSerPool Client (PU) for the PingPong service 🫢


🌈 SYNOPSIS 🌈

pingpongclient [-poolhandle=pool_handle] [-interval=milliseconds]
               [-cspinterval=milliseconds] [-cspserver=address:port]
               [-logappend=filename] [-logcolor=on|off]
               [-logfile=filename] [-loglevel=0-9]

like that's it, that's the whole invocation, she's compact and she knows it πŸ’…


πŸŽ€ DESCRIPTION πŸŽ€

pingpongclient is a Reliable Server Pooling (RSerPool) pool user β€” abbreviated PU, which is the cute technical term, not me being affectionate β€” for the PingPong service.

It's a simple example service. Its whole job is testing RSerPool and its failover functionalities. So basically it's the designated test subject, the lab rat, the girl who volunteers to go first so everyone else knows if it's safe. Respect 🫑


πŸ‘‘ ARGUMENTS πŸ‘‘

okay here come the options, grab a snack, there's a few. The following options are available:

  • -poolhandle=pool_handle β€” sets the PH to a non-default value. If you don't say anything, the default setting is "PingPongPool". so that's your homegirl's factory-installed name 🌸

🧁 Service Parameters

  • -interval=milliseconds β€” sets the request interval in milliseconds. how often she pings. the ping schedule. clocked in and everything ⏰

πŸ¦‹ ASAP Protocol Parameters

the ASAP girlies, let's go:

  • -registrar=address:port β€” adds a static PR entry into the Registrar Table. and listen β€” it is possible to add multiple entries, so stack 'em up, no cap πŸ’…
  • -registrarannouncetimeout=milliseconds β€” sets the timeout for ASAP announces via multicast.
  • -registrarconnecttimeout=milliseconds β€” sets the timeout for ASAP connection establishment.
  • -registrarconnectmaxtrials=trials β€” sets the maximum number of ASAP connection establishment trials.
  • -registrarrequesttimeout=milliseconds β€” sets the timeout for ASAP requests.
  • -registrarresponsetimeout=milliseconds β€” sets the timeout for waiting to receive ASAP responses. (note: waiting to receive, this is the "she said she'd text back" timer 😭)
  • -registrarrequestmaxtrials=trials β€” sets the maximum number of ASAP request trials.

🫢 Component Status Protocol (CSP) Parameters

  • -cspinterval=milliseconds β€” sets the interval for the CSP status updates in milliseconds. by default, the content of the environment variable CSP_INTERVAL is used. and if that's not defined? no CSP status reports will be sent. not one. silence. πŸ™ˆ
  • -cspserver=address:port β€” sets the address of a CSP monitor server. by default, the content of the environment variable CSP_SERVER is used. if that's not defined either, again: no CSP status reports will be sent. it's giving ghosting fr fr

πŸ“ Logging Parameters

  • -logappend=filename β€” write logging output to a file (default is stdout); the output will be appended to the given file. nothing gets deleted, we're keeping the receipts πŸ’–
  • -logcolor=on|off β€” turns ANSI colorization of the logging output on or off. aesthetic choice, both valid, no judgement ✨
  • -logfile=filename β€” write logging output to a file (default is stdout); the given file will be overwritten. so like, be aware, bestie, that one's a clean slate πŸ’€
  • -loglevel=0-9 β€” sets the logging verbosity from 0 (none) to 9 (very verbose). it is recommended to use at least a value of 2 to see possibly important error messages and warnings. do not be a 0 girlie, you will miss the warnings and then you will be sad 😭

🌸 ENVIRONMENT 🌸

pingpongclient uses the environment variables CSP_SERVER and CSP_INTERVAL to define a CSP server to send reports to in the specified interval. girl reads her env vars before she does anything, iconic behavior πŸ‘‘


πŸ’œ DIAGNOSTICS πŸ’œ

if loglevel>0, log messages will be printed to stdout or into a specified log file. that's the deal. turn the level up, get the tea β˜•


⭐ SEE ALSO ⭐

for a detailed introduction to RSerPool, see:

https://duepublico.uni-duisburg-essen.de/servlets/DerivateServlet/Deri‐
vate-16326/Dre2006_final.pdf

Thomas Dreibholz's RSerPool Page:

https://www.nntb.no/~dreibh/rserpool/

⚠️ heads up: those URLs are printed verbatim, including the soft-hyphen break in the long one. copy responsibly 🫢

aaaand that's the whole page!! this one's the PingPong Client page, and the footer info says it's dated May 12, 2025 β€” so mark your calendar, bestie, or don't, it's already in the past, lowkey. mwah, go test that failover πŸ’…πŸ“βœ¨

πŸ“¦ where this page comes from