diff package-update-indicator.1.xml @ 6:2477a6151087

Make PackagKit use the user's network proxies Pick up network proxies from the user's environment and make PackagKit use them. Setting network proxies is a privileged operation, so it is only attempted if the user is allowed to use the polkit action org.freedesktop.packagekit.system-network-proxy-configure without authentication.
author Guido Berhoerster <guido+pui@berhoerster.name>
date Tue, 19 Jun 2018 15:44:36 +0200
parents 2f04ec9e0506
children
line wrap: on
line diff
--- a/package-update-indicator.1.xml	Sun Jun 17 17:05:16 2018 +0200
+++ b/package-update-indicator.1.xml	Tue Jun 19 15:44:36 2018 +0200
@@ -33,7 +33,7 @@
       <email>guido+pui@berhoerster.name</email>
       <personblurb/>
     </author>
-    <date>5 June, 2018</date>
+    <date>19 June, 2018</date>
   </info>
   <refmeta>
     <refentrytitle>package-update-indicator</refentrytitle>
@@ -73,6 +73,11 @@
     checks for software updates and notifies the user about available updates
     using desktop notifications and either a status notifier icon or a system
     tray icon.</para>
+    <para>Protocol-specific proxies specified through the corresponding
+    environment variables will be used by PackagKit when refreshing metadata if
+    the user is allowed to use the polkit action
+    <literal>org.freedesktop.packagekit.system-network-proxy-configure</literal>
+    without authentication.</para>
   </refsect1>
   <refsect1>
     <title>Options</title>
@@ -104,6 +109,42 @@
     </variablelist>
   </refsect1>
   <refsect1>
+    <title>Environment Variables</title>
+    <variablelist>
+      <varlistentry>
+        <term>http_proxy</term>
+        <listitem>
+          <para>Network proxy using the HTTP protcol.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>https_proxy</term>
+        <listitem>
+          <para>Network proxy using the HTTPS protcol.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>ftp_proxy</term>
+        <listitem>
+          <para>Network proxy using the FTP protcol.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>socks_proxy</term>
+        <listitem>
+          <para>Network proxy using the SOCKS protcol.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>no_proxy</term>
+        <listitem>
+          <para>Comma-separated list of host for which no proxy should be
+            used.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+  <refsect1>
     <title>Exit Status</title>
     <para>The following exit values are returned:</para>
     <variablelist>
@@ -131,6 +172,8 @@
     <title>See Also</title>
     <para><citerefentry>
       <refentrytitle>package-update-indicator-prefs</refentrytitle>
-      <manvolnum>1</manvolnum></citerefentry></para>
+      <manvolnum>1</manvolnum></citerefentry>,
+      <citerefentry><refentrytitle>polkit</refentrytitle>
+      <manvolnum>8</manvolnum></citerefentry></para>
   </refsect1>
 </refentry>