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

« back to all changes in this revision

Viewing changes to builder-cc.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:
 
1
.TH BUILDER-CC 1 "2002-03-02" "Debian Project" "Debian GNU/Linux"
 
2
.SH NAME
 
3
builder-cc \- gcc wrapper to enforce hardening toolchain improvements
 
4
.SH SYNOPSIS
 
5
.BI "export DEB_BUILD_HARDENING=1"
 
6
.br
 
7
 
 
8
.B gcc
 
9
.I ...
 
10
.SH "DESCRIPTION"
 
11
The
 
12
.B builder-cc
 
13
wrapper is normally used by calling
 
14
.B gcc
 
15
as usual when
 
16
.B DEB_BUILD_HARDENING
 
17
is 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 gcc.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_STACKPROTECTOR=0
 
30
Disable stack overflow protection. See README.Debian for details.
 
31
.IP DEB_BUILD_HARDENING_RELRO=0
 
32
Disable read-only linker sections. See README.Debian for details.
 
33
.IP DEB_BUILD_HARDENING_FORTIFY=0
 
34
Don't fortify several standard functions. See README.Debian for details.
 
35
.IP DEB_BUILD_HARDENING_PIE=0
 
36
Don't build position independent executables. See README.Debian for details.
 
37
.IP DEB_BUILD_HARDENING_FORMAT=0
 
38
Disable unsafe format string usage warnings. See README.Debian for details.
 
39
 
 
40
.SH NOTES
 
41
The real
 
42
.B gcc
 
43
is renamed
 
44
.BR gcc.real , 
 
45
and a diversion is
 
46
registered with
 
47
.BR dpkg-divert (1).
 
48
Thus
 
49
.BR builder-cc 's
 
50
idea of the default
 
51
.B gcc
 
52
is dictated by whatever package installed
 
53
.IR /usr/bin/gcc .
 
54
 
 
55
.SH "SEE ALSO"
 
56
.BR gcc (1)