GPLINK(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

okay bestie, so this is gplink, aka the GNU PIC linker, from the Linux user's manual. and honestly? she's iconic. let's get into it 🫶

✨ NAME ✨

gplink — the GNU PIC linker. that's it, that's the whole name, and she ate 💅

🌸 SYNOPSIS 🌸

gplink [options] [objects] [libraries]

⚠️ WARNING ⚠️

no cap, the tea here is limited. everything in this man page is just an extract from the full gputils documentation, and it only covers what the options actually mean. for the complete and current version — the whole meal, not just the appetizer — go read gputils.ps over in the gputils docs directory. periodt.

🦋 DESCRIPTION 🦋

so what does gplink actually do? she takes a bunch of object and archive files, relocates their data, and ties up their symbol references. then she outputs an executable for Microchip (TM) PIC (TM) micro-controllers. main character energy fr fr 💖

and like, gplink is part of gputils, so if you wanna know about the other GNU PIC utilities, go check the gputils(1) manpage. iykyk.

👑 OPTIONS 👑

  • -a FMT, --hex-format FMT — picks which hex file format we're using. gplink supports inhx8m, inhx8s, inhx16, and inhx32. the default? inhx32. no thoughts, just that one ✨
  • -b OPT, --optimize-banksel OPT — removes unnecessary Banksel directives. default is [0].
  • -B, --experimental-banksel — uses the experimental Banksel removal. it's giving lab rat 🧪
  • -c, --object — outputs an executable object.
  • -C, --no-cinit-warnings — turns off these _cinit section warnings when you use the -O2 option: "Relocation symbol _cinit has no section." like girl, stop yelling at me 😭
  • -d, --debug — displays debug messages. for when you simply must know everything.
  • -f VALUE, --fill VALUE — fills unused unprotected program memory with value. this value supercedes the linker script fill value. important: it must not be greater than 0xffff. it's hex. it may be preceeded by "0x". (yes, "preceeded" — that's what the original says, i don't make the rules 💀)
  • -h, --help — shows the usage message and exits. bye bestie 👋
  • -I DIR, --include DIR — specifies an include directory.
  • -j, --no-save-local — disables the save of local registers to the COD file.
  • -l, --no-list — disables list file output.
  • -m, --map — outputs a map file. very demure, very mindful 🗺️
  • --mplink-compatible — this option sets the MPLINK compatibility mode.
  • -o FILE, --output FILE — alternate name of the output file.
  • -O OPT, --optimize OPT — optimization level. the default value is 1.
  • -p OPT, --optimize-pagesel OPT — removes unnecessary Pagesel directives. default is [0].
  • -P, --experimental-pagesel — uses the experimental Pagesel removal. again with the experiments, she's curious 🧚
  • -q, --quiet — suppresses anything sent to standard output. shhh 🤫
  • -r, --use-shared — attempts to relocate unshared data sections to shared memory if relocation fails. she's trying her best, okay?? 🥺
  • -s FILE, --script FILE — linker script.
  • -t SIZE, --stack SIZE — creates a stack section.
  • -S [0|1|2], --strict [0|1|2] — sets the strict level of the missing symbol. here's the breakdown:
    • 0: this is the default. no message. silence is golden ✨
    • 1: show a warning message if there's a missing symbol.
    • 2: show an error message if there's a missing symbol. she's mad now 😤
  • --strict-options — if this is set, then an option may not be a parameter of another option. for example: -s --quiet. yeah, that's the whole vibe check.
  • -u, --macro symbol=[value] — adds a macro value for the script.
  • -v, --version — shows the version information and exits.
  • -w, --processor-mismatch — disables the "processor mismatch" warning.
  • -W, --experimental-pcallw — removes unnecessary PCALLW stubs created by SDCC. slay, cleanup crew 🔥

🌈 SEE ALSO 🌈

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

💜 AUTHOR 💜

Craig Franklin <craigfranklin@users.sourceforge.net> — absolute legend, we stan 👑

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

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.

fr fr, read the license, it's not a vibe suggestion 💅

and that's the whole page bestie!! this one's from gputils-1.5.2, dated 2022-01-30, and it's the GPLINK(1) manual page. go link something iconic with it 💖✨🎀🦋🌸

📦 where this page comes from