README 3.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293
  1. _
  2. __| | _____ _____ _ _ ___
  3. / _` |/ _ \ \ / / __| | | / __|
  4. | (_| | __/\ V /\__ \ |_| \__ \
  5. \__,_|\___| \_/ |___/\__,_|___/
  6. Overview
  7. ========
  8. Devsus is a script that builds bootable, libre Devuan (http://www.devuan.org/)
  9. images for the Asus C201 Chromebook, one of the few laptops able to boot and run
  10. without any non-free software, all the way down to the firmware level. The C201
  11. is supported by Libreboot (http://www.libreboot.org/).
  12. The images produced by Devsus contain the latest Chrome OS kernel, deblobbed
  13. using the Linux-libre (http://linux-libre.fsfla.org/) scripts and tuned for
  14. smaller size, better performance and shorter boot times.
  15. In addition, the images contain the latest firmware for the freedom-friendly,
  16. Atheros AR9271 based WiFi dongles.
  17. Moreover, the Devuan installation is very minimal and consists of a barebones
  18. Devuan base, plus crucial command-line tools, like those required to connect to
  19. a WiFi network.
  20. Dependencies
  21. ============
  22. Devsus has been tested on Devuan 7 (Jessie) on x86_64, with the following
  23. packages installed:
  24. apt install --no-install-recommends --no-install-suggests \
  25. parted cgpt \
  26. git gawk device-tree-compiler vboot-kernel-utils gcc-arm-none-eabi \
  27. gcc make libc-dev wget g++ cmake \
  28. u-boot-tools binfmt-support qemu-user-static debootstrap
  29. Building
  30. ========
  31. # ./devsus
  32. This produces two Devuan disk images:
  33. 1) devuan-jessie-c201-libre-16GB.img, a 16 GB image suitable for persistent
  34. installation; its size should be exactly the size of the internal SSD
  35. 2) devuan-jessie-c201-libre-2GB.img, a 2 GB image suitable for booting the
  36. laptop off USB
  37. Usage
  38. =====
  39. To produce a bootable media, write the 2 GB image to a flash drive (of at least
  40. 2 GB):
  41. # dd if=$SOMEWHERE/devuan-jessie-c201-libre-2GB.img of=/dev/$DEVICE bs=50M
  42. The root password is blank.
  43. The 2 GB image (yes, the smaller one) contains the larger, 16 GB one under /.
  44. This way, it is possible to boot the laptop through USB, then install Devuan
  45. persistently without having to download or store the large image separately.
  46. Persistent installation is performed using dd, too:
  47. # dd if=/devuan-jessie-c201-libre-16GB.img of=/dev/mmcblk0 bs=50M
  48. Modifications
  49. =============
  50. The images produced by Devsus are very close to stock Devuan:
  51. - Many redundant drivers were removed from the kernel
  52. - Several responsiveness or performance vs. power consumption kernel
  53. configuration choices have been changed
  54. - APT has been configured not to install "recommended" packages by default
  55. - Some critical (like udev) or useful (like iw) packages have been added
  56. - unscd has been added, to cache DNS
  57. - The number of virtual consoles has been reduced from 6 to 2
  58. Credits and Legal Information
  59. =============================
  60. Devsus' kernel building procedure is based on the linux-veyron package of Arch
  61. Linux ARM (http://www.archlinuxarm.org/).
  62. Devsus is free and unencumbered software released under the terms of the GNU
  63. General Public License, version 2; see COPYING for the license text. For a list
  64. of its authors and contributors, see AUTHORS.
  65. The ASCII art logo at the top was made using FIGlet (http://www.figlet.org/).