/usr/share/gtk-doc/html/bonobo-activation/server-xml-reference.html is in libbonobo2-dev 2.32.1-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>.server file format reference</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
<link rel="home" href="index.html" title="Bonobo Activation API Reference Manual">
<link rel="up" href="index.html" title="Bonobo Activation API Reference Manual">
<link rel="prev" href="query-syntax.html" title="Syntax">
<link rel="next" href="attribute-tag.html" title="The oaf_attribute tag">
<meta name="generator" content="GTK-Doc V1.19 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
<td><a accesskey="p" href="query-syntax.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td> </td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">Bonobo Activation API Reference Manual</th>
<td><a accesskey="n" href="attribute-tag.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr></table>
<div class="chapter">
<div class="titlepage"><div><div><h1 class="title">
<a name="server-xml-reference"></a><code class="filename">.server</code> file format reference</h1></div></div></div>
<div class="toc"><dl class="toc">
<dt><span class="sect1"><a href="server-xml-reference.html#server-tag">The <code class="sgmltag-element">oaf_server</code> tag</a></span></dt>
<dt><span class="sect1"><a href="attribute-tag.html">The <code class="sgmltag-element">oaf_attribute</code> tag</a></span></dt>
</dl></div>
<p>
This section describes the format of the <code class="filename">.server</code> files
used by applications to tell the Bonobo Activation daemon about the
interfaces they support.
</p>
<div class="sect1">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="server-tag"></a>The <code class="sgmltag-element">oaf_server</code> tag</h2></div></div></div>
<p>
Here follows a simple example of a minimalist
<code class="filename">.server</code> file.
</p>
<pre class="programlisting">
<oaf_info>
<oaf_server iid="OAFIID:Bonobo_CosNaming_NamingContext"
type="exe"
location="/usr/lib/bonobo-activation/bonobo-activation-server">
</oaf_server>
</oaf_info></pre>
<p>
Each <code class="sgmltag-element">oaf_server</code> entry conventionally has three mandatory
properties:
<span class="emphasis"><em>iid</em></span> (the FAQ of the Bonobo API reference manual
explains how to create an iid),
<span class="emphasis"><em>type</em></span> (can be <span class="emphasis"><em>exe,</em></span>
<span class="emphasis"><em>factory,</em></span> or <span class="emphasis"><em>shlib</em></span>) and
<span class="emphasis"><em>location</em></span>.
</p>
<p>
If the type is <span class="emphasis"><em>exe,</em></span> <span class="emphasis"><em>location</em></span> is
the name of the executable which creates the CORBA interfaces associated to
this entry and registers them to Bonobo Activation.
If the type is <span class="emphasis"><em>factory,</em></span> <span class="emphasis"><em>location</em></span>
is the iid of the component which can create the corresponding CORBA
server.
If the type is <span class="emphasis"><em>shlib,</em></span> <span class="emphasis"><em>location</em></span> is
the name of the library the code is in: <code class="filename">libgmf</code>
for example.
</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Portability Note</h3>
<p>
Don't include the <code class="filename">.so</code> suffix common on Linux
systems in the <span class="emphasis"><em>location</em></span> of a
<span class="emphasis"><em>shlib</em></span> component.
</p>
</div>
<p>
Here follows a simple example of a component activated through a factory:
</p>
<pre class="programlisting">
<oaf_info>
<oaf_server iid="OAFIID:Bonobo_Sample_Echo_Factory" type="exe"
location="/usr/lib/bonobo-2.0/samples/bonobo-echo-2">
</oaf_server>
<oaf_server iid="OAFIID:Bonobo_Sample_Echo" type="factory"
location="OAFIID:Bonobo_Sample_Echo_Factory">
</oaf_server>
</oaf_info></pre>
<p>
If you ask Bonobo Activation to activate the
<code class="classname">OAFIID:Bonobo_Sample_Echo</code> component,
Bonobo Activation will first check if it is a factory, make sure the
corresponding factory compoenent is running (by activating it. Here,
activating the factory component is a matter of launching the executable)
and call <code class="function">create</code> on the factory.
It will return you that object.
</p>
</div>
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.19</div>
</body>
</html>
|