GOLF(2gg)

📦 version 601.4.41, in ubuntu questing

🎀 GOLF(2gg) — the manual page, but make it a group chat 💖

okay bestie so this is the GOLF(2gg) manual page, filed under Development, and we're about to talk about the cutest lil crypto thing ever. pull up a chair, grab a strawberry 🍓

✨ NAME ✨

random-crypto — (encryption) 💅

🌸 PURPOSE 🌸

obtain a random string for cryptographic use. that's it, that's the whole job. she's focused, she's employed, she's serving 💖

🦋 SYNTAX 🦋

random-crypto to <random string> \
    [ length <string length> ]

note the backslash, bestie — she's continuing onto the next line, don't panic 🫶

✨ DESCRIPTION ✨

okay so here's the tea ☕ random-crypto obtains a random string of length <string length>. this statement uses a cryptographically secure pseudo random generator (CSPRNG) from the OpenSSL library. no cap, that's the actual source. 🔥

if the length clause is omitted, the length is 20 by default. twenty. iconic number, no notes. ✨

the value generated is always binary and may contain null-characters, and it is null-terminated. yes, null characters inside a null-terminated string. she contains multitudes 😭

💀 important bestie, listen up: use this statement only when needed for specific cryptographic uses. in all other cases, use random-string which is considerably faster. do not be out here using the fancy one for no reason, that's not the vibe, that's just wasting time 💅

🌈 EXAMPLES 🌈

get a 20-digit long random binary value:

random-crypto to str length 20

ate. no crumbs. 👑

💜 SEE ALSO 💜

  • Encryption
  • decrypt-data
  • derive-key
  • encrypt-data
  • hash-string
  • hmac-string
  • random-crypto
  • random-string
  • See all documentation

and that's the whole page, my love 💖 this was GOLF(2gg), brought to you by version $VERSION and dated $DATE — she's timestamped, she's versioned, she's everything. mwah 🎀✨🦋💅

📦 where this page comes from