Man Linux: Main Page and Category List

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.

       -c, --object
              Output an executable object.

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

       -I DIR, --include DIR
              Specify include directory.

       -m, --map
              Output a map file.

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

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

       -v, --version
              Show the version.

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

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.