NetBSD Problem Report #46149

From www@NetBSD.org  Tue Mar  6 20:33:15 2012
Return-Path: <www@NetBSD.org>
Received: from mail.netbsd.org (mail.netbsd.org [149.20.53.66])
	by www.NetBSD.org (Postfix) with ESMTP id 7BF5E63E2C5
	for <gnats-bugs@gnats.NetBSD.org>; Tue,  6 Mar 2012 20:33:15 +0000 (UTC)
Message-Id: <20120306203314.8C03063BF7D@www.NetBSD.org>
Date: Tue,  6 Mar 2012 20:33:14 +0000 (UTC)
From: emmanuel@libera.cc
Reply-To: emmanuel@libera.cc
To: gnats-bugs@NetBSD.org
Subject: Multiboot man page does not mention how to boot with Grub2 ( patch included )
X-Send-Pr-Version: www-1.0

>Number:         46149
>Category:       kern
>Synopsis:       Multiboot man page does not mention how to boot with Grub2 ( patch included )
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    kern-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Mar 06 20:35:02 +0000 2012
>Originator:     Emmanuel Kasper
>Release:        5.1.2
>Organization:
My Org
>Environment:
NetBSD franz.libera.cc 5.1.2 NetBSD 5.1.2 (KVM) #1: Sat Feb 11 15:05:52 CET 2012  manu@leonard:/home/manu/Projects/netbsd/src/sys/arch/i386/compile/obj/KVM i386

>Description:
NetBSD multiboot man page does not mention how to use the GRUB2 bootloader, which the most popular multiboot boot loader by now. Only GRUB legacy is mentioned.
This issue has been discussed in the following thread:
http://mail-index.netbsd.org/tech-kern/2011/09/13/msg011481.html
>How-To-Repeat:
man multiboot
>Fix:
Index: multiboot.8
===================================================================
RCS file: /cvsroot/src/share/man/man8/man8.i386/multiboot.8,v
retrieving revision 1.3
diff -u -r1.3 multiboot.8
--- multiboot.8	30 Apr 2008 13:10:57 -0000	1.3
+++ multiboot.8	6 Mar 2012 20:12:14 -0000
@@ -45,9 +45,7 @@
 .Cd options MULTIBOOT
 (the default in the
 .Sq GENERIC
-and
-.Sq GENERIC_LAPTOP
-configurations).
+configuration).
 .Pp
 Unlike when using the native boot loader, the
 .Nx
@@ -95,14 +93,29 @@
 .Sq root=wd0e .
 .El
 .Ss Booting with GRUB Legacy
-GRUB Legacy is the most popular bootloader that supports Multiboot.
 You can boot a
 .Nx
-kernel (assuming it is compiled with Multiboot support) with a line
+kernel with a line
 similar to the following one:
 .Bd -literal
 kernel (fd0)/netbsd.gz -c console=pc root=wd0e
 .Ed
+.Ss Booting with GRUB 2
+You can boot a
+.Nx
+kernel with the 
+following commands from the GRUB 2 prompt:
+.Bd -literal
+insmod ufs2
+set root=(hd0,msdos1)
+multiboot /netbsd
+.Ed
+.Pp
+Note that the kernel assumes the behavior of GRUB Legacy and drops the
+first argument. In order to pass extra arguments you should write:
+.Bd -literal
+multiboot /netbsd /netbsd console=pc root=wd0e
+.Ed
 .Sh SEE ALSO
 .Xr options 4
 .Sh HISTORY

Home	PR Database Search