Index (Federated Naming Service Programming Guide)

Federated Naming Service Programming Guide


Numbers and Symbols

	. (dots)
		... namespace identifier ( )
		/... namespace identifier ( )

	\| (pipe) in BNF notation ( ) ( )

	" (quotation marks)
		BNF notation ( ) ( )
		XFN composite name syntax ( )
		XFN standard syntax model ( )

	' (single quote) in XFN composite name syntax ( )

	/ (slashes)
		/... namespace identifier ( )
		XFN component separator ( ) ( ) ( )

	* in BNF notation ( ) ( )

	+ in BNF notation ( ) ( )

	0 value ( )

	{} (curly braces) in BNF notation ( ) ( )

	::= in BNF notation ( ) ( )


A

	abstract data types ( )

	addresses
		multiple ( )
		references ( )
		XFN interface parameters ( ) ( )

	administration
		FNS on NIS+
			FNS context management ( ) ( )

	API usage model ( )

	application programming
		namespace browser example ( )
			code ( )
			commands ( )
			diagram ( )
			sample output ( )
		printer example ( )
			client ( )
			server ( )
		XFN composite names ( )
			naming system boundaries and component separators ( ) ( )
			resolution ( ) ( )
			syntax ( ) ( )
		XFN interfaces ( )
			abstract data types ( )
			base attribute interface ( ) ( ) ( )
			base context interface ( ) ( )
			conventions ( )
			memory management policies ( )
			overview ( ) ( )
			parameters ( ) ( )
			parsing compound names ( )
			status codes ( ) ( )
			status objects ( ) ( ) ( )
			usage ( )

	applications
		API usage model ( )
		FNS implementation ( )
		FNS interaction ( ) ( )
		name services ( ) ( )

	architectural model ( )
		attributes ( )
		composite names ( ) ( )
		compound names ( ) ( )
		contexts ( )
		initial context ( )
		references ( )
		XFN links ( )

	as XFN component escape character ( )

	ASCII string XFN identifier format ( )

	asterisk (*) in BNF notation ( ) ( )

	atomic names
		in compound names ( )
		in contexts ( )

	attribute-modification lists ( )

	attribute operations
		attribute-modification operations ( )
		get attribute ( ) ( )
		get attribute identifiers ( )
		get attribute values ( )
		get multiple attributes ( ) ( )
		modify attribute ( )
		modify multiple attributes ( )
		multiple-attribute operations ( ) ( ) ( )
		relationship to naming operations ( ) ( )
		single-attribute operations ( ) ( )
		status objects ( )
		XFN attribute model ( ) ( )

	attributes
		adding attributes or values ( )
		base attribute interface ( ) ( ) ( )
			attribute-modification operations ( )
			multiple-attribute operations ( ) ( ) ( )
			relationship to naming operations ( ) ( )
			single-attribute operations ( ) ( )
			status objects ( )
			supporting interfaces ( ) ( ) ( )
			XFN attribute model ( ) ( )
		described ( )
		getting ( ) ( )
			identifiers ( )
			multiple attributes ( ) ( )
			syntax attributes of context ( )
			values ( )
		sets ( )
		syntax attributes ( ) ( )
			getting ( )
		XFN interface parameters ( )
		XFN model ( ) ( )


