summary refs log tree commit diff
path: root/docs/libnm/html/NMSettingGsm.html
diff options
context:
space:
mode:
Diffstat (limited to 'docs/libnm/html/NMSettingGsm.html')
-rw-r--r--docs/libnm/html/NMSettingGsm.html75
1 files changed, 32 insertions, 43 deletions
diff --git a/docs/libnm/html/NMSettingGsm.html b/docs/libnm/html/NMSettingGsm.html
index 2da1fa2e..bee69df6 100644
--- a/docs/libnm/html/NMSettingGsm.html
+++ b/docs/libnm/html/NMSettingGsm.html
@@ -2,13 +2,13 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>libnm Reference Manual: NMSettingGsm</title>
+<title>NMSettingGsm: libnm Reference Manual</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="libnm Reference Manual">
 <link rel="up" href="ch03.html" title="Connection and Setting API Reference">
 <link rel="prev" href="NMSettingGeneric.html" title="NMSettingGeneric">
 <link rel="next" href="NMSettingInfiniband.html" title="NMSettingInfiniband">
-<meta name="generator" content="GTK-Doc V1.21 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.24 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -255,7 +255,6 @@ nm_setting_gsm_new (<em class="parameter"><code><span class="type">void</span></
 <div class="refsect3">
 <a name="id-1.4.15.8.2.5"></a><h4>Returns</h4>
 <p> the new empty <a class="link" href="NMSettingGsm.html" title="NMSettingGsm"><span class="type">NMSettingGsm</span></a> object</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -281,7 +280,6 @@ nm_setting_gsm_get_number (<em class="parameter"><code><a class="link" href="NMS
 <div class="refsect3">
 <a name="id-1.4.15.8.3.5"></a><h4>Returns</h4>
 <p> the <a class="link" href="NMSettingGsm.html#NMSettingGsm--number" title="The “number” property"><span class="type">“number”</span></a> property of the setting</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -307,7 +305,6 @@ nm_setting_gsm_get_username (<em class="parameter"><code><a class="link" href="N
 <div class="refsect3">
 <a name="id-1.4.15.8.4.5"></a><h4>Returns</h4>
 <p> the <a class="link" href="NMSettingGsm.html#NMSettingGsm--username" title="The “username” property"><span class="type">“username”</span></a> property of the setting</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -333,7 +330,6 @@ nm_setting_gsm_get_password (<em class="parameter"><code><a class="link" href="N
 <div class="refsect3">
 <a name="id-1.4.15.8.5.5"></a><h4>Returns</h4>
 <p> the <a class="link" href="NMSettingGsm.html#NMSettingGsm--password" title="The “password” property"><span class="type">“password”</span></a> property of the setting</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -359,7 +355,6 @@ nm_setting_gsm_get_apn (<em class="parameter"><code><a class="link" href="NMSett
 <div class="refsect3">
 <a name="id-1.4.15.8.6.5"></a><h4>Returns</h4>
 <p> the <a class="link" href="NMSettingGsm.html#NMSettingGsm--apn" title="The “apn” property"><span class="type">“apn”</span></a> property of the setting</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -385,7 +380,6 @@ nm_setting_gsm_get_network_id (<em class="parameter"><code><a class="link" href=
 <div class="refsect3">
 <a name="id-1.4.15.8.7.5"></a><h4>Returns</h4>
 <p> the <a class="link" href="NMSettingGsm.html#NMSettingGsm--network-id" title="The “network-id” property"><span class="type">“network-id”</span></a> property of the setting</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -411,7 +405,6 @@ nm_setting_gsm_get_pin (<em class="parameter"><code><a class="link" href="NMSett
 <div class="refsect3">
 <a name="id-1.4.15.8.8.5"></a><h4>Returns</h4>
 <p> the <a class="link" href="NMSettingGsm.html#NMSettingGsm--pin" title="The “pin” property"><span class="type">“pin”</span></a> property of the setting</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -437,7 +430,6 @@ nm_setting_gsm_get_home_only (<em class="parameter"><code><a class="link" href="
 <div class="refsect3">
 <a name="id-1.4.15.8.9.5"></a><h4>Returns</h4>
 <p> the <a class="link" href="NMSettingGsm.html#NMSettingGsm--home-only" title="The “home-only” property"><span class="type">“home-only”</span></a> property of the setting</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -463,7 +455,6 @@ nm_setting_gsm_get_pin_flags (<em class="parameter"><code><a class="link" href="
 <div class="refsect3">
 <a name="id-1.4.15.8.10.5"></a><h4>Returns</h4>
 <p> the <a class="link" href="NMSetting.html#NMSettingSecretFlags" title="enum NMSettingSecretFlags"><span class="type">NMSettingSecretFlags</span></a> pertaining to the <a class="link" href="NMSettingGsm.html#NMSettingGsm--pin" title="The “pin” property"><span class="type">“pin”</span></a></p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -489,7 +480,6 @@ nm_setting_gsm_get_password_flags (<em class="parameter"><code><a class="link" h
 <div class="refsect3">
 <a name="id-1.4.15.8.11.5"></a><h4>Returns</h4>
 <p> the <a class="link" href="NMSetting.html#NMSettingSecretFlags" title="enum NMSettingSecretFlags"><span class="type">NMSettingSecretFlags</span></a> pertaining to the <a class="link" href="NMSettingGsm.html#NMSettingGsm--password" title="The “password” property"><span class="type">“password”</span></a></p>
-<p></p>
 </div>
 </div>
 </div>
@@ -499,80 +489,60 @@ nm_setting_gsm_get_password_flags (<em class="parameter"><code><a class="link" h
 <a name="NM-SETTING-GSM-SETTING-NAME:CAPS"></a><h3>NM_SETTING_GSM_SETTING_NAME</h3>
 <pre class="programlisting">#define NM_SETTING_GSM_SETTING_NAME "gsm"
 </pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-GSM-NUMBER:CAPS"></a><h3>NM_SETTING_GSM_NUMBER</h3>
 <pre class="programlisting">#define NM_SETTING_GSM_NUMBER         "number"
 </pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-GSM-USERNAME:CAPS"></a><h3>NM_SETTING_GSM_USERNAME</h3>
 <pre class="programlisting">#define NM_SETTING_GSM_USERNAME       "username"
 </pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-GSM-PASSWORD:CAPS"></a><h3>NM_SETTING_GSM_PASSWORD</h3>
 <pre class="programlisting">#define NM_SETTING_GSM_PASSWORD       "password"
 </pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-GSM-PASSWORD-FLAGS:CAPS"></a><h3>NM_SETTING_GSM_PASSWORD_FLAGS</h3>
 <pre class="programlisting">#define NM_SETTING_GSM_PASSWORD_FLAGS "password-flags"
 </pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-GSM-APN:CAPS"></a><h3>NM_SETTING_GSM_APN</h3>
 <pre class="programlisting">#define NM_SETTING_GSM_APN            "apn"
 </pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-GSM-NETWORK-ID:CAPS"></a><h3>NM_SETTING_GSM_NETWORK_ID</h3>
 <pre class="programlisting">#define NM_SETTING_GSM_NETWORK_ID     "network-id"
 </pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-GSM-PIN:CAPS"></a><h3>NM_SETTING_GSM_PIN</h3>
 <pre class="programlisting">#define NM_SETTING_GSM_PIN            "pin"
 </pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-GSM-PIN-FLAGS:CAPS"></a><h3>NM_SETTING_GSM_PIN_FLAGS</h3>
 <pre class="programlisting">#define NM_SETTING_GSM_PIN_FLAGS      "pin-flags"
 </pre>
-<p>
-</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-GSM-HOME-ONLY:CAPS"></a><h3>NM_SETTING_GSM_HOME_ONLY</h3>
 <pre class="programlisting">#define NM_SETTING_GSM_HOME_ONLY      "home-only"
 </pre>
-<p>
-</p>
 </div>
 </div>
 <div class="refsect1">
@@ -580,7 +550,13 @@ nm_setting_gsm_get_password_flags (<em class="parameter"><code><a class="link" h
 <div class="refsect2">
 <a name="NMSettingGsm--apn"></a><h3>The <code class="literal">“apn”</code> property</h3>
 <pre class="programlisting">  “apn”                      <span class="type">gchar</span> *</pre>
-<p></p>
+<p>The GPRS Access Point Name specifying the APN used when establishing a
+data session with the GSM-based network.  The APN often determines how
+the user will be billed for their network usage and whether the user has
+access to the Internet or just a provider-specific walled-garden, so it
+is important to use the correct APN for the user's mobile broadband plan.
+The APN may only be composed of the characters a-z, 0-9, ., and - per GSM
+03.60 Section 14.9.</p>
 <p>Flags: Read / Write</p>
 <p>Default value: NULL</p>
 </div>
@@ -588,7 +564,8 @@ nm_setting_gsm_get_password_flags (<em class="parameter"><code><a class="link" h
 <div class="refsect2">
 <a name="NMSettingGsm--home-only"></a><h3>The <code class="literal">“home-only”</code> property</h3>
 <pre class="programlisting">  “home-only”                <span class="type">gboolean</span></pre>
-<p></p>
+<p>When <code class="literal">TRUE</code>, only connections to the home network will be allowed.
+Connections to roaming networks will not be made.</p>
 <p>Flags: Read / Write</p>
 <p>Default value: FALSE</p>
 </div>
@@ -596,7 +573,11 @@ nm_setting_gsm_get_password_flags (<em class="parameter"><code><a class="link" h
 <div class="refsect2">
 <a name="NMSettingGsm--network-id"></a><h3>The <code class="literal">“network-id”</code> property</h3>
 <pre class="programlisting">  “network-id”               <span class="type">gchar</span> *</pre>
-<p></p>
+<p>The Network ID (GSM LAI format, ie MCC-MNC) to force specific network
+registration.  If the Network ID is specified, NetworkManager will
+attempt to force the device to register only on the specified network.
+This can be used to ensure that the device does not roam when direct
+roaming control of the device is not otherwise possible.</p>
 <p>Flags: Read / Write</p>
 <p>Default value: NULL</p>
 </div>
@@ -604,7 +585,10 @@ nm_setting_gsm_get_password_flags (<em class="parameter"><code><a class="link" h
 <div class="refsect2">
 <a name="NMSettingGsm--number"></a><h3>The <code class="literal">“number”</code> property</h3>
 <pre class="programlisting">  “number”                   <span class="type">gchar</span> *</pre>
-<p></p>
+<p>Number to dial when establishing a PPP data session with the GSM-based
+mobile broadband network.  Many modems do not require PPP for connections
+to the mobile network and thus this property should be left blank, which
+allows NetworkManager to select the appropriate settings automatically.</p>
 <p>Flags: Read / Write</p>
 <p>Default value: NULL</p>
 </div>
@@ -612,7 +596,9 @@ nm_setting_gsm_get_password_flags (<em class="parameter"><code><a class="link" h
 <div class="refsect2">
 <a name="NMSettingGsm--password"></a><h3>The <code class="literal">“password”</code> property</h3>
 <pre class="programlisting">  “password”                 <span class="type">gchar</span> *</pre>
-<p></p>
+<p>The password used to authenticate with the network, if required.  Many
+providers do not require a password, or accept any password.  But if a
+password is required, it is specified here.</p>
 <p>Flags: Read / Write</p>
 <p>Default value: NULL</p>
 </div>
@@ -620,14 +606,16 @@ nm_setting_gsm_get_password_flags (<em class="parameter"><code><a class="link" h
 <div class="refsect2">
 <a name="NMSettingGsm--password-flags"></a><h3>The <code class="literal">“password-flags”</code> property</h3>
 <pre class="programlisting">  “password-flags”           <a class="link" href="NMSetting.html#NMSettingSecretFlags" title="enum NMSettingSecretFlags"><span class="type">NMSettingSecretFlags</span></a></pre>
-<p></p>
+<p>Flags indicating how to handle the <a class="link" href="NMSettingGsm.html#NMSettingGsm--password" title="The “password” property"><span class="type">“password”</span></a> property.</p>
 <p>Flags: Read / Write</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NMSettingGsm--pin"></a><h3>The <code class="literal">“pin”</code> property</h3>
 <pre class="programlisting">  “pin”                      <span class="type">gchar</span> *</pre>
-<p></p>
+<p>If the SIM is locked with a PIN it must be unlocked before any other
+operations are requested.  Specify the PIN here to allow operation of the
+device.</p>
 <p>Flags: Read / Write</p>
 <p>Default value: NULL</p>
 </div>
@@ -635,21 +623,22 @@ nm_setting_gsm_get_password_flags (<em class="parameter"><code><a class="link" h
 <div class="refsect2">
 <a name="NMSettingGsm--pin-flags"></a><h3>The <code class="literal">“pin-flags”</code> property</h3>
 <pre class="programlisting">  “pin-flags”                <a class="link" href="NMSetting.html#NMSettingSecretFlags" title="enum NMSettingSecretFlags"><span class="type">NMSettingSecretFlags</span></a></pre>
-<p></p>
+<p>Flags indicating how to handle the <a class="link" href="NMSettingGsm.html#NMSettingGsm--pin" title="The “pin” property"><span class="type">“pin”</span></a> property.</p>
 <p>Flags: Read / Write</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NMSettingGsm--username"></a><h3>The <code class="literal">“username”</code> property</h3>
 <pre class="programlisting">  “username”                 <span class="type">gchar</span> *</pre>
-<p></p>
+<p>The username used to authenticate with the network, if required.  Many
+providers do not require a username, or accept any username.  But if a
+username is required, it is specified here.</p>
 <p>Flags: Read / Write</p>
 <p>Default value: NULL</p>
 </div>
 </div>
 </div>
 <div class="footer">
-<hr>
-          Generated by GTK-Doc V1.21</div>
+<hr>Generated by GTK-Doc V1.24</div>
 </body>
 </html>
\ No newline at end of file