1 |
blueness 13/07/28 01:20:47 |
2 |
|
3 |
Modified: pax-migrate-xattr.xml |
4 |
Log: |
5 |
Update pax migration guide, bug #478400 |
6 |
|
7 |
Revision Changes Path |
8 |
1.3 xml/htdocs/proj/en/hardened/pax-migrate-xattr.xml |
9 |
|
10 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/hardened/pax-migrate-xattr.xml?rev=1.3&view=markup |
11 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/hardened/pax-migrate-xattr.xml?rev=1.3&content-type=text/plain |
12 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/hardened/pax-migrate-xattr.xml?r1=1.2&r2=1.3 |
13 |
|
14 |
Index: pax-migrate-xattr.xml |
15 |
=================================================================== |
16 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/hardened/pax-migrate-xattr.xml,v |
17 |
retrieving revision 1.2 |
18 |
retrieving revision 1.3 |
19 |
diff -u -r1.2 -r1.3 |
20 |
--- pax-migrate-xattr.xml 14 Jan 2013 12:20:38 -0000 1.2 |
21 |
+++ pax-migrate-xattr.xml 28 Jul 2013 01:20:47 -0000 1.3 |
22 |
@@ -1,5 +1,5 @@ |
23 |
<?xml version='1.0' encoding="UTF-8"?> |
24 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/hardened/pax-migrate-xattr.xml,v 1.2 2013/01/14 12:20:38 blueness Exp $ --> |
25 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/hardened/pax-migrate-xattr.xml,v 1.3 2013/07/28 01:20:47 blueness Exp $ --> |
26 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
27 |
|
28 |
<guide lang="en"> |
29 |
@@ -117,17 +117,7 @@ |
30 |
<dd><b>a.</b> make sure you set USE=xattr in your global USE flags, and</dd> |
31 |
<dd><b>b.</b> emerge >=sys-apps/elfix-0.8.1 without disabling either ptpax or xtpax USE flags.</dd> |
32 |
|
33 |
- <dt><b>2. Portage preliminaries:</b></dt> |
34 |
- <dd>The current in tree pax-utils.eclass is not XATTR_PAX aware, and so we need to |
35 |
- use the pax-utils.eclass from the |
36 |
- <uri link='http://git.overlays.gentoo.org/gitweb/?p=proj/hardened-dev.git;a=summary'> |
37 |
- hardened-development overlay</uri>. Add the overlay using layman and make sure you |
38 |
- set up your repos.conf file so that it overrides the tree eclass (man portage for more |
39 |
- details on how to setup repos.conf). This step will be removed once we update the eclass |
40 |
- in tree (<uri link='https://bugs.gentoo.org/show_bug.cgi?id=431092'>bug #431092</uri>). |
41 |
- </dd> |
42 |
- |
43 |
- <dt><b>3. Kernel preliminaries:</b></dt> |
44 |
+ <dt><b>2. Kernel preliminaries:</b></dt> |
45 |
<dd>As you do the migration, you must make sure your filesystem can accomodate extended |
46 |
attributes, including tmpfs! If your kernel hasn't been already so configured, do so |
47 |
now and reboot into it. Choosing PAX_XATTR_PAX_FLAGS under the PaX kernel menu |
48 |
@@ -136,7 +126,7 @@ |
49 |
PT_PAX will be respected until you create XATTR_PAX fields on the target binaries. |
50 |
We'll tolerate this as a transition, but we recommend using only XATTR_PAX afterward.</dd> |
51 |
|
52 |
- <dt><b>4. Migrate the flags:</b></dt> |
53 |
+ <dt><b>3. Migrate the flags:</b></dt> |
54 |
<dd>The elfix package comes with migrate-pax. Running it with the -m flag will |
55 |
copy the PT_PAX flags to XATTR_PAX for every ELF object that portage knows about, |
56 |
<b>except</b> for those object which have the <b>default</b> flags. Since a kernel |
57 |
@@ -145,13 +135,13 @@ |
58 |
desired. Running <c>migrate-pax -m</c> is very safe and you can easily undo it by |
59 |
running <c>migrate-pax -d</c>.</dd> |
60 |
|
61 |
- <dt><b>5. Boot into an XATTR_PAX only kernel:</b></dt> |
62 |
+ <dt><b>4. Boot into an XATTR_PAX only kernel:</b></dt> |
63 |
<dd>You can now boot into a pure XATTR_PAX kernel. Make sure PT_PAX is off. Even |
64 |
though the flags should be the same in both fields, or XATTR_PAX absent in the case |
65 |
of default flags, we will be on the side of caution and keep control over the effective |
66 |
flags by using only XATTR_PAX.</dd> |
67 |
|
68 |
- <dt><b>6. Profit!</b></dt> |
69 |
+ <dt><b>5. Profit!</b></dt> |
70 |
<dd>If you really want to make sure it worked, the elfix package comes with some test |
71 |
suites. These are tricky to use correctly because if you have the wrong combination |
72 |
of PT_PAX versus XATTR_PAX userland/kernel configurations, you'll get a lot of false |