aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/gnulinux/configuring_parabola.md18
-rw-r--r--docs/gnulinux/encrypted_parabola.md27
-rw-r--r--docs/gnulinux/grub_cbfs.md3
-rw-r--r--docs/hardware/gm45_remove_me.md5
-rw-r--r--docs/hardware/x200.md1
-rw-r--r--docs/install/bbb_setup.md5
-rw-r--r--docs/install/c201.md4
-rw-r--r--docs/install/index.md1
-rw-r--r--docs/install/r400_external.md6
-rw-r--r--docs/install/t400_external.md6
-rw-r--r--docs/install/t500_external.md6
-rw-r--r--docs/install/t60_unbrick.md1
-rw-r--r--docs/install/x60_unbrick.md1
-rw-r--r--docs/install/x60tablet_unbrick.md1
14 files changed, 85 insertions, 0 deletions
diff --git a/docs/gnulinux/configuring_parabola.md b/docs/gnulinux/configuring_parabola.md
index e70204e1..7fc9d688 100644
--- a/docs/gnulinux/configuring_parabola.md
+++ b/docs/gnulinux/configuring_parabola.md
@@ -56,8 +56,10 @@ careful about this when reading anything on the Arch wiki.
Some of these steps require internet access. I'll go into networking
later but for now, I just connected my system to a switch and did:
# systemctl start dhcpcd.service
+
You can stop it later by running:
# systemctl stop dhcpcd.service\
+
For most people this should be enough, but if you don't have DHCP on
your network then you should setup your network connection first:\
[Setup network connection in Parabola](#network)
@@ -83,6 +85,7 @@ In the end, I didn't change my configuration for pacman. When you are
updating, resync with the latest package names/versions:
# pacman -Syy
+
(according to the wiki, -Syy is better than Sy because it refreshes the
package list even if it appears to be up to date, which can be useful
when switching to another mirror).\
@@ -159,6 +162,7 @@ The wiki also mentions this method for removing everything from the
cache, including currently installed packages that are cached:
# pacman -Scc
+
This is inadvisable, since it means re-downloading the package again if
you wanted to quickly re-install it. This should only be used when disk
space is at a premium.
@@ -196,6 +200,7 @@ Read the entire document linked to above, and then continue.
Add your user:
# useradd -m -G wheel -s /bin/bash *yourusername*
+
Set a password:
# passwd *yourusername*
@@ -223,6 +228,7 @@ supplier) to use systemd.
The manpage should also help:
# man systemd
+
The section on 'unit types' is especially useful.
According to the wiki, systemd 'journal' keeps logs of a size up to
@@ -256,9 +262,11 @@ Finally, the wiki mentions 'temporary' files and the utility for
managing them.
# man systemd-tmpfiles
+
The command for 'clean' is:
# systemd-tmpfiles --clean
+
According to the manpage, this *"cleans all files and directories with
an age parameter"*. According to the Arch wiki, this reads information
in /etc/tmpfiles.d/ and /usr/lib/tmpfiles.d/ to know what actions to
@@ -270,6 +278,7 @@ However, /usr/lib/tmpfiles.d/ contained some files. The first one was
etc.conf, containing information and a reference to this manpage:
# man tmpfiles.d
+
Read that manpage, and then continue studying all the files.
The systemd developers tell me that it isn't usually necessary to touch
@@ -312,6 +321,7 @@ when installing Parabola. You can also do it with systemd (do so now, if
you like):
# hostnamectl set-hostname *yourhostname*
+
This writes the specified hostname to /etc/hostname. More information
can be found in these manpages:
@@ -399,6 +409,7 @@ non-free firmware inside, but it's transparent to you but the smart
data comes from it. Therefore, don't rely on it too much):
# pacman -S smartmontools
+
Read <https://wiki.archlinux.org/index.php/S.M.A.R.T.> to learn how to
use it.
@@ -418,6 +429,7 @@ Based on <https://wiki.archlinux.org/index.php/Xorg>.
Firstly, install it!
# pacman -S xorg-server
+
I also recommend installing this (contains lots of useful tools,
including *xrandr*):
@@ -427,9 +439,11 @@ Install the driver. For me this was *xf86-video-intel* on the ThinkPad
X60. T60 and macbook11/21 should be the same.
# pacman -S xf86-video-intel
+
For other systems you can try:
# pacman -Ss xf86-video- | less
+
Combined with looking at your *lspci* output, you can determine which
driver is needed. By default, Xorg will revert to xf86-video-vesa which
is a generic driver and doesn't provide true hardware acceleration.
@@ -535,6 +549,7 @@ I also like to install these:
Enable LXDM (the default display manager, providing a graphical login):
# systemctl enable lxdm.service
+
It will start when you boot up the system. To start it now, do:
# systemctl start lxdm.service
@@ -615,6 +630,7 @@ Install Network Manager:
You will also want the graphical applet:
# pacman -S network-manager-applet
+
Arch wiki says that an autostart rule will be written at
*/etc/xdg/autostart/nm-applet.desktop*
@@ -629,6 +645,7 @@ LXDE uses openbox, so I refer to:\
It tells me for the applet I need:
# pacman -S xfce4-notifyd gnome-icon-theme
+
Also, for storing authentication details (wifi) I need:
# pacman -S gnome-keyring
@@ -637,6 +654,7 @@ I wanted to quickly enable networkmanager:
# systemctl stop dhcpcd
# systemctl start NetworkManager
+
Enable NetworkManager at boot time:
# systemctl enable NetworkManager
diff --git a/docs/gnulinux/encrypted_parabola.md b/docs/gnulinux/encrypted_parabola.md
index 5f0b796b..e1f6a9d7 100644
--- a/docs/gnulinux/encrypted_parabola.md
+++ b/docs/gnulinux/encrypted_parabola.md
@@ -82,6 +82,7 @@ guide is recommending putting zero there. I'm going to use urandom. Do
this:
# head -c 3145728 /dev/urandom > /dev/sda; sync
+
(Wiping the LUKS header is important, since it has hashed passphrases
and so on. It's 'secure', but 'potentially' a risk).
@@ -93,6 +94,7 @@ list the available keymaps and use yours:
# localectl list-keymaps
# loadkeys LAYOUT
+
For me, LAYOUT would have been dvorak-uk.
Establish an internet connection
@@ -166,6 +168,7 @@ is the best option.
I am initializing LUKS with the following:
# cryptsetup -v --cipher serpent-xts-plain64 --key-size 512 --hash
+
whirlpool --iter-time 500 --use-random --verify-passphrase luksFormat
/dev/sda1
@@ -313,6 +316,7 @@ and wpa\_supplicant/dialog/iw/wpa\_actiond are needed for wireless after
the install:
# pacstrap /mnt base base-devel wpa\_supplicant dialog iw
+
wpa\_actiond
Configure the system
@@ -323,9 +327,11 @@ Generate an fstab - UUIDs are used because they have certain advantages
prefer labels instead, replace the -U option with -L):
# genfstab -U -p /mnt >> /mnt/etc/fstab
+
Check the created file:
# cat /mnt/etc/fstab
+
(If there are any errors, edit the file. Do **NOT** run the genfstab
command again!)
@@ -354,6 +360,7 @@ Parabola does not have wget. This is sinister. Install it:
Locale:
# vi /etc/locale.gen
+
Uncomment your needed localisations. For example en\_GB.UTF-8 (UTF-8 is
highly recommended over other options).
@@ -364,6 +371,7 @@ highly recommended over other options).
Console font and keymap:
# vi /etc/vconsole.conf
+
In my case:
KEYMAP=dvorak-uk
@@ -372,6 +380,7 @@ In my case:
Time zone:
# ln -s /usr/share/zoneinfo/Europe/London /etc/localtime
+
(Replace Zone and Subzone to your liking. See /usr/share/zoneinfo)
Hardware clock:
@@ -382,6 +391,7 @@ Hostname: Write your hostname to /etc/hostname. For example, if your
hostname is parabola:
# echo parabola > /etc/hostname
+
Add the same hostname to /etc/hosts:
# vi /etc/hosts
@@ -400,6 +410,7 @@ Mkinitcpio: Configure /etc/mkinitcpio.conf as needed (see
information about each hook.) Specifically, for this use case:
# vi /etc/mkinitcpio.conf
+
Then modify the file like so:
- MODULES="i915"
@@ -426,9 +437,11 @@ with (this is different from Arch, specifying linux-libre instead of
linux):
# mkinitcpio -p linux-libre
+
Also do it for linux-libre-lts:
# mkinitcpio -p linux-libre-lts
+
Also do it for linux-libre-grsec:
# mkinitcpio -p linux-libre-grsec
@@ -438,9 +451,11 @@ default for its password hashing. I referred to
<https://wiki.archlinux.org/index.php/SHA_password_hashes>.
# vi /etc/pam.d/passwd
+
Add rounds=65536 at the end of the uncommented 'password' line.
# passwd root
+
Make sure to set a secure password! Also, it must never be the same as
your LUKS password.
@@ -466,6 +481,7 @@ To unlock a user manually (if a password attempt is failed 3 times),
do:
# pam\_tally --user *theusername* --reset What the above
+
configuration does is lock the user out for 10 minutes, if they make 3
failed login attempts.
@@ -495,6 +511,7 @@ Lock the encrypted partition (close it):
# cryptsetup luksClose lvm
# shutdown -h now
+
Remove the installation media, then boot up again.
Booting from GRUB
@@ -546,6 +563,7 @@ current firmware - where *libreboot.rom* is an example: make sure to
adapt:
# flashrom -p internal -r libreboot.rom
+
If flashrom complains about multiple flash chips detected, add a *-c*
option at the end, with the name of your chosen chip is quotes.\
You can check if everything is in there (*grub.cfg* and *grubtest.cfg*
@@ -594,17 +612,20 @@ from the ROM image:
and insert the modified grubtest.cfg:
# ./cbfstool libreboot.rom add -n grubtest.cfg -f grubtest.cfg -t
+
raw
Now refer to [../install/#flashrom](../install/#flashrom). Cd (up) to
the libreboot\_util directory and update the flash chip contents:
# ./flash update libreboot.rom
+
Ocassionally, coreboot changes the name of a given board. If flashrom
complains about a board mismatch, but you are sure that you chose the
correct ROM image, then run this alternative command:
# ./flash forceupdate libreboot.rom
+
You should see "Verifying flash\... VERIFIED." written at the end of
the flashrom output.
@@ -633,6 +654,7 @@ Inside libreboot\_util/cbfstool/{armv7l i686 x86\_64}, we can do this
with the following command:
# sed -e 's:(cbfsdisk)/grub.cfg:(cbfsdisk)/grubtest.cfg:g' -e
+
's:Switch to grub.cfg:Switch to grubtest.cfg:g' < grubtest.cfg >
grub.cfg
@@ -649,6 +671,7 @@ Now you have a modified ROM. Once more, refer to
directory and update the flash chip contents:
# ./flash update libreboot.rom
+
And wait for the "Verifying flash\... VERIFIED." Once you have done
that, shut down and then boot up with your new configuration.
@@ -676,20 +699,24 @@ putting a keyfile inside initramfs would be a bad idea).\
Boot up and login as root or your user. Then generate the key file:
# dd bs=512 count=4 if=/dev/urandom of=/etc/mykeyfile
+
iflag=fullblock
Insert it into the luks volume:
# cryptsetup luksAddKey /dev/sdX /etc/mykeyfile
+
and enter your LUKS passphrase when prompted. Add the keyfile to the
initramfs by adding it to FILES in /etc/mkinitcpio.conf. For example:
# FILES="/etc/mykeyfile"
+
Create the initramfs image from scratch:
# mkinitcpio -p linux-libre
# mkinitcpio -p linux-libre-lts
# mkinitcpio -p linux-libre-grsec
+
Add the following to your grub.cfg - you are now able to do that, see
above! -, or add it in the kernel command line for GRUB:
diff --git a/docs/gnulinux/grub_cbfs.md b/docs/gnulinux/grub_cbfs.md
index 8d10c478..09e2c288 100644
--- a/docs/gnulinux/grub_cbfs.md
+++ b/docs/gnulinux/grub_cbfs.md
@@ -109,6 +109,7 @@ your current firmware, using flashrom:
$ sudo flashrom -p internal -r libreboot.rom
# flashrom -p internal -r libreboot.rom
+
If you are told to specify the chip, add the option **-c {your chip}**
to the command, for example:
@@ -158,6 +159,7 @@ Ocassionally, coreboot changes the name of a given board. If flashrom
complains about a board mismatch, but you are sure that you chose the
correct ROM image, then run this alternative command:
# ./flash forceupdate libreboot.rom
+
You should see **"Verifying flash\... VERIFIED."** written at the end
of the flashrom output. Once you have done that, shut down and then boot
up with your new test configuration.**
@@ -183,6 +185,7 @@ case you ever want to follow this guide again in the future (modifying
the already modified config). From /libreboot\_util/cbfstool, do:
# sed -e 's:(cbfsdisk)/grub.cfg:(cbfsdisk)/grubtest.cfg:g' -e
+
's:Switch to grub.cfg:Switch to grubtest.cfg:g' < grubtest.cfg >
grub.cfg
diff --git a/docs/hardware/gm45_remove_me.md b/docs/hardware/gm45_remove_me.md
index e083990a..d230c2a5 100644
--- a/docs/hardware/gm45_remove_me.md
+++ b/docs/hardware/gm45_remove_me.md
@@ -91,16 +91,19 @@ descriptor+gbe file into the ROM image.\
For 16MiB flash chips:
# dd if=ich9fdgbe\_16m.bin of=libreboot.rom bs=1 count=12k
+
conv=notrunc
For 8MiB flash chips:
# dd if=ich9fdgbe\_8m.bin of=libreboot.rom bs=1 count=12k
+
conv=notrunc
For 4MiB flash chips:
# dd if=ich9fdgbe\_4m.bin of=libreboot.rom bs=1 count=12k
+
conv=notrunc
Your libreboot.rom image is now ready to be flashed on the system. Refer
@@ -204,6 +207,7 @@ Assuming that your libreboot image is named **libreboot.rom**, copy the
and then run:
# dd if=deblobbed\_descriptor.bin of=libreboot.rom bs=1 count=12k
+
conv=notrunc
Alternatively, if you got a the **deblobbed\_4kdescriptor.bin** file (no
@@ -248,6 +252,7 @@ Insert that into a factory.rom image (NOTE: do this on a copy of it.
Keep the original factory.rom stored safely somewhere):
# dd if=demefactory\_4kdescriptor.bin of=factory\_nome.rom bs=1
+
count=4k conv=notrunc
TODO: test this.\
diff --git a/docs/hardware/x200.md b/docs/hardware/x200.md
index 492083c0..8afbe504 100644
--- a/docs/hardware/x200.md
+++ b/docs/hardware/x200.md
@@ -231,6 +231,7 @@ pehjota started collecting some steppings for different CPUs on several
X200 laptops. You can get the CPUID by running:
# dmesg | sed -n 's/\^.\* microcode: CPU0
+
sig=0x\\(\[\^,\]\*\\),.\*\$/\\1/p'
What pehjota wrote: The laptops that have issues resuming from suspend,
diff --git a/docs/install/bbb_setup.md b/docs/install/bbb_setup.md
index 6f2bc07d..7c55319e 100644
--- a/docs/install/bbb_setup.md
+++ b/docs/install/bbb_setup.md
@@ -150,6 +150,7 @@ Alternatives to SSH (in case SSH fails)
You can also use a serial FTDI debug board with GNU Screen, to access
the serial console.
# screen /dev/ttyUSB0 115200
+
Here are some example photos:\
![](images/x200/ftdi.jpg) ![](images/x200/ftdi_port.jpg)\
@@ -202,6 +203,7 @@ before continuing.
Check that the firmware exists:
# ls /lib/firmware/BB-SPI0-01-00A0.\*
+
Output:
/lib/firmware/BB-SPI0-01-00A0.dtbo
@@ -210,6 +212,7 @@ Then:
# echo BB-SPI0-01 > /sys/devices/bone\_capemgr.\*/slots
# cat /sys/devices/bone\_capemgr.\*/slots
+
Output:
0: 54:PF---
@@ -223,6 +226,7 @@ Output:
Verify that the spidev device now exists:
# ls -al /dev/spid\*
+
Output:
crw-rw---T 1 root spi 153, 0 Nov 19 21:07 /dev/spidev1.0
@@ -247,6 +251,7 @@ your BBB.
Now test flashrom:
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512
+
Output:
Calibrating delay loop... OK.
diff --git a/docs/install/c201.md b/docs/install/c201.md
index 3e924614..b8edc211 100644
--- a/docs/install/c201.md
+++ b/docs/install/c201.md
@@ -124,12 +124,14 @@ device (e.g. using the *root* account). In addition, the
The SPI flash has to be read first:
# flashrom -p host -r flash.img\
+
**Note: it might be a good idea to copy the produced flash.img file at
this point and store it outside of the device for backup purposes.**
Then, the **cros-flash-replace** script has to be executed as such:
# ./cros-flash-replace flash.img coreboot ro-frid
+
If any error is shown, it is definitely a bad idea to go further than
this point.
@@ -173,12 +175,14 @@ host (e.g. using the *root* account). In addition, the
The SPI flash has to be read first (using the right spi programmer):
# flashrom -p *programmer* -r flash.img
+
**Note: it might be a good idea to copy the produced flash.img file at
this point and store it outside of the device for backup purposes.**
Then, the **cros-flash-replace** script has to be executed as such:
# ./cros-flash-replace flash.img coreboot ro-frid
+
If any error is shown, it is definitely a bad idea to go further than
this point.
diff --git a/docs/install/index.md b/docs/install/index.md
index 7e2161b7..6a947da6 100644
--- a/docs/install/index.md
+++ b/docs/install/index.md
@@ -332,6 +332,7 @@ When you have booted up again, you must also do this:
If flashing fails at this stage, try the following:
# sudo ./flashrom/i686/flashrom -p
+
internal:laptop=force\_I\_want\_a\_brick -w [yourrom.rom](#rom)
You should see within the output the following:\
diff --git a/docs/install/r400_external.md b/docs/install/r400_external.md
index b4429e56..7c87b08d 100644
--- a/docs/install/r400_external.md
+++ b/docs/install/r400_external.md
@@ -215,6 +215,7 @@ Log in as root on your BBB, using the instructions in
Test that flashrom works:
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512\
+
In this case, the output was:
flashrom v0.9.7-r1854 on Linux 3.8.13-bone47 (armv7l)
@@ -230,12 +231,15 @@ How to backup factory.rom (change the -c option as neeed, for your flash
chip):
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
+
factory.rom
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
+
factory1.rom
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
+
factory2.rom
Note: the **-c** option is not required in libreboot's patched
@@ -244,6 +248,7 @@ have been removed.\
Now compare the 3 images:
# sha512sum factory\*.rom
+
If the hashes match, then just copy one of them (the factory.rom) to a
safe place (on a drive connected to another system, not the BBB). This
is useful for reverse engineering work, if there is a desirable
@@ -260,6 +265,7 @@ address to one that is correct for your system.**
Now flash it:
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -w
+
path/to/libreboot/rom/image.rom -V
![](images/x200/disassembly/0015.jpg)
diff --git a/docs/install/t400_external.md b/docs/install/t400_external.md
index 8dc2204a..bb3a93e2 100644
--- a/docs/install/t400_external.md
+++ b/docs/install/t400_external.md
@@ -213,6 +213,7 @@ Log in as root on your BBB, using the instructions in
Test that flashrom works:
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512
+
In this case, the output was:
flashrom v0.9.7-r1854 on Linux 3.8.13-bone47 (armv7l)
@@ -228,12 +229,15 @@ How to backup factory.rom (change the -c option as neeed, for your flash
chip):
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
+
factory.rom
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
+
factory1.rom
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
+
factory2.rom
Note: the **-c** option is not required in libreboot's patched
@@ -242,6 +246,7 @@ have been removed.\
Now compare the 3 images:
# sha512sum factory\*.rom
+
If the hashes match, then just copy one of them (the factory.rom) to a
safe place (on a drive connected to another system, not the BBB). This
is useful for reverse engineering work, if there is a desirable
@@ -258,6 +263,7 @@ address to one that is correct for your system.**
Now flash it:
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -w
+
path/to/libreboot/rom/image.rom -V
![](images/x200/disassembly/0015.jpg)
diff --git a/docs/install/t500_external.md b/docs/install/t500_external.md
index 56021fe0..05f418c8 100644
--- a/docs/install/t500_external.md
+++ b/docs/install/t500_external.md
@@ -230,6 +230,7 @@ Log in as root on your BBB, using the instructions in
Test that flashrom works:
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512
+
In this case, the output was:
flashrom v0.9.7-r1854 on Linux 3.8.13-bone47 (armv7l)
@@ -245,12 +246,15 @@ How to backup factory.rom (change the -c option as neeed, for your flash
chip):
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
+
factory.rom
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
+
factory1.rom
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -r
+
factory2.rom
Note: the **-c** option is not required in libreboot's patched
@@ -259,6 +263,7 @@ have been removed.\
Now compare the 3 images:
# sha512sum factory\*.rom
+
If the hashes match, then just copy one of them (the factory.rom) to a
safe place (on a drive connected to another system, not the BBB). This
is useful for reverse engineering work, if there is a desirable
@@ -275,6 +280,7 @@ address to one that is correct for your system.**
Now flash it:
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -w
+
path/to/libreboot/rom/image.rom -V
![](images/x200/disassembly/0015.jpg)
diff --git a/docs/install/t60_unbrick.md b/docs/install/t60_unbrick.md
index d2d59f42..9fd49bbf 100644
--- a/docs/install/t60_unbrick.md
+++ b/docs/install/t60_unbrick.md
@@ -144,6 +144,7 @@ source code which can be built.
SSH'd into the BBB:
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -w
+
yourrom.rom
It should be **Verifying flash\... VERIFIED** at the end. If flashrom
diff --git a/docs/install/x60_unbrick.md b/docs/install/x60_unbrick.md
index 24b4cb63..2493e56a 100644
--- a/docs/install/x60_unbrick.md
+++ b/docs/install/x60_unbrick.md
@@ -129,6 +129,7 @@ source code which can be built.
SSH'd into the BBB:
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -w
+
yourrom.rom
It should be **Verifying flash\... VERIFIED** at the end. If flashrom
diff --git a/docs/install/x60tablet_unbrick.md b/docs/install/x60tablet_unbrick.md
index d02a8ae6..f18e3629 100644
--- a/docs/install/x60tablet_unbrick.md
+++ b/docs/install/x60tablet_unbrick.md
@@ -108,6 +108,7 @@ source code which can be built.
SSH'd into the BBB:
# ./flashrom -p linux\_spi:dev=/dev/spidev1.0,spispeed=512 -w
+
yourrom.rom
It should be **Verifying flash\... VERIFIED** at the end. If flashrom