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.






SunOS 5.11          Last change: 07 Nov 2007                    1






User Commands                                activation-client(1)



     --register-iid=iid

         ID 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 OAFID:GNOMEClockApplet

     example% activation-client -q -s "iid == 'OAFID:GNOMEClockApplet'"

     The following output is returned:

      Query spec is "iid == 'OAFID:GNOMEClockApplet'"

            ID OAFID:GNOMEClockApplet,
            type factory,
            location OAFID:GNOMEGenUtilAppletFactory

                  repoids = ["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:otherbinaries = "gnome-panel"






SunOS 5.11          Last change: 07 Nov 2007                    2






User Commands                                activation-client(1)



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

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

     The following output is returned:

     ID OAFID:GNOMECDPlayerApplet,
            type factory,
            location OAFID:GNOMECDPlayerAppletFactory

                  repoids = ["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



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:










SunOS 5.11          Last change: 07 Nov 2007                    3






User Commands                                activation-client(1)



     
           ATRIBUTE TYPE               ATRIBUTE 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          Last change: 07 Nov 2007                    4