GPDASM(1)

📦
version 1.5.2 · 2 versions
, in arch rolling, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 gpdasm — GNU PIC disassembler 💖

okay bestie, sit DOWN, because we're about to talk about gpdasm from the Linux user's manual, section 1 (yes, the executable-commands one, very main character of it). 🎀

✨ SYNOPSIS ✨

gpdasm [options] file

that's it. that's the whole vibe. options go in, a file goes in, magic comes out. 🦋

🚨 WARNING 🚨

okay so real talk for a sec, and I need you to actually read this one because it's giving disclaimer energy:

The info in this man page is an extract from the full documentation of gputils, and it is limited to the meaning of the options. For the complete and current documentation, go read gputils.ps which lives in the gputils docs directory. no cap, the full docs are the moment, this page is the trailer. 😭

🌸 DESCRIPTION 🌸

So gpdasm is a disassembler for Microchip (TM) PIC (TM) micro-controllers. It's literally part of gputils. If you wanna know about the other GNU PIC utilities in the family, check the gputils(1) manpage — they're all siblings and they all ate. 👑

💅 OPTIONS 💅

okay here's the whole menu, every single one, no skips, no shortcuts:

  • -c, --mnemonics — decode the special mnemonics. ✨
  • -h, --help — show this usage message and then exit. polite king behavior.
  • -i, --hex-info — report extra info about the input hex file. and by "extra info" we mean file size and hex format. the deets, the tea. 🍓
  • -j, --mov-fsrn — in the MOVIW or MOVWI instructions, show the FSRn register as the base instead of the INDFn. the default here is [INDFn]. 💫
  • -k FILE, --label-list FILE — a file that lists the names and addresses of the labels in the disassembled program code. (works with the -n, -o and -s options.)
  • -l, --list-chips — list the supported processors. roster drop. 🌈
  • -m, --dump — display the contents of instruction memory. all of it. spill.
  • -n, --show-names — for some cases of SFR, shows the name instead of the address. plus it also shows the labels. so many names, so iconic. 🎀
  • -o, --show-config — show the CONFIG and IDLOCS — or __idlocs — directives.
  • -p PROC, --processor PROC — select the processor. you gotta tell it who it's dealing with. 💁
  • -s, --short — output the short format. this format can be reassembled by gpasm. (also see the -k, -n and -o options.) the round-trip is real. 🔥
  • -t, --use-tab — uses the tabulator character in the written text. tabs > spaces, fight me. 😤
  • -v, --version — show the version information and exit.
  • -y, --extended — enable 18xx extended mode. turning it up to 18xx, slay.
  • --strict — disassemble only opcodes generated by gpasm in the case of instructions with several opcodes. picky on purpose, and honestly? valid.
  • --strict-options — if this is set, then an option may not be a parameter of another option. for example: -p --dump. nope, not happening, we don't do nesting here. 💀

👀 SEE ALSO 👀

  • gputils(1) — go say hi to the rest of the family.

🫶 AUTHOR 🫶

  • Craig Franklin <craigfranklin@users.sourceforge.net>
  • Molnar Karoly <molnarkaroly@users.sourceforge.net>

absolute legends, both of them. 💜

Copyright (C) 2002, 2003, 2004, 2005 Craig Franklin

Copyright (C) 2014 Molnar Karoly

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

yes bestie, the ALL CAPS warranty bits stay ALL CAPS, that's a legal thing, we do not soften the legalese, we just vibe around it. 🙈

and that's the whole page!! this one's from gputils-1.5.2, dated 2016-02-28 — a vintage classic, still eating, still serving. bye bestie, go disassemble something. 💖✨🎀

📦 where this page comes from