<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!ENTITY cmd "activation-client">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY suncopy "Copyright (c) 2003,2006,2007 Sun Microsystems, Inc. All Rights Reserved.">
]>
<?Pub UDT _bookmark _target>
<?Pub Inc>
<refentry id="activation-client-1">
<!-- %Z%%M% %I% %E% SMI; -->
<refmeta><refentrytitle>activation-client</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">07 Nov 2007</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&release;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
</refmeta>
<indexterm><primary>activation-client</primary></indexterm><indexterm><primary>
bonobo-activation debugging tool</primary></indexterm>
<refnamediv id="activation-client-1-name"><refname>activation-client</refname>
<refpurpose><filename>bonobo-activation</filename> debugging tool</refpurpose>
</refnamediv>
<refsynopsisdiv id="activation-client-1-synp"><title>&synp-tt;</title>
<cmdsynopsis><command>&cmd;</command>
<arg choice="opt"><option>-ac-ior=<replaceable>ior</replaceable></option></arg>
<arg choice="opt"><option>-add-path=<replaceable>path</replaceable></option></arg>
<arg choice="opt"><option>-do-query</option></arg>
<arg choice="opt"><option>-help</option></arg>
<arg choice="opt"><option>-register-iid=<replaceable>iid</replaceable></option></arg>
<arg choice="opt"><option>-register-ior=<replaceable>ior</replaceable></option></arg>
<arg choice="opt"><option>-remove-path=<replaceable>path</replaceable></option></arg>
<arg choice="opt"><option>-spec=<replaceable>spec</replaceable></option></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1 id="activation-client-1-desc"><title>&desc-tt;</title>
<para>activation-client is a <filename>bonobo-activation</filename> debugging
tool which may be used to execute queries in the <filename>bonobo-activation
</filename> component server.</para>
<para>The query format used by <filename>bonobo-activation</filename> is documented
in the developer documentation.</para>
<para>To access the developer documentation, you must install the developer
version of the package.</para>
</refsect1>
<refsect1 id="activation-client-1-opts"><title>&opts-tt;</title>
<para>The following options are supported:</para>
<variablelist termlength="wholeline">

<varlistentry><term><option>-ac-ior=<replaceable>ior</replaceable></option></term>
<listitem><para>Query the <filename>bonobo-activation-server</filename> specified
by the stringified object reference <replaceable>ior</replaceable>. This option
is only useful to query a <filename>bonobo-activation-server</filename> running
as a different user or on a different host. By default, the <filename>bonobo-activation-server
</filename> running as the current user on the current host is used.</para>
</listitem></varlistentry>

<varlistentry><term><option>-add-path=<replaceable>path</replaceable></option></term>
<listitem><para>Search <replaceable>path</replaceable> to be added at runtime.</para>
</listitem></varlistentry>

<varlistentry><term><option>q</option>, <option>-do-query</option></term><listitem><para>Do not activate
the matching components; instead, just return the details of the components
matching the query.</para>
</listitem></varlistentry>

<varlistentry><term><option>?</option>, <option>-help</option></term><listitem><para>
Show help information on standard output and exit.
</para>
</listitem></varlistentry>

<varlistentry><term><option>-register-iid=<replaceable>iid</replaceable></option></term>
<listitem><para>IID of the server to be registered.</para>
</listitem></varlistentry>

<varlistentry><term><option>-register-ior=<replaceable>ior</replaceable></option></term>
<listitem><para>IOR of the server to be registered.</para>
</listitem></varlistentry>

<varlistentry><term><option>-remove-path=<replaceable>path</replaceable></option></term>
<listitem><para>Search <replaceable>path</replaceable> to be removed at runtime.</para>
</listitem></varlistentry>

<varlistentry><term><option>s</option>, <option>spec=<replaceable>spec</replaceable></option></term>
<listitem><para>Query the <filename>bonobo-activation-server</filename> with
query string <replaceable>spec</replaceable>.</para>
</listitem></varlistentry>

