OSF DCE Application Development Guide--Introduction and Style Guide

OSF DCE Application Development Guide—Introduction and Style Guide
Figure 8-1. Managing a Server with a Control Client
Application Server
dced_server_start(...);
/*application-specific control*/
dced_server_stop(...);
Application Control
Client
In addition to starting and stopping the server, dced’s management routines provide other
control operations. For example, the control program can use dced_server_disable_if()
and dced_server_enable_if( ) to disable and reenable specific interfaces offered by the
server. Application-specific management operations can be used to exert even finer
control than is possible with the DCE-provided services.
8.1 Application Support for Server Management
Applications can support server management at three levels. At a minimum, every server
automatically supports the RPC management API (routines the begin with rpc_mgmt_).
By attaching an authorization function to the management interface (via a call to
rpc_mgmt_set_authorizaton_fn( )), a server can set nondefault access to the generic
management functions. Although these routines give a management program some
control of the server, some of these routines only work locally, so the controlling client
must run on the same host as the server.
At the second level, all servers should permit themselves to be managed from remote
hosts via the dced. The requirements in the server’s initialization code are minimal:
• The server should establish a security state using the dce_server_sec_begin() call.
This call establishes the server’s identity with the RPC runtime such that clients can
make authenticated remote procedure calls to it. The call also establishes with the
security service the server’s identity so that it can make authenticated remote
procedure calls to other servers.
Server writers should also give the dced (which runs with the host’s principal
identity) permission to control the server. Since the default is to disable remote
8− 2 Tandem Computers Incorporated 124246