source: general/sysutils/pciutils.xml@ 5ae3416

10.0 10.1 11.0 11.1 8.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 5ae3416 was 5ae3416, checked in by Ken Moffat <ken@…>, 5 years ago

Tags.

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

  • Property mode set to 100644
File size: 6.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>
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 </sect2>
146
147 <sect2 role="content">
148 <title>Contents</title>
149
150 <segmentedlist>
151 <segtitle>Installed Programs</segtitle>
152 <segtitle>Installed Library</segtitle>
153 <segtitle>Installed Directory</segtitle>
154
155 <seglistitem>
156 <seg>
157 lspci, setpci, and update-pciids
158 </seg>
159 <seg>
160 libpci.so
161 </seg>
162 <seg>
163 /usr/include/pci and /usr/share/hwdata
164 </seg>
165 </seglistitem>
166 </segmentedlist>
167
168 <variablelist>
169 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
170 <?dbfo list-presentation="list"?>
171 <?dbhtml list-presentation="table"?>
172
173 <varlistentry id="lspci">
174 <term><command>lspci</command></term>
175 <listitem>
176 <para>
177 is a utility for displaying information about all PCI buses
178 in the system and all devices connected to them.
179 </para>
180 <indexterm zone="pciutils lspci">
181 <primary sortas="b-lspci">lspci</primary>
182 </indexterm>
183 </listitem>
184 </varlistentry>
185
186 <varlistentry id="setpci">
187 <term><command>setpci</command></term>
188 <listitem>
189 <para>
190 is a utility for querying and configuring PCI devices.
191 </para>
192 <indexterm zone="pciutils setpci">
193 <primary sortas="b-setpci">setpci</primary>
194 </indexterm>
195 </listitem>
196 </varlistentry>
197
198 <varlistentry id="update-pciids">
199 <term><command>update-pciids</command></term>
200 <listitem>
201 <para>
202 fetches the current version of the PCI ID list. Requires
203 <xref linkend="curl"/>, <xref linkend="lynx"/> or
204 <xref linkend="wget"/>.
205 </para>
206 <indexterm zone="pciutils update-pciids">
207 <primary sortas="b-update-pciids">update-pciids</primary>
208 </indexterm>
209 </listitem>
210 </varlistentry>
211
212 <varlistentry id="libpci">
213 <term><filename class="libraryfile">libpci.so</filename></term>
214 <listitem>
215 <para>
216 is library that allows applications to access the PCI
217 subsystem.
218 </para>
219 <indexterm zone="pciutils libpci">
220 <primary sortas="c-libpci">libpci.so</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225 </variablelist>
226
227 </sect2>
228
229</sect1>
Note: See TracBrowser for help on using the repository browser.