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 -c, --object
31 Output an executable object.
32
33 -d, --debug
34 Display debug messages.
35
36 -f VALUE, --fill VALUE
37 Fill unused unprotected program memory with value. The value
38 supercedes the linker script fill value. The value must not be
39 greater than 0xffff. The value is hex. The value may be pre‐
40 ceeded by "0x".
41
42 -h, --help
43 Show the usage message.
44
45 -I DIR, --include DIR
46 Specify include directory.
47
48 -m, --map
49 Output a map file.
50
51 -o FILE, --output FILE
52 Alternate name of the output file.
53
54 -q, --quiet
55 Suppress anything sent to standard output.
56
57 -r, --use-shared
58 Attempt to relocate unshared data sections to shared memory if
59 relocation fails.
60
61 -s FILE, --script FILE
62 Linker script.
63
64 -v, --version
65 Show the version.
66
67 -w, --processor-mismatch
68 Disable "processor mismatch" warning.
69
71 gputils(1)
72
74 Craig Franklin <craigfranklin@users.sourceforge.net>
75
77 Copyright (C) 2002, 2003, 2004, 2005 Craig Franklin
78
79 This program is free software; you can redistribute it and/or modify it
80 under the terms of the GNU General Public License as published by the
81 Free Software Foundation; either version 2 of the License, or (at your
82 option) any later version.
83
84 This program is distributed in the hope that it will be useful, but
85 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
86 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
87 Public License for more details.
88
89 You should have received a copy of the GNU General Public License along
90 with this program; if not, write to the Free Software Foundation, Inc.,
91 675 Mass Ave, Cambridge, MA 02139, USA.
92
93
94
95gputils-0.13.5 2007-10-27 GPLINK(1)