[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

Graham Perrin  changed:

   What|Removed |Added

   See Also||https://bugs.freebsd.org/bu
   ||gzilla/show_bug.cgi?id=2295
   ||95

-- 
You are receiving this mail because:
You are on the CC list for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

Graham Perrin  changed:

   What|Removed |Added

 CC||0...@freebsd.org
 Attachment #245269||maintainer-approval?(0mp@Fr
  Flags||eeBSD.org)

--- Comment #18 from Graham Perrin  ---
Created attachment 245269
  --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=245269&action=edit
signed-off .patch

-- 
You are receiving this mail because:
You are on the CC list for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

Graham Perrin  changed:

   What|Removed |Added

 Attachment #245266|0   |1
is obsolete||

--- Comment #17 from Graham Perrin  ---
Created attachment 245268
  --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=245268&action=edit
An updated screenshot of proposed changes

For the first note box in the window to the left: 

* instead of a two-sentence paragraph, two paragraphs. 

(The earlier edition avoided separate paragraphs only because spacing is
slightly peculiar.)


In the window to the right: 

* the section heading is expanded to include ESPs

* a paragraph about mirroring and the like (for example, both disks should have 
  equally capable ESPs).

-- 
You are receiving this mail because:
You are on the CC list for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

--- Comment #16 from Graham Perrin  ---
Created attachment 245266
  --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=245266&action=edit
A screenshot of proposed changes

Re: comment 15

> …
> 
> a) … a warning, for readers to know that attention to an ESP might be 
> essential
> 
> * two warning boxes plus a note box might be overwhelming, …

I opted for three note boxes, as shown in the window to the left. 

(What's now the second box was previously a warning.)


> b) … expanded, at least
> 
> * paraphrase the instruction to _stop_ using gpart(8) for ESP partitions
> 
> * refer directly to the EXAMPLES section of loader.efi(8)

Shown in the window to the right. 

First mentions of gpart(8) and loader.efi(8) are links to the manual pages. 

Second mentions – adjacent, and nearly adjacent – are intentionally not links.


> * hint that if multiple ESPs exist, attention to more than one may be 
>   appropriate (mirrored disks, for example).

I'll add this locally, then attach the .patch file in Bugzilla.

-- 
You are receiving this mail because:
You are on the CC list for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

Graham Perrin  changed:

   What|Removed |Added

   Keywords|needs-patch |

-- 
You are receiving this mail because:
You are on the CC list for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

Graham Perrin  changed:

   What|Removed |Added

 CC|grahamper...@gmail.com  |d...@freebsd.org
   Severity|Affects Some People |Affects Many People
   Assignee|d...@freebsd.org |grahamper...@gmail.com
   Keywords||loader

--- Comment #15 from Graham Perrin  ---
(In reply to Graham Perrin from comment #13)

Alternatives to the MarkMail URL: 





(In reply to commit-hook from comment #10)

>>…
>>Currently, the section does not explain when or why bootcode has to be
>>updated. It just references some related manual pages.
>>…

That is, ;
and (from base 9ecf6e0f9f25) the example in loader.efi(8) is good:

(thanks again, 0mp).



^Triage: with stable/12 end of life and 14.0-RELEASE both approaching, I
reckon: 

a)

 should gain a warning, for readers to know that attention to an ESP might be
essential

* two warning boxes plus a note box might be overwhelming, as a trio, so this
  ESP-related warning must be concise

* refer to the 'Updating Bootcode' section of the chapter

b)

should be expanded, at least

* paraphrase the instruction to _stop_ using gpart(8) for ESP partitions

* refer directly to the EXAMPLES section of loader.efi(8)

* hint that if multiple ESPs exist, attention to more than one may be 
  appropriate (mirrored disks, for example).




! There is no stop note for 13.2, and upgrades from 12.⋯ to 13.2-RELEASE
  are expected (not all departures from 12.⋯ will go to 14.⋯), so 
  let's document this ASAP.

-- 
You are receiving this mail because:
You are the assignee for the bug.
You are on the CC list for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

Graham Perrin  changed:

   What|Removed |Added

   See Also||https://bugs.freebsd.org/bu
   ||gzilla/show_bug.cgi?id=2627
   ||70

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

Graham Perrin ◐  changed:

   What|Removed |Added

 CC||grahamper...@gmail.com

