Oberon || Library || Module Index || Search Engine || Definition || Module


Ulm's Oberon Library:
UnixNames


NAME

UnixNames - import the public root

SYNOPSIS

VAR errors: RelatedEvents.Object;


PROCEDURE ImportPublicRoot(errors: RelatedEvents.Object) : BOOLEAN;

DESCRIPTION

UnixNames attempts to locate a public root and to insert it under the name ``pub'' into Names.root.

Public roots are imported by NamesBootService and RobustRoots using an address specification in the format fqdn:port where fqdn is a fully qualified domain name that can be resolved using DNSResolvers.

The address of the public root boot service can be specified

Note that if the enviroment variable ONS_ROOT is given, its contents is the only address that is tried to find the public root, i.e. TXT record lookups for the current hostname or the current domain will be skipped.

ImportPublicRoot allows to re-import the public root in case of a termination of the previous public root.

EXAMPLE

Following TXT records specifies that the public root boot service for the domain ``mathematik.uni-ulm.de'' is hosted at ``thales.mathematik.uni-ulm.de'' on port 9880:
mathematik.uni-ulm.de IN TXT "ons=thales.mathematik.uni-ulm.de:9880"

DIAGNOSTICS

The error events of the initial attempt are queued in errors.

ENVIRONMENT

ONS_ROOT
specifies the address of the public root boot service

SEE ALSO

IPv4NameSystems
allows to import root nodes using IPv4 sockets
Names
abstraction for name hierarchies
NamesBootService
service which exports root nodes at known addresses
RobustRoots
technique that re-imports terminated root nodes

Edited by: borchert, last change: 2005/04/28, revision: 1.3, converted to HTML: 2005/04/28

Oberon || Library || Module Index || Search Engine || Definition || Module