1GPLINK(1)                     Linux user's manual                    GPLINK(1)
2
3
4

NAME

6       gplink - GNU PIC linker
7

SYNOPSIS

9       gplink [options] [objects] [libraries]
10

WARNING

12       The information in this man page is an extract from the full documenta‐
13       tion of gputils and is limited to the meaning of the options.  For com‐
14       plete  and  current documentation, refer to "gputils.ps" located in the
15       gputils docs directory.
16

DESCRIPTION

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

OPTIONS

25       -a FMT, --hex-format FMT
26              gplink supports inhx8m, inhx8s, inhx16, and inhx32 hex file for‐
27              mats.   This option controls which hex file format is used.  The
28              default is inhx32.
29
30       -b OPT, --optimize-banksel OPT
31              Remove unnecessary Banksel directives. [0]
32
33       -c, --object
34              Output an executable object.
35
36       -C, --no-cinit-warnings
37              Disable this warnings of _cinit section with -O2 option:  "Relo‐
38              cation symbol _cinit has no section."
39
40       -d, --debug
41              Display debug messages.
42
43       -f VALUE, --fill VALUE
44              Fill  unused  unprotected  program memory with value.  The value
45              supercedes the linker script fill value.  The value must not  be
46              greater  than  0xffff.  The value is hex.  The value may be pre‐
47              ceeded by "0x".
48
49       -h, --help
50              Show the usage message and exit.
51
52       -I DIR, --include DIR
53              Specify include directory.
54
55       -j, --no-save-local
56              Disable the save of local registers to COD file.
57
58       -l, --no-list
59              Disable list file output.
60
61       -m, --map
62              Output a map file.
63
64       --mplink-compatible
65              This option sets the MPLINK compatibility mode.
66
67       -o FILE, --output FILE
68              Alternate name of the output file.
69
70       -O OPT, --optimize OPT
71              Optimization level.  Default value is 1.
72
73       -p OPT, --optimize-pagesel OPT
74              Remove unnecessary Pagesel directives. [0]
75
76       -q, --quiet
77              Suppress anything sent to standard output.
78
79       -r, --use-shared
80              Attempt to relocate unshared data sections to shared  memory  if
81              relocation fails.
82
83       -s FILE, --script FILE
84              Linker script.
85
86       -t SIZE, --stack SIZE
87              Create a stack section.
88
89       -S [0|1|2], --strict [0|1|2]
90              Set the strict level of the missing symbol.
91                  0: This is the default. No message.
92                  1: Show warning message if there is missing symbol.
93                  2: Show error message if there is missing symbol.
94
95       --strict-options
96              If  this  is  set,  then  an  option  may not be parameter of an
97              another option.  For example: -s --quiet
98
99       -u, --macro symbol=[value]
100              Add macro value for script.
101
102       -v, --version
103              Show the version information and exit.
104
105       -w, --processor-mismatch
106              Disable "processor mismatch" warning.
107

SEE ALSO

109       gputils(1)
110

AUTHOR

112       Craig Franklin <craigfranklin@users.sourceforge.net>
113

115       Copyright (C) 2002, 2003, 2004, 2005 Craig Franklin
116
117       This program is free software; you can redistribute it and/or modify it
118       under  the  terms of the GNU General Public License as published by the
119       Free Software Foundation; either version 2 of the License, or (at  your
120       option) any later version.
121
122       This  program  is  distributed  in the hope that it will be useful, but
123       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER‐
124       CHANTABILITY  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
125       Public License for more details.
126
127       You should have received a copy of the GNU General Public License along
128       with this program; if not, write to the Free Software Foundation, Inc.,
129       675 Mass Ave, Cambridge, MA 02139, USA.
130
131
132
133gputils-1.5.0                     2016-08-07                         GPLINK(1)
Impressum