xref: /illumos-gate/usr/src/man/man5/menu.lst.5 (revision 6312020e31ee7e61274dfa60b7bf2e0ec973f56a)
1*6312020eSToomas Soome.\"
2*6312020eSToomas Soome.\" This file and its contents are supplied under the terms of the
3*6312020eSToomas Soome.\" Common Development and Distribution License ("CDDL"), version 1.0.
4*6312020eSToomas Soome.\" You may only use this file in accordance with the terms of version
5*6312020eSToomas Soome.\" 1.0 of the CDDL.
6*6312020eSToomas Soome.\"
7*6312020eSToomas Soome.\" A full copy of the text of the CDDL should have accompanied this
8*6312020eSToomas Soome.\" source.  A copy of the CDDL is also available via the Internet at
9*6312020eSToomas Soome.\" http://www.illumos.org/license/CDDL.
10*6312020eSToomas Soome.\"
11*6312020eSToomas Soome.\"
12*6312020eSToomas Soome.\" Copyright 2023 Toomas Soome <tsoome@me.com>
13*6312020eSToomas Soome.\"
14*6312020eSToomas Soome.Dd March 30, 2023
15*6312020eSToomas Soome.Dt MENU.LST 5
16*6312020eSToomas Soome.Os
17*6312020eSToomas Soome.Sh NAME
18*6312020eSToomas Soome.Nm menu.lst
19*6312020eSToomas Soome.Nd List of entries for boot menu
20*6312020eSToomas Soome.Sh SYNOPSIS
21*6312020eSToomas Soome.Pa <pool>/boot/menu.lst
22*6312020eSToomas Soome.Pp
23*6312020eSToomas Soome.Pa /boot/menu.lst
24*6312020eSToomas Soome.Sh DESCRIPTION
25*6312020eSToomas SoomeThis file contains the list of menu entries for use by boot loader.
26*6312020eSToomas SoomeThe location is either root dataset of boot zfs pool or
27*6312020eSToomas Soome.Pa /boot
28*6312020eSToomas Soomedirectory of root file system.
29*6312020eSToomas Soome.Nm
30*6312020eSToomas Soomeis created automatically by
31*6312020eSToomas Soome.Xr beadm 8 ,
32*6312020eSToomas Soomeand can be managed by
33*6312020eSToomas Soome.Xr bootadm 8 .
34*6312020eSToomas Soome.Pp
35*6312020eSToomas SoomeEach menu entry in
36*6312020eSToomas Soome.Nm
37*6312020eSToomas Soomeconsists of two lines:
38*6312020eSToomas Soome.Pp
39*6312020eSToomas Soome.Dl Sy title Ar name
40*6312020eSToomas Soome.Dl Ar type Ar data
41*6312020eSToomas Soome.Pp
42*6312020eSToomas SoomeWhere first line will set name for the menu entry and second line
43*6312020eSToomas Soomewill declare the type and type specific data for boot menu entry.
44*6312020eSToomas Soome.Pp
45*6312020eSToomas SoomeCurrently accepted types are:
46*6312020eSToomas Soome.Bl -tag -width Ds
47*6312020eSToomas Soome.It Sy bootfs
48*6312020eSToomas Soometo specify the name or location of the boot file system.
49*6312020eSToomas Soome.It Sy chain
50*6312020eSToomas Soometo specify device or file to be used with
51*6312020eSToomas Soome.Xr loader 7
52*6312020eSToomas Soome.Sy chain
53*6312020eSToomas Soomecommand.
54*6312020eSToomas Soome.El
55*6312020eSToomas Soome.Pp
56*6312020eSToomas SoomeThe boot file system name could be either the name of zfs dataset or
57*6312020eSToomas Soomethe device name in case of
58*6312020eSToomas Soome.Xr ufs 4fs ,
59*6312020eSToomas Soome.Xr pcfs 4fs ,
60*6312020eSToomas Soomeor other currently supported disk based file system.
61*6312020eSToomas Soome.Pp
62*6312020eSToomas SoomeDevice name for
63*6312020eSToomas Soome.Sy chain
64*6312020eSToomas Soomecommand must use the form
65*6312020eSToomas Soome.Pp
66*6312020eSToomas Soome.Dl diskN[pX]: or diskN[sXpY]:
67*6312020eSToomas Soome.Dl zfs:pool/dataset:
68*6312020eSToomas Soome.Pp
69*6312020eSToomas SoomeSee output of loader
70*6312020eSToomas Soome.Cm lsdev Fl v
71*6312020eSToomas Soomecommand for available device names.
72*6312020eSToomas Soome.Sh FILES
73*6312020eSToomas Soome.Pa <pool>/boot/menu.lst
74*6312020eSToomas Soome.Pp
75*6312020eSToomas Soome.Pa /boot/menu.lst
76*6312020eSToomas Soome.Sh EXAMPLES
77*6312020eSToomas SoomeA sample
78*6312020eSToomas Soome.Nm
79*6312020eSToomas Soomefile.
80*6312020eSToomas Soome.Bd -literal -offset indent
81*6312020eSToomas Soometitle Disk1:
82*6312020eSToomas Soomechain disk1:
83*6312020eSToomas Soometitle Disk2_UFS
84*6312020eSToomas Soomebootfs disk2s1a:
85*6312020eSToomas Soometitle openindiana-2023:01:03
86*6312020eSToomas Soomebootfs rpool/ROOT/openindiana-2023:01:03
87*6312020eSToomas Soome.Ed
88*6312020eSToomas Soome.Sh SEE ALSO
89*6312020eSToomas Soome.Xr pcfs 4fs ,
90*6312020eSToomas Soome.Xr ufs 4fs ,
91*6312020eSToomas Soome.Xr loader 7 ,
92*6312020eSToomas Soome.Xr beadm 8 ,
93*6312020eSToomas Soome.Xr bootadm 8
94