1GPLINK(1) Linux user's manual GPLINK(1)
2
6 gplink - GNU PIC linker
7
9 gplink [options] [objects] [libraries]
10
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
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
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 -b OPT, --optimize-banksel OPT
31 Remove unnecessary Banksel directives. [0]
32 -B, --experimental-banksel
34 Use experimental Banksel removal.
35 -c, --object
37 Output an executable object.
38 -C, --no-cinit-warnings
40 Disable this warnings of _cinit section with -O2 option: "Relo‐
41 cation symbol _cinit has no section."
42 -d, --debug
44 Display debug messages.
45 -f VALUE, --fill VALUE
47 Fill unused unprotected program memory with value. The value
48 supercedes the linker script fill value. The value must not be
49 greater than 0xffff. The value is hex. The value may be pre‐
50 ceeded by "0x".
51 -h, --help
53 Show the usage message and exit.
54 -I DIR, --include DIR
56 Specify include directory.
57 -j, --no-save-local
59 Disable the save of local registers to COD file.
60 -l, --no-list
62 Disable list file output.
63 -m, --map
65 Output a map file.
66 --mplink-compatible
68 This option sets the MPLINK compatibility mode.
69 -o FILE, --output FILE
71 Alternate name of the output file.
72 -O OPT, --optimize OPT
74 Optimization level. Default value is 1.
75 -p OPT, --optimize-pagesel OPT
77 Remove unnecessary Pagesel directives. [0]
78 -P, --experimental-pagesel
80 Use experimental Pagesel removal.
81 -q, --quiet
83 Suppress anything sent to standard output.
84 -r, --use-shared
86 Attempt to relocate unshared data sections to shared memory if
87 relocation fails.
88 -s FILE, --script FILE
90 Linker script.
91 -t SIZE, --stack SIZE
93 Create a stack section.
94 -S [0|1|2], --strict [0|1|2]
96 Set the strict level of the missing symbol.
97 0: This is the default. No message.
98 1: Show warning message if there is missing symbol.
99 2: Show error message if there is missing symbol.
100 --strict-options
102 If this is set, then an option may not be parameter of an an‐
103 other option. For example: -s --quiet
104 -u, --macro symbol=[value]
106 Add macro value for script.
107 -v, --version
109 Show the version information and exit.
110 -w, --processor-mismatch
112 Disable "processor mismatch" warning.
113 -W, --experimental-pcallw
115 Remove unnecessary PCALLW stubs created by SDCC.
116
118 gputils(1)
119
121 Craig Franklin <craigfranklin@users.sourceforge.net>
122
124 Copyright (C) 2002, 2003, 2004, 2005 Craig Franklin
125 This program is free software; you can redistribute it and/or modify it
127 under the terms of the GNU General Public License as published by the
128 Free Software Foundation; either version 2 of the License, or (at your
129 option) any later version.
130 This program is distributed in the hope that it will be useful, but
132 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
133 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
134 Public License for more details.
135 You should have received a copy of the GNU General Public License along
137 with this program; if not, write to the Free Software Foundation, Inc.,
138 675 Mass Ave, Cambridge, MA 02139, USA.
139gputils-1.5.2 2022-01-30 GPLINK(1)