~ubuntu-branches/ubuntu/intrepid/hardening-wrapper/intrepid

« back to all changes in this revision

Viewing changes to hardened-ld.1

  • Committer: Bazaar Package Importer
  • Author(s): Kees Cook
  • Date: 2008-01-22 16:48:49 UTC
  • Revision ID: james.westby@ubuntu.com-20080122164849-wq1qgctrdbtb4lvf
Tags: 1.2
* Move away from generic "builder" prefix to "hardened".
* Provide links for gcc 4.1, 4.2, and 4.3 instead of top-level links.
* Provide manpage link for package name.
* Clean up previous diversions.
* Move to "all" arch since arch-dep symlinks are no longer used.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH BUILDER-CC 1 "2002-03-02" "Debian Project" "Debian GNU/Linux"
 
2
.SH NAME
 
3
hardened-ld \- linker wrapper to enforce hardening toolchain improvements
 
4
.SH SYNOPSIS
 
5
.BI "export DEB_BUILD_HARDENING=1"
 
6
.br
 
7
 
 
8
.B ld
 
9
.I ...
 
10
.SH "DESCRIPTION"
 
11
The
 
12
.B hardened-ld
 
13
wrapper is normally used by calling
 
14
.B ld
 
15
as usual with
 
16
.B DEB_BUILD_HARDENING
 
17
set to 1. It will configure the necessary toolchain hardening
 
18
features. By default, all features are enabled. If a given feature does not
 
19
work correctly and needs to be disabled, the corresponding environment
 
20
variables mentioned below can be set to 0.
 
21
 
 
22
.SH ENVIRONMENT
 
23
.IP DEB_BUILD_HARDENING=1
 
24
Enable hardening features.
 
25
.IP DEB_BUILD_HARDENING_DEBUG=1
 
26
Print the full resulting gcc command line to STDERR before calling gcc.
 
27
.IP DEB_BUILD_HARDENING_RELRO=0
 
28
Don't mark ELF sections read-only after start. See README.Debian for details.
 
29
.IP DEB_BUILD_HARDENING_PIE=0
 
30
Don't build position independent executables. See README.Debian for details.
 
31
 
 
32
.SH NOTES
 
33
The real
 
34
.B ld
 
35
is renamed
 
36
.BR ld.real , 
 
37
and a diversion is
 
38
registered with
 
39
.BR dpkg-divert (1).
 
40
Thus
 
41
.BR hardened-ld 's
 
42
idea of the default
 
43
.B ld
 
44
is dictated by whatever package installed
 
45
.IR /usr/bin/ld .
 
46
 
 
47
.SH "SEE ALSO"
 
48
.BR ld (1)
 
49