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

NAME

       activation-client - bonobo-activation debugging tool

SYNOPSIS

       activation-client [--ac-ior=ior] [-q] [-s spec] [--usage] [--help]

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  run-
		       ning as the current user on the current host is used.

       --help	       Show help information on standard output and exit. You can also use -?  to specify this option.

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

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

       --usage	       Display brief usage information.

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 = "gnome-clock.png"
		    panel:category = "Accessories"

       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 = "CD Player"
		    description = "Panel applet for playing audio CDs"
		    panel:category = "Multimedia"
		    panel:icon = "gnome-cdplayer-icon.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-clieExecutable for bonobo-activation debugging tool

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWgnome-component-devel    |
       +-----------------------------+-----------------------------+
       |Interface stability	     |External			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       libbonobo-activation(5), attributes(5)

NOTES

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

SunOS 5.10							    8 Oct 2003						      activation-client(1)