'\" te
.TH activation-client 1 "07 Nov 2007" "SunOS 5.11" "User Commands"
.SH "NAME"
activation-client \- \fBbonobo-activation\fR debugging tool
.SH "SYNOPSIS"
.PP
\fBactivation-client\fR [-\fB-ac-ior=\fIior\fR\fR] [-\fB-add-path=\fIpath\fR\fR] [-\fB-do-query\fR] [-\fB-help\fR] [-\fB-register-iid=\fIiid\fR\fR] [-\fB-register-ior=\fIior\fR\fR] [-\fB-remove-path=\fIpath\fR\fR] [-\fB-spec=\fIspec\fR\fR]
.SH "DESCRIPTION"
.PP
activation-client is a \fBbonobo-activation\fR debugging
tool which may be used to execute queries in the \fBbonobo-activation\fR component server\&.
.PP
The query format used by \fBbonobo-activation\fR is documented
in the developer documentation\&.
.PP
To access the developer documentation, you must install the developer
version of the package\&.
.SH "OPTIONS"
.PP
The following options are supported:
.sp
.ne 2
.mk
\fB-\fB-ac-ior=\fIior\fR\fR\fR
.sp .6
.in +4
Query the \fBbonobo-activation-server\fR specified
by the stringified object reference \fIior\fR\&. This option
is only useful to query a \fBbonobo-activation-server\fR running
as a different user or on a different host\&. By default, the \fBbonobo-activation-server\fR running as the current user on the current host is used\&.
.sp
.sp 1
.in -4
.sp
.ne 2
.mk
\fB-\fB-add-path=\fIpath\fR\fR\fR
.sp .6
.in +4
Search \fIpath\fR to be added at runtime\&.
.sp
.sp 1
.in -4
.sp
.ne 2
.mk
\fB-\fBq\fR, -\fB-do-query\fR\fR
.sp .6
.in +4
Do not activate
the matching components; instead, just return the details of the components
matching the query\&.
.sp
.sp 1
.in -4
.sp
.ne 2
.mk
\fB-\fB?\fR, -\fB-help\fR\fR
.sp .6
.in +4
Show help information on standard output and exit\&.
.sp
.sp 1
.in -4
.sp
.ne 2
.mk
\fB-\fB-register-iid=\fIiid\fR\fR\fR
.sp .6
.in +4
IID of the server to be registered\&.
.sp
.sp 1
.in -4
.sp
.ne 2
.mk
\fB-\fB-register-ior=\fIior\fR\fR\fR
.sp .6
.in +4
IOR of the server to be registered\&.
.sp
.sp 1
.in -4
.sp
.ne 2
.mk
\fB-\fB-remove-path=\fIpath\fR\fR\fR
.sp .6
.in +4
Search \fIpath\fR to be removed at runtime\&.
.sp
.sp 1
.in -4
.sp
.ne 2
.mk
\fB-\fBs\fR, -\fBspec=\fIspec\fR\fR\fR
.sp .6
.in +4
Query the \fBbonobo-activation-server\fR with
query string \fIspec\fR\&.
.sp
.sp 1
.in -4
.SH "EXAMPLES"
.PP
\fBExample 1: Querying for details about a component whose implementation 		 identifier
is OAFIID:GNOME_ClockApplet\fR
.PP
.PP
.nf
example% \fBactivation-client -q -s "iid == \&'OAFIID:GNOME_ClockApplet\&'"\fR
.fi
.PP
The following output is returned:
.PP
.PP
.nf
\f(CW 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"
\fR
.fi
.PP
\fBExample 2: Querying for details of all the available components that implement
the GNOME::Vertigo::PanelAppletShell interface\fR
.PP
.PP
.nf
example% \fBactivation-client -q -s "repo_ids\&.has (\&'IDL:GNOME/Vertigo/PanelAppletShell:1\&.0\&')"\fR
.fi
.PP
The following output is returned:
.PP
.PP
.nf
\f(CWIID 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"
\&.
\&.
\&.\fR
.fi
.SH "EXIT STATUS"
.PP
The following exit values are returned:
.sp
.ne 2
.mk
\fB\fB0\fR\fR
.in +9n
.rt
Application
exited successfully
.sp
.sp 1
.in -9n
.sp
.ne 2
.mk
\fB\fB>0\fR\fR
.in +9n
.rt
Application
exited with failure
.sp
.sp 1
.in -9n
.SH "FILES"
.PP
The following files are used by this application:
.sp
.ne 2
.mk
\fB\fB/usr/bin/activation-client\fR \fR
.in +32n
.rt
Executable for \fBbonobo-activation\fR debugging tool
.sp
.sp 1
.in -32n
.SH "ATTRIBUTES"
.PP
See \fBattributes\fR(5)
for descriptions of the following attributes:
.sp
.TS
tab() allbox;
cw(2.750000i)| cw(2.750000i)
lw(2.750000i)| lw(2.750000i).
ATTRIBUTE TYPEATTRIBUTE VALUE
Availabilitylibrary/gnome/gnome-component
Interface stabilityVolatile
.TE
.sp
.SH "SEE ALSO"
.PP
\fBattributes\fR(5),
\fBlibbonobo-activation\fR(5)
.SH "NOTES"
.PP
Written by Mark McLoughlin, Sun Microsystems Inc\&., 2003, 2006, 2007\&.
...\" created by instant / solbook-to-man, Wed 18 Dec 2013, 18:59