initial sync

BIOS-and-UEFI-Bootable-USB.md

@@ -0,0 +1,29 @@
+## Installation from Bootable USB
+
+**BIOS and UEFI Bootable USB**
+
+*Creating on GNU/Linux*
+
+This method is recommended due to its simplicity. **This will irrevocably destroy all data on /dev/sdx**
+
+Run the following command, replacing /dev/sdx with your drive, e.g. /dev/sdb. (do not append a partition number, so do not use something like /dev/sdb1)
+
+```
+dd bs=512k if=/path/to/pentoo-amd64-hardened-2015.0_RC*.iso of=/dev/sdx && sync
+```
+and wait patiently until the process is completed.
+
+*Creating on Windows*
+
+If you’re running under Windows, you’ll need to download the Win32 Disk Imager utility:
+
+<a href="http://sourceforge.net/projects/win32diskimager/"><img src="https://a.fsdn.com/con/app/proj/win32diskimager/screenshots/Win32DiskImager-1.0.png"></a>
+
+*Creating on OS X*
+
+Run the following command, replacing /dev/diskx with your drive, e.g. /dev/disk7.
+
+```
+sudo dd if=/path/to/pentoo-amd64-hardened-2015.0_RC*.iso of=/dev/diskx bs=1m
+```
+and wait patiently until the process is completed.****

Customization.md

@@ -0,0 +1,24 @@
+<a href="http://pentoo.ch"><img src="https://github.com/pentoo/pentoo-overlay/wiki/images/pentoo1.png"></a>
+
+#### Pentoo profiles and overlay
+
+````
+amd64           pentoo/default/linux/amd64                      stable
+amd64           pentoo/default/linux/amd64/bleeding_edge        dev
+amd64           pentoo/hardened/linux/amd64                     stable
+amd64           pentoo/hardened/linux/amd64/binary              dev
+amd64           pentoo/hardened/linux/amd64/bleeding_edge       dev
+
+x86             pentoo/default/linux/x86                        stable
+x86             pentoo/default/linux/x86/bleeding_edge          dev
+x86             pentoo/hardened/linux/x86                       stable
+x86             pentoo/hardened/linux/x86/binary                dev
+x86             pentoo/hardened/linux/x86/bleeding_edge         dev
+
+arm             pentoo/default/linux/arm/armv7a                 stable
+arm             pentoo/default/linux/arm/armv7a/bleeding_edge   dev
+arm             pentoo/hardened/linux/arm/armv7a                stable
+arm             pentoo/hardened/linux/arm/armv7a/bleeding_edge  dev
+arm             pentoo/default/linux/arm/armv6j                 stable
+arm             pentoo/default/linux/arm/armv6j/bleeding_edge   dev
+````

Distro-Rules.md

