GP-DISPLAY-SRC.1(1)

📦
version 2.42 · 6 versions
, in ubuntu noble

💖 GP-DISPLAY-SRC — bestie's guide to peeking at your source code 💖

okay so. <rainbow>gp-display-src</rainbow> — she shows you source code, and if you want, she'll also show you the disassembly of your target object. it's giving "x-ray vision for your binaries" fr fr. 🦋

✨ NAME ✨

gp-display-src — display source code and optionally disassembly of the target object 💅

🌸 SYNOPSIS 🌸

gprofng display src [option(s)] target-file

🎀 DESCRIPTION 🎀

So like, this command displays the source code listing — or, if you're feeling extra, the source code interleaved with disassembly code — as extracted from the target-file. and the target-file can be an executable, a shared object, an object file, or a Java .class file. she contains multitudes. 👑

For example?? this command displays the source code and disassembly listing for a function called mxv_core that's part of the object file mxv.o:

$ gprofng display src -disasm mxv_core mxv.o

And if you wanna list the source code and disassembly for all the functions in this file, you do:

$ gprofng display src -disasm all -1 mxv.o

The target-file is the name of an executable, a shared object, an object file (.o), or a Java .class file. no notes. 💁‍♀️

If you give her no options at all, she shows you the source code listing of the target-file. this is equivalent to -source all -1, bestie. and if that info just… isn't available? she prints a message to that extent. she's honest like that. 😭

💅 OPTIONS 💅

  • --version — print the version number and dip. bye! ✌️
  • --help — print usage information and exit. she's helpful AND pretty. 🫶
  • -functions — list all the functions from the given object. the whole roster. 👑
  • -source item tag — show the source code for item in target-file. the tag is used to differentiate in case there are multiple occurrences with the same name. see the NOTES section for the definition of item and tag. 📖
  • -disasm item tag — include the disassembly in the source listing. the default listing does not include the disassembly. and if the source code isn't available? she shows you a listing of the disassembly only. slay. see the NOTES section for the definition of item and tag. 🔥
  • -outfile filename — write results to file filename. a dash (-) writes to stdout. that's also the default, fyi. ⚠️ note: this option only affects those options included to the right of the option. order matters, bestie, don't forget it. 😤

🦋 NOTES 🦋

Use item to specify the name of a function, or of a source or object file that was used to build the executable, or shared object. 🧚

The tag is an index used to determine which item is being referred to when multiple functions have the same name. it's required, but it will be ignored if it's not necessary to resolve the function. so like, she needs it, but she doesn't need it. iykyk. 💀

The item may also be specified in the form function`file` , in which case the source or disassembly of the named function in the source context of the named file will be used. cute little backtick moment. 🎀

The special item and tag combination all -1 is used to indicate generating the source, or disassembly, for all functions in the target-file. periodt. 💖

🌈 SEE ALSO 🌈

The user guide for gprofng is maintained as a Texinfo manual. if the info and gprofng programs are correctly installed, the command info gprofng should give access to this document. go read it, bestie, it's giving ✨educational✨. 📚

Copyright (c) 2022-2024 Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License". 📜 (yes the legal girlies ate with this one, we love a permissive license 🫶)

and that's the whole page, mwah 💋 this one's from binutils-2.42, dated 2025-12-03, and it's the GP-DISPLAY-SRC.1(1) manual — go forth and disassemble something iconic. bye bestie!! 🌸💖✨

📦 where this page comes from