OSF DCE Application Development Style Guide

• Preface
  • Copyright Information

  • Overview

  • Document Usage

  • Related Documents

  • Typographic and Keying Conventions

  • Problem Reporting

  • Path Names of Directories and Files in DCE Documentation

• Introduction to DCE Application Programming
  • Overview - Introduction to DCE Application Programming

  • Development Overview

  • Overview of DCE Application Development Steps

  • DCE Application Development Tools
    • DCE Application Development Tools

    • The DCE UUID Generator

    • DCE Interface Definition Language

    • The DCE IDL Compiler

    • The Attribute Configuration File

    • The DCE Host Daemon

    • The DCE API

    • The DCE Control Program

  • The Interface Definition
    • The Interface Definition

    • Generating the Interface UUID

    • Writing the Interface Definition File

    • Writing the Attribute Configuration File

    • Processing the Files with the IDL Compiler

  • Server Initialization
    • Server Initialization

    • Setting Up for Serviceability

    • Setting Up the Server's Objects
      • Setting Up the Server's Objects

      • Object UUIDs in Bindings

      • Making Object-UUID/Type-UUID Associations

      • Summary of Mechanisms that Rely on Object UUIDs

    • Setting Up Security
      • Setting Up Security

    • Defining the Manager Entry Point Vectors for Each Set of Operations
      • Defining the Manager Entry Point Vectors for Each Set of Operations

    • Registering the Server
      • Registering the Server

      • Registering the Interface, Type UUID, and EPV with RPC Runtime

      • Telling RPC Runtime What Protocol Sequences to Use

      • Registering the Binding Information with the Endpoint Mapper Service

      • Exporting the Binding Information to the Namespace

    • Specifying Multithreadedness
      • Specifying Multithreadedness

    • Listening for Incoming Service Requests
      • Listening for Incoming Service Requests

    • Cleaning Up Code When the Server Terminates
      • Cleaning Up Code When the Server Terminates

      • Unregistering the Server

      • Unexporting from the Namespace

      • Cleaning Up Security Information

  • The Client Binding and RPC Invocation
    • The Client Binding and RPC Invocation

    • Importing the Binding Information from the Namespace
      • Importing the Binding Information from the Namespace

      • Getting a Handle

      • Determining the Entry Name

      • Binding Compatibility

    • Annotating the Binding Handle for Security
      • Annotating the Binding Handle for Security

      • Preparation

      • Setting Up for Authenticated RPC

    • Invoking Remote Procedure Calls
      • Invoking Remote Procedure Calls

      • The Possibility of Binding Failure

      • The Result of Successful Binding

  • The Server's Manager of RPC Requests
    • The Server's Manager of RPC Requests

    • Getting the Client's Credentials

    • Getting the Object's ACL

    • Making the Authorization Decision

    • Servicing the RPC Request

    • Returning the Results and Resuming Listening
      • Returning the Results and Resuming Listening

      • Continuing

  • About DCE Programming Style
    • About DCE Programming Style

    • Mechanism, Policy, and Style

    • Policy and Style Issues

    • General Policies

• Threads
  • Overview - Threads

  • Thread Use Policy
    • Thread Use Policy

    • Choosing to Thread

    • Specifying the Number of Threads

    • Scheduling Policies

  • Thread Safety
    • Thread Safety

  • Threads Programming Topics
    • Threads Programming Topics

    • Thread Handles

    • Storage for Thread Specific Data

    • Canceling Threads
      • Canceling Threads

      • Cancelability State

      • Cancellation Points

      • Cancellation Side Effects

      • Thread Cleanup

      • Asynchronous Cancel Safety

      • Cancel Rules Summary

    • Signals
      • Signals

      • Signal Masking

      • Synchronous Signal Handling

      • Asynchronous Signal Handling

      • Signal Rules

    • Forking in a Threaded Application
      • Forking in a Threaded Application

  • RPC Threads and RPC Cancel Semantics
    • RPC Threads and RPC Cancel Semantics

• Security
  • Overview - Security

  • The Basic Security Model

  • Application Roles

  • Authentication Model
    • Authentication Model

    • The DCE Authentication Model

    • Application-Level Authentication

    • Obtaining an Authentication Identity

    • The Authenticated RPC Call

    • Managing Keys

    • Default Server Authentication Steps
      • Default Server Authentication Steps

      • The managekey Routine

      • The server_get_identity Routine

      • The server_renew_identity Routine

    • Default Client Authentication Step
      • Default Client Authentication Step

      • The is_valid_principal Routine

  • Authorization
    • Authorization

    • Client Credential

    • Access Control Lists
      • Access Control Lists

      • Permissions Semantics Recommendations

    • ACL Managers
      • ACL Managers

      • Who Does What?

      • The Requirements

      • What is an Object?

      • Why Three Databases?

      • Object Name Resolution Routine

      • What is an ACL Manager?

      • Why Two ACL Managers?

      • How the ACL Library Routines Extract and Evaluate ACLs

      • Backing Store Database Items and Headers

      • Object-Indexed Store

      • Name-Indexed Store

      • ACL UUID-Indexed Store

      • ACL Manager Coding Example

      • Data Definitions

      • The server_get_local_principal_id Routine

      • The server_create_acl Routine

      • The server_store_acl Routine

      • The server_acl_mgr_setup Routine

      • The server_acl_mgr_close Routine

      • The server_rdacl_export Routine

      • The server_rdacl_cleanup Routine

      • The sample_mgmt_auth Routine

      • The sample_resolve_by_name Routine

