Skip to content

Commit

Permalink
'README.adoc': refine wording, fix usage
Browse files Browse the repository at this point in the history
  • Loading branch information
s-n-ushakov committed May 11, 2020
1 parent e568329 commit 7a15746
Showing 1 changed file with 9 additions and 8 deletions.
17 changes: 9 additions & 8 deletions README.adoc
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# rename-efi-entry

[.lead]
A Bash script to rename EFI boot entries
A Bash script to rename EFI boot entries

## Background

Expand All @@ -10,15 +10,16 @@ A Bash script to rename EFI boot entries
EFI{nbsp}/ https://uefi.org/[UEFI] is a specification that defines a software interface between an operating system and
platform firmware. It is intended by hardware manufacturers to replace the legacy BIOS firmware interface.

In particular this specification allows to define OS boot configurations to be executed upon system power on. These boot
configurations specify disk partitions to boot from and are typically identified by their text labels that are listed in
"Startup"{nbsp}/ "Boot" EFI setup section. These boot configurations may be optionally selectable upon system startup.
In particular this specification allows to define OS boot configurations to be loaded{nbsp}/ executed upon system power
on. These boot configurations specify disk partitions to boot from and are typically identified by their text labels
that are listed in the "Startup"{nbsp}/ "Boot" EFI setup section. These boot configurations may be optionally selectable
upon system startup.

### The problem

Operating system installation routines tend to have these boot configuration entry labels hard-coded and to create
them in EFI PROM automatically. So in case a computer has, say, several Ubuntu instances installed, it is also likely to
have several identical "ubuntu" boot configuration labels in its EFI menus, causing a kind of confusion.
Operating system installation routines tend to have these boot configuration labels hard-coded and to create them in EFI
PROM automatically. So in case a computer has, say, several Ubuntu instances installed, it is also likely to have
several identical "ubuntu" boot configuration labels in its EFI menus, causing a kind of confusion.

One might further want to rename boot configurations, so to make them distinguishable, but unfortunately the standard
https://github.com/rhboot/efibootmgr[`efibootmgr`] utility has no option for that. It is only possible to delete a boot
Expand All @@ -33,7 +34,7 @@ arguments for `efibootmgr`.

### Usage

sudo ./rename-efi-entry existing_efi_label new_efi_label [bootnum]
sudo ./rename-efi-entry.bash existing_efi_label new_efi_label [bootnum]

[%autowidth,cols=2*.<]
.Command line arguments
Expand Down

0 comments on commit 7a15746

Please sign in to comment.