test

Federated Naming Service Programming Guide

Preface

The Federated Naming Service (FNS) is new to the SolarisTM product family. FNS is a set of application programming interfaces and policies that allow applications to use a common set of names and policies over different name services.

FNS is not a replacement for NIS+, the network name service included in the Solaris software environment. Rather, FNS is implemented on top of NIS+ and allows you to use a set of common names with desktop applications. SunSoft.'s implementation of FNS conforms to the X/OpenTM federated naming (XFN) specification.

Who Should Use This Book

The primary audience of Federated Naming Service Guide is software developers who write distributed applications. Use of this guide assumes basic competence in programming, a working familiarity with the C programming language, and a working familiarity with the UNIX® operating system. Developers should read all four parts of this manual.

System and network administrators should look at Solaris Naming Setup and Configuration Guide for FNS setup and configuration information. Information on FNS administratiuon is in Solaris Naming Administration Guide. This manual does not cover NIS+ or the Domain Name System (DNS) except as they relate to FNS.

How This Book Is Organized

Chapter 1, Introduction to the Federated Naming Service (FNS) is a high-level overview of FNS and the problems it addresses.

Chapter 2, Interfaces for Writing XFN Applications describes the client programming interfaces for X/Open Federated Naming (XFN).

Chapter 3, XFN Programming Examples presents three self-contained executable programs: a namespace browser, a printer client and server, and a tool to populate attributes of users.

Appendixes

Appendix A, XFN Composite Names describes the XFN composite name string syntax and the resolution techniques for composite names.

Appendix B, XFN Composite Names Syntax gives supplemental information about composite name syntax.

Related Books

With the exception of the XFN specification, the following books do not specifically cover FNS but they provide a good background on how name services work in client-server computing:

You may also want to reference the following AnswerBook® on-line documentation:

Ordering Sun Documents

The SunDocsSM program provides more than 250 manuals from Sun Microsystems, Inc. If you live in the United States, Canada, Europe, or Japan, you can purchase documentation sets or individual manuals using this program.

What Typographic Changes and Symbols Mean

The following table describes the typographic changes used in this book.

Table P-1 Typographic Conventions

Typeface or Symbol 

Meaning 

Example 

AaBbCc123

The names of commands, files, and directories; on-screen computer output 

Edit your .login file.

Use ls -a to list all files.

machine_name% You have mail.

 

AaBbCc123

What you type, contrasted with on-screen computer output 

 

machine_name% su


Password:

AaBbCc123

Command-line placeholder: 

replace with a real name or value 

To delete a file, type rm filename.

AaBbCc123

Book titles, new words or terms, or words to be emphasized 

Read Chapter 6 in User's Guide. These are called class options.

You must be root to do this.

Shell Prompts in Command Examples

The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Table P-2 Shell Prompts

Shell 

Prompt 

C shell prompt 

machine_name%

C shell superuser prompt 

machine_name#

Bourne shell and Korn shell prompt 

$

Bourne shell and Korn shell superuser prompt 

#