NRS

Section: File Formats (5)
Updated: (Local)
Index Return to Main Contents

NAME

nrs - nrs config file format

SYNOPSIS

fun for all the family.

DESCRIPTION

The nrs config file tells the nrs command exactly what to do. It has a variety of control lines which are brought into play depending on the output format. See the definative text `A Quick Jog Through Configuring The Nrs Processor' for the most accurate details. All keywords are matched in a case insensitive manner. Lines beginning with a # are ignored as comments.

Global Controls

These variables affect the behaviour of nrs no matter what else you do.

Verbose: This line takes as an argument a numeric parameter which governs the verbosity of those annoying messages that programs are so good at producing. If no value is given it is set to 1, if the verbose line is not present, only fatal messages are produced.
Context: This control takes two parameters which are :-
The name of the context (see below for contexts).
The network represented (see below again).
If no contexts are given, you wont get any output.
Derfil: This control specifies the name of the NRS derived file. If this control is missing DERFIL2 is assumed.
Gateway: This control takes two parameters which are :-
The network that needs a gateway (currently either janet or pss)
The string to prepend to dte addresses if using this entry. This is typically used if all PSS addresses must pass through a gateway somewhere.
output: This control sets the output format to one of several output styles.

Non Global

Now the more specific controls.

The output control can takes as an argument any of the following.

york: York x25 directory format (D2.2).
york2.1: Old format (D2.1) york x25 directory format.
x25hosts: /etc/x25hosts format
mmdf: MMDF domain & channel tables. An optional second argument here sets the alias mapping. Long maps all short names as alias of long names, and short (the default) works the other way.
vms: VMS PSI format tables.
text: Human readable form of tables, similar to parts of the NRS t.central file.

When generating mmdf format output, two more controls are used.

Filedmn

There may be several of these lines, and they can take up to three arguments.

The first argument is the name of the file to output the strings to.

The second argument (if present) is the domain name to match in order to be put into the aforementioned file. If this is missing it matches all unmatched domains. The third argument is the long form of the domain, if different to the short form. If missing this is assumed to be the short form.

EXAMPLE

An Example of filedmn line

filedmn nott-dmn uk.ac.nott. uk.ac.nottingham.
filedmn ac-dmn uk.ac.
filedmn others-dmn

This says to put anything matching uk.ac.nott. or uk.ac.nottingham. into file nott-dmn, anything that matches uk.ac. into file ac-dmn and anything left over into others-dmn. As the first match is used, the order of these tables is important.

filechan

This control is used to create the channel table part of the file tables. It takes two arguments a file and a network. Any match on the network is put into the file.

EXAMPLE

An example of filechan usage.

filechan pss-chan pss
filechan janet-chan janet

This says to put any JANET network host into file janet-chan and PSS hosts into pss-chan.

CONTEXTS

These are the currently recognised contexts as used with the file control line.

X29 - X29 connections
TS29 - TS29 connections
NIFTP - NIFTP file transfer
FTP -   NIFTP file transfer
MAIL -  Grey Book Mail
MAIL-NIFTP - Grey Book Mail
MAIL-X29 - X29 Mail
MAIL-TELEX - Telex Mail
JTMP - JTMP
JTMP-FILES - JTMP_FILES,
JTMP-REG - JTMP_REG,
YBTS-NODE - YBTS_NODE,
YBTS - YBTS
DESC - Description text

NETWORKS

These are the currently recognised networks.

JANET - the joint academic network
PSS - BTs network
TELEX - the telex network

FILES

DERFIL2 the master derived file from the nrs

DIAGNOSTICS

Are meaningless and unhelpful.

BUGS

... are a problem in any software.

Index

NAME

SYNOPSIS

DESCRIPTION

Global Controls
Non Global
Filedmn
EXAMPLE
filechan
EXAMPLE
CONTEXTS
NETWORKS

This document was created by man2html, using the manual pages.
Time: 13:41:25 GMT, October 03, 2024