Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 documenta-
       tion of gputils and is limited to the meaning of	the options.  For com-
       plete  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 for-
	      mats.  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:	"Relo-
	      cation 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  pre-
	      ceeded 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  an-
	      other 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  MER-
       CHANTABILITY  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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gplink&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help