source: general/sysutils/modemmanager.xml@ be46d3d

elogind
Last change on this file since be46d3d was be46d3d, checked in by DJ Lucas <dj@…>, 5 years ago

Missing autoreconf command as well.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/BOOK-elogind@21132 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 8.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 ModemManager-download-http "https://www.freedesktop.org/software/ModemManager/ModemManager-&ModemManager-version;.tar.xz">
8 <!ENTITY ModemManager-download-ftp " ">
9 <!ENTITY ModemManager-md5sum "92d25176d0cc9d588ca29700b33c7d98">
10 <!ENTITY ModemManager-size "2.1 MB">
11 <!ENTITY ModemManager-buildsize "130 MB (with tests)">
12 <!ENTITY ModemManager-time "1.0 SBU (with tests)">
13]>
14
15<sect1 id="ModemManager" xreflabel="ModemManager-&ModemManager-version;">
16 <?dbhtml filename="ModemManager.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>ModemManager-&ModemManager-version;</title>
24
25 <indexterm zone="ModemManager">
26 <primary sortas="a-ModemManager">ModemManager</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to ModemManager</title>
31
32 <para>
33 <application>ModemManager</application> provides a unified high level
34 API for communicating with mobile broadband modems, regardless of the
35 protocol used to communicate with the actual device.
36 </para>
37
38 &lfs83_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&ModemManager-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&ModemManager-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &ModemManager-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &ModemManager-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &ModemManager-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &ModemManager-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3" revision="sysv">Additional Downloads</bridgehead>
75 <itemizedlist spacing="compact" revision="sysv">
76 <listitem revision="sysv">
77 <para>
78 Required patch:
79 <ulink url="&patch-root;/ModemManager-&ModemManager-version;-elogind-1.patch"/>
80 </para>
81 </listitem>
82 </itemizedlist>
83
84 <bridgehead renderas="sect3">ModemManager Dependencies</bridgehead>
85
86 <bridgehead renderas="sect4">Required</bridgehead>
87 <para role="required">
88 <xref linkend="libgudev"/>
89 </para>
90
91 <bridgehead renderas="sect4">Recommended</bridgehead>
92 <para role="recommended">
93 <phrase revision="sysv"><xref linkend="elogind"/>,</phrase>
94 <xref linkend="gobject-introspection"/>,
95 <xref linkend="libmbim"/>,
96 <xref linkend="libqmi"/>,
97 <xref linkend="polkit"/>, and
98 <xref linkend="vala"/>
99 </para>
100
101 <bridgehead renderas="sect4">Optional</bridgehead>
102 <para role="optional">
103 <xref linkend="gtk-doc"/>
104 </para>
105
106 <para condition="html" role="usernotes">User Notes:
107 <ulink url="&blfs-wiki;/ModemManager"/>
108 </para>
109 </sect2>
110
111 <sect2 role="installation">
112 <title>Installation of ModemManager</title>
113
114 <para revision="sysv">
115 Apply a patch to correct elogind detection:
116 </para>
117
118<screen revision="sysv"><userinput>patch -Np1 -i ../ModemManager-&ModemManager-version;-elogind-1.patch &amp;&amp;
119autoreconf -fi</userinput></screen>
120
121 <para>
122 Install <application>ModemManager</application> by running the following
123 commands:
124 </para>
125
126<screen revision="sysv"><userinput>./configure --prefix=/usr \
127 --sysconfdir=/etc \
128 --localstatedir=/var \
129 --disable-static \
130 --enable-more-warnings=no \
131 --with-elogind-suspend-resume=yes &amp;&amp;
132make</userinput></screen>
133
134<screen revision="systemd"><userinput>./configure --prefix=/usr \
135 --sysconfdir=/etc \
136 --localstatedir=/var \
137 --enable-more-warnings=no \
138 --with-systemd-journal \
139 --with-systemd-suspend-resume \
140 --disable-static &amp;&amp;
141make</userinput></screen>
142
143 <para>
144 To test the results, issue: <command>make check</command>.
145 </para>
146
147 <para>
148 Now, as the <systemitem class="username">root</systemitem> user:
149 </para>
150
151<screen role="root"><userinput>make install</userinput></screen>
152
153 </sect2>
154
155 <sect2 role="commands">
156
157 <title>Command Explanations</title>
158
159 <para revision="sysv">
160 <parameter>--with-elogind-suspend-resume=yes</parameter>: This switch
161 forces <application>ModmeManager</application> to use the
162 <application>elogind</application> power management facilities.
163 </para>
164
165 <para revision="systemd">
166 <parameter>--with-systemd-suspend-resume</parameter>: This
167 switch forces <application>ModemManager</application> to use the
168 <application>systemd</application> power management facilities.
169 </para>
170
171 <para revision="systemd">
172 <parameter>--with-systemd-journal</parameter>: This switch forces
173 <application>ModemManager</application> to use the systemd journal for
174 logging.
175 </para>
176
177 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
178 href="../../xincludes/static-libraries.xml"/>
179
180 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
181 href="../../xincludes/gtk-doc-rebuild.xml"/>
182
183 </sect2>
184 <sect2 role="configuration" revision="systemd">
185 <title>Configuring ModemManager</title>
186
187 <sect3 id="ModemManager-init">
188 <title>Systemd Units</title>
189
190 <para>
191 To start the <command>ModemManager</command> daemon at boot, enable
192 the previously installed systemd unit by running the following command
193 as the <systemitem class="username">root</systemitem> user:
194 </para>
195
196 <indexterm zone="ModemManager ModemManager-init">
197 <primary sortas="f-ModemManager">ModemManager</primary>
198 </indexterm>
199
200<screen role="root"><userinput>systemctl enable ModemManager</userinput></screen>
201
202 </sect3>
203
204 </sect2>
205
206 <sect2 role="content">
207 <title>Contents</title>
208
209 <segmentedlist>
210 <segtitle>Installed Programs</segtitle>
211 <segtitle>Installed Libraries</segtitle>
212 <segtitle>Installed Directories</segtitle>
213
214 <seglistitem>
215 <seg>
216 mmcli and ModemManager
217 </seg>
218 <seg>
219 libmm-glib.so
220 </seg>
221 <seg>
222 /usr/include/libmm-glib,
223 /usr/include/ModemManager,
224 /usr/lib/ModemManager,
225 /usr/share/gtk-doc/html/libmm-glib, and
226 /usr/share/gtk-doc/html/ModemManager
227 </seg>
228 </seglistitem>
229 </segmentedlist>
230
231 <variablelist>
232 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
233 <?dbfo list-presentation="list"?>
234 <?dbhtml list-presentation="table"?>
235
236 <varlistentry id="mmcli">
237 <term><command>mmcli</command></term>
238 <listitem>
239 <para>
240 is an utility used to control and monitor the
241 <application>ModemManager</application>.
242 </para>
243 <indexterm zone="ModemManager mmcli">
244 <primary sortas="b-mmcli">mmcli</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="ModemManager-prog">
250 <term><command>ModemManager</command></term>
251 <listitem>
252 <para>
253 is a <application>D-Bus</application> service used
254 to communicate with modems.
255 </para>
256 <indexterm zone="ModemManager ModemManager-prog">
257 <primary sortas="b-ModemManager">ModemManager</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>
261
262 <varlistentry id="libmm-glib">
263 <term><filename class="libraryfile">libmm-glib.so</filename></term>
264 <listitem>
265 <para>
266 contains API functions for communicating with mobile broadband
267 modems, regardless of the protocol used to communicate with
268 the actual device.
269 </para>
270 <indexterm zone="ModemManager libmm-glib">
271 <primary sortas="c-libmm-glib">libmm-glib.so</primary>
272 </indexterm>
273 </listitem>
274 </varlistentry>
275
276 </variablelist>
277
278 </sect2>
279
280</sect1>
Note: See TracBrowser for help on using the repository browser.