source: general/sysutils/modemmanager.xml@ 64b3927

10.0 10.1 11.0 11.1 11.2 9.0 9.1 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 64b3927 was 64b3927, checked in by Douglas R. Reno <renodr@…>, 3 years ago

Update to ModemManager-1.10.2

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21701 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 ModemManager-download-http "https://www.freedesktop.org/software/ModemManager/ModemManager-&ModemManager-version;.tar.xz">
8 <!ENTITY ModemManager-download-ftp " ">
9 <!ENTITY ModemManager-md5sum "dad80b3b4f27c1d6eae7e019542338be">
10 <!ENTITY ModemManager-size "2.0 MB">
11 <!ENTITY ModemManager-buildsize "133 MB (with tests)">
12 <!ENTITY ModemManager-time "1.1 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 &lfs84_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">ModemManager Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Required</bridgehead>
77 <para role="required">
78 <xref linkend="libgudev"/>
79 </para>
80
81 <bridgehead renderas="sect4">Recommended</bridgehead>
82 <para role="recommended">
83 <xref linkend="gobject-introspection"/>,
84 <xref linkend="libmbim"/>,
85 <xref linkend="libqmi"/>,
86 <xref linkend="polkit"/>, and
87 <xref linkend="vala"/>
88 </para>
89
90 <bridgehead renderas="sect4">Optional</bridgehead>
91 <para role="optional">
92 <xref linkend="gtk-doc"/>
93 </para>
94
95 <para condition="html" role="usernotes">User Notes:
96 <ulink url="&blfs-wiki;/ModemManager"/>
97 </para>
98 </sect2>
99
100 <sect2 role="installation">
101 <title>Installation of ModemManager</title>
102
103 <para>
104 Install <application>ModemManager</application> by running the following
105 commands:
106 </para>
107
108<screen revision="sysv"><userinput>./configure --prefix=/usr \
109 --sysconfdir=/etc \
110 --localstatedir=/var \
111 --enable-more-warnings=no \
112 --disable-static &amp;&amp;
113make</userinput></screen>
114
115<screen revision="systemd"><userinput>./configure --prefix=/usr \
116 --sysconfdir=/etc \
117 --localstatedir=/var \
118 --enable-more-warnings=no \
119 --with-systemd-journal \
120 --with-systemd-suspend-resume \
121 --disable-static &amp;&amp;
122make</userinput></screen>
123
124 <para>
125 To test the results, issue: <command>make check</command>.
126 </para>
127
128 <para>
129 Now, as the <systemitem class="username">root</systemitem> user:
130 </para>
131
132<screen role="root"><userinput>make install</userinput></screen>
133
134 </sect2>
135
136 <sect2 role="commands">
137
138 <title>Command Explanations</title>
139
140 <para revision="systemd">
141 <parameter>--with-systemd-suspend-resume</parameter>: This
142 switch forces <application>ModemManager</application> to use the systemd
143 power management facilities.
144 </para>
145
146 <para revision="systemd">
147 <parameter>--with-systemd-journal</parameter>: This switch forces
148 <application>ModemManager</application> to use the systemd journal for
149 logging.
150 </para>
151
152 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
153 href="../../xincludes/static-libraries.xml"/>
154
155 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
156 href="../../xincludes/gtk-doc-rebuild.xml"/>
157
158 </sect2>
159 <sect2 role="configuration" revision="systemd">
160 <title>Configuring ModemManager</title>
161
162 <sect3 id="ModemManager-init">
163 <title>Systemd Units</title>
164
165 <para>
166 To start the <command>ModemManager</command> daemon at boot, enable
167 the previously installed systemd unit by running the following command
168 as the <systemitem class="username">root</systemitem> user:
169 </para>
170
171 <indexterm zone="ModemManager ModemManager-init">
172 <primary sortas="f-ModemManager">ModemManager</primary>
173 </indexterm>
174
175<screen role="root"><userinput>systemctl enable ModemManager</userinput></screen>
176
177 </sect3>
178
179 </sect2>
180
181 <sect2 role="content">
182 <title>Contents</title>
183
184 <segmentedlist>
185 <segtitle>Installed Programs</segtitle>
186 <segtitle>Installed Libraries</segtitle>
187 <segtitle>Installed Directories</segtitle>
188
189 <seglistitem>
190 <seg>
191 mmcli and ModemManager
192 </seg>
193 <seg>
194 libmm-glib.so
195 </seg>
196 <seg>
197 /usr/include/libmm-glib,
198 /usr/include/ModemManager,
199 /usr/lib/ModemManager,
200 /usr/share/ModemManager,
201 /usr/share/gtk-doc/html/libmm-glib, and
202 /usr/share/gtk-doc/html/ModemManager
203 </seg>
204 </seglistitem>
205 </segmentedlist>
206
207 <variablelist>
208 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
209 <?dbfo list-presentation="list"?>
210 <?dbhtml list-presentation="table"?>
211
212 <varlistentry id="mmcli">
213 <term><command>mmcli</command></term>
214 <listitem>
215 <para>
216 is an utility used to control and monitor the
217 <application>ModemManager</application>.
218 </para>
219 <indexterm zone="ModemManager mmcli">
220 <primary sortas="b-mmcli">mmcli</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225 <varlistentry id="ModemManager-prog">
226 <term><command>ModemManager</command></term>
227 <listitem>
228 <para>
229 is a <application>D-Bus</application> service used
230 to communicate with modems.
231 </para>
232 <indexterm zone="ModemManager ModemManager-prog">
233 <primary sortas="b-ModemManager">ModemManager</primary>
234 </indexterm>
235 </listitem>
236 </varlistentry>
237
238 <varlistentry id="libmm-glib">
239 <term><filename class="libraryfile">libmm-glib.so</filename></term>
240 <listitem>
241 <para>
242 contains API functions for communicating with mobile broadband
243 modems, regardless of the protocol used to communicate with
244 the actual device.
245 </para>
246 <indexterm zone="ModemManager libmm-glib">
247 <primary sortas="c-libmm-glib">libmm-glib.so</primary>
248 </indexterm>
249 </listitem>
250 </varlistentry>
251
252 </variablelist>
253
254 </sect2>
255
256</sect1>
Note: See TracBrowser for help on using the repository browser.