Author: wblaszcz Date: 2009-10-08 04:59:45 -0600 (Thu, 08 Oct 2009) New Revision: 8056
Added: trunk/BOOK/general/genlib/gir-repository.xml trunk/BOOK/general/genlib/gobject-introspection.xml trunk/BOOK/general/genlib/libffi.xml trunk/BOOK/postlfs/security/polkit.xml Modified: trunk/BOOK/general.ent trunk/BOOK/general/genlib/dbus-bindings.xml trunk/BOOK/general/genlib/genlib.xml trunk/BOOK/introduction/welcome/changelog.xml trunk/BOOK/postlfs/security/security.xml Log: New packages: polkit-0.94, libffi-3.0.8, gir-repository-0.6.5, gobject-introspection-0.6.5, and eggdbus-0.5. Modified: trunk/BOOK/general/genlib/dbus-bindings.xml =================================================================== --- trunk/BOOK/general/genlib/dbus-bindings.xml 2009-10-06 20:26:52 UTC (rev 8055) +++ trunk/BOOK/general/genlib/dbus-bindings.xml 2009-10-08 10:59:45 UTC (rev 8056) @@ -25,6 +25,13 @@ <!ENTITY dbus-qt3-buildsize "4 MB"> <!ENTITY dbus-qt3-time "0.1 SBU"> + <!ENTITY eggdbus-download-http "http://hal.freedesktop.org/releases/eggdbus-&eggdbus-version;.tar.gz";> + <!ENTITY eggdbus-download-ftp " "> + <!ENTITY eggdbus-md5sum "44f1f6387c49e8198d7aa755aeee46c6"> + <!ENTITY eggdbus-size "772 KB"> + <!ENTITY eggdbus-buildsize "21 MB"> + <!ENTITY eggdbus-time "0.3 SBU"> + <!-- All the other bindings info should be here as well --> ]> @@ -53,9 +60,9 @@ successfully.</para> <para>The <application>GLib</application>, - <application>Python</application> and <application>Qt3</application> - Bindings are included on this page. Other language bindings will be added - soon. Until then, see the <ulink + <application>Python</application>, <application>Qt3</application>, and + <application>GObject</application> Bindings are included on this page. Other + language bindings will be added soon. Until then, see the <ulink url="http://www.freedesktop.org/wiki/Software/DBusBindings";>D-Bus Bindings</ulink> page for information.</para> @@ -69,6 +76,9 @@ <listitem> <para><xref linkend="dbus-qt3"/></para> </listitem> + <listitem> + <para><xref linkend="eggdbus"/></para> + </listitem> </itemizedlist> </sect2> @@ -76,79 +86,82 @@ <!-- Below is 111 lines to cut and paste to create a new binding --> <!-- Begin D-Bus GLib Bindings --> <sect2 id="dbus-glib" xreflabel="D-Bus GLib Bindings-&dbus-glib-version;"> - <title>D-Bus GLib Bindings</title> + <title>D-Bus GLib Bindings</title> - <indexterm zone="dbus-glib"> - <primary sortas="a-dbus-glib">D-Bus GLib Bindings</primary> - </indexterm> + <indexterm zone="dbus-glib"> + <primary sortas="a-dbus-glib">D-Bus GLib Bindings</primary> + </indexterm> &lfs65_checked; - <bridgehead renderas="sect3">Package Information</bridgehead> - <itemizedlist spacing="compact"> - <listitem> - <para>Download (HTTP): <ulink url="&dbus-glib-download-http;"/></para> - </listitem> - <listitem> - <para>Download (FTP): <ulink url="&dbus-glib-download-ftp;"/></para> - </listitem> - <listitem> - <para>Download MD5 sum: &dbus-glib-md5sum;</para> - </listitem> - <listitem> - <para>Download size: &dbus-glib-size;</para> - </listitem> - <listitem> - <para>Estimated disk space required: &dbus-glib-buildsize;</para> - </listitem> - <listitem> - <para>Estimated build time: &dbus-glib-time;</para> - </listitem> - </itemizedlist> + <sect3 role="package"> + <title>Introduction to D-Bus GLib Bindings</title> - <bridgehead renderas="sect3">D-Bus GLib Dependencies</bridgehead> + <bridgehead renderas="sect4">Package Information</bridgehead> + <itemizedlist spacing="compact"> + <listitem> + <para>Download (HTTP): <ulink url="&dbus-glib-download-http;"/></para> + </listitem> + <listitem> + <para>Download (FTP): <ulink url="&dbus-glib-download-ftp;"/></para> + </listitem> + <listitem> + <para>Download MD5 sum: &dbus-glib-md5sum;</para> + </listitem> + <listitem> + <para>Download size: &dbus-glib-size;</para> + </listitem> + <listitem> + <para>Estimated disk space required: &dbus-glib-buildsize;</para> + </listitem> + <listitem> + <para>Estimated build time: &dbus-glib-time;</para> + </listitem> + </itemizedlist> - <bridgehead renderas="sect4">Required</bridgehead> - <para role="required"><xref linkend="dbus"/>, - <xref linkend="glib2"/>, and - <xref linkend="expat"/></para> + <bridgehead renderas="sect4">D-Bus GLib Dependencies</bridgehead> - <bridgehead renderas="sect4">Optional to Build the API Documentation</bridgehead> - <para role="required"><xref linkend="doxygen"/></para> + <bridgehead renderas="sect5">Required</bridgehead> + <para role="required"><xref linkend="dbus"/>, + <xref linkend="glib2"/>, and + <xref linkend="expat"/></para> - <para condition="html" role="usernotes">User Notes: - <ulink url="&blfs-wiki;/dbus-glib"/></para> + <bridgehead renderas="sect5">Optional to Build the API Documentation</bridgehead> + <para role="optional"><xref linkend="doxygen"/></para> - </sect2> + <para condition="html" role="usernotes">User Notes: + <ulink url="&blfs-wiki;/dbus-glib"/></para> - <sect2 role="installation"> - <title>Installation of D-Bus GLib Bindings</title> + </sect3> - <para>Install <application>D-Bus GLib Bindings</application> by - running the following commands:</para> + <sect3 role="installation"> + <title>Installation of D-Bus GLib Bindings</title> + <para>Install <application>D-Bus GLib Bindings</application> by + running the following commands:</para> + <screen><userinput>./configure --prefix=/usr \ --sysconfdir=/etc \ --libexecdir=/usr/lib/dbus-1.0/dbus-1 && make</userinput></screen> - <para>The <option>--enable-doxygen-docs</option> parameter does not work - properly. If you have <application>Doxygen</application> installed and you - wish to build the API documentation, issue - <command>doxygen</command>.</para> + <para>The <option>--enable-doxygen-docs</option> parameter does not work + properly. If you have <application>Doxygen</application> installed and you + wish to build the API documentation, issue + <command>doxygen</command>.</para> - <para>To test the results, issue: <command>make check</command>. Note that - more comprehensive tests can be run by following the same method used in - <application>D-BUS</application> instructions, which requires building the - package twice.</para> + <para>To test the results, issue: <command>make check</command>. Note that + more comprehensive tests can be run by following the same method used in + <application>D-BUS</application> instructions, which requires building the + package twice.</para> - <para>Now, as the <systemitem class="username">root</systemitem> user:</para> + <para>Now, as the <systemitem class="username">root</systemitem> user:</para> <screen role="root"><userinput>make install</userinput></screen> - <para>If you built the API documentation, install it by issuing the - following commands as the <systemitem class="username">root</systemitem> - user:</para> + <para>If you built the API documentation, install it by issuing the + following commands as the <systemitem class="username">root</systemitem> + user:</para> <screen role="root"><userinput>install -v -m755 -d /usr/share/doc/dbus-glib-&dbus-glib-version;/api \ /usr/share/man/man3dbus && @@ -157,160 +170,167 @@ install -v -m644 doc/api/man/man3dbus/* \ /usr/share/man/man3dbus</userinput></screen> - </sect2> + </sect3> - <sect2 role="commands"> - <title>Command Explanations</title> + <sect3 role="commands"> + <title>Command Explanations</title> - <para><parameter>--libexecdir=/usr/lib/dbus-1.0/dbus-1</parameter>: This - moves <command>dbus-bash-completion-helper</command> out of <filename - class="directory">/usr/libexec</filename>.</para> + <para><parameter>--libexecdir=/usr/lib/dbus-1.0/dbus-1</parameter>: This + moves <command>dbus-bash-completion-helper</command> out of <filename + class="directory">/usr/libexec</filename>.</para> - <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; - href="../../xincludes/gtk-doc-rebuild.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; + href="../../xincludes/gtk-doc-rebuild.xml"/> - </sect2> + </sect3> - <sect2 role="content"> - <title>Contents</title> + <sect3 role="content"> + <title>Contents</title> - <segmentedlist> - <segtitle>Installed Program</segtitle> - <segtitle>Installed Library</segtitle> - <segtitle>Installed Directories</segtitle> + <segmentedlist> + <segtitle>Installed Program</segtitle> + <segtitle>Installed Library</segtitle> + <segtitle>Installed Directories</segtitle> - <seglistitem> - <seg>dbus-binding-tool</seg> - <seg>libdbus-glib-1.{so,a}</seg> - <seg>/etc/bash_completion.d, /usr/share/gtk-doc/html/dbus-glib, and - optionally /usr/share/doc/dbus-glib-&dbus-glib-version;/api</seg> - </seglistitem> - </segmentedlist> + <seglistitem> + <seg>dbus-binding-tool</seg> + <seg>libdbus-glib-1.{so,a}</seg> + <seg>/etc/bash_completion.d, /usr/share/gtk-doc/html/dbus-glib, and + optionally /usr/share/doc/dbus-glib-&dbus-glib-version;/api</seg> + </seglistitem> + </segmentedlist> - <variablelist> - <bridgehead renderas="sect3">Short Descriptions</bridgehead> - <?dbfo list-presentation="list"?> - <?dbhtml list-presentation="table"?> + <variablelist> + <bridgehead renderas="sect4">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> - <varlistentry id="glib-dbus-binding-tool"> - <term><command>dbus-binding-tool</command></term> - <listitem> - <para>is a tool used to interface with the D-Bus API.</para> - <indexterm zone="dbus-glib glib-dbus-binding-tool"> - <primary sortas="b-dbus-binding-tool">dbus-binding-tool</primary> - </indexterm> - </listitem> - </varlistentry> + <varlistentry id="glib-dbus-binding-tool"> + <term><command>dbus-binding-tool</command></term> + <listitem> + <para>is a tool used to interface with the D-Bus API.</para> + <indexterm zone="dbus-glib glib-dbus-binding-tool"> + <primary sortas="b-dbus-binding-tool">dbus-binding-tool</primary> + </indexterm> + </listitem> + </varlistentry> - <varlistentry id="libdbus-glib-1"> - <term><filename class='libraryfile'>libdbus-glib-1.{so,a}</filename></term> - <listitem> - <para>contains <application>GLib</application> interface functions - to the D-Bus API.</para> - <indexterm zone="dbus-glib libdbus-glib-1"> - <primary sortas="c-libdbus-glib-1">libdbus-glib-1.{so,a}</primary> - </indexterm> - </listitem> - </varlistentry> + <varlistentry id="libdbus-glib-1"> + <term><filename class='libraryfile'>libdbus-glib-1.{so,a}</filename></term> + <listitem> + <para>contains <application>GLib</application> interface functions + to the D-Bus API.</para> + <indexterm zone="dbus-glib libdbus-glib-1"> + <primary sortas="c-libdbus-glib-1">libdbus-glib-1.{so,a}</primary> + </indexterm> + </listitem> + </varlistentry> - </variablelist> + </variablelist> + </sect3> + </sect2> <!-- Begin D-Bus Python Bindings --> <sect2 id="dbus-python" xreflabel="D-Bus Python Bindings-&dbus-python-version;"> - <title>D-Bus Python Bindings</title> + <title>D-Bus Python Bindings</title> - <indexterm zone="dbus-python"> - <primary sortas="a-dbus-python">D-Bus Python Bindings</primary> - </indexterm> + <indexterm zone="dbus-python"> + <primary sortas="a-dbus-python">D-Bus Python Bindings</primary> + </indexterm> - <bridgehead renderas="sect3">Package Information</bridgehead> - <itemizedlist spacing="compact"> - <listitem> - <para>Download (HTTP): <ulink url="&dbus-python-download-http;"/></para> - </listitem> - <listitem> - <para>Download (FTP): <ulink url="&dbus-python-download-ftp;"/></para> - </listitem> - <listitem> - <para>Download MD5 sum: &dbus-python-md5sum;</para> - </listitem> - <listitem> - <para>Download size: &dbus-python-size;</para> - </listitem> - <listitem> - <para>Estimated disk space required: &dbus-python-buildsize;</para> - </listitem> - <listitem> - <para>Estimated build time: &dbus-python-time;</para> - </listitem> - </itemizedlist> + <sect3 role="package"> + <title>Introduction to D-Bus Python Bindings</title> - <bridgehead renderas="sect3">D-Bus Python Dependencies</bridgehead> + <bridgehead renderas="sect4">Package Information</bridgehead> + <itemizedlist spacing="compact"> + <listitem> + <para>Download (HTTP): <ulink url="&dbus-python-download-http;"/></para> + </listitem> + <listitem> + <para>Download (FTP): <ulink url="&dbus-python-download-ftp;"/></para> + </listitem> + <listitem> + <para>Download MD5 sum: &dbus-python-md5sum;</para> + </listitem> + <listitem> + <para>Download size: &dbus-python-size;</para> + </listitem> + <listitem> + <para>Estimated disk space required: &dbus-python-buildsize;</para> + </listitem> + <listitem> + <para>Estimated build time: &dbus-python-time;</para> + </listitem> + </itemizedlist> - <bridgehead renderas="sect4">Required</bridgehead> - <para role="required"><xref linkend="python"/> and - <xref linkend="dbus-glib"/></para> + <bridgehead renderas="sect4">D-Bus Python Dependencies</bridgehead> - <bridgehead renderas="sect4">Optional</bridgehead> - <para role="optional"><ulink url="&gnome-download-http;/pygobject">PyGObject</ulink> - (required to run the test suite)</para> + <bridgehead renderas="sect5">Required</bridgehead> + <para role="required"><xref linkend="python"/> and + <xref linkend="dbus-glib"/></para> - <bridgehead renderas="sect4">Optional - (Required to build the API and HTML Documentation)</bridgehead> - <para role="optional"><ulink url="http://epydoc.sourceforge.net/";>Epydoc</ulink> - and <ulink url="http://docutils.sourceforge.net/";>Docutils</ulink></para> + <bridgehead renderas="sect5">Optional</bridgehead> + <para role="optional"><ulink url="&gnome-download-http;/pygobject">PyGObject</ulink> + (required to run the test suite)</para> - <para condition="html" role="usernotes">User Notes: - <ulink url="&blfs-wiki;/dbus-python"/></para> + <bridgehead renderas="sect5">Optional + (Required to build the API and HTML Documentation)</bridgehead> + <para role="optional"><ulink url="http://epydoc.sourceforge.net/";>Epydoc</ulink> + and <ulink url="http://docutils.sourceforge.net/";>Docutils</ulink></para> - </sect2> + <para condition="html" role="usernotes">User Notes: + <ulink url="&blfs-wiki;/dbus-python"/></para> - <sect2 role="installation"> - <title>Installation of D-Bus Python Bindings</title> + </sect3> - <para>Install <application>D-Bus Python Bindings</application> by - running the following commands:</para> + <sect3 role="installation"> + <title>Installation of D-Bus Python Bindings</title> + <para>Install <application>D-Bus Python Bindings</application> by + running the following commands:</para> + <screen><userinput>./configure --prefix=/usr \ --docdir=/usr/share/doc/dbus-python-&dbus-python-version; && make</userinput></screen> - <para>To test the results, issue: <command>make check</command>. Note you - must have <application>PyGObject</application> installed.</para> + <para>To test the results, issue: <command>make check</command>. Note you + must have <application>PyGObject</application> installed.</para> - <para>Now, as the <systemitem class="username">root</systemitem> user:</para> + <para>Now, as the <systemitem class="username">root</systemitem> user:</para> <screen role="root"><userinput>make install</userinput></screen> - <para>If you built the API documentation, install it by issuing the - following commands as the <systemitem class="username">root</systemitem> - user:</para> + <para>If you built the API documentation, install it by issuing the + following commands as the <systemitem class="username">root</systemitem> + user:</para> <screen role="root"><userinput>install -v -m755 -d /usr/share/doc/dbus-python-&dbus-python-version;/api && install -v -m644 api/* \ /usr/share/doc/dbus-python-&dbus-python-version;/api</userinput></screen> - </sect2> + </sect3> - <sect2 role="content"> - <title>Contents</title> + <sect3 role="content"> + <title>Contents</title> - <segmentedlist> - <segtitle>Installed Programs</segtitle> - <segtitle>Installed Libraries</segtitle> - <segtitle>Installed Directories</segtitle> + <segmentedlist> + <segtitle>Installed Programs</segtitle> + <segtitle>Installed Libraries</segtitle> + <segtitle>Installed Directories</segtitle> - <seglistitem> - <seg>None</seg> - <seg><application>Python</application> - <application>D-Bus</application> modules</seg> - <seg>/usr/lib/python&python-majorver;/site-packages/dbus and - /usr/share/doc/dbus-python-&dbus-python-version;</seg> - </seglistitem> - </segmentedlist> + <seglistitem> + <seg>None</seg> + <seg><application>Python</application> + <application>D-Bus</application> modules</seg> + <seg>/usr/lib/python&python-majorver;/site-packages/dbus and + /usr/share/doc/dbus-python-&dbus-python-version;</seg> + </seglistitem> + </segmentedlist> + </sect3> + </sect2> <!-- Begin D-Bus Qt3 Bindings --> @@ -321,92 +341,188 @@ <primary sortas="a-dbus-qt3">D-Bus Qt3 Bindings</primary> </indexterm> - <bridgehead renderas="sect3">Package Information</bridgehead> - <itemizedlist spacing="compact"> - <listitem> - <para>Download (HTTP): <ulink url="&dbus-qt3-download-http;"/></para> - </listitem> - <listitem> - <para>Download (FTP): <ulink url="&dbus-qt3-download-ftp;"/></para> - </listitem> - <listitem> - <para>Download MD5 sum: &dbus-qt3-md5sum;</para> - </listitem> - <listitem> - <para>Download size: &dbus-qt3-size;</para> - </listitem> - <listitem> - <para>Estimated disk space required: &dbus-qt3-buildsize;</para> - </listitem> - <listitem> - <para>Estimated build time: &dbus-qt3-time;</para> - </listitem> - </itemizedlist> + <sect3 role="package"> + <title>Introduction to D-Bus Qt3 Bindings</title> - <bridgehead renderas="sect3">D-Bus Qt3 Dependencies</bridgehead> + <bridgehead renderas="sect4">Package Information</bridgehead> + <itemizedlist spacing="compact"> + <listitem> + <para>Download (HTTP): <ulink url="&dbus-qt3-download-http;"/></para> + </listitem> + <listitem> + <para>Download (FTP): <ulink url="&dbus-qt3-download-ftp;"/></para> + </listitem> + <listitem> + <para>Download MD5 sum: &dbus-qt3-md5sum;</para> + </listitem> + <listitem> + <para>Download size: &dbus-qt3-size;</para> + </listitem> + <listitem> + <para>Estimated disk space required: &dbus-qt3-buildsize;</para> + </listitem> + <listitem> + <para>Estimated build time: &dbus-qt3-time;</para> + </listitem> + </itemizedlist> - <bridgehead renderas="sect4">Required</bridgehead> - <para role="required"><xref linkend="dbus"/> and - <xref linkend="qt"/></para> + <bridgehead renderas="sect4">D-Bus Qt3 Dependencies</bridgehead> - <!-- <bridgehead renderas="sect4">Recommended</bridgehead> - <para role="recommended"><xref linkend="pkgconfig"/></para> --> + <bridgehead renderas="sect5">Required</bridgehead> + <para role="required"><xref linkend="dbus"/> and + <xref linkend="qt"/></para> - <para condition="html" role="usernotes">User Notes: - <ulink url="&blfs-wiki;/dbus-qt3"/></para> + <para condition="html" role="usernotes">User Notes: + <ulink url="&blfs-wiki;/dbus-qt3"/></para> - </sect2> + </sect3> - <sect2 role="installation"> - <title>Installation of D-Bus Qt3 Bindings</title> + <sect3 role="installation"> + <title>Installation of D-Bus Qt3 Bindings</title> - <para>Install <application>D-Bus Qt3 Bindings</application> by - running the following commands:</para> + <para>Install <application>D-Bus Qt3 Bindings</application> by + running the following commands:</para> <screen><userinput>./configure --prefix=/usr && make</userinput></screen> - <para>This package does not come with a test suite.</para> + <para>This package does not come with a test suite.</para> - <para>Now, as the <systemitem class="username">root</systemitem> user:</para> + <para>Now, as the <systemitem class="username">root</systemitem> user:</para> <screen role="root"><userinput>make install</userinput></screen> + </sect3> + + <sect3 role="content"> + <title>Contents</title> + + <segmentedlist> + <segtitle>Installed Programs</segtitle> + <segtitle>Installed Library</segtitle> + <segtitle>Installed Directories</segtitle> + + <seglistitem> + <seg>None</seg> + <seg>libdbus-qt-1.so</seg> + <seg>None</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect4">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="libdbus-qt-1"> + <term><filename class='libraryfile'>libdbus-qt-1.{so,a}</filename></term> + <listitem> + <para>contains <application>Qt3</application> interface functions + to the D-Bus API.</para> + <indexterm zone="dbus-qt3 libdbus-qt-1"> + <primary sortas="c-libdbus-qt-1">libdbus-qt-1.{so,a}</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect3> + </sect2> - <sect2 role="content"> - <title>Contents</title> + <!-- Begin D-Bus GObject Bindings --> + <sect2 id="eggdbus" xreflabel="D-Bus GObject Bindings-&eggdbus-version;"> + <title>D-Bus GObject Bindings</title> - <segmentedlist> - <segtitle>Installed Programs</segtitle> - <segtitle>Installed Library</segtitle> - <segtitle>Installed Directories</segtitle> + <indexterm zone="eggdbus"> + <primary sortas="a-eggdbus">D-Bus GObject Bindings</primary> + </indexterm> - <seglistitem> - <seg>None</seg> - <seg>libdbus-qt-1.so</seg> - <seg>None</seg> - </seglistitem> - </segmentedlist> + &lfs65_checked; - <variablelist> - <bridgehead renderas="sect3">Short Descriptions</bridgehead> - <?dbfo list-presentation="list"?> - <?dbhtml list-presentation="table"?> + <sect3 role="package"> + <title>Introduction to D-Bus GObject Bindings</title> - <varlistentry id="libdbus-qt-1"> - <term><filename class='libraryfile'>libdbus-qt-1.{so,a}</filename></term> + <bridgehead renderas="sect4">Package Information</bridgehead> + <itemizedlist spacing="compact"> <listitem> - <para>contains <application>Qt3</application> interface functions - to the D-Bus API.</para> - <indexterm zone="dbus-qt3 libdbus-qt-1"> - <primary sortas="c-libdbus-qt-1">libdbus-qt-1.{so,a}</primary> - </indexterm> + <para>Download (HTTP): <ulink url="&eggdbus-download-http;"/></para> </listitem> - </varlistentry> + <listitem> + <para>Download (FTP): <ulink url="&eggdbus-download-ftp;"/></para> + </listitem> + <listitem> + <para>Download MD5 sum: &eggdbus-md5sum;</para> + </listitem> + <listitem> + <para>Download size: &eggdbus-size;</para> + </listitem> + <listitem> + <para>Estimated disk space required: &eggdbus-buildsize;</para> + </listitem> + <listitem> + <para>Estimated build time: &eggdbus-time;</para> + </listitem> + </itemizedlist> - </variablelist> + <bridgehead renderas="sect4">eggdbus Dependencies</bridgehead> + <bridgehead renderas="sect5">Required</bridgehead> + <para role="required"><xref linkend="dbus-glib"/> and + <xref linkend="docbook-xsl"/></para> + + <bridgehead renderas="sect5">Optional</bridgehead> + <para role="optional"><xref linkend="gtk-doc"/></para> + + <para condition="html" role="usernotes">User Notes: + <ulink url="&blfs-wiki;/eggdbus"/></para> + + </sect3> + + <sect3 role="installation"> + <title>Installation of D-Bus GObject Bindings</title> + + + <para>Install <application>eggdbus</application> by + running the following commands:</para> + +<screen><userinput>./configure --prefix=/usr && +make</userinput></screen> + + <para>To test the results, issue: <command>make check</command>.</para> + + <para>Now, as the <systemitem class="username">root</systemitem> user:</para> + +<screen role="root"><userinput>make install</userinput></screen> + + </sect3> + + <sect3 role="commands"> + <title>Command Explanations</title> + + <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; + href="../../xincludes/gtk-doc-rebuild.xml"/> + + </sect3> + + <sect3 role="content"> + <title>Contents</title> + + <segmentedlist> + <segtitle>Installed Programs</segtitle> + <segtitle>Installed Library</segtitle> + <segtitle>Installed Directory</segtitle> + + <seglistitem> + <seg>eggdbus-binding-tool and eggdbus-glib-genmarshal</seg> + <seg>libeggdbus-1.{so,a}</seg> + <seg>/usr/include/eggdbus-1/eggdbus</seg> + </seglistitem> + </segmentedlist> + + </sect3> + </sect2> </sect1> Modified: trunk/BOOK/general/genlib/genlib.xml =================================================================== --- trunk/BOOK/general/genlib/genlib.xml 2009-10-06 20:26:52 UTC (rev 8055) +++ trunk/BOOK/general/genlib/genlib.xml 2009-10-08 10:59:45 UTC (rev 8056) @@ -85,6 +85,9 @@ <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="libunique.xml"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="liboil.xml"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="nspr.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="libffi.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="gobject-introspection.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="gir-repository.xml"/> <!-- <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="libxml.xml"/> --> <!-- <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="ispell.xml"/> --> Added: trunk/BOOK/general/genlib/gir-repository.xml =================================================================== --- trunk/BOOK/general/genlib/gir-repository.xml (rev 0) +++ trunk/BOOK/general/genlib/gir-repository.xml 2009-10-08 10:59:45 UTC (rev 8056) @@ -0,0 +1,150 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" + "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ + <!ENTITY % general-entities SYSTEM "../../general.ent"> + %general-entities; + + <!ENTITY gir-repository-download-http "&gnome-download-http;/gir-repository/0.6/gir-repository-&gir-repository-version;.tar.bz2"> + <!ENTITY gir-repository-download-ftp "&gnome-download-ftp;/gir-repository/0.6/gir-repository-&gir-repository-version;.tar.bz2"> + <!ENTITY gir-repository-md5sum "f161fa1ae161e81117af6f4bb79bf344"> + <!ENTITY gir-repository-size "258 KB"> + <!ENTITY gir-repository-buildsize "17 MB"> + <!ENTITY gir-repository-time "0.3 SBU"> +]> + +<sect1 id="gir-repository" xreflabel="gir-repository-&gir-repository-version;"> + <?dbhtml filename="gir-repository.html"?> + + <sect1info> + <othername>$LastChangedBy$</othername> + <date>$Date$</date> + </sect1info> + + <title>gir-repository-&gir-repository-version;</title> + + <indexterm zone="gir-repository"> + <primary sortas="a-gir-repository">gir-repository</primary> + </indexterm> + + <sect2 role="package"> + <title>Introduction to gir-repository</title> + + <para>The <application>gir-repository</application> is a repository of GIR + interface description files.</para> + + <bridgehead renderas="sect3">Package Information</bridgehead> + <itemizedlist spacing="compact"> + <listitem> + <para>Download (HTTP): <ulink url="&gir-repository-download-http;"/></para> + </listitem> + <listitem> + <para>Download (FTP): <ulink url="&gir-repository-download-ftp;"/></para> + </listitem> + <listitem> + <para>Download MD5 sum: &gir-repository-md5sum;</para> + </listitem> + <listitem> + <para>Download size: &gir-repository-size;</para> + </listitem> + <listitem> + <para>Estimated disk space required: &gir-repository-buildsize;</para> + </listitem> + <listitem> + <para>Estimated build time: &gir-repository-time;</para> + </listitem> + </itemizedlist> + + <bridgehead renderas="sect3">gir-repository Dependencies</bridgehead> + + <bridgehead renderas="sect4">Required</bridgehead> + <para role="required"><xref linkend="gobject-introspection"/></para> + + <bridgehead renderas="sect4">Optional</bridgehead> + <para role="optional"><xref linkend="dbus-glib"/>, + <xref linkend="glib2"/>, + <xref linkend="gtk2"/>, + <xref linkend="libsoup"/>, and + <ulink url="http://clutter-project.org/";>Clutter</ulink>. Plus many more + (runtime).</para> + + <para condition="html" role="usernotes">User Notes: + <ulink url="&blfs-wiki;/gir-repository"/></para> + + </sect2> + + <sect2 role="installation"> + <title>Installation of gir-repository</title> + + <para>Install <application>gir-repository</application> by running the + following commands:</para> + +<screen><userinput>./configure --prefix=/usr && +make</userinput></screen> + + <para>This package does not come with a test suite.</para> + + <para>Now, as the <systemitem class="username">root</systemitem> user:</para> + +<screen role="root"><userinput>make install</userinput></screen> + + </sect2> + + <sect2 role="content"> + <title>Contents</title> + + <segmentedlist> + <segtitle>Installed Programs</segtitle> + <segtitle>Installed Libraries</segtitle> + <segtitle>Installed Directories</segtitle> + + <seglistitem> + <seg>None</seg> + <seg>libgirepo-DBus-custom.{so,a}, libgirepo-Gdk-custom.{so,a}, and + libgirepo-Gtk-custom.{so,a}</seg> + <seg>/usr/lib/girepository-1.0 and /usr/share/gir-1.0</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="libgirepo-DBus-custom"> + <term><filename class='libraryfile'>libgirepo-DBus-custom.{so,a}</filename></term> + <listitem> + <para>contains the <application>gir-repository</application> + <application>D-Bus</application> API functions.</para> + <indexterm zone="gir-repository libgirepo-DBus-custom"> + <primary sortas="c-libgirepo-DBus-custom">libgirepo-DBus-custom.{so,a}</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="libgirepo-Gdk-custom"> + <term><filename class='libraryfile'>libgirepo-Gdk-custom.{so,a}</filename></term> + <listitem> + <para>contains the <application>gir-repository</application> GDK API + functions.</para> + <indexterm zone="gir-repository libgirepo-Gdk-custom"> + <primary sortas="c-libgirepo-Gdk-custom">libgirepo-Gdk-custom.{so,a}</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="libgirepo-Gtk-custom"> + <term><filename class='libraryfile'>libgirepo-Gtk-custom.{so,a}</filename></term> + <listitem> + <para>contains the <application>gir-repository</application> + <application>GTK</application> API functions.</para> + <indexterm zone="gir-repository libgirepo-Gtk-custom"> + <primary sortas="c-libgirepo-Gtk-custom">libgirepo-Gtk-custom.{so,a}</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> + +</sect1> Property changes on: trunk/BOOK/general/genlib/gir-repository.xml ___________________________________________________________________ Name: svn:keywords + LastChangedBy Date Added: trunk/BOOK/general/genlib/gobject-introspection.xml =================================================================== --- trunk/BOOK/general/genlib/gobject-introspection.xml (rev 0) +++ trunk/BOOK/general/genlib/gobject-introspection.xml 2009-10-08 10:59:45 UTC (rev 8056) @@ -0,0 +1,172 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" + "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ + <!ENTITY % general-entities SYSTEM "../../general.ent"> + %general-entities; + + <!ENTITY gobject-introspection-download-http "&gnome-download-http;/gobject-introspection/0.6/gobject-introspection-&gobject-introspection-version;.tar.bz2"> + <!ENTITY gobject-introspection-download-ftp "&gnome-download-http;/gobject-introspection/0.6/gobject-introspection-&gobject-introspection-version;.tar.bz2"> + <!ENTITY gobject-introspection-md5sum "c946cddf10f02a3aea483967ab6de605"> + <!ENTITY gobject-introspection-size "594 KB"> + <!ENTITY gobject-introspection-buildsize "18 MB"> + <!ENTITY gobject-introspection-time "0.3 SBU"> +]> + +<sect1 id="gobject-introspection" xreflabel="gobject-introspection-&gobject-introspection-version;"> + <?dbhtml filename="gobject-introspection.html"?> + + <sect1info> + <othername>$LastChangedBy$</othername> + <date>$Date$</date> + </sect1info> + + <title>gobject-introspection-&gobject-introspection-version;</title> + + <indexterm zone="gobject-introspection"> + <primary sortas="a-gobject-introspection">gobject-introspection</primary> + </indexterm> + + <sect2 role="package"> + <title>Introduction to gobject-introspection</title> + + <para>The <application>gobject-introspection</application> package is used + to describe the APIs and collect them in a uniform, machine readable + format.</para> + + <bridgehead renderas="sect3">Package Information</bridgehead> + <itemizedlist spacing="compact"> + <listitem> + <para>Download (HTTP): <ulink url="&gobject-introspection-download-http;"/></para> + </listitem> + <listitem> + <para>Download (FTP): <ulink url="&gobject-introspection-download-ftp;"/></para> + </listitem> + <listitem> + <para>Download MD5 sum: &gobject-introspection-md5sum;</para> + </listitem> + <listitem> + <para>Download size: &gobject-introspection-size;</para> + </listitem> + <listitem> + <para>Estimated disk space required: &gobject-introspection-buildsize;</para> + </listitem> + <listitem> + <para>Estimated build time: &gobject-introspection-time;</para> + </listitem> + </itemizedlist> + + <bridgehead renderas="sect4">Required</bridgehead> + <para role="required"><xref linkend="glib2"/> and + <xref linkend="libffi"/></para> + + <bridgehead renderas="sect4">Optional</bridgehead> + <para role="optional"><xref linkend="gtk-doc"/></para> + + <para condition="html" role="usernotes">User Notes: + <ulink url="&blfs-wiki;/gobject-introspection"/></para> + + </sect2> + + <sect2 role="installation"> + <title>Installation of gobject-introspection</title> + + <para>Install <application>gobject-introspection</application> by running + the following commands:</para> + +<screen><userinput>./configure --prefix=/usr && +make</userinput></screen> + + <para>To test the results, issue: <command>make check</command>.</para> + + <para>Now, as the <systemitem class="username">root</systemitem> user:</para> + +<screen role="root"><userinput>make install</userinput></screen> + + </sect2> + + <sect2 role="commands"> + <title>Command Explanations</title> + + <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; + href="../../xincludes/gtk-doc-rebuild.xml"/> + + </sect2> + + <sect2 role="content"> + <title>Contents</title> + + <segmentedlist> + <segtitle>Installed Programs</segtitle> + <segtitle>Installed Libraries</segtitle> + <segtitle>Installed Directories</segtitle> + + <seglistitem> + <seg>g-ir-compiler, g-ir-scanner, and g-ir-generate</seg> + <seg>libgirepository-1.0.{so,a} and + libgirepository-everything-1.0.{so,a}</seg> + <seg>/usr/{include/gobject-introspection-1.0,lib/{girepository-1.0, + gobject-introspection/giscanner},share/gir-1.0}</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="g-ir-compiler"> + <term><command>g-ir-compiler</command></term> + <listitem> + <para>converts one or more GIR files into one or more typelib.</para> + <indexterm zone="gobject-introspection g-ir-compiler"> + <primary sortas="b-g-ir-compiler">g-ir-compiler</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="g-ir-scanner"> + <term><command>g-ir-scanner</command></term> + <listitem> + <para>is a tool which generates GIR XML files by parsing headers and + introspecting GObject based libraries.</para> + <indexterm zone="gobject-introspection g-ir-scanner"> + <primary sortas="b-g-ir-scanner">g-ir-scanner</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="g-ir-generate"> + <term><command>g-ir-generate</command></term> + <listitem> + <para>is a GIR generator, using the repository API.</para> + <indexterm zone="gobject-introspection g-ir-generate"> + <primary sortas="b-g-ir-generate">g-ir-generate</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="libgirepository-1.0"> + <term><filename class='libraryfile'>libgirepository-1.0.{so,a}</filename></term> + <listitem> + <para>provides an API to access to the typelib metadata.</para> + <indexterm zone="gobject-introspection libgirepository-1.0"> + <primary sortas="c-libgirepository-1.0">libgirepository-1.0.{so,a}</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="libgirepository-everything-1.0"> + <term><filename class='libraryfile'>libgirepository-everything-1.0.{so,a}</filename></term> + <listitem> + <para>provides an API to access to the typelib metadata.</para> + <indexterm zone="gobject-introspection libgirepository-everything-1.0"> + <primary sortas="c-libgirepository-everything-1.0">libgirepository-everything-1.0.{so,a}</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> + +</sect1> Property changes on: trunk/BOOK/general/genlib/gobject-introspection.xml ___________________________________________________________________ Name: svn:keywords + LastChangedBy Date Added: trunk/BOOK/general/genlib/libffi.xml =================================================================== --- trunk/BOOK/general/genlib/libffi.xml (rev 0) +++ trunk/BOOK/general/genlib/libffi.xml 2009-10-08 10:59:45 UTC (rev 8056) @@ -0,0 +1,113 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" + "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ + <!ENTITY % general-entities SYSTEM "../../general.ent"> + %general-entities; + + <!ENTITY libffi-download-http " "> + <!ENTITY libffi-download-ftp "ftp://sourceware.org/pub/libffi/libffi-&libffi-version;.tar.gz";> + <!ENTITY libffi-md5sum "188a4f79fdac2310044b44b7d3918ef9"> + <!ENTITY libffi-size "706 KB"> + <!ENTITY libffi-buildsize "5 MB"> + <!ENTITY libffi-time "0.1 SBU"> +]> + +<sect1 id="libffi" xreflabel="libffi-&libffi-version;"> + <?dbhtml filename="libffi.html"?> + + <sect1info> + <othername>$LastChangedBy$</othername> + <date>$Date$</date> + </sect1info> + + <title>libffi-&libffi-version;</title> + + <indexterm zone="libffi"> + <primary sortas="a-libffi">libffi</primary> + </indexterm> + + <sect2 role="package"> + <title>Introduction to libffi</title> + + <para>The <application>libffi</application> library provides a portable, + high level programming interface to various calling conventions. This + allows a programmer to call any function specified by a call interface + description at run time.</para> + + <bridgehead renderas="sect3">Package Information</bridgehead> + <itemizedlist spacing="compact"> + <listitem> + <para>Download (HTTP): <ulink url="&libffi-download-http;"/></para> + </listitem> + <listitem> + <para>Download (FTP): <ulink url="&libffi-download-ftp;"/></para> + </listitem> + <listitem> + <para>Download MD5 sum: &libffi-md5sum;</para> + </listitem> + <listitem> + <para>Download size: &libffi-size;</para> + </listitem> + <listitem> + <para>Estimated disk space required: &libffi-buildsize;</para> + </listitem> + <listitem> + <para>Estimated build time: &libffi-time;</para> + </listitem> + </itemizedlist> + + </sect2> + + <sect2 role="installation"> + <title>Installation of libffi</title> + + <para>Install <application>libffi</application> by running the following + commands:</para> + +<screen><userinput>./configure --prefix=/usr && +make</userinput></screen> + + <para>This package does not come with a test suite.</para> + + <para>Now, as the <systemitem class="username">root</systemitem> user:</para> + +<screen role="root"><userinput>make install</userinput></screen> + + </sect2> + + <sect2 role="content"> + <title>Contents</title> + + <segmentedlist> + <segtitle>Installed Programs</segtitle> + <segtitle>Installed Library</segtitle> + <segtitle>Installed Directory</segtitle> + + <seglistitem> + <seg>None</seg> + <seg>libffi.{so,a}</seg> + <seg>/usr/lib/libffi-&libffi-version;/include</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="libffi-lib"> + <term><filename class='libraryfile'>libffi.{so,a}</filename></term> + <listitem> + <para>contains the <application>libffi</application> API + functions.</para> + <indexterm zone="libffi libffi-lib"> + <primary sortas="c-libffi">libffi.{so,a}</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> + +</sect1> Property changes on: trunk/BOOK/general/genlib/libffi.xml ___________________________________________________________________ Name: svn:keywords + LastChangedBy Date Modified: trunk/BOOK/general.ent =================================================================== --- trunk/BOOK/general.ent 2009-10-06 20:26:52 UTC (rev 8055) +++ trunk/BOOK/general.ent 2009-10-08 10:59:45 UTC (rev 8056) @@ -3,7 +3,7 @@ $Date$ --> -<!ENTITY day "06"> <!-- Always 2 digits --> +<!ENTITY day "08"> <!-- Always 2 digits --> <!ENTITY month "10"> <!-- Always 2 digits --> <!ENTITY year "2009"> <!ENTITY copyrightdate "2001-&year;"> @@ -89,6 +89,7 @@ <!ENTITY sudo-version "1.7.0"> <!ENTITY nss-version "3.12.4"> <!ENTITY policykit-version "0.9"> +<!ENTITY polkit-version "0.94"> <!ENTITY consolekit-version "0.3.0"> <!-- Chapter 5 --> @@ -145,6 +146,7 @@ <!ENTITY dbus-glib-version "0.82"> <!ENTITY dbus-python-version "0.83.0"> <!ENTITY dbus-qt3-version "0.62"> +<!ENTITY eggdbus-version "0.5"> <!ENTITY libpthread-stubs-version "0.1"> <!ENTITY pth-version "2.0.7"> <!ENTITY libassuan-version "1.0.5"> @@ -157,6 +159,9 @@ <!ENTITY libunique-version "1.0.8"> <!ENTITY liboil-version "0.3.16"> <!ENTITY nspr-version "4.8"> +<!ENTITY libffi-version "3.0.8"> +<!ENTITY gobject-introspection-version "0.6.5"> +<!ENTITY gir-repository-version "0.6.5"> <!-- Obsolete <!ENTITY fam-version "2.7.0"> Modified: trunk/BOOK/introduction/welcome/changelog.xml =================================================================== --- trunk/BOOK/introduction/welcome/changelog.xml 2009-10-06 20:26:52 UTC (rev 8055) +++ trunk/BOOK/introduction/welcome/changelog.xml 2009-10-08 10:59:45 UTC (rev 8056) @@ -41,6 +41,27 @@ --> <listitem> + <para>October 8th, 2009</para> + <itemizedlist> + <listitem> + <para>[wblaszcz] - Added new package. polkit-0.94.</para> + </listitem> + <listitem> + <para>[wblaszcz] - Added new package. libffi-3.0.8.</para> + </listitem> + <listitem> + <para>[wblaszcz] - Added new package. gir-repository-0.6.5.</para> + </listitem> + <listitem> + <para>[wblaszcz] - Added new package. gobject-introspection-0.6.5.</para> + </listitem> + <listitem> + <para>[wblaszcz] - Added new package. eggdbus-0.5.</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> <para>September 28th, 2009</para> <itemizedlist> <listitem> Added: trunk/BOOK/postlfs/security/polkit.xml =================================================================== --- trunk/BOOK/postlfs/security/polkit.xml (rev 0) +++ trunk/BOOK/postlfs/security/polkit.xml 2009-10-08 10:59:45 UTC (rev 8056) @@ -0,0 +1,255 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" + "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ + <!ENTITY % general-entities SYSTEM "../../general.ent"> + %general-entities; + + <!ENTITY polkit-download-http "http://hal.freedesktop.org/releases/polkit-&polkit-version;.tar.gz";> + <!ENTITY polkit-download-ftp " "> + <!ENTITY polkit-md5sum "5abc9f858e7b614ef41161db36d53915"> + <!ENTITY polkit-size "986 KB"> + <!ENTITY polkit-buildsize "17 MB"> + <!ENTITY polkit-time "0.3 SBU"> +]> + +<sect1 id="polkit" xreflabel="polkit-&polkit-version;"> + <?dbhtml filename="polkit.html"?> + + <sect1info> + <othername>$LastChangedBy$</othername> + <date>$Date$</date> + </sect1info> + + <title>polkit-&polkit-version;</title> + + <indexterm zone="polkit"> + <primary sortas="a-polkit">polkit</primary> + </indexterm> + + <sect2 role="package"> + <title>Introduction to polkit</title> + + <para>The <application>polkit</application> package is an + application-level toolkit for defining and handling the policy that allows + unprivileged processes to speak to privileged processes.</para> + + <bridgehead renderas="sect3">Package Information</bridgehead> + <itemizedlist spacing="compact"> + <listitem> + <para>Download (HTTP): <ulink url="&polkit-download-http;"/></para> + </listitem> + <listitem> + <para>Download (FTP): <ulink url="&polkit-download-ftp;"/></para> + </listitem> + <listitem> + <para>Download MD5 sum: &polkit-md5sum;</para> + </listitem> + <listitem> + <para>Download size: &polkit-size;</para> + </listitem> + <listitem> + <para>Estimated disk space required: &polkit-buildsize;</para> + </listitem> + <listitem> + <para>Estimated build time: &polkit-time;</para> + </listitem> + </itemizedlist> + + <bridgehead renderas="sect3">polkit Dependencies</bridgehead> + + <bridgehead renderas="sect4">Required</bridgehead> + <para role="required"><xref linkend="eggdbus"/>, + <xref linkend="linux-pam"/>, + <xref linkend="gobject-introspection"/>, and + <xref linkend="DocBook"/></para> + + <bridgehead renderas="sect4">Optional</bridgehead> + <para role="optional"><xref linkend="expat"/> and + <xref linkend="gtk-doc"/></para> + + <para condition="html" role="usernotes">User Notes: + <ulink url="&blfs-wiki;/polkit"/></para> + + </sect2> + + <sect2 role="installation"> + <title>Installation of polkit</title> + + <para>It is a requirement to have a dedicated user and group for + <application>polkit</application> to function correctly. Issue the + following commands as the <systemitem class="username">root</systemitem> + user:</para> + +<screen role="root"><userinput>groupadd -g 27 polkituser && +useradd -c "Policy Kit Daemon User" -d /dev/null \ + -u 27 -g polkituser -s /bin/false polkituser</userinput></screen> + + <para>Install <application>polkit</application> by running the following + commands as an unprivileged user::</para> + +<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc \ + --libexecdir=/usr/lib/polkit-1 --localstatedir=/var && +make</userinput></screen> + + <para>This package does not come with a test suite.</para> + + <para>Now, as the <systemitem class="username">root</systemitem> user:</para> + +<screen role="root"><userinput>make install</userinput></screen> + + </sect2> + + <sect2 role="commands"> + <title>Command Explanations</title> + + <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; + href="../../xincludes/gtk-doc-rebuild.xml"/> + + </sect2> + + <sect2 role="content"> + <title>Contents</title> + + <segmentedlist> + <segtitle>Installed Programs</segtitle> + <segtitle>Installed Libraries</segtitle> + <segtitle>Installed Directories</segtitle> + + <seglistitem> + <seg>pkaction, pkcheck, pk-example-frobnicate, pkexec, + polkit-agent-helper-1, and polkitd</seg> + <seg>libpolkit-agent-1.{so,a}, libpolkit-backend-1.{so,a}, + libpolkit-gobject-1.{so,a}, libnullbackend.{so,a}, and + libpkexec-action-lookup.{so,a}</seg> + <seg>/etc/polkit-1/{localauthority.conf.d,nullbackend.conf.d}, + /usr/{include/polkit-1/{polkit,polkitagent,polkitbackend}, + lib/polkit-1/extensions,share/polkit-1/actions}, + /var/lib/polkit-1/localauthority/{10-vendor.d,20-org.d,30-site.d, + 50-local.d,90-mandatory.d}</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="pkaction"> + <term><command>pkaction</command></term> + <listitem> + <para>is used to obtain information about registered PolicyKit actions.</para> + <indexterm zone="polkit pkaction"> + <primary sortas="b-pkaction">pkaction</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="pkcheck"> + <term><command>pkcheck</command></term> + <listitem> + <para>is used to check whether a process is authorized for action.</para> + <indexterm zone="polkit pkcheck"> + <primary sortas="b-pkcheck">pkcheck</primary> + </indexterm> + </listitem> + </varlistentry> + +<!-- <varlistentry id="pk-example-frobnicate"> + <term><command>pk-example-frobnicate</command></term> + <listitem> + <para>does this .....</para> + <indexterm zone="polkit pk-example-frobnicate"> + <primary sortas="b-pk-example-frobnicate">pk-example-frobnicate</primary> + </indexterm> + </listitem> + </varlistentry>--> + + <varlistentry id="pkexec"> + <term><command>pkexec</command></term> + <listitem> + <para>allows an authorized user to execute a command as another user.</para> + <indexterm zone="polkit pkexec"> + <primary sortas="b-pkexec">pkexec</primary> + </indexterm> + </listitem> + </varlistentry> + +<!-- <varlistentry id="polkit-agent-helper-1"> + <term><command>polkit-agent-helper-1</command></term> + <listitem> + <para>does this .....</para> + <indexterm zone="polkit polkit-agent-helper-1"> + <primary sortas="b-polkit-agent-helper-1">polkit-agent-helper-1</primary> + </indexterm> + </listitem> + </varlistentry>--> + + <varlistentry id="polkitd-0.94"> + <term><command>polkitd</command></term> + <listitem> + <para>provides the org.freedesktop.PolicyKit1 + <application>D-Bus</application> service on the system message bus.</para> + <indexterm zone="polkit polkitd-0.94"> + <primary sortas="b-polkitd">polkitd</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="libpolkit-agent-1"> + <term><filename class='libraryfile'>libpolkit-agent-1.{so,a}</filename></term> + <listitem> + <para>contains the <application>polkit</application> authentication + agent API functions.</para> + <indexterm zone="polkit libpolkit-agent-1"> + <primary sortas="c-libpolkit-agent-1">libpolkit-agent-1.{so,a}</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="libpolkit-backend-1"> + <term><filename class='libraryfile'>libpolkit-backend-1.{so,a}</filename></term> + <listitem> + <para>contains the <application>polkit</application> backend API + functions.</para> + <indexterm zone="polkit libpolkit-backend-1"> + <primary sortas="c-libpolkit-backend-1">libpolkit-backend-1.{so,a}</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="libpolkit-gobject-1"> + <term><filename class='libraryfile'>libpolkit-gobject-1.{so,a}</filename></term> + <listitem> + <para>contains the <application>polkit</application> authorization API + functions.</para> + <indexterm zone="polkit libpolkit-gobject-1"> + <primary sortas="c-libpolkit-gobject-1">libpolkit-gobject-1.{so,a}</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="libnullbackend"> + <term><filename class='libraryfile'>libnullbackend.{so,a}</filename></term> + <listitem> + <para>is an extension library.</para> + <indexterm zone="polkit libnullbackend"> + <primary sortas="c-libnullbackend">libnullbackend.{so,a}</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="libpkexec-action-lookup"> + <term><filename class='libraryfile'>libpkexec-action-lookup.{so,a}</filename></term> + <listitem> + <para>is an extension library.</para> + <indexterm zone="polkit libpkexec-action-lookup"> + <primary sortas="c-libpkexec-action-lookup">libpkexec-action-lookup.{so,a}</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> + +</sect1> Property changes on: trunk/BOOK/postlfs/security/polkit.xml ___________________________________________________________________ Name: svn:keywords + LastChangedBy Date Modified: trunk/BOOK/postlfs/security/security.xml =================================================================== --- trunk/BOOK/postlfs/security/security.xml 2009-10-06 20:26:52 UTC (rev 8055) +++ trunk/BOOK/postlfs/security/security.xml 2009-10-08 10:59:45 UTC (rev 8056) @@ -56,6 +56,7 @@ <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="sudo.xml"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="nss.xml"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="policykit.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="polkit.xml"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="consolekit.xml"/> </chapter> -- http://linuxfromscratch.org/mailman/listinfo/blfs-book FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page
