blood-elf(1)

✨ blood-elf(1) β€” the User Manuals glow-up πŸ’…

okay so bestie, welcome to blood-elf, living in the User Manuals section of your friendly neighborhood Linux man pages. this is the one that gets mescc its dwarfs 🧚 β€” yes really, that's the whole NAME line, i'm not even kidding.


🩸 NAME

blood-elf β€” Get mescc with dwarfs 🧚✨


πŸ“œ SYNOPSIS

blood-elf --file FILE [--output FILE --64]

πŸ’– DESCRIPTION

okay so here's the tea β˜•: blood-elf exists to generate ELF debug tables in M1-macro format from M1-macro assembly files. that's it. that's the job. she's a specialist, she's booked, she's busy. πŸ‘‘

At its core β€” and i mean at its core β€” it just reads until it finds :LABEL, and then it adds that label to the list of things to output. that's literally the whole personality. πŸŽ€

It will ignore labels that have _ prefixing their name. so like, :_foo will not get an entry. sorry bestie, no entry for you, the underscore said no πŸ™ˆ

If no output is specified, the result gets sent to Standard Out. no file, no problem, she'll just yell it into the terminal πŸ’¬

Fortunately, the only architecture difference you need to concern yourself with is whether your binary is going to be 64bits or 32bits β€” and 32bits is the default β€” and you pass the flag --64 should you need that alternate format. that's the entire architecture discourse, you're welcome, we kept it short. ✨


🫢 EXAMPLES

Typically, blood-elf gets called in scripts used in bootstrapping, like this:

# blood-elf -f cc.M1 -o cc-footer.M1
# blood-elf --file cc.M1 --64 --output cc-footer.M1

see? short flag version AND long flag version, because she's versatile like that πŸ’…


🌈 COMPATIBILITY

blood-elf is compatible with all Turing complete machines πŸ’€ β€” even the ones that try to be Turing complete minus one. (yes, -1. we said what we said. iconic.)


πŸ‘‘ AUTHORS

  • Jeremiah Orians <Jeremiah@pdp10.guru>
  • Jan (janneke) Nieuwenhuizen <janneke@gnu.org>

the two legends who made this happen, give them their flowers 🌸


  • Copyright 2016-2019 Jeremiah Orians <Jeremiah@pdp10.guru>
  • Copyright 2017 Jan Nieuwenhuizen <janneke@gnu.org>
  • License GPLv3+.

πŸ” SEE ALSO

M1(1), hex2(1), kaem(1), syscalls(2)

go read those next bestie, the lore is deep πŸ“š


this page shipped from Linux, dated JULY 2019, and answers to the name blood-elf(1) β€” mwah, love u, go generate some debug tables πŸ’–πŸ¦‹β­

~ that's the whole manpage, no cap, periodt ~ πŸ‘‘βœ¨