RFMASTER(5)

NAME
rfmaster - Remote File Sharing name server master file

SYNOPSIS
/usr/nserve/rfmaster

DESCRIPTION
The rfmaster file is an ASCII text file that identifies the hosts that are responsible for providing primary and secondary domain name service for Remote File Sharing domains. This file contains a series of entries, each terminated by a NEWLINE; a record may be extended over more than one line by escaping the NEWLINE with a backslash. Fields in each record are separated by white space. Each record has three fields: name, type, and data.

The type field, which defines the meaning of the name and data fields, has three possible values:

p   Primary domain name server. In this case, name is the domain name and data is the full hostname of the primary name server, specified as:

        domain.nodename

    There can be only one primary name server per domain.

s   Define a secondary name server for a domain. In this case, name and data are the same as for the p type. The order of the s entries in the rfmaster file determines the order in which secondary name servers take over when the current domain name server fails.

a   Define a network address for a machine. In this case, name is the full domain name for the machine, and data is the network address. The network address can be in plain ASCII text or it can be preceded by a `\x' to be interpreted as hexadecimal notation.

There are at least two lines in the rfmaster file per domain name server: one p line and one a line. Together, they define the primary and its network address. There should also be at least one secondary name server in each domain.

This file is created and maintained on the primary domain name server. When a machine other than the primary tries to start Remote File Sharing, this file is read to determine the address of the primary. If this file is missing, the -p option of rfstart must be used to identify the primary. After that, a copy of the primary's rfmaster file is automatically placed on the machine.

Domains not served by the primary can also be listed in the rfmaster file. By adding primary, secondary, and address information for other domains on a network, machines served by the primary will be able to share resources with machines in other domains.

A primary name server may be a primary for more than one domain. However, the secondaries must then also be the same for each domain served by the primary.

EXAMPLE

An example of an rfmaster file is shown below. The network addresses given in the example are IP addresses; for more information on their format and how to generate them, see hostrfs(8).

    	sunrfs		p	sunrfs.estale
    	sunrfs		s	sunrfs.ivy
    	sunrfs.estale	a	\x000214508190320d
    	sunrfs.ivy	a	\x0002145081903246

Note: If a line in the rfmaster file begins with a `#' (pound sign) character, the entire line will be treated as a comment.

FILES
/usr/nserve/rfmaster

SEE ALSO
rfstart(8)