source: postlfs/filesystems/uefi-bootloaders/efivar.xml

trunk
Last change on this file was f1a7af6, checked in by Xi Ruoyao <xry111@…>, 5 months ago

tag grub-efi and dependencies

  • Property mode set to 100644
File size: 5.4 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../../general.ent">
5 %general-entities;
6
7 <!ENTITY efivar-download-http "https://github.com/rhboot/efivar/releases/download/&efivar-version;/efivar-&efivar-version;.tar.bz2">
8 <!ENTITY efivar-download-ftp " ">
9 <!ENTITY efivar-md5sum "9f067275c5f7aafdd75bfb364280ac9c">
10 <!ENTITY efivar-size "108 KB">
11 <!ENTITY efivar-buildsize "2.75 MB">
12 <!ENTITY efivar-time "less than 0.1 SBU">
13]>
14
15<sect1 id="efivar" xreflabel="efivar-&efivar-version;">
16 <?dbhtml filename="efivar.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>efivar-&efivar-version;</title>
23
24 <indexterm zone="efivar">
25 <primary sortas="a-efivar">efivar</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to efivar</title>
30
31 <para>
32 The <application>efivar</application> package provides tools and
33 libraries to manipulate EFI variables.
34 </para>
35
36 &lfs110a_checked;
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>
42 Download (HTTP): <ulink url="&efivar-download-http;"/>
43 </para>
44 </listitem>
45 <listitem>
46 <para>
47 Download (FTP): <ulink url="&efivar-download-ftp;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download MD5 sum: &efivar-md5sum;
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download size: &efivar-size;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Estimated disk space required: &efivar-buildsize;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated build time: &efivar-time;
68 </para>
69 </listitem>
70 </itemizedlist>
71
72 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
73 <itemizedlist spacing="compact">
74 <listitem>
75 <para>
76 Required patch:
77 <ulink url="&patch-root;/efivar-&efivar-version;-gcc_9-1.patch"/>
78 </para>
79 </listitem>
80 </itemizedlist>
81
82 <para condition="html" role="usernotes">User Notes:
83 <ulink url="&blfs-wiki;/efivar"/></para>
84
85 </sect2>
86
87 <sect2 role="installation">
88 <title>Installation of efivar</title>
89
90 <para>
91 First, apply a patch to fix an issue building with GCC 9 or later:
92 </para>
93
94<screen><userinput>patch -Np1 -i ../efivar-37-gcc_9-1.patch</userinput></screen>
95
96 <para>
97 Build <application>efivar</application> with the following commands:
98 </para>
99
100<screen><userinput>make CFLAGS="-O2 -Wno-stringop-truncation"</userinput></screen>
101
102 <para>
103 The test suite of this package is dangerous. Running it may trigger
104 firmware bugs and make your system unusable without using some special
105 hardware to reprogram the firmware.
106 </para>
107
108 <para>
109 Now, as the <systemitem class="username">root</systemitem> user:
110 </para>
111
112<screen role="root"><userinput>make install LIBDIR=/usr/lib</userinput></screen>
113
114 </sect2>
115
116 <sect2 role="commands">
117 <title>Command Explanations</title>
118
119 <para>
120 <parameter>CFLAGS="-O2 -Wno-stringop-truncation"</parameter>:
121 This option overrides the default compiler flags to avoid a build failure.
122 </para>
123
124 <para>
125 <parameter>LIBDIR=/usr/lib</parameter>:
126 This option overrides the default library directory of the package
127 (<filename class="directory">/usr/lib64</filename>, which is not used
128 by LFS.)
129 </para>
130
131 </sect2>
132
133 <sect2 role="content">
134 <title>Contents</title>
135
136 <segmentedlist>
137 <segtitle>Installed Programs</segtitle>
138 <segtitle>Installed Libraries</segtitle>
139 <segtitle>Installed Directories</segtitle>
140
141 <seglistitem>
142 <seg>
143 efivar
144 </seg>
145 <seg>
146 libefiboot.so and libefivar.so
147 </seg>
148 <seg>
149 /usr/include/efivar
150 </seg>
151 </seglistitem>
152 </segmentedlist>
153
154 <variablelist>
155 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
156 <?dbfo list-presentation="list"?>
157 <?dbhtml list-presentation="table"?>
158
159 <varlistentry id="efivar-prog">
160 <term><command>efivar</command></term>
161 <listitem>
162 <para>
163 is a tool to manipulate UEFI variables
164 </para>
165 <indexterm zone="efivar efivar-prog">
166 <primary sortas="b-efivar">efivar</primary>
167 </indexterm>
168 </listitem>
169 </varlistentry>
170
171 <varlistentry id="libefiboot">
172 <term><filename class="libraryfile">libefiboot.so</filename></term>
173 <listitem>
174 <para>
175 is a library used by <command>efibootmgr</command>
176 </para>
177 <indexterm zone="efivar libefiboot">
178 <primary sortas="c-libefiboot">libefiboot.so</primary>
179 </indexterm>
180 </listitem>
181 </varlistentry>
182
183 <varlistentry id="libefivar">
184 <term><filename class="libraryfile">libefivar.so</filename></term>
185 <listitem>
186 <para>
187 is a library for the manipulation of EFI variables
188 </para>
189 <indexterm zone="efivar libefiboot">
190 <primary sortas="c-libefiboot">libefiboot.so</primary>
191 </indexterm>
192 </listitem>
193 </varlistentry>
194
195 </variablelist>
196
197 </sect2>
198
199</sect1>
Note: See TracBrowser for help on using the repository browser.