plist(1)

🎀 plist(1) — your General Commands Manual bestie for peeking at AS output 🎀

🌟 NAME 🌟

plist — list contents of output files generated by AS

---

✨ SYNTAX ✨

plist [ file name ]

---

💅 DESCRIPTION 💅

Okay so PLIST is a program to list the contents of code output files generated by AS, a cross assembler for a variety of microprocessors and -controllers. It takes only one argument: the name of the file to list. If [ name ] does not have an extension, the default extension .p will be added automatically. Slay.

The output consists of a single line for each record in the file, listing the target processor, target address space, number of code/data bytes, and start/stop address. Heads up tho: the difference between the start and stop address need not equal the number of bytes, since there are target processors whose memory is not bytewise-organized. Not me knowing that little detail 💅

The records that specify entry address and file creator have a different layout and therefore have a little bit different look in PLIST’s output.

PLIST does not accept multiple file arguments; processing of several files must be done with individual calls. So like… one file at a time, bestie. 🫶

---

🫶 COMMAND-LINE PARAMETERS 🫶

none. Literally none. Zero. Zip. The command line is not the main character here. ✨

---

🌍 NATIONAL LANGUAGE SUPPORT 🌍

plist supports national languages in the same way as AS. See the manual page for asl(1) for more information about this. 🌈

---

🎀 RETURN CODES 🎀

plist may return with the following codes:

• 0 — no errors. Iconic. 💖
• 1 — incorrect command line parameters. Oops. 😭
• 2 — I/O-error. Not the vibe. 💀
• 3 — An input file had an incorrect format. Format check failed, bestie. 🙈

---

🦋 EXAMPLES 🦋

To list the contents of a code file file1.p, use:

plist file1

There aren’t more meaningful examples, as PLIST does not have any command line parameters. That’s it. That’s the example. Periodt. 💅

---

🔥 TIPS 🔥

If PLIST is started without any argument, it will prompt for a file’s name. So you don’t have to remember the name immediately — it’s giving helpful. 🫶

---

🌸 SEE ALSO 🌸

asl(1), pbind(1), p2hex(1), p2bin(1)

Go read the girlies too, iykyk. 📚✨

---

🧚 HISTORY 🧚

PLIST originally appeared as an AS tool in 1992, written in Borland-Pascal, and was ported to C and UNIX in 1996. 1992 to 1996 is such a glow-up timeline, ngl. 💖

---

💀 BUGS 💀

There are too few options. fr fr. 😭

---

👑 AUTHOR(S) 👑

Alfred Arnold (alfred@ccac.rwth-aachen.de) 💌

---

💖 That’s the whole plist(1) page from the General Commands Manual, with the footer vibes being plist(1) — no extra date/version on this one, so I’m not inventing one. Bye bestie! 🎀✨