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
- by using the environment variable ONS_ROOT,
- by defining a TXT record for the current hostname that
is returned by GetFullyQualifiedHostName for the
attribute ``ons'' according to RFC 1464, or by
- by defining a similar TXT record for the current domain
that is returned by UnixHost.GetDomainName.
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