PreviousNext

sec_rgy_site_open_update(3sec)

Binds to a registry update site

Synopsis

#include <dce/binding.h>

void sec_rgy_site_open_update(

unsigned_char_t *site_name,
sec_rgy_handle_t *context,
error_status_t *status);

Parameters

Input

site_name
A character string (type unsigned_char_t) specifying the security server to bind to in one of the following forms:

· To bind to an arbitrary security server site in a named cell, specify a cell name (for example, /.../r_d.com or /.: for the local cell)

· To start the search for the update site at a specific replica in the replica's cell, specify either the cell name and the server name (for example, /.../r_d.com/subsys/dce/sec/rs_server_250_2) or the server's network address (for example, ncadg_ip_udp:15.22.144.248). If the server name is not valid, the routine binds to an arbitrary security site in the named cell.

Note that the routine ignores anything after the cellname that does not refer to an item in the Cell Directory Service (CDS) namespace. If the specified CDS namespace item does not resolve to a security server, the call fails.

Output

context
A pointer to a sec_rgy_handle_t variable. Upon return, this contains a registry server handle indicating (bound to) the desired registry site.

status
A pointer to the completion status. On successful completion, the routine returns error_status_ok. Otherwise, it returns an error.

Description
The sec_rgy_site_open_update( ) routine binds to a registry update site. A registry update site is a master server that may control several satellite (query) servers. To change the registry database, it is necessary to change a registry update site, which then automatically updates its associated query sites. No changes can be made directly to a registry query database.

The site_name parameter identifies either the cell in which to find the update site or the replica at which to start the search for the update site. If site_name is NULL, or a zero-length string, an update site in the local cell is selected by the client agent.

The handle for the associated registry server is returned in context. The handle is to an update site. Use this registry context handle in subsequent calls that update or query the registry database (for example, the sec_rgy_pgo_add( ) or sec_rgy_acct_lookup( ) call). The caller must have established a valid network identity for this call to succeed.

Notes
To bind to a registry update site, the use of the sec_rgy_site_bind_update( ) call is recommended in place of this call.

Files

/usr/include/dce/binding.idl
The idl file from which dce/binding.h was derived.

Errors

The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.

sec_login_s_no_current_context
The caller does not have a valid network login context.

sec_rgy_server_unavailable
The DCE Registry Server is unavailable.

error_status_ok
The call was successful.

Related Information
Functions:

sec_intro(3sec)

sec_rgy_site_close(3sec)

sec_rgy_site_get(3sec)

sec_rgy_site_is_readonly(3sec)

sec_rgy_site_open(3sec)

sec_rgy_site_open_query(3sec)