DISASSEMBLE(1)

hey bestie 💖 welcome to the DISASSEMBLE(1) page from the User Contributed Perl Documentation crew — yes, that one. we're making bytecode make sense, no cap.

💖 NAME 💖

disassemble — that's it, one word, lowercase, iconic. 💅

✨ SYNOPSIS ✨

disassemble [--bare] [bytecode.plc] > bytecode.asm
assemble bytecode.asm > bytecode.plc

🌸 DESCRIPTION 🌸

okay so this utility decompiles binary bytecode into readable and recompilable bytecode assembler. that's the whole vibe. ✨

the manual spells it byteocde (yes, exactly like that, no cap) and says it's a binary file wih (also exactly like that) — either the magic 4 bytes 'PLBC' at the start, or something like "#! /usr/bin/perl\n use ByteLoader '0.07'". 🦋

if you don't give a filename, it uses STDIN. literally just reads from STDIN. 🫶

🎀 OPTION --bare 🎀

• --bare — this is the no-commentary switch. if you don't pass it, the output will be commented. 💅

heads up bestie 😭 older assembler, before B::Assembler version 0.07, i.e. up to perl-5.8.x, will not be able to parse this commented assembler.

but --bare is only optional, so the default is not backwards compatible. rationale: Disassembling is primarily done to make binary bytecode readable, and not necessarily recompilable with older assemblers. 👑

okay that's the whole page — it's perl v5.42.3, dated 2019-05-07, and it's the DISASSEMBLE(1) manual. byeee 💜🦋