GPLINK(1)                     Linux user's manual                    GPLINK(1)

NAME
       gplink - GNU PIC linker

SYNOPSIS
       gplink [options] [objects] [libraries]

WARNING
       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.

DESCRIPTION
       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.

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

       -b OPT, --optimize-banksel OPT
              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.

       -f VALUE, --fill VALUE
              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.

       -I DIR, --include DIR
              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.

       -o FILE, --output FILE
              Alternate name of the output file.

       -O OPT, --optimize OPT
              Optimization level.  Default value is 1.

       -p OPT, --optimize-pagesel OPT
              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.

       -s FILE, --script FILE
              Linker script.

       -t SIZE, --stack SIZE
              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, --macro symbol=[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.

SEE ALSO
       gputils(1)

AUTHOR
       Craig Franklin <craigfranklin@users.sourceforge.net>

COPYRIGHT
       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)