atst(1)

📦 version 7.0.7, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing

💖 atst(1) — the Scotch user's manual, but make it cute 💖

okay bestie, gather round, because we're talking about atst — the little tool that tests the consistency of target architectures. yes, that's the whole vibe. it's a vibe check for your architecture files. 🦋

✨ SYNOPSIS ✨

atst [options] [afile] [lfile]

two optional files, some optional flags, and honestly? that's it. she's simple. she's iconic. she's serving minimalism. 💅

🌸 DESCRIPTION 🌸

so here's the tea, fr fr: the atst program checks the consistency of a Scotch decomposition-defined target architecture, and — if everything passes the vibe check — it spits out some statistics about the number of target vertices and the length of paths linking them. periodt.

and like, why do we care? because target architectures define the topology of the target graphs used by the static mapping programs gmap(1) and dgmap(1). so if your architecture is a mess, your mapping is gonna be a mess. we do not want that energy. 🙈

the resulting statistics get stored in file lfile. and when file names aren't specified, data is read from standard input and written to standard output. standard streams can also be explicitly represented by a dash '-', if you're feeling extra. 😌

okay now this part is lowkey cool: when the proper libraries have been included at compile time, atst can directly handle compressed files, both as input and output. 🎀 a stream is treated as compressed whenever its name is postfixed with a compressed file extension, such as in 'brol.tgt.bz2' or '-.gz'. the compression formats which can be supported are:

  • the bzip2 format ('.bz2')
  • the gzip format ('.gz')
  • the lzma format ('.lzma')

slay. compressed files said "i'm not like other streams". 💜

👑 OPTIONS 👑

  • -h — Display some help. she's helpful, she's brief, she's there for you. 🫶
  • -V — Display program version and copyright. the receipts. the credentials. the "who even am i" moment. ⭐

🍓 EXAMPLE 🍓

Test the consistency of architecture arch.tgt:

$ atst arch.tgt

literally one line. no drama. no flags. just you, your architecture, and the truth. 🔥

💀 SEE ALSO 💀

Scotch user's manual.

iykyk. go read the whole family. 💖

🧚 AUTHOR 🧚

Francois Pellegrini <francois.pellegrini@labri.fr>

and that's the whole page bestie!! no cap, every single detail made it through the vibe check intact. 💅✨ this edition of the Scotch user's manual (the atst(1) page, if you somehow forgot already) is dated 23 November 2019, so like, throwback era but still eating. mwah. 🎀🦋💜

📦 where this page comes from