activation-client(1)						   User Commands					      activation-client(1)

NAME

       activation-client - bonobo-activation debugging tool

SYNOPSIS

       activation-client  [--ac-ior=ior]  [--add-path=path]  [--do-query]  [--help] [--register-iid=iid] [--register-ior=ior] [--remove-path=path]
       [--spec=spec]

DESCRIPTION

       activation-client is a bonobo-activation debugging tool which may be used to execute queries in the bonobo-activation component server.

       The query format used by bonobo-activation is documented in the developer documentation.

       To access the developer documentation, you must install the developer version of the package.

OPTIONS

       The following options are supported:

       --ac-ior=ior

	   Query the bonobo-activation-server specified by the stringified object reference ior. This option is only useful  to  query	a  bonobo-
	   activation-server  running  as a different user or on a different host. By default, the bonobo-activation-server running as the current
	   user on the current host is used.

       --add-path=path

	   Search path to be added at runtime.

       -q, --do-query

	   Do not activate the matching components; instead, just return the details of the components matching the query.

       -?, --help

	   Show help information on standard output and exit.

       --register-iid=iid

	   IID of the server to be registered.

       --register-ior=ior

	   IOR of the server to be registered.

       --remove-path=path

	   Search path to be removed at runtime.

       -s, -spec=spec

	   Query the bonobo-activation-server with query string spec.

EXAMPLES

       Example 1: Querying for details about a component whose implementation		identifier is OAFIID:GNOME_ClockApplet

       example% activation-client -q -s "iid == 'OAFIID:GNOME_ClockApplet'"

       The following output is returned:

	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"

       Example 2: Querying for details of all the available components that implement the GNOME::Vertigo::PanelAppletShell interface

       example% activation-client -q -s "repo_ids.has ('IDL:GNOME/Vertigo/PanelAppletShell:1.0')"

       The following output is returned:

       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"
       .
       .
       .

EXIT STATUS

       The following exit values are returned:

       0	Application exited successfully

       >0	Application exited with failure

FILES

       The following files are used by this application:

       /usr/bin/activation-client      Executable for bonobo-activation debugging tool

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWgnome-component	   |
       +-----------------------------+-----------------------------+
       |Interface stability	     |Volatile			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       attributes(5), libbonobo-activation(5)

NOTES

       Written by Mark McLoughlin, Sun Microsystems Inc., 2003, 2006, 2007.

SunOS 5.11							    07 Nov 2007 					      activation-client(1)