File: gplink.1

package info (click to toggle)
gputils 0.13.4-1
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 16,620 kB
  • ctags: 3,066
  • sloc: pascal: 191,182; ansic: 18,644; sh: 3,391; makefile: 1,293; lex: 991; yacc: 917
file content (82 lines) | stat: -rw-r--r-- 2,564 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
.TH gplink 1 "(c) 2002, 2003, 2004, 2005 Craig Franklin"
.SH NAME
gplink - GNU PIC Linker
.SH SYNOPSIS
.B gplink [options] [objects] [libraries]
.SH 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.
.SH DESCRIPTION
.B 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.
.B gplink
is part of gputils.  Check the gputils(1) manpage for details on other GNU 
PIC utilities.
.SH OPTIONS
.TP
.B -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.
.TP
.B -c, --object 
Output an executable object.
.TP
.B -d, --debug 
Display debug messages.
.TP
.B -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".
.TP
.B -h, --help
Show the usage message. 
.TP
.B -I DIR, --include DIR
Specify include directory.
.TP
.B -m, --map
Output a map file.
.TP
.B -o FILE, --output FILE
Alternate name of the output file.
.TP
.B -q, --quiet
Suppress anything sent to standard output.
.TP
.B -r, --use-shared
Attempt to relocate unshared data sections to shared memory if relocation
fails.
.TP
.B -s FILE, --script FILE
Linker script.
.TP
.B -v, --version
Show the version.
.TP
.B -w, --processor-mismatch
Disable "processor mismatch" warning.
.SH SEE ALSO
gputils(1)
.SH AUTHOR
Craig Franklin <craigfranklin@users.sourceforge.net>
.SH 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.