← Back to branch summary

~ubuntu-branches/ubuntu/karmic/hardening-wrapper/karmic

« back to all changes in this revision

Viewing changes to builder-ld.1

  • Committer: Bazaar Package Importer
  • Author(s): Kees Cook
  • Date: 2008-01-08 16:00:58 UTC
  • Revision ID: james.westby@ubuntu.com-20080108160058-sfilpglt31x7124g
Tags: 1.1
Initial release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
builder-ld.1
 
1
.TH BUILDER-CC 1 "2002-03-02" "Debian Project" "Debian GNU/Linux"
 
2
.SH NAME
 
3
builder-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 builder-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 above can be set to 0.
 
21
 
 
22
You can still call ld.real directly.
 
23
 
 
24
.SH ENVIRONMENT
 
25
.IP DEB_BUILD_HARDENING=1
 
26
Enable hardening features.
 
27
.IP DEB_BUILD_DEBUG=1
 
28
Print the full resulting gcc command line to STDERR before calling gcc.
 
29
.IP DEB_BUILD_HARDENING_RELRO=0
 
30
Don't mark ELF sections read-only after start. See README.Debian for details.
 
31
.IP DEB_BUILD_HARDENING_PIE=0
 
32
Don't build position independent executables. See README.Debian for details.
 
33
 
 
34
.SH NOTES
 
35
The real
 
36
.B ld
 
37
is renamed
 
38
.BR ld.real , 
 
39
and a diversion is
 
40
registered with
 
41
.BR dpkg-divert (1).
 
42
Thus
 
43
.BR builder-ld 's
 
44
idea of the default
 
45
.B ld
 
46
is dictated by whatever package installed
 
47
.IR /usr/bin/ld .
 
48
 
 
49
.SH "SEE ALSO"
 
50
.BR ld (1)
 
51