Previous section.

DCE 1.1: Authentication and Security Services
Copyright © 1997 The Open Group

NAME

rs_ns_entry_validate-Validate that this server can use "name" as its nameservice entry

SYNOPSIS

void rs_ns_entry_validate (
    unsigned_char_p_t       name,
    uuid_p_t                cell_sec_id,
    uuid_p_t                rep_id,
    rpc_binding_vector_p_t  svr_bindings,
    rpc_if_handle_t         ifspec,
    error_status_t          *status
);

PARAMETERS

Input/Output

name

The string name associated with this registry database entry

cell_sec_id

The well-known cell security id (of this cell)

rep_id

The replica id for this entry

svr_bindings

The server binding tower associated with this entry

ifspec

The interface specification for this entry

status

Completion status.

Output

status

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

DESCRIPTION

The rs_ns_entry_validate() routine gets the nameservice entry's data associated with name. This data consists of the server bindings and replica id associated with name, cell's security id (cell_sec_id), and interface specification (ifspec).

If there is no entry associated with name (the nameservice entry does not exist), then this routine returns with error_status_ok. If an entry exists, then it is checked to verify that it isn't someone else's entry (the bindings for the replica id, rep_id, are checked to ensure they are the bindings expected). If this is the correct entry, this routine returns with error_status_ok.

If the entry associated with name is does not have the expected bindings (it is someone else's entry), then this routine returns with status (non-zero) not equal error_status_ok.

RETURN VALUES

The routine returns error_status_ok if it is okay for the nameservice to use "name" as its nameservice entry. It also returns error_status_ok if the entry ("name") does not exist.

ERRORS

!error_status_ok

Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.

Contents Next section Index