MEMTOUCH(1)

πŸ’… MEMTOUCH(1) β€” the libmemcached-awesome girlies' guide πŸ’…

okay so bestie, sit down, grab a strawberry drink πŸ“, because we're talking about memtouch, which lives in the libmemcached-awesome manual, section 1. she's a tiny little client program and honestly she's iconic for how simple she is πŸ’–


✨ NAME ✨

memtouch β€” the libmemcached documentation, aka the page you're reading right now, no cap πŸŽ€


✨ SYNOPSIS ✨

memtouch [options] <key>

that's it. that's the whole vibe check. one key, some options, done. πŸ¦‹


✨ DESCRIPTION ✨

so memtouch does a "touch" on the key you give it. that's literally the whole thing, and honestly? love that for her. she's not doing too much, she's just touching your key and moving on. main character energy but make it efficient πŸ’…


🌸 OPTIONS 🌸

okay this is the part where we go through every single flag, and yes, all of them, because we don't skip πŸ’œ

  • -h, --help β€” displays help. when in doubt, hit this and let her explain herself 🫢
  • -V, --version β€” displays the version. cute lil "who am i" moment.
  • -q, --quiet β€” operate quietly. she's giving stealth mode, minimal chatter 🀫
  • -v, --verbose β€” operate more verbosely. the opposite of quiet, she's gonna tell you everything πŸ—£οΈβœ¨
  • -d, --debug β€” see -v, --verbose. literally the same thing, she's just wearing a different outfit πŸ’€
  • *-s, --servers <list of servers*> β€” specify the list of servers as hostname[:port][,hostname[:port]...]. that's the exact format, copy it, don't freestyle it πŸ”₯
  • -n, --non-blocking β€” enables non-blocking operations. no waiting around, she's booked and busy ⭐
  • -N, --tcp-nodelay β€” disables Nagle's algorithm. yes, the networking one. she said "no buffering delays, we move fast" πŸ¦‹
  • -b, --binary β€” enables the binary protocol. glow-up protocol, if you will 😌
  • -B, --buffer β€” buffers requests. she's collecting them first, like saving up your snaps πŸŽ€
  • *-u, --username <username*> β€” uses username for SASL authentication. yes bestie, you need credentials for that πŸ’…
  • -p, --password <password> β€” uses password for SASL authentication. keep it secret, keep it safe πŸ™ˆ
  • *-H, --hash <algorithm*> β€” uses algorithm as the key hash algo. see memcached_behavior_t::MEMCACHED_BEHAVIOR_HASH, that's the exact name, don't @ me 🧚
  • *-e, --expire <expiration*> β€” uses expiration seconds (or a UNIX timestamp). so you can say "5 minutes" in seconds, or just drop a whole UNIX timestamp in there πŸ‘‘

🌈 ENVIRONMENT 🌈

  • MEMCACHED_SERVERS β€” specifies a list of servers. so you can set this in your environment instead of typing -s every single time, and honestly? respectful of your time πŸ’–

πŸ’« NOTES πŸ’«

πŸŽ€ PROGRAM PREFIX πŸŽ€

okay important detail bestie, listen up:

the prefix of this program is variable, meaning it can be configured at build time. so the name might not always be exactly memtouch, iykyk πŸ‘€

usually the client programs of libmemcached-awesome are prefixed with mem, like memcat or memcp. cute little family 🌸

but it can be configured to replace the prefix with something else, like mc. and in case of that, the client programs of libmemcached-awesome would be called mccat, mccp, etc. respectively. so don't be shook if you see those names, she just changed her hair πŸ’‡β€β™€οΈβœ¨


πŸ”₯ SEE ALSO πŸ”₯

also on the list:

  • C/C++ Client Library for memcached
  • Update expiration on a key

ngl, this one's short but she ate. touch that key, specify your servers, and go πŸ’…

and that's the whole page bestie, 100% of the facts, zero skipped flags 🫢 this was version 1.1, dated Jul 18, 2024, and it's the libmemcached-awesome manual's MEMTOUCH(1) page β€” periodt. πŸ’–βœ¨πŸŽ€

πŸ“¦ where this page comes from