--- Comment #14 from Graham Perrin ◐  ---
(In reply to Graham Perrin from comment #12)

> … (Some users will find the ESP mounted by default.)

Probably _not_ true. I might have misunderstood part of a commit message.

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

Graham Perrin  changed:

   What|Removed |Added

   See Also||https://bugs.freebsd.org/bu
   ||gzilla/show_bug.cgi?id=2709
   ||36

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

Graham Perrin  changed:

   What|Removed |Added

   See Also||https://bugs.freebsd.org/bu
   ||gzilla/show_bug.cgi?id=2633
   ||22

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

Graham Perrin  changed:

   What|Removed |Added

   Severity|Affects Only Me |Affects Some People
   Keywords||uefi

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

Graham Perrin  changed:

   What|Removed |Added

 CC||grahamper...@freebsd.org

--- Comment #13 from Graham Perrin  ---
(In reply to Graham Perrin from comment #11)

> … It will be good to exemplify at least:
> 
> /EFI/BOOT/BOOTX64.EFI
> 
> – or (lowercase, maybe preferred): 
> 
> /efi/boot/bootx64.efi


 imp@ enlightens: 

>>> …
>>>
>>> … amd64 … (/boot/efi/efi/freebsd/loader.efi) …
>>
>> Side note: please, why the FreeBSD reserved area?
> 
> When you create a boot variable using efibootmgr, it's better to 
> specify something that's not the default binary. It's what Windows, 
> Linux, etc do when they are installed and it facilitates better 
> multiboot when the target OSes depend on the first stage efi boot 
> loader (like FreeBSD and Windows certainly do).
> 
> Warner

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

--- Comment #12 from Graham Perrin  ---
(In reply to Graham Perrin from comment #11)

> … (lowercase, maybe preferred): …

Sorry, I forgot to add an example. 

>From last year's 
(consistent with what I was taught, long ago): 

> … ESP partitions should be mounted as MS-DOS filesystems as 
> /boot/efi, and /boot/loader.efi should be copied to 
> /boot/efi/efi/boot/bootx64.efi if the default setup is used. …


(Some users will find the ESP mounted by default.)

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

--- Comment #11 from Graham Perrin  ---
(In reply to commit-hook from comment #10)

Thanks. 

Can we add links to the following? 

uefi(8)


UEFI - FreeBSD Wiki




loader.efi(8) is somewhat vague, compared to uefi(8) (and neither page mentions
the other; see also bug 265834). 

It will be good to exemplify at least:

/EFI/BOOT/BOOTX64.EFI

– or (lowercase, maybe preferred): 

/efi/boot/bootx64.efi

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

Mateusz Piotrowski <0...@freebsd.org> changed:

   What|Removed |Added

   Assignee|0...@freebsd.org |d...@freebsd.org

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

Mateusz Piotrowski <0...@freebsd.org> changed:

   What|Removed |Added

   Assignee|d...@freebsd.org |0...@freebsd.org
 Status|New |Open

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

--- Comment #9 from Graham Perrin  ---
Also: bug 229191

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

--- Comment #8 from Graham Perrin  ---
A moderated how-to: 

Update of the bootcodes for a GPT scheme | The FreeBSD Forums


-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

--- Comment #7 from Graham Perrin  ---
See also: bug 258987

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

PauAmma  changed:

   What|Removed |Added

 CC|paua...@gundo.com   |

--- Comment #6 from PauAmma  ---
Uncc'ing myself to avoid duplicate emails.

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

bsduck  changed:

   What|Removed |Added

 CC||bsd...@mailo.com

--- Comment #5 from bsduck  ---
A section mentioning the need to update the bootloader is definitely missing in
Chapter 24 "Updating and Upgrading FreeBSD". There's currently no mention of
it, but a system upgrade isn't complete without this step, and the upgraded
system may encounter problems with an out of date bootloader (happened to me
after upgrading from 12.2 to 13.0).

-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

Graham Perrin  changed:

   What|Removed |Added

 CC||paua...@gundo.com

--- Comment #4 from Graham Perrin  ---
(In reply to Michael Gmelin from comment #3)

Last month's
 and
the response suggest improvements to: 

intro(8)


>  intro -- introduction to system maintenance procedures and commands


In particular, from the first and second e-mails: 

> - whichever ZFS command(s) control mounting at boot

> efibootmgr(8)



-- 
You are receiving this mail because:
You are the assignee for the bug.

[Bug 255318] handbook: Document how to update the bootloader

[bugzilla-noreply]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=255318

Bug ID: 255318
   Summary: handbook: Document how to update the bootloader
   Product: Documentation
   Version: Latest
  Hardware: Any
OS: Any
Status: New
  Keywords: needs-patch
  Severity: Affects Only Me
  Priority: ---
 Component: Documentation
  Assignee: d...@freebsd.org
  Reporter: 0...@freebsd.org

-- 
You are receiving this mail because:
You are the assignee for the bug.
___
freebsd-doc@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"