PSL(1)

📦 version 0.23.3, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, debian bookworm, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 PSL-MAKE-DAFSA 💖

okay bestie, so this page is all about psl-make-dafsa from the User Commands corner of the manual (manual name: PSL, section 1, iykyk) — and no cap, it's a little build-tool baddie ✨

🦋 NAME 🦋

psl-make-dafsa — generate a compact and optimized DAFSA from a Public Suffix List 💅

🌸 SYNOPSIS 🌸

psl-make-dafsa [options] infile outfile

✨ DESCRIPTION ✨

So here's the vibe: psl-make-dafsa produces C/C++ code or an architecture-independent binary object that represents a Deterministic Acyclic Finite State Automaton (DAFSA) 🌈 — and it builds that from a textual representation of a Public Suffix List.

Input and output files must be specified on the command line. Like, both of them. No skipping, bestie 🫶

This compact representation is the whole point, fr fr: it enables optimized queries of the list, saving both time and space when compared to searches of human-readable representations. it's giving efficiency, it's giving glow-up for your data structure 👑

🎀 OPTIONS 🎀

The format of the data read and written by psl-make-dafsa depends on the options you pass to it. choose your own adventure, babe 🦋

  • --output-format=[cxx|cxx+|binary] — picks what comes out the other side:
    • cxx: (default) output is C/C++ code 💖
    • cxx+: output is C/C++ code plus statistical assignments (this one is used by the libpsl build process, slay)
    • binary: output is an architecture-independent binary format 🧚
  • --encoding=[utf-8|ascii] — picks how the text is encoded:
    • utf-8: (default) UTF-8 mode (output contains UTF-8 + punycode) ✨
    • ascii: (deprecated) 7-bit ASCII mode (output contains punycode only)
⚠️ heads up bestie: ascii is deprecated. like, it still works, but the vibes are off. consider utf-8, the main character option 👑

🔥 SEE ALSO 🔥

psl-make-dafsa was written by Olle Liljenzin as part of the Chromium project, and has been modified by Tim Ruehsen and Daniel Kahn Gillmor. The code and its documentation is governed by a BSD-style license 🫶

and that's the whole page, babe — written by legends, licensed the chill way, and optimized to the moon 💜

version psl 0.13.0, dated July 2016, page PSL(1) — a classic, an icon, a moment. periodt 💅✨

📦 where this page comes from