B

	backslash () as XFN component escape character ( )

	Backus-Naur Form (BNF) ( ) ( ) ( ) ( )

	base attribute interface ( ) ( ) ( )
		abstract data types ( )
		attribute-modification operations ( )
		conventions ( )
		memory management policies ( )
		multiple-attribute operations ( ) ( ) ( )
		parameters ( ) ( )
			attribute modification lists ( )
			attribute sets ( )
			attributes and attribute values ( )
			composite names ( )
			identifiers ( )
			references and addresses ( ) ( )
			strings ( )
		parsing compound names ( )
			syntax attributes ( ) ( )
			XFN standard syntax model ( ) ( )
		relationship to naming operations ( ) ( )
		single-attribute operations ( ) ( )
		status objects ( )
		supporting interfaces ( ) ( ) ( )
		usage ( )
		XFN attribute model ( ) ( )

	base context interface ( )
		abstract data types ( )
		context handles ( ) ( )
		conventions ( )
		lookup and list contexts ( ) ( )
		managing contexts ( ) ( )
		memory management policies ( )
		names in context operations ( )
		other context operations ( ) ( )
		parameters ( ) ( )
			attribute modification lists ( )
			attribute sets ( )
			attributes and attribute values ( )
			composite names ( )
			identifiers ( )
			references and addresses ( ) ( )
			strings ( )
		parsing compound names ( )
			syntax attributes ( ) ( )
			XFN standard syntax model ( ) ( )
		requirements for operations ( ) ( )
		status objects ( )
		supporting interfaces ( ) ( )
		updating bindings ( ) ( )
		usage ( )

	begin-quote (") in XFN standard syntax model ( )

	bind/lookup model ( )

	bindings
		adding ( )
		initial context bindings for enterprise naming ( )
			example ( )
			table ( )
		listing names and bindings in contexts ( )
		removing
			terminal atomic name ( ) ( )
		renaming ( )
		updating ( ) ( )

	BNF (Backus-Naur Form) ( ) ( ) ( ) ( )

	boundaries (naming system) and component separators ( ) ( )
		strong separation ( )
		weak separation ( ) ( )

	browsing
		namespace browser programming example ( )
			code ( )
			commands ( )
			diagram ( )
			sample output ( )


C

	client programming interfaces ( )
		abstract data types ( )
		base attribute interface ( ) ( ) ( )
			attribute-modification operations ( )
			multiple-attribute operations ( ) ( ) ( )
			relationship to naming operations ( ) ( )
			single-attribute operations ( ) ( )
			status objects ( )
			XFN attribute model ( ) ( )
		base context interface ( ) ( )
			context handles ( ) ( )
			lookup and list contexts ( ) ( )
			managing contexts ( ) ( )
			names in context operations ( )
			other context operations ( ) ( )
			requirements for operations ( ) ( )
			status objects ( )
			updating bindings ( ) ( )
		conventions ( )
		memory management policies ( )
		overview ( ) ( )
		parameters ( ) ( )
			attribute modification lists ( )
			attribute sets ( )
			attributes and attribute values ( )
			composite names ( )
			identifiers ( )
			references and addresses ( ) ( )
			strings ( )
		parsing compound names ( )
			syntax attributes ( ) ( )
			XFN standard syntax model ( ) ( )
		status codes ( ) ( )
		status objects ( )
			base attribute interface ( )
			base context interface ( )
		supporting interfaces ( ) ( )
		usage ( )

	codes
		attribute-modification operation ( )
		link status ( )
		status ( ) ( )

	commands
		fnbrowse program ( )
		XFN interface function names ( )

	component separator (/)
		naming system boundaries and ( ) ( )
			strong separation ( )
			weak separation ( ) ( )
		XFN composite name syntax ( ) ( )
		XFN standard syntax model ( )

	composing XFN composite name strings ( ) ( ) ( ) ( )

	composite names
		applications' use of FNS ( )
		defined ( ) ( )
		examples
			hosts ( )
			illustration ( )
			organizations ( )
			sites ( )
			user ( )
		host naming systems ( )
		organization naming systems ( )
		parsing XFN composite names ( ) ( ) ( ) ( )
		resolution ( ) ( )
			coexistence of explicit and implicit NNSPs ( )
			explicit NNSPs ( ) ( )
			implicit NNSPs ( ) ( )
			XFN links ( )
		site naming systems ( )
		user naming systems ( )
		XFN composite names ( )
			naming system boundaries and component separators ( ) ( )
			resolution ( ) ( )
			syntax ( ) ( ) ( ) ( ) ( )
		XFN context implementation ( )
		XFN interface parameters ( )
		XFN syntax ( ) ( ) ( ) ( ) ( )
			Backus-Naur Form (BNF) ( ) ( ) ( ) ( )
			composing the composite name string ( ) ( ) ( ) ( )
			decomposing the composite name string ( ) ( ) ( ) ( )
			encoding ( ) ( ) ( ) ( )
			string and structural forms ( ) ( )

	compound names ( ) ( )
		described ( )
		hierarchical naming system examples ( ) ( )
		parsing ( )
			syntax attributes ( ) ( )
			XFN standard syntax model ( ) ( )

	const parameters ( )

	const pointers ( )

	constants, XFN interface conventions ( )

	context operations
		bind ( )
		construct context handle from reference ( ) ( )
		construct handle to initial context ( )
		context handles ( ) ( )
		create subcontext ( ) ( )
		destroy context handle ( )
		destroy subcontext ( )
		get reference to context ( )
		get syntax attributes of context ( )
		list bindings ( )
		list names ( ) ( )
		lookup ( )
		lookup link ( ) ( )
		managing contexts ( ) ( )
		names in ( )
		rename ( )
		requirements ( ) ( )
		status objects ( )
		unbind ( ) ( )
		updating bindings ( ) ( )

	context shared object modules ( )

	contexts
		base context interface ( )
			context handles ( ) ( )
			lookup and list contexts ( ) ( )
			managing contexts ( ) ( )
			names in context operations ( )
			other context operations ( ) ( )
			requirements for operations ( ) ( )
			status objects ( )
			supporting interfaces ( ) ( )
			updating bindings ( ) ( )
		creating subcontexts ( ) ( )
		defined ( )
		destroying
			handles ( )
			subcontexts ( )
		getting
			handles ( ) ( )
			references ( )
			syntax attributes ( )
		initial context
			bindings for enterprise naming ( )
			described ( )
		managing and examining ( ) ( )
		syntax-related attributes ( )
		tree structure ( ) ( )
		XFN contexts ( )

	curly braces in BNF notation ( ) ( )


D

	data types
		abstract data types ( )
		XFN interface conventions ( )

	decomposing XFN composite name strings ( ) ( ) ( ) ( )

	deleting
		See removing

	destroying
		context handles ( )
		subcontexts ( )

	DNS
		See Domain Name System (DNS)

	Domain Name System (DNS), hierarchical naming system ( )

	dots (.)
		... namespace identifier ( )
		/... namespace identifier ( )

	double quotes
		BNF notation ( ) ( )
		XFN composite name syntax ( )
		XFN standard syntax model ( )


E

	encoding for XFN composite names ( ) ( ) ( ) ( )

	end quote (") in XFN standard syntax model ( )

	enterprise level of service ( ) ( )

	enterprise namespace policies
		arrangement of objects ( )
		illustrated ( )
		initial context bindings ( )
			example ( )
			table ( )
		namespace structure
			example ( )
		table of policies ( ) ( )

	erasing
		See removing

	error messages
		status codes ( ) ( )

	examining
		See displaying

	explicit NNSPs ( ) ( )

	exporting the FNS interface ( )


F

	federated enterprise namespace policies
		See enterprise namespace policies

	federated global namespace policies
		See global namespace policies

	Federated Naming Service
		API usage model ( )
		application view ( ) ( )
		architectural model ( )
		described ( ) ( )
		need for ( )
		XFN compliance ( ) ( )

	files and file systems
		enterprise namespace policies ( )
		as enterprise policy entities ( )

	FN_ prefix ( )

	fn_ prefix ( )

	fn_attr_get() function ( ) ( ) ( )

	fn_attr_get_ids() function ( )

	fn_attr_get_values() function ( ) ( ) ( )

	fn_attr_modify() function ( )

	fn_attr_multi_modify() function ( )

	fn_attr_multiget() function ( )

	FN_ATTR_OP_ADD_EXCLUSIVE operation code ( )

	FN_ATTR_OP_ADD operation code ( )

	FN_ATTR_OP_ADD_VALUES operation code ( )

	FN_ATTR_OP_REMOVE operation code ( )

	FN_ATTR_OP_REMOVE_VALUES operation code ( )

	fn_composite_name_from_string() function ( ) ( ) ( ) ( )

	fn_ctx_bind() function ( )

	fn_ctx_bindinglist_destroy() function ( )

	fn_ctx_bindinglist_next() function ( )

	fn_ctx_create_subcontext() function ( ) ( )

	fn_ctx_destroy_subcontext() function ( )

	fn_ctx_get_ref() function ( )

	fn_ctx_get_syntax_attrs() function ( )

	fn_ctx_handle_destroy() function ( )

	fn_ctx_handle_from_initial() function, getting context handles ( )

	fn_ctx_handle_from_ref() function ( ) ( )

	fn_ctx_list_names() function ( ) ( )

	fn_ctx_listbindings() function ( )

	fn_ctx_lookup() function
		support required ( )
		using ( )

	fn_ctx_lookup_link() function ( ) ( )

	fn_ctx_namelist_destroy() function ( ) ( )

	fn_ctx_namelist_next() function ( ) ( )

	fn_ctx_rename() function ( )

	fn_ctx_unbind() function ( ) ( )

	FN_E_ATTR_NO_PERMISSION status code ( )

	FN_E_ATTR_VALUE_REQUIRED status code ( )

	FN_E_AUTHENTICATION_FAILURE status code ( )

	FN_E_COMMUNICATION_FAILURE status code ( )

	FN_E_CONFIGURATION_ERROR status code ( )

	FN_E_CONTINUE status code ( )

	FN_E_CTX_NO_PERMISSION status code ( )

	FN_E_CTX_NOT_EMPTY status code ( )

	FN_E_CTX_UNAVAILABLE status code ( )

	FN_E_ILLEGAL_NAME status code ( ) ( )

	FN_E_INCOMPATIBLE_CODE_SETS status code ( ) ( )

	FN_E_INSUFFICIENT_RESOURCES status code ( )

	FN_E_INVALID_ATTR_VALUE status code ( )

	FN_E_INVALID_ENUM_HANDLE status code ( )

	FN_E_INVALID_SYNTAX_ATTRS status code ( )

	FN_E_LINK_ERROR status code ( ) ( )

	FN_E_LINK_LOOP_LIMIT status code ( )

	FN_E_MALFORMED_LINK status code ( )

	FN_E_MALFORMED_REFERENCE status code ( )

	FN_E_NAME_IN_USE status code ( )

	FN_E_NAME_NOT_FOUND status code ( )

	FN_E_NO_SUCH_ATTRIBUTE status code ( )

	FN_E_NO_SUPPORTED_ADDRESS status code ( )

	FN_E_NOT_A_CLIENT status code ( )

	FN_E_OPERATION_NOT_SUPPORTED status code ( ) ( )

	FN_E_PARTIAL_RESULT status code ( )

	FN_E_SYNTAX_NOT_SUPPORTED status code ( )

	FN_E_TOO_MANY_ATTR_VALUES status code ( )

	FN_E_UNSPECIFIED_ERROR status code ( )

	FN_ID_DCE_UUID XFN identifier format ( )

	FN_ID_ISO_OID_STRING XFN identifier format ( )

	FN_ID_STRING XFN identifier format ( )

	fn_multigetlist_destroy() function ( ) ( )

	fn_multigetlist_next() function ( ) ( )

	FN_status_t parameter ( )

	fn_std_syntax_ava_separator XFN syntax attribute ( )

	fn_std_syntax_begin_quote XFN syntax attribute ( ) ( )

	fn_std_syntax_case_insensitive XFN syntax attribute ( )

	fn_std_syntax_code_sets XFN syntax attribute ( )

	fn_std_syntax_end_quote XFN syntax attribute ( ) ( )

	fn_std_syntax_escape XFN syntax attribute ( )

	fn_std_syntax_separator XFN syntax attribute ( )

	fn_std_syntax_typeval_separator XFN syntax attribute ( )

	fn_string_from_composite_name() function ( ) ( ) ( ) ( )

	FN_SUCCESS status code ( )

	fn_syntax_direction XFN syntax attribute ( )

	fn_syntax_type XFN syntax attribute ( )

	fn_valuelist_destroy() function ( ) ( )

	fn_valuelist_next() function ( ) ( )

	fnbrowse program example ( )
		code ( )
		commands ( )
		diagram ( )
		sample output ( )

	FNS
		See Federated Naming Service

	fs or _fs namespace identifier, FNS policy ( )

	functions, XFN interface conventions ( )


G

	getting
		attribute identifiers ( )
		attribute values ( )
		attributes ( ) ( )
		context handles ( ) ( )
		multiple attributes ( ) ( )
		reference to context ( )
		syntax attributes of context ( )

	global level of service ( ) ( )

	global namespace policies, illustrated ( )


H

	handles
		context handles
			destroying ( )
			getting ( ) ( )
		overview ( ) ( )

	hierarchical naming system
		compound name examples ( ) ( )
		enterprise namespace structure ( )

	host or _host namespace identifier
		FNS policy ( )
		initial context binding ( )

	hosts
		as enterprise policy entities ( )
		composite name examples ( )
		enterprise namespace policies ( )


I

	identifiers
		namespace
			enterprise level ( )
		XFN interface parameters ( )

	implicit NNSPs ( ) ( )

	initial context
		bindings for enterprise naming ( )
			example ( )
			table ( )
		described ( )
		handle construction operation ( )

	interfaces for programming
		See client programming interfaces

	Internet DNS
		See domain name system (DNS)

	ISO OID XFN identifier formats ( )


J

	junctions ( ) ( )


L

	links (XFN)
		composite name resolution ( )
		described ( )
		lookup operation ( ) ( )
		status object information ( )
		XFN header file ( )
		XFN library ( )

	listing
		names and bindings in contexts ( )
		names bound in contexts ( ) ( )
		namespace browser programming example ( )
			code ( )
			commands ( )
			diagram ( )
			sample output ( )

	lookup model ( )

	lookup operations
		contexts ( )
		XFN links ( ) ( )


M

	managing
		See administration

	memory management policies for client interfaces ( )

	messages
		See error messages

	modules, context shared object ( )

	multiple addresses ( )

	multiple attributes
		getting ( ) ( )
		getting identifiers ( )
		modifying ( )

	myens or _myens namespace identifier, initial context binding ( )

	myorgunit or _myorgunit namespace identifier, initial context binding ( )

	myself or _myself namespace identifier, initial context binding ( )


N

	name resolution
		context operation support requirements ( ) ( )
		status object information ( )
		XFN composite names ( ) ( )
			coexistence of explicit and implicit NNSPs ( )
			explicit NNSPs ( ) ( )
			implicit NNSPs ( ) ( )
			XFN links ( )

	namespace browser programming example ( )
		code ( )
		commands ( )
		diagram ( )
		sample output ( )

	namespace identifiers
		enterprise level
			initial context bindings ( )

	namespace policies
		See policies

	naming
		context operation names ( )
		XFN attribute operations and ( ) ( )
		XFN interface conventions ( )

	naming system boundaries and component separators ( ) ( )
		strong separation ( )
		weak separation ( ) ( )

	navigating
		See browsing

	next naming system pointers (NNSPs)
		XFN composite name resolution
			coexistence of explicit and implicit NNSPs ( )
			explicit NNSPs ( ) ( )
			implicit NNSPs ( ) ( )

	NNSPs
		See next naming system pointers (NNSPs)


O

	operations
		See attribute operations

	org namespace identifier, initial context binding ( )

	organizational units
		composite name examples ( )
		described ( )
		enterprise namespace policies ( )

	orgunit or _orgunit namespace identifier
		FNS policy ( )
		initial context binding ( )

	OSF DCE UUID XFN identifier format ( )


P

	parsing
		compound names ( )
			syntax attributes ( ) ( )
			XFN standard syntax model ( ) ( )
		XFN composite names ( ) ( ) ( ) ( )

	periods
		See dots (.)

	pipe character (\|) in BNF notation ( ) ( )

	plus sign (+) in BNF notation ( ) ( )

	pointer types ( )

	policies
		enterprise namespace
			arrangement of objects ( )
			illustrated ( )
			initial context bindings ( )
			table of policies ( ) ( )
		global namespace
			illustrated ( )
		information specified ( )
		levels of services ( )
		overview ( )

	predefined constants ( )

	primary status code ( )

	printer namespace identifier, FNS policy ( )

	printers
		enterprise namespace policies ( )
		programming example ( )
			client ( )
			server ( )

	programming
		See application programming


Q

	quotation marks
		BNF notation ( ) ( )
		XFN composite name syntax ( )
		XFN standard syntax model ( )


R

	RAM, memory-management policies for client interfaces ( )

	references
		defined ( )
		getting for contexts ( )
		handle construction operation ( ) ( )
		status object information ( )
		XFN interface parameters ( ) ( )

	relative distinguished names ( )

	removing
		bindings ( ) ( )
		destroying
			context handles ( )
			subcontexts ( )

	renaming bindings ( )

	resolution
		See name resolution


S

	separator character (/)
		naming system boundaries and ( ) ( )
			strong separation ( )
			weak separation ( ) ( )
		XFN composite name syntax ( ) ( )
		XFN standard syntax model ( )

	servers, print server programming example ( )

	service or _service namespace identifier, FNS policy ( )

	services
		as enterprise policy entities ( )
		enterprise namespace policies ( )
		levels ( )

	sets of attributes ( )

	single quote in XFN composite name syntax ( )

	site or _site namespace identifier
		FNS policy ( )
		initial context binding ( )

	sites
		composite name examples ( )
		enterprise namespace policies ( )
		as enterprise policy entities ( )

	slash (/)
		/... namespace identifier ( )
		XFN component separator ( ) ( ) ( )

	Solaris
		FNS implementation
			applications ( )

	status codes ( ) ( )
		link status ( )

	status objects ( )
		base attribute interface ( )
		base context interface ( )

	strings
		composing XFN composite name strings ( ) ( ) ( ) ( )
		decomposing XFN composite name strings ( ) ( ) ( ) ( )
		XFN composite name syntax ( ) ( )
		XFN identifier formats ( )
		XFN interface parameters ( )
		XFN standard syntax model ( )

	subcontexts
		See subordinate contexts

	subordinate contexts
		creating ( ) ( )
		destroying ( )


T

	_t suffix ( )

	thisens or _thisens namespace identifier, initial context binding ( )

	thishost or _thishost namespace identifier, initial context binding ( )

	thisorgunit or _thisorgunit namespace identifier, initial context binding ( )

	thisuser namespace identifier, initial context binding ( )

	troubleshooting
		status codes ( ) ( )


U

	UNIX hierarchical naming system ( )

	updating
		bindings ( ) ( )

	user or _user namespace identifier
		FNS policy ( )
		initial context binding ( )

	users
		as enterprise policy entities ( )
		composite name examples ( )
		enterprise namespace policies ( )


V

	viewing
		See displaying


X

	X.500 global directory service, hierarchical naming system ( )

	X/Open Federated Naming
		attribute model ( ) ( )
		client programming interfaces ( )
			abstract data types ( )
			base attribute interface ( ) ( ) ( )
			base context interface ( ) ( )
			conventions ( )
			memory management policies ( )
			overview ( ) ( )
			parameters ( ) ( )
			parsing compound names ( )
			status codes ( ) ( )
			status objects ( ) ( ) ( )
			supporting interfaces ( ) ( )
			usage ( )
		component separator and naming system boundaries ( ) ( )
			strong separation ( )
			weak separation ( ) ( )
		composite names ( )
			naming system boundaries and component separators ( ) ( )
			resolution ( ) ( )
			syntax ( ) ( ) ( ) ( ) ( )
		compound-name syntax model ( ) ( )
		contexts ( )
		described ( )
		FNS conformity ( ) ( )
		identifier formats ( )
		links
			composite name resolution ( )
			described ( )
			lookup operation ( ) ( )
			status object information ( )
			XFN header file ( )
			XFN library ( )

	XFN
		See X/Open Federated Naming