1GPLINK(1) Linux user's manual GPLINK(1)
2
3
4
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
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
109 gputils(1)
110
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)