• Binding
  • Overview - Binding

  • The Binding Model
    • The Binding Model

    • Server Binding Model

    • Client Binding Model

    • Call Routing

    • Routing Policy

  • Binding Handles
    • Binding Handles

  • Binding Methods
    • Binding Methods

• Using the DCE Name Service
  • Overview - Using the DCE Name Service

  • Introduction to Using NSI
    • Introduction to Using NSI

    • The UUID

    • Object UUIDs

    • Interface UUIDs

    • Summary: Names and UUIDs

  • Binding to an Object
    • Binding to an Object

  • Junctions
    • Junctions

    • A Junction Example

    • Junctions and the ACL Editor

  • Name Service Terminology
    • Name Service Terminology

    • CDS Entries

    • CDS Entry Attributes

  • Binding
    • Binding

    • Importing and Exporting Bindings

    • Summary

  • Partial Binding and the Endpoint Mapper
    • Partial Binding and the Endpoint Mapper

  • Interface Ambiguity and Partial Bindings
    • Interface Ambiguity and Partial Bindings

  • Using Object UUIDs to Avoid Binding Ambiguity
    • Using Object UUIDs to Avoid Binding Ambiguity

  • An Object-Oriented Namespace
    • An Object-Oriented Namespace

  • Setting Up an Object-Oriented Namespace
    • Setting Up an Object-Oriented Namespace

  • Groups and Profiles
    • Groups and Profiles

    • Group Entries

    • Profiles

    • Summary of Namespace Entry Types

  • Three Models for Accessing Binding Information
    • Three Models for Accessing Binding Information

    • Access By Services

    • Access By Servers

    • Access By Objects

    • Summary of Binding Models

  • Models Based on Non-CDS Databases
    • Models Based on Non-CDS Databases

    • Example of a Privately Managed Database

    • Combining Models

  • An Object-Oriented Model with Grouped Binding Information
    • An Object-Oriented Model with Grouped Binding Information

  • Server and Client Steps
    • Server and Client Steps

    • Server Export

    • Client Import

  • Global Organization of the Namespace
    • Global Organization of the Namespace

• RPC Parameters
  • Overview - RPC Parameters

  • Execution Semantics

  • Parameter Semantics
    • Parameter Semantics

    • Parameter Memory Management

    • Client Side Allocation

    • Server Side Allocation

  • RPC Data Types
    • RPC Data Types

    • IDL to C Type Mappings

    • Character Handling

    • Pointers
      • Pointers

      • Memory Allocation Routines

      • Pointer Types

      • Pointer Examples

    • Context Handles
      • Context Handles

    • Arrays
      • Arrays

    • Structures and Unions
      • Structures and Unions

    • Pipes
      • Pipes

    • The transmit_as Attribute
      • The transmit_as Attribute

• Errors and Messaging
  • Overview - Errors and Messaging

  • Error Handling

  • Messaging Facilities
    • Messaging Facilities

    • DCE Errors and DCE Messages

    • DCE Application Message APIs

  • Serviceability and Logging
    • Serviceability and Logging

  • Sample Code
    • Sample Code

• Object-Oriented Applications with Distributed Objects
  • Overview - Object-Oriented Applications with Distributed Objects

  • Kinds of Objects

  • Reference Counting: How Objects Keep Track of Multiple Clients

  • Using Interface Definitions to Design Classes
    • Using Interface Definitions to Design Classes

    • Using Static Functions in Interface Design

    • Adding an Interface Rather than Changing One

  • Binding to Distributed Objects Rather than Servers
    • Binding to Distributed Objects Rather than Servers

  • Clients Manipulate Objects Maintained on Servers
    • Clients Manipulate Objects Maintained on Servers

  • Naming Objects
    • Naming Objects

• Server Management
  • Overview - Server Management

  • Application Support for Server Management

  • Manager Initialization

• A Sample Application
  • Overview - A Sample Application

  • The Generic Server

  • Object Bind Interface

  • Manager and Client Illustrations

  • Message (sams) File

  • Makefile