* [gentoo-commits] gentoo commit in xml/htdocs/proj/en/base/mips: yeeloong.xml
@ 2012-08-22 0:14 Anthony G. Basile (blueness)
0 siblings, 0 replies; 4+ messages in thread
From: Anthony G. Basile (blueness) @ 2012-08-22 0:14 UTC (permalink / raw
To: gentoo-commits
blueness 12/08/22 00:14:13
Added: yeeloong.xml
Log:
Add Lemote Yeeloong Gentoo Desktop documentation
Revision Changes Path
1.1 xml/htdocs/proj/en/base/mips/yeeloong.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/mips/yeeloong.xml?rev=1.1&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/mips/yeeloong.xml?rev=1.1&content-type=text/plain
Index: yeeloong.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide>
<title>Lemote Yeeloong Gentoo Desktop</title>
<author title="Author">
<mail link="blueness@gentoo.org">Anthony G. Basile</mail>
</author>
<abstract>
The Lemote Yeeloong Gentoo Desktop aim to provide a ready to install
XFCE4 base desktop to the Yeeloong netbook.
</abstract>
<version>1.0</version>
<date>2012-08-19</date>
<chapter>
<title>Introduction</title>
<section>
<body>
<p>
The Lemote Yeeloong netbook is based on a 64-bit little endian MIPS processor,
named the loongson2f, and is manufactured by <uri link="http://www.lemote.com/en/">
lemote.com</uri>. It is celebrated as sporting only hardware that respects your
freedom, that is, hardware that will run purely with open source software at every
level. There are no proprietary binary blobs required to make any hardware work,
and even its boot firmware (<uri link="http://www.pmon2000.com/">PMON</uri>) is
released under a copyleft licence. As the netbook of choice for Richard Stallman,
it is distributed in the United States by <uri link="http://freedomincluded.com/">
Freedom Included</uri>. Take a look at their web site for why the choice of hardware
is a political choice and why freedom matters.
</p>
<p>
Th "Lemote Yeeloong Gentoo Desktop" initiative is part of a bigger initiative in Gentoo
to support MIPS based systems. We started this because compiling on the Yeeloong is
slow enough that it is annoying for the average person to build a useful system from a
classical Gentoo stage3 tarball. One could cross compile from a different, faster,
architecture; but, that's involved and doesn't always produce the best native code. So,
with a prebuilt desktops, we hope to give the end user a quick start to a productive
environment that they are (hopefully) mostly happy with. One can always tweak from there.
The drawback to this approach is that it does rub against the "Gentoo way" which is to
maximize choice, but we still provide a stage3 for those who want --- so choose!
</p>
<p>
Currently the desktop of choice is based on XFCE4. We did not even attemp Gnome
or KDE becuase of their bloat, and because much of that software is in a bad state
with respect to all MIPS architecture. The bloat, however, was the deciding factor.
We can always hack Gnome back into a MIPS friendly state, but on a system with a
~600MHz processor with 1GB of RAM, do we really want to follow bloatware development?
We may expand into other light desktop systems, like LXDE. Tell us what you want!
</p>
<p>
We are also working with two "flavors" of each desktop, what we call "vanilla"
and "hardened". The two are identical in term of what packages they provide,
except the hardened image is built using the completely hardened toolchain
maintained by the Hardened Gentoo team. The means that all the ELF binaries
are ET_DYN (not ET_EXE so their address space is better randomized), have SSP
(stack smashing protection against buffer overflows), PIE (position independant
executable, also better address space randomization) and FORTIFY_SOURCES=2
(extra hardening of glibc functions). They are also linked relro (relocation
read-only) and bind-now to prevent redirection of symbols.
</p>
<p>
Sounds like hardened is a clear winner over vanilla, except that there is a
small performance hit. Not anything like i686, but still noticeable. Maybe
five to ten percent, but we haven't made a good measure. Also, if you're
compiling your own binaries, there may be some exotic breakage with the
hardened that you won't get with the vanilla. Again its much rarer than
on i686. There, the issue is often poorly written assembly that isn't
PIC/PIE friendly, but since you're on a mips64el arch, chances are that
that assembly hasn't even been ported, so there's nothing there to break!
</p>
<p>
If you're just an ordinary user, choose hardened. The extra security will
outweigh the other factors.
</p>
<p>
We are actively developing and things are in flux --- when it is mature, we
will change this paragraph. So, there are some TODOs. But, the most important
TODO is you. What should be included and what should not?
</p>
</body>
</section>
</chapter>
<chapter>
<title>Goals</title>
<section>
<body>
<p>
The purpose of the "Lemote Yeeloong Gentoo Desktop" initiative is to make
ready to install Gentoo based desktops for the Lemote Yeeloong netbook
to ease the long process of building a full desktop system from a stage3
tarball. As a secondary goal, it aims to port the hardening toolchains and
kernel features currently available in amd64 and x86 to mips architecture.
</p>
</body>
</section>
</chapter>
<chapter>
<title>Installation</title>
<section>
<body>
<p>
First, where do you find the images you'll need? Everything you'll need
is on the <uri link="http://www.gentoo.org/main/en/mirrors2.xml"> gentoo
mirrors </uri>, under experimental/mips/desktop-loongson2f. You'll need two
images, the boot image called netboot-yeeloong.img and the desktop image, a simple
tarball called desktop-loongson2f-[flavor]-[date].tar.lzma, where the [flavor]
is either "hardened" or "vanilla" and [date] is the release date. We'll
try to produce a new release every month. As stated above, this is just for
XFCE4, but when/if we get more desktops, that will also be make explicit in
the image name.
</p>
<p>
So, how do I install it on my Lemote Yeeloong?
</p>
<ul>
<li>
Prepare the boot image: Get the file called netboot-yeeloong.img and put
it either on a tftp server or a pen drive at some /path/to/. Make sure you
prepare the drive with a FAT32, EXT2 or EXT3, but <b>not</b> EXT4 filesystem.
PMON doesn't understand EXT4.
</li>
<li>
Boot into a rescue environment: Turn the lemote on and hit the Del key
multiple times. You should see a PMON> prompt appear with possibly some
trailing garbage characters, usually repeated G's. Backspace over the
garbage to delete it.
</li>
<li>
If you are booting off the network with a tftp server, then the enter:
<ul>
<li>PMON> ifaddr rtl0 [my_ip]</li>
<li>PMON> load tftp://[tftp_ip]/path/to/netboot-yeeloong.img</li>
<li>PMON> g</li>
</ul>
Replace [my_ip] with the ip of the lemote yeeloong and [tftp_ip] with the ip of
your tftp server.
</li>
<li>
If, however, you want to boot off a pen drive, enter:
<ul>
<li>PMON> load /dev/fs/ext2@usb0/path/to/netboot-yeeloong.img</li>
<li>PMON> g</li>
</ul>
At this point you'll come up in a ramdisk image with busybox and a few other
utilities to get your system ready. Hit enter a couple of times if you don't
see a shell prompt right away.
</li>
<li>
Prepare a root partition and mount:
<ul>
<li>Using fdisk, prepare at least two partitions:
<ul>
<li>/dev/sda1 - this will be root, give it a generous amount, at least 6GB.</li>
<li>/dev/sda2 - this will be swap, give it at least 1GB.</li>
</ul>
These really are minimal. I use 40GB for root and 4GB for swap.
</li>
<li>mdev needs to rescan the devices after (re)partioning. You could reboot,
but its easier to just do:
<ul>
<li>mdev -s</li>
</ul>
</li>
<li>Format the partitons:
<ul>
<li>mkfs.ext3 /dev/sda1 - do not use EXT4 since PMON doesn't understand it</li>
<li>mkswap /dev/sda2</li>
</ul>
</li>
<li>Mount it
<ul>
<li>mkdir -p /mnt/gentoo</li>
<li>mount /dev/sda1 /mnt/gentoo</li>
</ul>
</li>
</ul>
</li>
<li>
Download and unpack the tarball images:
<ul>
<li>cd /mnt/gentoo</li>
<li>wget http://[mirror]/gentoo/experimental/mips/desktop-loongson2f/desktop-loongson2f-[flavor]-[date].tar.lzma</li>
<li>tar xf desktop-loongson2f-[flavor]-[date].tar.lzma</li>
</ul>
Replace [mirror] with the FQDN of your favorite Gentoo mirror, replace
[flavor] with either "hardened" or "vanilla" and replace [date] with the
date of the release.
</li>
<li>
If you changed any of the above values for /dev/sda* then edit the boot.cfg
file. It can be found at /mnt/gentoo/boot/boot.cfg.
</li>
<li>
Reboot your yeeloong. PMON should find the kernel, but if it doesn't then enter
<ul>
<li>PMON> load /dev/fs/ext2@wd0/boot/vmlinuz</li>
<li>PMON> g console=tty root=/dev/sda1</li>
</ul>
</li>
<li>
Log in and enjoy!
<ul>
<li>user: gentoo</li>
<li>pass: gentoo</li>
</ul>
or
<ul>
<li>user: root</li>
<li>pass: root</li>
</ul>
</li>
</ul>
</body>
</section>
</chapter>
<chapter>
<title>Developers</title>
<section>
<body>
<table>
<tr>
<th>Developer</th>
<th>Nickname</th>
<th>Role</th>
</tr>
<tr>
<ti>Anthony G. Basile</ti>
<ti>blueness</ti>
<ti>Lead</ti>
</tr>
</table>
</body>
</section>
</chapter>
<chapter>
<title>Bug Reporting</title>
<section>
<body>
<p>
Please submit feature requests and bug reports at <uri link="https://bugs.gentoo.org">bugs.gentoo.org</uri>
and make your bug a blocker to <uri link="https://bugs.gentoo.org/show_bug.cgi?id=282265">bug #282265</uri>.
Assign your bug to mips@gentoo.org.
</p>
</body>
</section>
</chapter>
</guide>
^ permalink raw reply [flat|nested] 4+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/proj/en/base/mips: yeeloong.xml
@ 2012-09-09 12:33 Anthony G. Basile (blueness)
0 siblings, 0 replies; 4+ messages in thread
From: Anthony G. Basile (blueness) @ 2012-09-09 12:33 UTC (permalink / raw
To: gentoo-commits
blueness 12/09/09 12:33:53
Modified: yeeloong.xml
Log:
Fix some typos, thanks nimiux
Revision Changes Path
1.2 xml/htdocs/proj/en/base/mips/yeeloong.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/mips/yeeloong.xml?rev=1.2&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/mips/yeeloong.xml?rev=1.2&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/mips/yeeloong.xml?r1=1.1&r2=1.2
Index: yeeloong.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/mips/yeeloong.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- yeeloong.xml 22 Aug 2012 00:14:13 -0000 1.1
+++ yeeloong.xml 9 Sep 2012 12:33:53 -0000 1.2
@@ -32,12 +32,12 @@
is a political choice and why freedom matters.
</p>
<p>
-Th "Lemote Yeeloong Gentoo Desktop" initiative is part of a bigger initiative in Gentoo
+The "Lemote Yeeloong Gentoo Desktop" initiative is part of a bigger initiative in Gentoo
to support MIPS based systems. We started this because compiling on the Yeeloong is
slow enough that it is annoying for the average person to build a useful system from a
classical Gentoo stage3 tarball. One could cross compile from a different, faster,
architecture; but, that's involved and doesn't always produce the best native code. So,
-with a prebuilt desktops, we hope to give the end user a quick start to a productive
+with a prebuilt desktop, we hope to give the end user a quick start to a productive
environment that they are (hopefully) mostly happy with. One can always tweak from there.
The drawback to this approach is that it does rub against the "Gentoo way" which is to
maximize choice, but we still provide a stage3 for those who want --- so choose!
@@ -54,7 +54,7 @@
We are also working with two "flavors" of each desktop, what we call "vanilla"
and "hardened". The two are identical in term of what packages they provide,
except the hardened image is built using the completely hardened toolchain
-maintained by the Hardened Gentoo team. The means that all the ELF binaries
+maintained by the Hardened Gentoo team. This means that all the ELF binaries
are ET_DYN (not ET_EXE so their address space is better randomized), have SSP
(stack smashing protection against buffer overflows), PIE (position independant
executable, also better address space randomization) and FORTIFY_SOURCES=2
^ permalink raw reply [flat|nested] 4+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/proj/en/base/mips: yeeloong.xml
@ 2013-01-27 13:51 Anthony G. Basile (blueness)
0 siblings, 0 replies; 4+ messages in thread
From: Anthony G. Basile (blueness) @ 2013-01-27 13:51 UTC (permalink / raw
To: gentoo-commits
blueness 13/01/27 13:51:39
Modified: yeeloong.xml
Log:
Update yeeloong doc for the 20130124 images
Revision Changes Path
1.3 xml/htdocs/proj/en/base/mips/yeeloong.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/mips/yeeloong.xml?rev=1.3&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/mips/yeeloong.xml?rev=1.3&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/mips/yeeloong.xml?r1=1.2&r2=1.3
Index: yeeloong.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/mips/yeeloong.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- yeeloong.xml 9 Sep 2012 12:33:53 -0000 1.2
+++ yeeloong.xml 27 Jan 2013 13:51:39 -0000 1.3
@@ -122,7 +122,7 @@
<li>
Prepare the boot image: Get the file called netboot-yeeloong.img and put
it either on a tftp server or a pen drive at some /path/to/. Make sure you
-prepare the drive with a FAT32, EXT2 or EXT3, but <b>not</b> EXT4 filesystem.
+prepare the pen drive with a FAT32, EXT2 or EXT3, but <b>not</b> EXT4 filesystem.
PMON doesn't understand EXT4.
</li>
<li>
@@ -156,10 +156,12 @@
<ul>
<li>Using fdisk, prepare at least two partitions:
<ul>
- <li>/dev/sda1 - this will be root, give it a generous amount, at least 6GB.</li>
- <li>/dev/sda2 - this will be swap, give it at least 1GB.</li>
+ <li>/dev/sda1 - this will be /boot, give it about 128 MB.</li>
+ <li>/dev/sda2 - this will be swap, give it at least 1 GB.</li>
+ <li>/dev/sda3 - this will be root, give it a generous amount, at least 6 GB.</li>
</ul>
- These really are minimal. I use 40GB for root and 4GB for swap.
+ /boot only has to hold a kernel or two, so you can get away with less, but the others are minima.
+ I use 4GB for swap and 40GB for root.
</li>
<li>mdev needs to rescan the devices after (re)partioning. You could reboot,
@@ -171,15 +173,18 @@
<li>Format the partitons:
<ul>
- <li>mkfs.ext3 /dev/sda1 - do not use EXT4 since PMON doesn't understand it</li>
+ <li>mke2fs /dev/sda1 - do not use EXT4 since PMON doesn't understand it</li>
<li>mkswap /dev/sda2</li>
+ <li>mkfs.ext4 /dev/sda3 - use the tried and true EXT4</li>
</ul>
</li>
<li>Mount it
<ul>
<li>mkdir -p /mnt/gentoo</li>
- <li>mount /dev/sda1 /mnt/gentoo</li>
+ <li>mkdir -p /mnt/gentoo/boot</li>
+ <li>mount /dev/sda3 /mnt/gentoo</li>
+ <li>mount /dev/sda1 /mnt/gentoo/boot</li>
</ul>
</li>
</ul>
@@ -203,7 +208,7 @@
Reboot your yeeloong. PMON should find the kernel, but if it doesn't then enter
<ul>
<li>PMON> load /dev/fs/ext2@wd0/boot/vmlinuz</li>
- <li>PMON> g console=tty root=/dev/sda1</li>
+ <li>PMON> g console=tty root=/dev/sda3</li>
</ul>
</li>
<li>
^ permalink raw reply [flat|nested] 4+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/proj/en/base/mips: yeeloong.xml
@ 2013-01-28 21:11 Anthony G. Basile (blueness)
0 siblings, 0 replies; 4+ messages in thread
From: Anthony G. Basile (blueness) @ 2013-01-28 21:11 UTC (permalink / raw
To: gentoo-commits
blueness 13/01/28 21:11:08
Modified: yeeloong.xml
Log:
Fix number of partitions to create
Revision Changes Path
1.4 xml/htdocs/proj/en/base/mips/yeeloong.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/mips/yeeloong.xml?rev=1.4&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/mips/yeeloong.xml?rev=1.4&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/mips/yeeloong.xml?r1=1.3&r2=1.4
Index: yeeloong.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/mips/yeeloong.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- yeeloong.xml 27 Jan 2013 13:51:39 -0000 1.3
+++ yeeloong.xml 28 Jan 2013 21:11:08 -0000 1.4
@@ -154,7 +154,7 @@
<li>
Prepare a root partition and mount:
<ul>
- <li>Using fdisk, prepare at least two partitions:
+ <li>Using fdisk, prepare at least three partitions:
<ul>
<li>/dev/sda1 - this will be /boot, give it about 128 MB.</li>
<li>/dev/sda2 - this will be swap, give it at least 1 GB.</li>
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2013-01-28 21:11 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2013-01-28 21:11 [gentoo-commits] gentoo commit in xml/htdocs/proj/en/base/mips: yeeloong.xml Anthony G. Basile (blueness)
-- strict thread matches above, loose matches on Subject: below --
2013-01-27 13:51 Anthony G. Basile (blueness)
2012-09-09 12:33 Anthony G. Basile (blueness)
2012-08-22 0:14 Anthony G. Basile (blueness)
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox