2.2.2 File Format for Phonebook

The Phonebook<201> is an 8-bit ASCII-encoded text file that contains the names and settings for the demand-dial connections. It includes the connection settings that can be used for establishing the demand-dial connections. The RRASM client can remotely configure this file on the RRAS server at a well-known name and location using any remote file management protocol (such as SMB). RRAS can read the phonebook file from this location<202> for gathering the demand-dial connection settings.

The name and the settings for a single demand-dial connection is known as an RRAS phonebook section (also known as RRAS phonebook entry or RRAS entry). A RRAS entry begins with the name of the demand-dial connection, which MUST be unique. The name is followed by settings as a sequence of key value pairs (KVP). The phonebook file can have zero (when there are no demand-dial connections) or more RRAS entry sections.

Each RRAS entry section in the phonebook file can have the following four RRAS entry subsections: NETCOMPONENTS, MEDIA, DEVICE, and PhoneNumber. The NETCOMPONENTS and PhoneNumber subsections are optional, whereas MEDIA and DEVICE subsections MUST be present. There can be multiple MEDIA subsections within a single RRAS entry section. Each MEDIA subsection can have multiple DEVICE subsections and each DEVICE subsection in turn can have multiple PhoneNumber subsections. When there are multiple MEDIA subsections, each subsection corresponds to a physical device.

RRASM uses the list of phonebook entries to validate the WAN interface name as a part of specific RPC methods as specified in section 3.1.1. For the WAN interface name to be valid, there has to be a RRAS phonebook entry with the specified name.