diff options
| -rw-r--r-- | documentation/ref-manual/ref-variables.xml | 54 |
1 files changed, 0 insertions, 54 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index b49fb2535b..6470c739c2 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml | |||
| @@ -3621,60 +3621,6 @@ | |||
| 3621 | </glossdef> | 3621 | </glossdef> |
| 3622 | </glossentry> | 3622 | </glossentry> |
| 3623 | 3623 | ||
| 3624 | <glossentry id='var-DISK_SIGNATURE'><glossterm>DISK_SIGNATURE</glossterm> | ||
| 3625 | <info> | ||
| 3626 | DISK_SIGNATURE[doc] = "A 32-bit MBR disk signature used by directdisk images." | ||
| 3627 | </info> | ||
| 3628 | <glossdef> | ||
| 3629 | <para role="glossdeffirst"> | ||
| 3630 | <!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> | ||
| 3631 | A 32-bit MBR disk signature used by | ||
| 3632 | <filename>directdisk</filename> images. | ||
| 3633 | </para> | ||
| 3634 | |||
| 3635 | <para> | ||
| 3636 | By default, the signature is set to an automatically | ||
| 3637 | generated random value that allows the OpenEmbedded | ||
| 3638 | build system to create a boot loader. | ||
| 3639 | You can override the signature in the image recipe | ||
| 3640 | by setting <filename>DISK_SIGNATURE</filename> to an | ||
| 3641 | 8-digit hex string. | ||
| 3642 | You might want to override | ||
| 3643 | <filename>DISK_SIGNATURE</filename> if you want the disk | ||
| 3644 | signature to remain constant between image builds. | ||
| 3645 | </para> | ||
| 3646 | |||
| 3647 | <para> | ||
| 3648 | When using Linux 3.8 or later, you can use | ||
| 3649 | <filename>DISK_SIGNATURE</filename> to specify the root | ||
| 3650 | by UUID to allow the kernel to locate the root device | ||
| 3651 | even if the device name changes due to differences in | ||
| 3652 | hardware configuration. | ||
| 3653 | By default, <filename>ROOT_VM</filename> is set | ||
| 3654 | as follows: | ||
| 3655 | <literallayout class='monospaced'> | ||
| 3656 | ROOT_VM ?= "root=/dev/sda2" | ||
| 3657 | </literallayout> | ||
| 3658 | However, you can change this to locate the root device | ||
| 3659 | using the disk signature instead: | ||
| 3660 | <literallayout class='monospaced'> | ||
| 3661 | ROOT_VM = "root=PARTUUID=${DISK_SIGNATURE}-02" | ||
| 3662 | </literallayout> | ||
| 3663 | </para> | ||
| 3664 | |||
| 3665 | <para> | ||
| 3666 | As previously mentioned, it is possible to set the | ||
| 3667 | <filename>DISK_SIGNATURE</filename> variable in your | ||
| 3668 | <filename>local.conf</filename> file to a fixed | ||
| 3669 | value if you do not want <filename>syslinux.cfg</filename> | ||
| 3670 | changing for each build. | ||
| 3671 | You might find this useful when you want to upgrade the | ||
| 3672 | root filesystem on a device without having to recreate or | ||
| 3673 | modify the master boot record. | ||
| 3674 | </para> | ||
| 3675 | </glossdef> | ||
| 3676 | </glossentry> | ||
| 3677 | |||
| 3678 | <glossentry id='var-DISTRO'><glossterm>DISTRO</glossterm> | 3624 | <glossentry id='var-DISTRO'><glossterm>DISTRO</glossterm> |
| 3679 | <info> | 3625 | <info> |
| 3680 | DISTRO[doc] = "The short name of the distribution. If the variable is blank, meta/conf/distro/defaultsetup.conf will be used." | 3626 | DISTRO[doc] = "The short name of the distribution. If the variable is blank, meta/conf/distro/defaultsetup.conf will be used." |
