ARGON2-CALIBRATE(1p)

📦
version 0.031 · 4 versions
, in ubuntu stonking

💖 ARGON2-CALIBRATE(1p) 💖

okay bestie, welcome to the User Contributed Perl Documentation corner of the manual — yes this is a 1p page, we're in Perl territory, hydration is mandatory 🫶

✨ NAME ✨

argon2-calibrate — literally just a script that helps you find the right argon2 parameters 💅

🌸 VERSION 🌸

version 0.031 ⭐

🦋 DESCRIPTION 🦋

so this program runs through a whole procedure, and it's the exact one the argon2 authors recommend. no cap, we're just following their recipe:

  1. Pick your type, call it y. If you have zero clue what the difference between the types even is, just go Argon2id. it's giving safe choice 💖
  2. Figure out the max number of threads, h, that each call to Argon2 can actually kick off. that number is the "parallelism" argument, periodt.
  3. Figure out the max amount of memory m that each call can afford.
  4. Figure out the max amount x of time (in seconds, bestie, seconds) that each call can afford.
  5. Pick the salt length. 16 bytes is sufficient for all applications ✨ but you can drop it to 8 bytes if you're in a space-constraints situation.
  6. Pick the tag (output) size. 16 bytes is sufficient for most applications, key derivation included 🎀
  7. Now run the scheme of type y, memory m, and h lanes and threads, using a different number of passes t. Find the max t where the running time does not go over x. If it blows past x even at t = 1, then reduce m accordingly. And if you're using Argon2i, t must be at least 3. no exceptions, iykyk 👑
  8. Hash all the passwords with the values m, h, and t you just figured out. slay, you're done 🎉
lowkey the whole point is: your machine has limits, your users have patience limits, and this script helps you find the sweet spot between them 🌈

🎀 AUTHOR 🎀

Leon Timmermans <fawaka@gmail.com> 💌

This software is Copyright (c) 2013 by Daniel Dinu, Dmitry Khovratovich, Jean-Philippe Aumasson, Samuel Neves, Thomas Pornin and Leon Timmermans.

This is free software, licensed under:

The Apache License, Version 2.0, January 2004

and that's the whole page, bestie!! 🦋✨ this rendition came to you via perl v5.42.3, dated 2026-08-19 — mwah, take care of your hashes 💖💅🫶

📦 where this page comes from