gplink - GNU PIC linker

       Craig Franklin <craigfranklin@users.sourceforge.net>

       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.

gputils-1.5.2                                      2022-01-30                                          GPLINK(1)

gplink combines a number of object and archive files, relocates their data,  and  ties  up  their  symbol
       references.   It  outputs an executable for Microchip (TM) PIC (TM) micro-controllers.  gplink is part of
       gputils.  Check the gputils(1) manpage for details on other GNU PIC utilities.

       gplink - GNU PIC linker

-aFMT, --hex-formatFMT
              gplink supports inhx8m, inhx8s, inhx16, and inhx32 hex file formats.  This option  controls  which
              hex file format is used.  The default is inhx32.

       -bOPT, --optimize-bankselOPT
              Remove unnecessary Banksel directives. [0]

       -B, --experimental-banksel
              Use experimental Banksel removal.

       -c, --object
              Output an executable object.

       -C, --no-cinit-warnings
              Disable  this  warnings  of  _cinit  section  with  -O2  option:  "Relocation symbol _cinit has no
              section."

       -d, --debug
              Display debug messages.

       -fVALUE, --fillVALUE
              Fill unused unprotected program memory with value.  The value supercedes the  linker  script  fill
              value.   The value must not be greater than 0xffff.  The value is hex.  The value may be preceeded
              by "0x".

       -h, --help
              Show the usage message and exit.

       -IDIR, --includeDIR
              Specify include directory.

       -j, --no-save-local
              Disable the save of local registers to COD file.

       -l, --no-list
              Disable list file output.

       -m, --map
              Output a map file.

       --mplink-compatible
              This option sets the MPLINK compatibility mode.

       -oFILE, --outputFILE
              Alternate name of the output file.

       -OOPT, --optimizeOPT
              Optimization level.  Default value is 1.

       -pOPT, --optimize-pageselOPT
              Remove unnecessary Pagesel directives. [0]

       -P, --experimental-pagesel
              Use experimental Pagesel removal.

       -q, --quiet
              Suppress anything sent to standard output.

       -r, --use-shared
              Attempt to relocate unshared data sections to shared memory if relocation fails.

       -sFILE, --scriptFILE
              Linker script.

       -tSIZE, --stackSIZE
              Create a stack section.

       -S[0|1|2], --strict[0|1|2]
              Set the strict level of the missing symbol.
                  0: This is the default. No message.
                  1: Show warning message if there is missing symbol.
                  2: Show error message if there is missing symbol.

       --strict-options
              If this is set, then an option may not be parameter of an another option.  For example: -s --quiet

       -u, --macrosymbol=[value]
              Add macro value for script.

       -v, --version
              Show the version information and exit.

       -w, --processor-mismatch
              Disable "processor mismatch" warning.

       -W, --experimental-pcallw
              Remove unnecessary PCALLW stubs created by SDCC.

gputils(1)

gplink[options][objects][libraries]

       The  information  in this man page is an extract from the full documentation of gputils and is limited to
       the meaning of the options.  For complete and current documentation, refer to "gputils.ps" located in the
       gputils docs directory.