1
0

README 5.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192
  1. LSB-Bootscripts README
  2. The scripts contained in this directory are a complete rewrite of the
  3. boot scripts from LFS-6.1. As is usually the case with a rewrite, there have
  4. been many changes:
  5. LSB Version 4.1 Compliant Scripts - Immediately noticable are the LSB headers
  6. in the rc.d scripts themselves. Each script contains a usable header to
  7. allow for automating both the installation of, and determining proper
  8. execution order for the startup scripts. These values can also be used
  9. directly in parallel boot setups. Additionally, messages are displayed in
  10. one single write to the screen, after exit status is determined, so that
  11. they can be used in parallel setups. I am not sure if this was the only
  12. barrier to auto language translation in the previous bootscripts. Further,
  13. the messages are created from parts and only written to the screen in a
  14. single command, so maybe no help at all WRT translated boot messages.
  15. AS OF 20080907, THESE SCRIPTS REQUIRE THE initd-tools PACKAGE.
  16. Dan Nicholson has recently released an initd-tools package that contain
  17. LSB compliant install_initd and remove_initd programs written in C.
  18. See the INSTALL file for installation instructions.
  19. Path changes - The base directory for the bootscripts is now /etc. This is
  20. mostly to conform with mainstream distros. Of course, this is still
  21. configurable in /etc/default/rc.site. The rcsysinit.d directory has been
  22. removed and and replaced with the shorter rcS.d. /etc/sysconfig has been
  23. removed in favor of /etc/default. The network service scripts have been moved
  24. to /lib/network-services and the the network configuration files to
  25. /etc/network. Values for short, and relatively static, configuration files
  26. (clock and network) have been included in the rc.site file directly.
  27. Distribution Independent - this original goal for the LFS scripts has been
  28. stretched even further by providing both a global rc config file that
  29. contains (generally) static values, and a new rc.site config file to allow
  30. customization of messages as diplayed to the end user during the boot
  31. process. The format of messages printed to the screen is adjustable
  32. here. Other options that were available in the previous versions of the
  33. lfs-bootscripts, and additional options such as message format and color, are
  34. configurable by the /etc/sysconfig/rc.site file.
  35. Single Environment - The rc script has been rewritten completely to allow a
  36. single source of the boot configuration per runlevel change. This config
  37. is inherited from rc's environment as opposed to being sourced everytime a
  38. script is run. This does result in a negledgable decrease in boot time, but
  39. is simply better in principle.
  40. Boot Logging - The previous incarnation of the boot log didn't begin
  41. recording events until the root filesystem was mounted read/write. This has
  42. been corrected by providing the /run tempfs mount immediately after init hands
  43. control to the rc script. The bootlog is generated on the tempfs and then
  44. passed to the log file before login. Additionally, shutdown events are no
  45. longer recorded in the bootlog. They were pretty much useless and it really
  46. wasn't what I'd call a *boot* log. Boot logging is on by default and is
  47. configurable in the /etc/default/rc.site file via the "BOOTLOG_ENAB" parameter.
  48. Interactive Boot - This feature has been included by default, and is a
  49. little more polished than in previous versions. It does introduce a two
  50. second delay in the boot process (so that you have time to press a button
  51. to select interactive mode). This time value, and the option prompt itself,
  52. is configurable in the /etc/default/rc.site file via the "itime" and "iprompt"
  53. variables respectively.
  54. LSB Functions - The previous lfs-bootscripts sourced a functions file
  55. located at /etc/rc.d/init.d/functions. This file has been renamed
  56. $distro-functions to segregate it from the old. The name is configurable
  57. by the rc.site configuration file ("DISTRO_MINI"). LSB defined functions are
  58. used where possible througout the individual scripts, but the $distro-functions
  59. file provides, easy to use wraper functions that start, stop, reload,
  60. force-reload, and restart programs, evaluate the numerical LSB return values,
  61. and print status messages to the screen and boot log. Both distro functions and
  62. LSB functions are documented directly in the scritps located at
  63. /etc/init.d/$distro-functions and /lib/lsb/init-functions respectively.
  64. Pretier - By default, successful boot messages are prefixed with a single green
  65. astrik character, warning messages with two yellow astirks, and failures are
  66. prefixed with three red astriks. This provides a second 'quick glance' status
  67. when watching the boot messages fly by. Again, the prefixes are configurable
  68. (or completely removable) in the /etc/default/rc.site file.
  69. Complete Rewrite - That doesn't mean that code wasn't reused when possible,
  70. so to Alexander Patrakov, Archiac, Bruce Dubbs, Bryan Kadzban, Dan Nicholson,
  71. Gerard Beekmans, Jeremy Huntwork, Jim Gifford, Mathias Benkmans, Matthew
  72. Burgess, Nathan Coulson, and countless other contributors: Thanks for the help
  73. and guidance.
  74. Please report any bugs to lfs-dev@linuxfromscratch.org.
  75. Thanks.
  76. -- DJ Lucas
  77. dj@linuxfromscratch.org