source: general/genlib/umockdev.xml@ 5d5c2107

10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 5d5c2107 was 5d5c2107, checked in by Douglas R. Reno <renodr@…>, 14 months ago

Update to umockdev-0.14.3
Update to bind/bind-utils 9.16.3
Update to tracker-2.3.5
Update to tracker-miners-2.3.4
update to telepathy-mission-control-5.16.6
Update to libwacom-1.5
Update to grilo-0.3.13
Update to libgdata-0.17.13
Update to cifs-utils-6.11

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

  • Property mode set to 100644
File size: 6.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 umockdev-download-http "https://github.com/martinpitt/umockdev/releases/download/&umockdev-version;/umockdev-&umockdev-version;.tar.xz">
8 <!ENTITY umockdev-download-ftp " ">
9 <!ENTITY umockdev-md5sum "44fd2ad44c2a7468b44b3a2c91153c61">
10 <!ENTITY umockdev-size "748 KB">
11 <!ENTITY umockdev-buildsize "13 MB (with tests)">
12 <!ENTITY umockdev-time "0.3 SBU (with tests)">
13
14]>
15
16<sect1 id="umockdev" xreflabel="umockdev-&umockdev-version;">
17 <?dbhtml filename="umockdev.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>Umockdev-&umockdev-version;</title>
25
26 <indexterm zone="umockdev">
27 <primary sortas="a-umockdev">umockdev</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Umockdev</title>
32
33 <para>
34 The <application>Umockdev</application> package contains a framework
35 that allows a developer to mock devices for use in unit testing.
36 </para>
37
38 &lfs10_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&umockdev-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&umockdev-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &umockdev-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &umockdev-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &umockdev-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &umockdev-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">Umockdev Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Required</bridgehead>
77 <para role="required">
78 <xref linkend="libgudev"/> and
79 <xref linkend="vala"/>
80 </para>
81
82 <bridgehead renderas="sect4">Optional</bridgehead>
83 <para role="optional">
84 <ulink url="http://www.gphoto.org/">libgphoto2</ulink> (optional for tests)
85 </para>
86
87 <para condition="html" role="usernotes">
88 User Notes: <ulink url="&blfs-wiki;/umockdev"/>
89 </para>
90 </sect2>
91
92 <sect2 role="installation">
93 <title>Installation of Umockdev</title>
94
95 <para>
96 Install <application>Umockdev</application> by running the following
97 commands:
98 </para>
99
100<screen><userinput>./configure --prefix=/usr \
101 --disable-static \
102 --docdir=/usr/share/doc/umockdev-&umockdev-version;&amp;&amp;
103make</userinput></screen>
104
105 <para>
106 To test the results, issue: <command>PATH=$PATH:/sbin:/usr/sbin make
107 check</command>. The addition to <envar>PATH</envar> is needed if you
108 use the starting scripts in <xref linkend="postlfs-config-profile"/>,
109 because some tests need to run <command>udevadm</command>.
110 </para>
111
112 <para>
113 Now, as the <systemitem class="username">root</systemitem> user:
114 </para>
115
116<screen role="root"><userinput>make install</userinput></screen>
117 </sect2>
118
119 <sect2 role="commands">
120 <title>Command Explanations</title>
121
122 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
123 href="../../xincludes/static-libraries.xml"/>
124
125 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
126 href="../../xincludes/gtk-doc-rebuild.xml"/>
127
128 </sect2>
129
130 <sect2 role="content">
131 <title>Contents</title>
132
133 <segmentedlist>
134 <segtitle>Installed Programs</segtitle>
135 <segtitle>Installed Libraries</segtitle>
136 <segtitle>Installed Directories</segtitle>
137
138 <seglistitem>
139 <seg>
140 umockdev-record,
141 umockdev-run, and
142 umockdev-wrapper
143 </seg>
144 <seg>
145 libumockdev-preload.so.0 <!-- Only intended for use by
146 umockdev-wrapper. Don't put in a short description for this--> and
147 libumockdev.so
148 </seg>
149 <seg>
150 /usr/include/umockdev-1.0 and
151 /usr/share/doc/umockdev-&umockdev-version;
152 </seg>
153 </seglistitem>
154 </segmentedlist>
155
156 <variablelist>
157 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
158 <?dbfo list-presentation="list"?>
159 <?dbhtml list-presentation="table"?>
160
161 <varlistentry id="umockdev-record">
162 <term><command>umockdev-record</command></term>
163 <listitem>
164 <para>
165 records Linux devices and their ancestors from sysfs/udev or
166 records ioctls for a device.
167 </para>
168 <indexterm zone="umockdev umockdev-record">
169 <primary sortas="b-umockdev-record">umockdev-record</primary>
170 </indexterm>
171 </listitem>
172 </varlistentry>
173
174 <varlistentry id="umockdev-run">
175 <term><command>umockdev-run</command></term>
176 <listitem>
177 <para>
178 runs a program under an <application>umockdev</application>
179 testbed.
180 </para>
181 <indexterm zone="umockdev umockdev-run">
182 <primary sortas="b-umockdev-run">umockdev-run</primary>
183 </indexterm>
184 </listitem>
185 </varlistentry>
186
187 <varlistentry id="umockdev-wrapper">
188 <term><command>umockdev-wrapper</command></term>
189 <listitem>
190 <para>
191 wraps a program around
192 <filename class="libraryfile">libumockdev-preload.so.0</filename>
193 through LD_PRELOAD.
194 </para>
195 <indexterm zone="umockdev umockdev-wrapper">
196 <primary sortas="b-umockdev-wrapper">umockdev-wrapper</primary>
197 </indexterm>
198 </listitem>
199 </varlistentry>
200
201 <varlistentry id="libumockdev">
202 <term><filename class="libraryfile">libumockdev.so</filename></term>
203 <listitem>
204 <para>
205 provides API functions that allow mocking hardware devices for unit
206 testing.
207 </para>
208 <indexterm zone="umockdev libumockdev">
209 <primary sortas="c-libumockdev">libumockdev.so</primary>
210 </indexterm>
211 </listitem>
212 </varlistentry>
213 </variablelist>
214 </sect2>
215</sect1>
Note: See TracBrowser for help on using the repository browser.