@@ -0,0 +1,14 @@
+<a href="http://pentoo.ch"><img src="https://github.com/pentoo/pentoo-overlay/wiki/images/pentoo1.png"></a>
+### Introduction
+We need a set of rules to govern our behavior. This wiki page is intended to be a place to compile such policies in one place.
+
+### USE flags:
+pentoo is used to switch on and off our changes to packages we are overriding for gentoo. For instance we have acpid in our repo, and the diffs from gentoo are controlled with the pentoo use flag. livecd is used for things which belong on the livecd but not on the installed systems !livecd is used for things which belong on the running systems but not on the livecd (do not abuse this for large packages) missing we need a new use flag to denote the difference between livecd sized versions and maxi versions. maxi is possible and not currently in use, thoughts? mpentoo will be reserved for a theoretical tiny pentoo like we used to have while minimal will be avoided because of the overlap on gentoo (also minimal doesn't really make sense as a difference between large and huge imho, as well as the fact that building the livecd with minimal would have undesirable consequences like vim being built without gentoo-syntax etc etc). Still taking thoughts...
+
+### Keywording:
+Any packages we are overriding from gentoo MUST keep the same keywords as gentoo at all times (do the best you can). Remember when overriding gentoo packages you MUST use the pentoo use flag for all changes. You can always update portage/profiles/package.accept_keywords to install the version you want.
+
+Any packages that are ONLY in pentoo can be keyworded as you please. If you have tested it on an arch then feel free to add that keyword. If you think it is stable, then feel free to keyword it as such.
+
+### Additions:
+Please feel free to add to this list of rules and policies as you see fit. Discussion can take place on irc or the dev mailing list.

Download.md

@@ -0,0 +1 @@
+<a href="http://pentoo.ch"><img src="https://github.com/pentoo/pentoo-overlay/wiki/images/pentoo1.png"></a>

FAQ.md

@@ -0,0 +1,128 @@
+<a href="http://pentoo.ch"><img src="https://github.com/pentoo/pentoo-overlay/wiki/images/pentoo1.png"></a>
+## Frequently Asked Questions - Pentoo
+### Installation
+#### Pentoo Linux Hard Disk Install
+This feature is supported by the official Pentoo-installer. More info: Installation to disc page.
+
+#### Pentoo Linux Encrypted Disk Install
+How to go about it? Grimmlin took care to make our life easier and now this feature is available from the pentoo-installer.
+
+    r5245 pentoo-installer: Added LUKS with pgp-encrypted keys support
+#### Pentoo Linux Overlay Install
+More info: OverlayUsage page.
+
+### Customization
+#### Can I install XXX instead of YYY?
+Yes, there are number of packages which can replaced. For example:
+
+    emerge -C wicd
+    emerge -1 networkmanager
+    emerge -C chromium
+    emerge -1 google-chrome
+
+#### Can I uninstall XXX? Pentoo pulls it by default
+There are number of USE flags which can be disabled. For example:
+
+    pentoo/pentoo kde -gnome -radio qemu
+    pentoo/pentoo-mobile -ios
+    pentoo/pentoo-wireless -drivers
+    pentoo/pentoo-system -drivers -windows-compat
+    pentoo/pentoo-misc -accessibility -atm -qt4 -gtk -X -office
+    app-exploits/packetstormexploits -2009 -2010 -2011 -2012
+
+    www-servers/lighttpd -mysql -php
+    net-analyzer/wireshark -ares -btbb -gcrypt -geoip -kerberos -portaudio -smi libadns
+    net-wireless/kismet -plugin-btscan -plugin-spectools
+
+    net-misc/networkmanager -modemmanager
+Use eix or examine each ebuild for more details
+
+#### How to configure proxy for the overlay
+
+Please customize the proxy variable in /etc/layman/layman.cfg
+         
+     proxy  : http://[user:pass@]www.my-proxy.org:3128
+
+If unset, layman will use the http_proxy environment variable.
+To use this method:
+
+     cd /etc/env.d
+     sudo touch 99local
+     sudo nano 99local
+
+and please add:
+
+     http_proxy="http://YourProxyAddress:YourProxyPortNumber"
+     https_proxy="http://YourProxyAddress:YourProxyPortNumber"
+     ftp_proxy="http://YourProxyAddress:YourProxyPortNumber"
+
+And then to apply changes to the system:
+
+     sudo env-update && source /etc/profile
+
+To check this variable:
+
+     sudo echo $http_proxy
+
+and then:
+
+     git config --global http.proxy $http_proxy
+     layman -S
+
+If you use a local proxy such as CNTLM to authenticate through a corporate proxy server or for whatever other reason, you should be aware that you may experience a several minute delay in GIT making the first connection to the proxy. This could be caused by GIT/cURL resolving localhost to an IPv6 address first ::1 and trying to connect to that before timing out (in my case, after 2.5 minutes). After the timeout, cURL will then try the IPv4 version of 127.0.0.1. If your local proxy only listens on the IPv4 address (which seems a common occurrence), make sure you define the proxy as such:
+
+     git config http.proxy http://127.0.0.1:8080
+
+To troubleshoot problems with your proxy, you can set the following environment variables:
+
+     set GIT_TRACE=1
+     set GIT_CURL_VERBOSE=1
+
+Then run the command again and you will get much more information about what GIT and the cURL library are up to.
+
+#### Restrict Thunar from showing encrypted partitions
+For some reason, Thunar will sometimes show encrypted partitions as removable devices. To restrict thunar from showing encrypted partitions:
+
+    nano /etc/udev/rules.d/99-hide-disks.rules 
+and add:
+
+    KERNEL=="sda3", ENV{UDISKS_IGNORE}="1"
+where sda3 is an encrypted partition meant to hide. Then use this command (as root) to trigger a refresh:
+
+udevadm trigger
+## Troubleshooting a Pentoo Installation
+#### Compilation errors
+##### Unable to compile app-exploits/packetstormexploits-meta-2000:0/0::pentoo
+    cd /usr/portage/distfiles/
+    wget --no-check-certificate http://dl.packetstormsecurity.net/1501-exploits/1501-exploits.tgz
+    wget --no-check-certificate http://dl.packetstormsecurity.net/1502-exploits/1502-exploits.tgz
+    wget --no-check-certificate http://dl.packetstormsecurity.net/1503-exploits/1503-exploits.tgz
+    wget --no-check-certificate http://dl.packetstormsecurity.net/1504-exploits/1504-exploits.tgz
+    wget --no-check-certificate http://dl.packetstormsecurity.net/1505-exploits/1505-exploits.tgz
+    wget --no-check-certificate http://dl.packetstormsecurity.net/1412-exploits/2014-exploits.tgz
+    wget --no-check-certificate http://dl.packetstormsecurity.net/1312-exploits/2013-exploits.tgz
+    wget --no-check-certificate http://dl.packetstormsecurity.net/1212-exploits/2012-exploits.tgz
+    wget --no-check-certificate http://dl.packetstormsecurity.net/1112-exploits/2011-exploits.tgz
+    wget --no-check-certificate http://dl.packetstormsecurity.net/1012-exploits/2010-exploits.tgz
+    emerge packetstormexploits-meta -1 -va
+    
+##### Unable to compile a kernel module
+    * ERROR: sys-kernel/spl-0.6.2-r3::gentoo failed:
+    * ERROR: sys-fs/zfs-kmod-0.6.2-r3::gentoo failed:
+then do the same thing:
+
+    ls -l /usr/src/linux
+    lrwxrwxrwx 1 root root 12 Dec 25 07:50 /usr/src/linux -> /usr/src/linux-3.9.9-pentoo
+    cd /usr/src/linux
+assuming /usr/src/linux links to the 3.9.9-pentoo sources,
+
+    zcat /proc/config.gz > .config
+    make clean && make clean
+    make prepare
+    make modules_prepare
+#### Upgrading
+##### Unable to resolve blocks
+Uninstall all blocks manually. For example:
+
+    emerge -C dev-lang/vala
+    emerge -C dev-libs/ecore

Getting-Started.md

@@ -0,0 +1,22 @@
+<a href="http://pentoo.ch"><img src="https://github.com/pentoo/pentoo-overlay/wiki/images/pentoo1.png"></a>
+
+## DISCLAIMER
+THIS IS EXPERIMENTAL SOFTWARE. USE AT YOUR OWN RISK. PENTOO.CH CAN NOT BE HELD LIABLE UNDER ANY CIRCUMSTANCES FOR DAMAGE TO HARDWARE OR SOFTWARE, LOST DATA, OR OTHER DIRECT OR INDIRECT DAMAGE RESULTING FROM THE USE OF THIS SOFTWARE. IN SOME COUNTRIES THE CRYPTOGRAPHIC SOFTWARE AND OTHER COMPONENTS ON THE ISO ARE GOVERNED BY EXPORT REGULATIONS AND THUS MAY NOT BE FREELY COPIED AS IS OTHERWISE NORMAL FOR SOFTWARE UNDER THE GPL LICENSE. IF YOU DO NOT AGREE TO THESE CONDITIONS, YOU ARE NOT PERMITTED TO USE OR FURTHER DISTRIBUTE THIS SOFTWARE. IF YOU PLAN TO COMMERCIALLY USE OR DISTRIBUTE (AND SELL) THE SOFTWARE, YOU HAVE TO ACQUIRE THE NECESSARY LICENSES AND PERMISSIONS FROM ALL SOFTWARE COPYRIGHT HOLDERS OF NON-FREE SOFTWARE COMPONENTS, OR REMOVE THESE COMPONENTS BEFORE DISTRIBUTING THE SOFTWARE.
+
+[Download from main site (EMEA)](https://www.pentoo.ch/isos/)
+
+[Download from Brinstar Networks mirror via HTTP (US)](https://mirror.astr.al/pentoo/)
+
+[Download from Galapagos Linux mirror via HTTP (EMEA)](https://pentoo.emjay-embedded.co.uk/)
+
+[Download from Switch via HTTP (EMEA)](http://mirror.switch.ch/ftp/mirror/pentoo/)
+
+[Download from Switch via FTP (EMEA)](ftp://mirror.switch.ch/mirror/pentoo/)
+
+[Beta ISO (EMEA)](https://pentoo.ch/isos/Beta/)
+
+#### Special thanks to our mirrors:
+
+<a href="http://mirror.switch.ch/"><img src="https://www.switch.ch/export/system/modules/ch.SWITCH.ocms.www/resources/images/logo.png"></a>
+
+<a herf="https://astr.al/blog/"><img src="https://astr.al/u/05792092_276x90.png">

Home.md

@@ -0,0 +1,19 @@
+<a href="http://pentoo.ch"><img src="https://github.com/pentoo/pentoo-overlay/wiki/images/pentoo1.png"></a>
+# Pentoo Penetration Testing Overlay
+
+**Gentoo overlay for security tools as well as the heart of the Pentoo Livecd**
+
+
+<a href="http://pentoo.ch"><img src="https://avatars0.githubusercontent.com/u/6411603?v=3&s=200" align="left" hspace="10" vspace="6"></a>
+Pentoo is a Live CD and Live USB designed for penetration testing and security assessment. Based off Gentoo Linux, Pentoo is provided both as 32 and 64 bit installable livecd. Pentoo is also available as an overlay for an existing Gentoo installation. It features packet injection patched wifi drivers, GPGPU cracking software, and lots of tools for penetration testing and security assessment. The Pentoo kernel includes grsecurity and PAX hardening and extra patches - with binaries compiled from a hardened toolchain with the latest nightly versions of some tools available. 
+
+It's basically a Gentoo, a Linux-based operating system and a meta-distribution, which means that is built automatically from source code and is customized with the functionality that you want to have and without the unnecessary features that you want to avoid, with lots of customized tools, customized kernel, and much more...
+
+#### Current Features :
+
+* Full UEFI including secure boot support
+* CUDA/OpenCL Enhanced cracking software
+* Kernel 4.17.4 and all needed patches for injection
+* XFCE 4.12
+* Full tools list to the right ->
+* All the latest tools and a responsive development team!

List.md

@@ -0,0 +1,18 @@
+<a href="http://pentoo.ch"><img src="https://github.com/pentoo/pentoo-overlay/wiki/images/pentoo1.png"></a>
+#### Features
+
+Here is a non-exhaustive list of the features currently included :
+
++ Available in 32-bit and 64-bit versions, the latter having a significant speed increase from 32bit
++ Includes the required environment to crack passwords using GPGPU with openCL and CUDA configured 'out of the box'
++ Built on hardened linux, including a hardened kernel (with extra patches) and toolchain
++ Backported Wifi stack from latest stable kernel release
++ Uses a pentoo overlay, which allows tools to be built on top of a standard gentoo build
++ Module loading support ala slax
++ Changes saving on usb stick
++ XFCE4 wm
++ Support for full disk encryption with LUKs if installed on HDD
++ Automated installation
++ System updates if you got it finally installed
+
+(...)it's basically a highly customizable Linux-based operating system and a meta-distribution. Using excellent development techniques, we have created a pre-configured security-focused or so called penetration testing LiveCD distribution that is built automatically from source code and is customized with the functionality that you want to have and without the unnecessary features that you want to avoid, with lots of customized tools, customized kernel, and much more.

Overview.md

@@ -0,0 +1,10 @@
+<a href="http://pentoo.ch"><img src="https://github.com/pentoo/pentoo-overlay/wiki/images/pentoo1.png"></a>
+# Pentoo Penetration Testing Overlay
+
+**Gentoo overlay for security tools as well as the heart of the Pentoo Livecd**
+
+
+<a href="http://pentoo.ch"><img src="https://avatars0.githubusercontent.com/u/6411603?v=3&s=200" align="left" hspace="10" vspace="6"></a>
+Pentoo is a Live CD and Live USB designed for penetration testing and security assessment. Based on Gentoo Linux, Pentoo is provided both as 32 and 64 bit installable livecd. Pentoo is also available as an overlay for an existing Gentoo installation. It features packet injection patched wifi drivers, GPGPU cracking software, and lots of tools for penetration testing and security assessment. The Pentoo kernel includes grsecurity and PAX hardening and extra patches - with binaries compiled from a hardened toolchain with the latest nightly versions of some tools available. 
+
+It's basically a Gentoo, a Linux-based operating system and a meta-distribution, which means that it is built automatically from source code and is customized with the functionality that you want to have and without the unnecessary features that you want to avoid, with lots of customized tools, customized kernel, and much more...

Pentoo-Installer.md

@@ -0,0 +1,154 @@
+
+<a href="http://i.imgur.com/FRGc1q1.png">
+  <img src="http://imgur.com/FRGc1q1l.png" />
+</a>
+<a href="http://i.imgur.com/K7lG6kQ.png">
+  <img src="http://imgur.com/K7lG6kQl.png" />
+</a>
+<a href="http://i.imgur.com/NdevkWd.png">
+  <img src="http://imgur.com/NdevkWdl.png" />
+</a>
+<a href="http://i.imgur.com/JRSClvd.png">
+  <img src="http://imgur.com/JRSClvdl.png" />
+</a>
+<a href="http://i.imgur.com/r7HBHqA.png">
+  <img src="http://imgur.com/r7HBHqAl.png" />
+</a>
+<a href="http://i.imgur.com/Zck15cL.png">
+  <img src="http://imgur.com/Zck15cLl.png" />
+</a>
+<a href="http://i.imgur.com/qPVFr7p.png">
+  <img src="http://imgur.com/qPVFr7pl.png" />
+</a>
+<a href="http://i.imgur.com/M1m8mP3.png">
+  <img src="http://imgur.com/M1m8mP3l.png" />
+</a>
+<a href="http://i.imgur.com/uyPZz5s.png">
+  <img src="http://imgur.com/uyPZz5sl.png" />
+</a>
+<a href="http://i.imgur.com/4Uauij3.png">
+  <img src="http://imgur.com/4Uauij3l.png" />
+</a>
+<a href="http://i.imgur.com/kLztDGq.png">
+  <img src="http://imgur.com/kLztDGql.png" />
+</a>
+<a href="http://i.imgur.com/bftQAqj.png">
+  <img src="http://imgur.com/bftQAqjl.png" />
+</a>
+<a href="http://i.imgur.com/knFYmb7.png">
+  <img src="http://imgur.com/knFYmb7l.png" />
+</a>
+<a href="http://i.imgur.com/GWfio3E.png">
+  <img src="http://imgur.com/GWfio3El.png" />
+</a>
+<a href="http://i.imgur.com/4hh0IWm.png">
+  <img src="http://imgur.com/4hh0IWml.png" />
+</a>
+<a href="http://i.imgur.com/s2NpPT0.png">
+  <img src="http://imgur.com/s2NpPT0l.png" />
+</a>
+<a href="http://i.imgur.com/j8JoOTM.png">
+  <img src="http://imgur.com/j8JoOTMl.png" />
+</a>
+<a href="http://i.imgur.com/HA0p7wh.png">
+  <img src="http://imgur.com/HA0p7whl.png" />
+</a>
+<a href="http://i.imgur.com/o5aJokY.png">
+  <img src="http://imgur.com/o5aJokYl.png" />
+</a>
+<a href="http://i.imgur.com/jFOt6iI.png">
+  <img src="http://imgur.com/jFOt6iIl.png" />
+</a>
+<a href="http://i.imgur.com/mwGiheJ.png">
+  <img src="http://imgur.com/mwGiheJl.png" />
+</a>
+<a href="http://i.imgur.com/hURrp59.png">
+  <img src="http://imgur.com/hURrp59l.png" />
+</a>
+<a href="http://i.imgur.com/suGS4q8.png">
+  <img src="http://imgur.com/suGS4q8l.png" />
+</a>
+<a href="http://i.imgur.com/TVZrtiK.png">
+  <img src="http://imgur.com/TVZrtiKl.png" />
+</a>
+<a href="http://i.imgur.com/drL6qgq.png">
+  <img src="http://imgur.com/drL6qgql.png" />
+</a>
+<a href="http://i.imgur.com/SBSTnBO.png">
+  <img src="http://imgur.com/SBSTnBOl.png" />
+</a>
+<a href="http://i.imgur.com/SaLU1Zc.png">
+  <img src="http://imgur.com/SaLU1Zcl.png" />
+</a>
+<a href="http://i.imgur.com/fThXNVD.png">
+  <img src="http://imgur.com/fThXNVDl.png" />
+</a>
+<a href="http://i.imgur.com/tZXDE8d.png">
+  <img src="http://imgur.com/tZXDE8dl.png" />
+</a>
+<a href="http://i.imgur.com/j0Oep7I.png">
+  <img src="http://imgur.com/j0Oep7Il.png" />
+</a>
+<a href="http://i.imgur.com/UH64z9C.png">
+  <img src="http://imgur.com/UH64z9Cl.png" />
+</a>
+<a href="http://i.imgur.com/0XA3vzP.png">
+  <img src="http://imgur.com/0XA3vzPl.png" />
+</a>
+<a href="http://i.imgur.com/lmdzacu.png">
+  <img src="http://imgur.com/lmdzacul.png" />
+</a>
+<a href="http://i.imgur.com/UzBHbGc.png">
+  <img src="http://imgur.com/UzBHbGcl.png" />
+</a>
+<a href="http://i.imgur.com/QxCPo5r.png">
+  <img src="http://imgur.com/QxCPo5rl.png" />
+</a>
+<a href="http://i.imgur.com/c14FCmo.png">
+  <img src="http://imgur.com/c14FCmol.png" />
+</a>
+<a href="http://i.imgur.com/YnZB20T.png">
+  <img src="http://imgur.com/YnZB20Tl.png" />
+</a>
+<a href="http://i.imgur.com/KNwY5Ya.png">
+  <img src="http://imgur.com/KNwY5Yal.png" />
+</a>
+<a href="http://i.imgur.com/Tql8XSx.png">
+  <img src="http://imgur.com/Tql8XSxl.png" />
+</a>
+<a href="http://i.imgur.com/TrSwfQU.png">
+  <img src="http://imgur.com/TrSwfQUl.png" />
+</a>
+<a href="http://i.imgur.com/EPo4Pgy.png">
+  <img src="http://imgur.com/EPo4Pgyl.png" />
+</a>
+<a href="http://i.imgur.com/AbXsa3v.png">
+  <img src="http://imgur.com/AbXsa3vl.png" />
+</a>
+<a href="http://i.imgur.com/yjlcZLD.png">
+  <img src="http://imgur.com/yjlcZLDl.png" />
+</a>
+<a href="http://i.imgur.com/HUlfxwV.png">
+  <img src="http://imgur.com/HUlfxwVl.png" />
+</a>
+<a href="http://i.imgur.com/PJgKmed.png">
+  <img src="http://imgur.com/PJgKmedl.png" />
+</a>
+<a href="http://i.imgur.com/vxXIX4j.png">
+  <img src="http://imgur.com/vxXIX4jl.png" />
+</a>
+<a href="http://i.imgur.com/cKu4Y6J.png">
+  <img src="http://imgur.com/cKu4Y6Jl.png" />
+</a>
+<a href="http://i.imgur.com/iH5mG2D.png">
+  <img src="http://imgur.com/iH5mG2Dl.png" />
+</a>
+<a href="http://i.imgur.com/X84HVlG.png">
+  <img src="http://imgur.com/X84HVlGl.png" />
+</a>
+<a href="http://i.imgur.com/C5IC4KH.png">
+  <img src="http://imgur.com/C5IC4KHl.png" />
+</a>
+<a href="http://i.imgur.com/yFcZE4U.png">
+  <img src="http://imgur.com/yFcZE4Ul.png" />
+</a>

Remove.md

@@ -0,0 +1,21 @@
+## Remove
+
+Uninstall whatever was installed
+````
+emerge -C pentoo
+````
+or a separate package
+````
+emerge -C pentoo-wireless
+````
+If you installed multiple individual packages, use the following command to get the list:
+````
+cd /var/db/pkg ; for x in */* ; do [[ `cat ${x}/repository` == "pentoo" ]] && echo "${x}"; done
+````
+Clean up the system and remove the overlay from your repository:
+````
+emerge --depclean
+eclean-dist
+revdep-rebuild
+layman -d pentoo
+````

Requirements.md

@@ -0,0 +1,48 @@
+<a href="http://pentoo.ch"><img src="https://github.com/pentoo/pentoo-overlay/wiki/images/pentoo1.png"></a>
+### System Requirements
+#### Introduction
+##### What are the minimum system requirements to be able to run Pentoo Penetration Testing Overlay and Livecd effectively?
+
+Pretty much just having a computer will let you run Pentoo. lol. But seriously, it depends on what you want to do. Pentoo Penetration Testing Overlay is supported on i686, amd64, and ARM (both armel and armhf) platforms.
+
+##### Prerequisites and System Requirements for running Pentoo livecd
+
+###### Live Environment - No 3D Desktop:
++ i686 Processor
++ at least 1 GiB of RAM (2 GiB suggested)
++ a 2D graphics card
++ a DDC capable Monitor
++ mouse and keyboard
+
+###### Live Environment - 3D Desktop:
++ i686 Processor (starting from AMD K6 and Intel Pentium II)
++ at least 2 GiB of RAM (4 GiB suggested)
++ an OpenGL capable 3D graphics card (mostly NVIDIA, ATI, Intel, VIA)
++ a DDC capable Monitor
++ mouse and keyboard
+
+###### Installation:
++ i686 Processor
++ at least 2 GiB of RAM
++ an OpenGL capable 3D graphics card (mostly NVIDIA, ATI, Intel, VIA)
++ 20 GiB of free space, that is bare minimum DVD Install. 30+ GiB is highly recommended.
++ Internet connection (not mandatory but highly suggested)
++ a DDC capable Monitor
++ mouse and keyboard
+
+##### Prerequisites and System Requirements for running with Pentoo overlay
+
+###### Overlay:
++ i686 or ARM Processor
++ at least 512 MiB of RAM (2 GiB suggested)
++ an OpenGL capable 3D graphics card (mostly NVIDIA, ATI, Intel, VIA)
++ 20 GiB of free space, 30+ GiB is highly recommended.
++ Internet connection (not mandatory but highly suggested)
++ a DDC capable Monitor
++ mouse and keyboard
+
+##### Pentoo Penetration Testing Overlay and Livecd can be as heavy as you want, or as small as you want. Yet unless you deviate from the documented approach, Gentoo Linux remains a source-based distribution.
+
+Because of that, it has a slightly higher disk space requirement than other distributions. To have a comfortable installation, yet with room to spare for additional installations, you should consider a total diskspace of at least 20 Gbyte for the applications alone. With current disk sizes, this should not be a problem. If you don't install a full-blown KDE or GNOME, you should have enough with 20Gbyte.
+
+Disk space aside, Gentoo Linux can run and install with almost any system specification. Of course, the lower the specs, the higher the duration of an installation.

Roadmap.md

@@ -0,0 +1 @@
+<a href="http://pentoo.ch"><img src="https://github.com/pentoo/pentoo-overlay/wiki/images/pentoo1.png"></a>

Set-up.md

@@ -0,0 +1,81 @@
+## Set-up
+
+**WARNING**: Very recently some changes were pushed to Pentoo which moved the Pentoo Overlay from /var/lib/layman to /var/db/repos.
+
+#### Introduction
+Pentoo Linux can be used as an overlay bringing a full set of tools and settings to an existing stable Gentoo setup.
+
+#### Adding the overlay
+##### Update the portage to the latest version
+````
+emerge --sync
+````
+##### Make sure that layman and subversion are installed
+````
+emerge app-portage/layman subversion 
+````
+##### Update list of overlays
+````
+layman -L
+````
+##### Add Pentoo overlay
+````
+layman -a pentoo
+````
+#### Add proper keywords/use flags and other settings. There are 3 options:
+
+##### Option 1: Use one of Pentoo profiles
+List all available profiles
+````
+eselect profile list
+````
+Select an appropriate Pentoo profile for your current setup
+````
+eselect profile set pentoo:pentoo/hardened/linux/amd64
+````
+##### Option 2: Use the "overlay" subprofile (gentoo profile + keywords/use files)
+Remove an old profile
+````
+rm /etc/portage/make.profile
+mkdir -p /etc/portage/make.profile
+````
+Create the /etc/portage/make.profile/parent file with the following context:
+````
+gentoo:default/linux/amd64/17.1/hardened
+gentoo:targets/desktop/
+pentoo:pentoo/overlay
+````
+switch to that profile
+````
+env-update && source /etc/profile 
+````
+##### Option 3: Manual
+Create symlinks for necessary keywords/use files:
+````
+ln -s /var/lib/layman/pentoo/profiles/pentoo/base/package.accept_keywords/net-analyzer /etc/portage/package.keywords
+ln -s /var/lib/layman/pentoo/profiles/pentoo/base/package.use/dev-ruby /etc/portage/package.use
+````
+Check changes and adjust other settings if required
+See the next section for examples
+````
+emerge -DNupv world
+````
+##### Install the entire Pentoo 
+````
+emerge -DNu pentoo
+````
+or choose a separate package
+````
+emerge -DNu pentoo-wireless
+````
+##### Adjusting settings
+To merge the overlay with your current setup smoother, additional changes can be made in a usual Gentoo way by modifying files in the /etc/portage directory. For example, you can disable additional wireless drivers by adding a file to the /etc/portage/package.use/ directory with the following content:
+````
+pentoo/pentoo -bluetooth
+pentoo/pentoo-wireless -drivers
+````
+and disable unrequired global flags in the make.conf file:
+````
+USE="-bluetooth -gps -caps -livecd -ldap"
+````
+See the official Gentoo handbook for more details

Support.md

@@ -0,0 +1,3 @@
+<a href="http://pentoo.ch"><img src="https://github.com/pentoo/pentoo-overlay/wiki/images/pentoo1.png"></a>
+
+Discussion and support available on irc.freenode.net  **#pentoo**

Tools.md

@@ -0,0 +1,24 @@
+<a href="http://pentoo.ch"><img src="https://github.com/pentoo/pentoo-overlay/wiki/images/pentoo1.png"></a>
+#### Tools
+
+Tools are installed with versioned ebuilds and open-ended ebuilds, making it possible to pull in the latest subversions and still have installs tracked by package management. The following tool categories are included:
+
++ Analyzer
++ Bluetooth
++ Cracker
++ Database
++ Development
++ Exploit
++ Footprint
++ Forensics
++ Forging
++ Fuzzers
++ Misc
++ MitM
++ Nfc
++ Pentoo
++ Proxy
++ RCE
++ Scanner
++ SIP-VOIP
++ Wireless

Update.md

@@ -0,0 +1,140 @@
+## Update
+
+To eliminate most of the question in IRC (#pentoo) and to start a good documentation process, here are the steps to bring your system up to date.
+
+**WARNING**: The errors on your screen need to be read and acted upon, following these directions blindly will result in failure, then ridicule, then more failure.
+
+### For the first time
+
+##### Sync with the portage tree
+````
+emerge --sync
+````
+##### Modify /etc/portage/make.conf file for your system:
+
+Please adjust your CFLAGS as desired, information can be found here: https://wiki.gentoo.org/wiki/CFLAGS
+Do not modify these FLAGS unless you know what you are doing, always check the defaults first with: 
+````
+portageq envvar CFLAGS
+````
+This is the default for pentoo at the time of build:
+````
+# CFLAGS="-Os -mtune=nocona -pipe -ggdb"
+````
+A safe choice would be to keep whatever Pentoo defaults are, but optimize for your specific machine:
+````
+CFLAGS="${CFLAGS} -march=native"
+CXXFLAGS="${CFLAGS}"
+FCFLAGS="${CFLAGS}"
+FFLAGS="${CFLAGS}"
+````
+MAKEOPTS is set automatically by the profile to jobs equal to processors, you do not need to set it.
+````
+ACCEPT_LICENSE="Oracle-BCLA-JavaSE NVIDIA-CUDA google-chrome Google-TOS PUEL baudline"
+````
+You may wish to edit your VIDEO_CARDS line to match your system better.
+Example, for nvidia/ati users should add nvdia/fglrx flags:
+````
+VIDEO_CARDS="fbdev vga vesa nvidia"
+````
+Guest OS users should add virtualbox/vmware or qxl flag(s):
+````
+VIDEO_CARDS="fbdev vga vesa virtualbox"
+````
+##### Modify your profile only if you know what you are doing, default should be fine for most users
+````
+eselect profile list
+eselect profile set <number>
+````
+*Follow the pentoo-updater below*
+### On regular basis
+Pay extra attention on upgrading kernel, gcc, python or any other system package. It is important to upgrade these packages properly before moving to the next step. You might also need to understand Upgrading Gentoo generic guideline.
+
+Very recently some changes were pushed to Pentoo which moved the Pentoo Overlay from /var/lib/layman to /var/db/repos so:
+
+##### If you have /var/db/repos/pentoo:
+
+````
+cd /var/db/repos/pentoo
+git pull
+./scripts/pentoo-updater.sh
+````
+
+everything should work now,
+
+
+##### If you have /var/lib/layman/pentoo:
+
+````
+cd /var/lib/layman/pentoo
+git pull
+./scripts/pentoo-updater.sh
+````
+
+everything should work now,
+
+
+##### This syncs the gentoo and pentoo repos like "apt-get update" in debian
+````
+emerge --sync
+````
+##### This updates all the normal packages like "apt-get upgrade" in debian
+````
+emerge --deep --update --newuse world -vt
+````
+##### This optionally merges in changed config files. unchanged files are merged automatically
+````
+etc-update
+````
+##### This removes old packages which are not needed like "apt-get autoremove" in debian
+````
+emerge --depclean
+````
+##### This rebuilds anything which may have been broken in update
+````
+emerge @preserved-rebuild
+````
+##### This checks all the programs installed from VCS for new revisions and updates if needed
+````
+smart-live-rebuild
+````
+##### Verifies there is no breakage after updates
+````
+revdep-rebuild
+````
+##### merge in any new config files
+````
+etc-update
+````
+##### clean up the distfiles/packages dirs to remove old/un-needed files
+````
+eclean-dist -d && eclean-pkg -d
+````
+*Check /var/log/portage/elog/summary.log file*
+
+##### Kernel update
+Follow the usual Gentoo way. Once the source is installed, download the latest config and run:
+````
+genkernel --no-clean --luks --gpg all
+emerge @module-rebuild
+````
+and add a new boot menu in the /boot/grub/menu.lst file 
+
+##### You might need to run extra commands. For example:
+````
+emerge @x11-module-rebuild
+eselect java-vm set system icedtea-bin-7
+````
+after python/perl upgrade:
+````
+perl-cleaner --modules
+python-updater
+````
+
+*Run the following command under each regular user's account*
+##### Regenerate the main menu for XFCE WM (or "-e" for e17, "-k" for KDE)
+````
+genmenu.py -x
+````
+
+Discussion and support available on irc.freenode.net  **#pentoo**

_Footer.md

@@ -0,0 +1,2 @@
+**Pentoo Penetration Testing Overlay and Livecd**  
+[Blog](http://pentoo.blogspot.com) | [Twitter @pentoo_linux](https://twitter.com/pentoo_linux) | [Download Stable](https://pentoo.ch/isos/) | [Download Beta](https://pentoo.ch/isos/Beta/) | [Wiki](https://github.com/pentoo/pentoo-overlay/wiki)

_Sidebar.md

@@ -0,0 +1,21 @@
+<a href="http://pentoo.ch"><img src="https://avatars0.githubusercontent.com/u/6411603?v=3&s=200" align="center" hspace="1" vspace="1"></a>
+
+**About**
+* [Project home page](http://pentoo.ch)
+* [[Home]]
+* [[Requirements]]
+* [[Support]]
+* [[Roadmap]]
+* [[Distro Rules]]
+
+**Essentials**
+
+* [[Getting Started]]
+  * [Download](http://pentoo.ch/download/)
+  * [[BIOS and UEFI Bootable USB]]
+  * [[Pentoo Installer]]
+  * [[Set-up]]
+  * [[Update]]
+  * [[Remove]]
+* [[Customization]]
+* [[FAQ]]