source: general/sysutils/modemmanager.xml@ c176fc7

11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since c176fc7 was c176fc7, checked in by Bruce Dubbs <bdubbs@…>, 8 months ago

Package updates.
Update to bind9-9.16.21.
Update to pipewire-0.3.36.
Update to ModemManager-1.18.2.
Update to sudo-1.9.8p1.
Update to acpid-2.0.33.

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