Name

dced_secval_start - Starts the security validation service of a specific host’s dced

Synopsis

#include <dce/dced.h> void dced_secval_start(
dced_binding_handle_t dced_bh,
error_status_t ∗status);

Parameters

Input

dced_bhSpecifies the dced binding handle for the secval service on a specific host. 

Output

statusReturns the status code from this routine.  This status code indicates whether the routine completed successfully or, if not, why not. 

Description

The dced_secval_start() routine starts the security validation service of a specific host’s dced.  This routine is typically used by management applications. 

The security validation service (secval) has two major functions:

       •Maintains a login context for the host’s self identity. 

       •Validates and certifies to applications (usually login programs) that the DCE security daemon (secd) is legitimate. 

The secval program is commonly started by default when dced starts.  See the dced_secval_stop() routine for a discussion of when to use the combination of dced_secval_stop() and dced_secval_start(). 

Prior to calling this routine, the application must have established a valid dced binding handle to the secval service by calling either the dced_binding_create() or dced_binding_from_rpc_binding() routine. 

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. 

error_status_ok

dced_s_bad_binding

dced_s_sv_already_enabled

sec_acl_invalid_permission

Related Information

Commands: dced(8dce), the secval(8dce) object of dcecp. 

Functions: dced_binding_create(3dce), dced_binding_from_rpc_binding(3dce), dced_secval_stop(3dce). 

Books: OSF DCE Application Development Guide.