Refencing (RPC) memory manager

[Luke Kenneth Casson Leighton]

> >or rather, as much of it as we need to make it convenient to write
> >services and clients, and if in the process we happen to make it
> >convenient for other people to write services and clients, so much
> >the better.
> 
> OK, so we'll need to implement (or a subset, or more):
> 
> // stub support
> rpc_ss_allocate() // automatically freed in the rpc server when call
> completes
> rpc_ss_free()

dunno.
 
> // uuid
> uuid_create_nil()
> uuid_create()
> uuid_from_string()
> uuid_to_string()
> uuid_is_nil()
> uuid_equal()
> uuid_compare()
> uuid_hash()

convenience fns.
 
> // binding
> rpc_binding_copy()
> rpc_binding_free()
> rpc_binding_reset()
> rpc_binding_inq_object()
> rpc_binding_set_object()

dunno.

> rpc_binding_inq_auth_info()

obtain info at the *server* end about the authentication performed by the
client.  e.g. you can confirm that 40-bit NTLMSSP with NTLMv2 auth was
performed but that no sign or seal was negotiated.

> rpc_binding_inq_auth_client()


> rpc_binding_set_auth_info()
> rpc_binding_vector_free()
> rpc_binding_server_from_client()
> rpc_binding_from_string_binding()
> rpc_binding_to_string_binding()
> rpc_server_inq_bindings()
> rpc_string_binding_compose()
> rpc_string_binding_parse()

hmm.

> // general/string
> rpc_string_free()
> dce_error_inq_text()
> 
> // protocol sequence
> rpc_network_is_protseq_valid()
> rpc_network_inq_protseqs()
> rpc_protseq_vector_free()
> rpc_server_use_protseq()
> rpc_server_use_all_protseqs()
> rpc_server_use_protseq_ep()
> rpc_server_use_protseq_if()
> rpc_server_use_all_protseqs_if()

dunno.

> // interface information
> rpc_if_inq_id()
> rpc_if_register_auth_info()
> rpc_if_id_vector_free()
> rpc_server_register_if()
> rpc_server_unregister_if()
> rpc_server_inq_if()

transport syntax?
 
> // endpoints
> rpc_ep_register()
> rpc_ep_register_no_replace()
> rpc_ep_unregister()
> rpc_ep_resolve_binding()
> 
> // authentication
> rpc_server_register_auth_info()

ah ha!  that's the equivalent of... of... add_srv_auth_fns() - see
netlogond/netlogond.c as an example.
 
> // listen
> rpc_server_listen()

fairly obvious, although i am not so sure :)

> // object type
> rpc_object_set_type()
> rpc_object_inq_type()
> rpc_object_set_inq_fn()

dunno.

> Comments?

more comments!