source: general/sysutils/pciutils.xml@ ac8c7d4

10.0 10.1 11.0 11.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since ac8c7d4 was ac8c7d4, checked in by DJ Lucas <dj@…>, 5 years ago

Use timers in systemd where appropriate, not crontab.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@19359 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 7.5 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 pciutils-download-http "&kernel-dl;/software/utils/pciutils/pciutils-&pciutils-version;.tar.xz">
8 <!ENTITY pciutils-download-ftp " ">
9 <!ENTITY pciutils-md5sum "238d9969cc0de8b9105d972007d9d546">
10 <!ENTITY pciutils-size "317 KB">
11 <!ENTITY pciutils-buildsize "3.6 MB">
12 <!ENTITY pciutils-time "less than 0.1 SBU">
13]>
14
15<sect1 id="pciutils" xreflabel="pciutils-&pciutils-version;">
16 <?dbhtml filename="pciutils.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>pciutils-&pciutils-version;</title>
24
25 <indexterm zone="pciutils">
26 <primary sortas="a-pciutils">pciutils</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to PCI Utils</title>
31
32 <para>
33 The <application>PCI Utils</application> package contains
34 a set of programs for listing PCI devices, inspecting
35 their status and setting their configuration registers.
36 </para>
37
38 &lfs81_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&pciutils-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&pciutils-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &pciutils-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &pciutils-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &pciutils-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &pciutils-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <para condition="html" role="usernotes">User Notes:
75 <ulink url="&blfs-wiki;/pciutils"/>
76 </para>
77 </sect2>
78
79 <sect2 role="installation">
80 <title>Installation of PCI Utils</title>
81
82 <para>
83 Install <application>PCI Utils</application> by
84 running the following commands:
85 </para>
86
87<screen><userinput>make PREFIX=/usr \
88 SHAREDIR=/usr/share/hwdata \
89 SHARED=yes</userinput></screen>
90
91 <para>
92 This package does not come with a test suite.
93 </para>
94
95 <para>
96 Now, as the <systemitem class="username">root</systemitem> user:
97 </para>
98
99<screen role="root"><userinput>make PREFIX=/usr \
100 SHAREDIR=/usr/share/hwdata \
101 SHARED=yes \
102 install install-lib &amp;&amp;
103
104chmod -v 755 /usr/lib/libpci.so</userinput></screen>
105
106 </sect2>
107
108 <sect2 role="commands">
109 <title>Command Explanations</title>
110
111 <para>
112 <parameter>SHARED=yes</parameter>: This parameter enables building of
113 the shared library instead of the static one.
114 </para>
115
116 <para>
117 <option>ZLIB=no</option>: This option prevents compression of
118 the <filename>pci.ids</filename> file.
119 </para>
120
121 </sect2>
122
123 <sect2 role="configuration">
124 <title>Configuring PCI Utils</title>
125
126 <para>
127 The <filename>pci.ids</filename> data file is constantly being
128 updated. To get a current version of this file, run
129 <command>update-pciids</command> as the <systemitem
130 class="username">root</systemitem> user. This program requires the
131 <xref linkend="which"/> script or program to find <xref linkend="curl"/>,
132 <xref linkend="lynx"/> or <xref linkend="wget"/> which are used to
133 download the most current file, and then replace the existing file in
134 <filename class="directory">/usr/share/hwdata</filename>.
135 </para>
136
137 <para revision="sysv">
138 You may wish to add an entry to
139 <systemitem class="username">root</systemitem>'s (or any other user who has
140 write privilege to <filename class="directory">/usr/share/hwdata</filename>)
141 crontab to automatically update the <filename>pci.ids</filename> file
142 periodically.
143 </para>
144
145 <para revision="systemd">
146 You should update the <filename>/usr/share/hwdata/pci.ids</filename> file
147 periodically. Execute the following commands, as the
148 <systemitem class="username">root</systemitem> user, to create a systemd
149 timer to update it weekly on Sundays at 3:00 A.M. (local time):
150 </para>
151
152<screen role="root" revision="systemd"><userinput>cat &gt; /lib/systemd/system/update-pciids.service &lt;&lt; "EOF" &amp;&amp;
153<literal>[Unit]
154Description=Update pci.ids file
155Documentation=man:update-pciids(8)
156DefaultDependencies=no
157After=local-fs.target
158Before=shutdown.target
159
160[Service]
161Type=oneshot
162RemainAfterExit=yes
163ExecStart=/usr/sbin/update-pciids</literal>
164EOF
165cat &gt; /lib/systemd/system/update-pciids.timer &lt;&lt; "EOF" &amp;&amp;
166<literal>[Unit]
167Description=Update pci.ids file weekly
168
169[Timer]
170OnCalendar=Sun 02:30:00
171Persistent=true
172
173[Install]
174WantedBy=timers.target</literal>
175EOF
176systemctl enable update-usbids.timer</userinput></screen>
177
178
179 </sect2>
180
181 <sect2 role="content">
182 <title>Contents</title>
183
184 <segmentedlist>
185 <segtitle>Installed Programs</segtitle>
186 <segtitle>Installed Library</segtitle>
187 <segtitle>Installed Directory</segtitle>
188
189 <seglistitem>
190 <seg>
191 lspci, setpci, and update-pciids
192 </seg>
193 <seg>
194 libpci.so
195 </seg>
196 <seg>
197 /usr/include/pci and /usr/share/hwdata
198 </seg>
199 </seglistitem>
200 </segmentedlist>
201
202 <variablelist>
203 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
204 <?dbfo list-presentation="list"?>
205 <?dbhtml list-presentation="table"?>
206
207 <varlistentry id="lspci">
208 <term><command>lspci</command></term>
209 <listitem>
210 <para>
211 is a utility for displaying information about all PCI buses
212 in the system and all devices connected to them.
213 </para>
214 <indexterm zone="pciutils lspci">
215 <primary sortas="b-lspci">lspci</primary>
216 </indexterm>
217 </listitem>
218 </varlistentry>
219
220 <varlistentry id="setpci">
221 <term><command>setpci</command></term>
222 <listitem>
223 <para>
224 is a utility for querying and configuring PCI devices.
225 </para>
226 <indexterm zone="pciutils setpci">
227 <primary sortas="b-setpci">setpci</primary>
228 </indexterm>
229 </listitem>
230 </varlistentry>
231
232 <varlistentry id="update-pciids">
233 <term><command>update-pciids</command></term>
234 <listitem>
235 <para>
236 fetches the current version of the PCI ID list. Requires
237 <xref linkend="curl"/>, <xref linkend="lynx"/> or
238 <xref linkend="wget"/>.
239 </para>
240 <indexterm zone="pciutils update-pciids">
241 <primary sortas="b-update-pciids">update-pciids</primary>
242 </indexterm>
243 </listitem>
244 </varlistentry>
245
246 <varlistentry id="libpci">
247 <term><filename class="libraryfile">libpci.so</filename></term>
248 <listitem>
249 <para>
250 is library that allows applications to access the PCI
251 subsystem.
252 </para>
253 <indexterm zone="pciutils libpci">
254 <primary sortas="c-libpci">libpci.so</primary>
255 </indexterm>
256 </listitem>
257 </varlistentry>
258
259 </variablelist>
260
261 </sect2>
262
263</sect1>
Note: See TracBrowser for help on using the repository browser.