README 2.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283
  1. #######################################
  2. # #
  3. # KERNEL-KIT #
  4. # #
  5. #######################################
  6. version 0.3
  7. gpl2 or later at your discretion, see /usr/share/doc/legal
  8. THIS KIT COMES WITH ABSOLUTELY NO WARRANTY, USE ENTIRELY AT OWN RISK
  9. NO RESPONSIBILITY ACCEPTED. YOU HAVE BEEN WARNED
  10. ABOUT
  11. -----
  12. This kit is designed to make it easy to compile a kernel for Puppy Linux.
  13. The packages produced are compatible with Woof/Woof2 and now FatDog.
  14. See Barry's Blog .. bkhome.org/blog or woof-CE
  15. This kit assumes you are comfortable with shell scripts and command line usage.
  16. DEPENDENCIES
  17. ------------
  18. This kit is designed for Puppy Linux. A late model build is
  19. recommended, such as Wary, Racy, Slacko, Precise, Dpup-Exprimo, FatDog64
  20. Be aware that for best results you should compile in a host
  21. distro which is compatible with the target distro.
  22. REQUIRED:
  23. gcc - for compilation
  24. git - for aufs sources
  25. mksquashfs - for compressing the kernel source sfs, will build without
  26. CREDIT
  27. ------
  28. Much credit has to go to BarryK, for inventing Puppy Linux,
  29. Iguleder, the original designer of this kit, pemasu for input and bugfixes,
  30. jamesbond for fatdog stuff and various testers on the Murga-Linux/puppy forum
  31. USAGE
  32. -----
  33. First, edit the build.conf file for your preferences
  34. You will certainly need to change the $kernel_version variable
  35. You can put in a custom mirror.
  36. It is recommended to use a $custom_suffix and $package_name_suffix
  37. There are custom kernel DOTconfigs in configs_extra directory.
  38. Move one to the top level and rename it to "DOTconfig" if you wish (YMMV).
  39. There is a default DOTconfig but it may not suit you.
  40. You can also add your own.
  41. Second, run "./build.sh"
  42. The kernel source will download, aufs will be downloaded from git
  43. The patches will be applied automatically and halt the script if
  44. there are failures.
  45. The script will pause once all patches are applied so you
  46. can configure the kernel.
  47. You can use:
  48. 1) make menuconfig (ncurses based)
  49. 2) make gconfig (gtk based)
  50. 3) make xconfig (qt based, depends on nokia qt libraries)
  51. Save it when done and continue.
  52. Kernel headers are created, kernel compiles (takes a long time), kernel
  53. source sfs is created, kernel pet package is NOT created BUT the
  54. correct directory structure is in place at dist/packages/linux_kernel*
  55. to make a pet easily. Same with headers.
  56. New options in the build.conf file include an option to build a FatDog64
  57. style kernel package and choice of squash fs compression. Also number of
  58. jobs is supported - use with caution. Read comments in build.conf.
  59. The kit can be cleaned with "./build.sh clean" which deletes everything except
  60. for configs. Please manually check before obliterating your work!
  61. Have fun!
  62. -------------------------------------------------------------------------------
  63. 01micko @ http://www.murga-linux.com/puppy Puppy Linux forum
  64. TODO: fully support ARM arch