minix/commands/update_bootcfg/update_bootcfg.8

   1 .TH man 8 "14 July  2015" "2.0" "update_bootcfg  man page"
   2 .SH NAME
   3 update_bootcfg \- Update the configuration for the boot monitor
   4
   5 .SH SYNOPSIS
   6 update_bootcfg
   7
   8 .SH DESCRIPTION
   9 Updates /boot.cfg, the configuration file used by the MINIX boot monitor. The default values are stored in /etc/boot.cfg.default.
  10 /etc/boot.cfg.local stores any local modifications. These templates obey the syntax of boot.cfg(5). The /etc/boot.cfg.default template
  11 expects the system images to reside in the /boot/minix directory and that /boot/minix_latest points to last image, selected by the default= command. Besides the directory to which points /boot/minix_latest, all the directory entries within /boot/minix are expected to be alternative system releases, and are given additional menu= entries, with the basic parameters $rootdevname and $args. Template menu= entries for inexistant directories, or directories without kernel file, are skipped; the default= option is adjusted to point to the
  12 same relative menu entry.
  13
  14 Within the templates, some variables can be used and will be substituted by update_bootcfg at run time. They are preceded by the dollar
  15 sign. $rootdevname is replaced with the name of the device holding the (current) root file system; $args, which is intended to be at the
  16 end of the menu lines, is replaced by the system environement values.
  17
  18 Finally, the update_bootcfg command updates the root file system.
  19
  20 .SH EXAMPLES
  21 update_bootcfg
  22
  23 .SH FILES
  24 .TP
  25 .I /boot.cfg
  26 Location of the configuration file
  27 .TP
  28 .I /boot/minix/*
  29 Directories with the various releases
  30 .TP
  31 .I /boot/minix_default
  32 Directory with the base release of MINIX, installed at setup(8) time
  33 .TP
  34 .I /boot/minix_latest
  35 Symbolic link to the directory with the latest release, usually taken by default
  36 .TP
  37 .I /etc/boot.cfg.default
  38 Default template
  39 .TP
  40 .I /etc/boot.cfg.local
  41 Locally-defined additional boot commands
  42
  43 .SH BUGS
  44 The previous content of /boot.cfg is lost. Do not change that file directly!
  45 The presence of /boot/minix_latest as a menu= entry is not checked; it is assumed than one or several entries refer to it.
  46
  47 The naming conventions, particularly the use of default, are not consistent.
  48
  49 .SH SEE ALSO
  50 boot(8), boot.cfg(5), setup(8), sysenv(1)
  51
  52 .SH AUTHOR
  53 Manpage written by Jacob Adams <tookmund@gmail.com>.
  54 This manpage borrows liberally from Antoine Leca's manual page.