Commands Reference, Volume 4

namerslv Command

Purpose

Directly manipulates domain name server entries for local resolver routines in the system configuration database.

Syntax

To Add a Name Server Entry

namerslv -a { -i IPAddress | -D DomainName| -S SearchList}

To Delete a Name Server Entry

namerslv -d { -i IPAddress | -n | -l}

To Delete All Name Server Entries

namerslv -X [ -I ]

To Change a Name Server Entry

namerslv -c DomainName

To Display a Name Server Entry

namerslv -s [ -I | -n | -l ] [ -Z ]

To Create the Configuration Database File

namerslv -b [ -i IPAddress [ -D DomainName ] [ -S SearchList ] ]

To Rename the Configuration Database File

namerslv -E FileName

To Move the Configuration Database File to Prevent Name Server Use

namerslv -e

To Import a File into the Configuration Database File

namerslv -B FileName

To Change a Search List Entry

namerslv -C Search List

Description

The namerslv low-level command adds or deletes domain name server entries for local resolver routines in the system configuration database. By default, the system configuration database is contained in the /etc/resolv.conf file.

To use a name server, do one of the following:

Specify a file name to use as the system configuration database.
Specify an Internet Protocol address and, optionally, a domain name.

The namerslv command can show one or all domain name server entries in the system configuration database. The namerslv command can also rename the /etc/resolv.conf file so that it stops using a name server.

There are three types of domain name server entries:

A domain entry identifying the name of the local Internet domain.
A name server entry that identifies the Internet address of a domain name server for the local domain. The address must be in dotted decimal format.
A search list entry that lists all the domains to search when resolving hostnames. This is a space delimited list.

One domain entry and a maximum of three name server entries can exist in the system configuration database. The MAXNS global variable in the /usr/include/resolv.h file defines the maximum number of name servers. One search entry can exist.

You can use the Web-based System Manager Network application (wsm network fast path) to run this command. You could also use the System Management Interface Tool (SMIT) smit namerslv fast path to run this command.

Flags

-a	Adds an entry to the system configuration database. The -a flag must be used with either the -i or -D flag.
-B FileName	Restores the /etc/resolv.conf file from the file specified by the FileName variable.
-b	Creates the system configuration database, using the /etc/resolv.conf.sv file. If the /etc/resolv.conf.sv file does not exist, an error is returned. Note The /etc/resolv.conf.sv file is not shipped with the system. You have to create the file before the -b flag will work.
-C	Changes the search list in the /etc/resolv.conf file.
-c DomainName	Changes the domain name in the system configuration database.
-D	Indicates that the command deals with the domain name entry.
-d	Deletes an entry in the system configuration database. It must be used with the -i IPAddress flag or the -n flag. The -i flag deletes a name server entry. The -n flag deletes the domain name entry.
-E FileName	Renames the system configuration database file, so you can stop using a name server. The /etc/resolv.conf file is moved to the file specified by the FileName variable.
-e	Moves the /etc/resolv.conf file to the /etc/resolv.conf.sv file, preventing use of a name server.
-I	(Uppercase i) Specifies that the -s flag or -X flag should print all name server entries.
-i IPAddress	Indicates that the command deals with a name server entry. Use dotted decimal format for the given IP address.
-l	(Lowercase L) Specifies that the operation is on the search list. Use this flag with the -d and -s flag.
-n	Specifies that the operation is on the domain name. Use this flag with the -d flag and the -s flag.
-S SearchList	Changes the search list in the system configuration database.
-s	Shows all domain and name server entries in the configuration system database. If you use the -i flag, the namerslv command shows all name server entries. If you use the -n flag, the namerslv command shows the domain name entry found in the database.
-X	Deletes all entries in the database. Use the -I flag with this flag to delete all name server entries.
-Z	Generates the output of the query in colon format. This flag is used when the namerslv command is called from the SMIT usability interface.

Examples

To add a domain entry with a domain name of abc.aus.century.com, type:
namerslv -a -D abc.aus.century.com
To change the abc.aus.century.com domain entry to the domain name xyz.aus.century.com, type:
```
namerslv xyz.aus.century.com
```
To add a name server entry with IP address 192.9.201.1, type:
namerslv -a -i 192.9.201.1
To show all system configuration database entries related to domain name server information used by local resolver routines, type:
namerslv -s
The output is given in the following format:
```
domain xyz.aus.century.com
    name server 192.9.201.1
```
To rename the /etc/resolv.conf file to stop using the name server and specify the new file name, /etc/resolv.back, type:
namerslv -E /etc/resolv.back

Files

/usr/sbin/namerslv	Contains the namerslv command.
/etc/resolv.conf	Contains the default system configuration database.
/etc/resolv.conf.sv	Contains the old system configuration database.

Related Information

The chnamsv command, lsnamsv command, mknamsv command, nslookup command, rmnamsv command, traceroute command.

Naming and TCP/IP Daemons in AIX 5L Version 5.2 System Management Guide: Communications and Networks.

For information on installing the Web-based System Manager, see Chapter 2: Installation and System Requirements in AIX 5L Version 5.2 Web-based System Manager Administration Guide.

The TCP/IP Reference in AIX 5L Version 5.2 System Management Guide: Communications and Networks.