[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 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 SearchList

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:

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:

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

  1. To add a domain entry with a domain name of abc.aus.century.com , enter:
    namerslv -a -D abc.aus.century.com
  2. To change the abc.aus.century.com domain entry to the domain name xyz.aus.century.com , enter:
    namerslv xyz.aus.century.com
  3. To add a name server entry with IP address 192.9.201.1 , enter:
    namerslv -a -i 192.9.201.1
  4. To show all system configuration database entries related to domain name server information used by local resolver routines, enter:
    namerslv -s
    The output is given in the following format:
    domain xyz.aus.century.com
        name server 192.9.201.1
  5. To rename the /etc/resolv.conf file to stop using the name server and specify the new file name, /etc/resolv.back , enter:
    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 Version 4.3 System Management Guide: Communications and Networks.

Setting up and running Web-based System Management in AIX Version 4.3 System Management Guide: Operating System and Devices.

The SMIT Interface for TCP/IP in AIX Version 4.3 System Management Guide: Communications and Networks.


[ Previous | Next | Contents | Glossary | Home | Search ]