</variablelist></refsect1>
<refsect1 id="activation-client-1-exam"><title>&exam-tt;</title>
<example role="example">
<title>Querying for details about a component whose implementation 		 identifier
is OAFIID:GNOME_ClockApplet</title>
<para><screen>example% <userinput>&cmd; -q -s "iid == 'OAFIID:GNOME_ClockApplet'"
</userinput></screen></para>
<para>The following output is returned:</para>
<para><screen><computeroutput> Query spec is "iid == 'OAFIID:GNOME_ClockApplet'"

	  IID OAFIID:GNOME_ClockApplet,
	  type factory,
	  location OAFIID:GNOME_GenUtilApplet_Factory

             repo_ids = ["IDL:GNOME/Vertigo/PanelAppletShell:1.0",
			 "IDL:Bonobo/Control:1.0",
			 "IDL:Bonobo/Unknown:1.0"]
             name = "Clock"
             description = "Get the current time and date"
             panel:icon = "clock.png"
             bugzilla:bugzilla = "GNOME"
             bugzilla:product = "gnome-panel"
             bugzilla:component = "Clock Applet"
             bugzilla:other_binaries = "gnome-panel"

</computeroutput></screen></para>
</example>
<example role="example">
<title>Querying for details of all the available components that implement
the GNOME::Vertigo::PanelAppletShell interface</title>
<para><screen>example% <userinput>&cmd; -q -s "repo_ids.has ('IDL:GNOME/Vertigo/PanelAppletShell:1.0')"
</userinput></screen></para>
<para>The following output is returned:</para>
<para><screen><computeroutput>IID OAFIID:GNOME_CDPlayerApplet,
	  type factory,
	  location OAFIID:GNOME_CDPlayerApplet_Factory

             repo_ids = ["IDL:GNOME/Vertigo/PanelAppletShell:1.0",
			 "IDL:Bonobo/Control:1.0",
			 "IDL:Bonobo/Unknown:1.0"]
             name = "CpuFreq Monitor"
             description = "Monitor and change your CPU speed"
             panel:category = "Utility"
             panel:icon = "emifreq-applet/emifreq-applet.png"
.
.
.</computeroutput></screen></para>
</example>
</refsect1>
<refsect1 id="activation-client-1-exit"><title>&exit-tt;</title>
<para>The following exit values are returned:</para>
<variablelist termlength="xtranarrow">
<varlistentry><term><returnvalue>0</returnvalue></term><listitem><para>Application
exited successfully</para>
</listitem></varlistentry>
<varlistentry><term><returnvalue>>0</returnvalue></term><listitem><para>Application
exited with failure</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1 id="activation-client-1-file"><title>&file-tt;</title>
<para>The following files are used by this application:</para>
<variablelist termlength="wide">
<varlistentry><term><filename>/usr/bin/&cmd;</filename> </term><listitem>
<para>Executable for <filename>bonobo-activation</filename> debugging tool
</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1 id="activation-client-1-attr"><title>&attr-tt;</title>
<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>
<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>
for descriptions of the following attributes:</para>
<informaltable frame="all">
<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">
<colspec colname="COLSPEC1" colwidth="1*">
<thead>
<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"
valign="middle">ATTRIBUTE VALUE</entry></row>
</thead>
<tbody>
<row><entry><para>Availability</para></entry><entry><para>library/gnome/gnome-component
</para></entry></row>
<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry
colname="COLSPEC1"><para>Volatile</para></entry></row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="activation-client-1-also"><title>&also-tt;</title>
<!--Reference to another man page-->
<!--Reference to a Help manual-->
<!--Reference to a book.-->
<para>
<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>libbonobo-activation</refentrytitle><manvolnum>5</manvolnum></citerefentry>
</para>
</refsect1>
<refsect1 id="activation-client-1-note"><title>&note-tt;</title>
<para>Written by Mark McLoughlin, Sun Microsystems Inc., 2003, 2006, 2007.</para>
</refsect1>
</refentry>
