1<h2>ledger_get_remote</h2>
2<hr>
3<p>
4<strong>Function</strong> - Return send right to specified host's remote ledger port.
5<h3>SYNOPSIS</h3>
6<pre>
7<strong>kern_return_t   ledger_get_remote</strong>
8                <strong>(ledger_port_t</strong>                           <var>ledger</var>,
9                 <strong>host_t</strong>                               <var>host_name</var>,
10                 <strong>ledger</strong>                            <var>service_port</var><strong>);</strong>
11
12
13<strong>kern_return_t   ledger_return_remote</strong>
14                <strong>(ledger_port_t</strong>                           <var>ledger</var>,
15                 <strong>host_t</strong>                               <var>host_name</var>,
16                 <strong>ledger</strong>                            <var>service_port</var><strong>);</strong>
17</pre>
18<h3>PARAMETERS</h3>
19<dl>
20<p>
21<dt> <var>ledger</var> 
22<dd>
23[in ledger send right]
24The ledger whose service port is desired.
25<p>
26<dt> <var>host_name</var> 
27<dd>
28[in host-name send right]
29The name for the host requesting the service 
30port.
31<p>
32<dt> <var>service_port</var> 
33<dd>
34[out ledger-service send right]
35The ledger service port.
36</dl>
37<h3>DESCRIPTION</h3>
38<p>
39The <strong>ledger_get_remote</strong> function returns the remote ledger
40service port for the 
41ledger
42<h3>NOTES</h3>
43<p>
44This interface is not implemented in OSF/1 R1.3.
45<p>
46This mechanism supports distributed resource ledgers in the following way:
47<dl>
48<dd>
49With <strong>ledger_set_remote</strong>, a ledger is assigned a remote
50ledger service port.
51<dd>
52This ledger is used as the ledger for a create operation.  
53If the ledger is local to the target kernel, all is fine.
54<dd>
55For a non-local creation, the target kernel sees that the supplied
56ledger is not 
57a local ledger.  The kernel sends a <strong>ledger_get_remote</strong> message to it,
58including the host name.
59<dd>
60The (remote) ledger receives this message, ignores the host name and returns 
61the remote ledger service port.
62<dd>
63Assuming that the remote ledger service port is not a local ledger, the kernel 
64sends a <strong>ledger_get_remote</strong> message to this service port.
65<dd>
66A server receives this request (with the <strong>ledger_return_remote</strong>
67server interface) 
68and uses the identity of the service port as well as the host name of the 
69target kernel to locate or create a suitable ledger on that kernel.
70<dd>
71The port for a ledger on the target kernel is sent to that kernel and used.
72</dl>
73<h3>RETURN VALUES</h3>
74<p>
75Only generic errors apply.
76<h3>RELATED INFORMATION</h3>
77<p>
78Functions:
79<a href="ledger_create.html"><strong>ledger_create</strong></a>,
80<a href="ledger_set_remote.html"><strong>ledger_set_remote</strong></a>.
81