hostent Command

Purpose

Directly manipulates address-mapping entries in the system configuration database.

Syntax

To Add an Address-to-Host Name Mapping

hostent -a IPAddress -h "HostName..."

To Delete an Address-to-Host Name Mapping

hostent -d IPAddress

To Delete All Address-to-Host Name Mappings

hostent -X

To Change an Address-to-Host Name Mapping

hostent -c IPAddress -h "HostName..." [ -i NewIPAddress ]

To Show an Address or Host Name in Colon Format

hostent -s { IPAddress | "HostName" } [ -Z ]

To Show all Address-to-Host Name Mappings in Colon Format

hostent -S [ -Z ]

Description

The hostent low-level command adds, deletes, or changes address-mapping entries in the system configuration database. Entries in the database are used to map an Internet Protocol (IP) address (local or remote) to its equivalent host names.

The hostent command can show one or all address-to-host name mapping entries in the /etc/hosts file. An Internet Protocol (IP) address of a given local or remote host may be associated with one or more host names. Represent an IP address in dotted decimal format. Represent a host name as a string with a maximum length of 255 characters, and use no blank characters. Each entry must be contained on one line. Multiple HostNames (or aliases) can be specified.

Note: Valid host names or alias host names must contain at least one alphabetic character. If you choose to specify a host name or alias that begins with an x followed by any hexadecimal digit (0-f), the host name or alias must also contain at least one additional letter that cannot be expressed as a hexadecimal digit. The system interprets a leading x followed by a hexadecimal digit as the base 16 representation of an address unless there is at least one character in the host name or alias that is not a hexadecimal digit. Thus, xdeer would be a valid host name, whereas xdee would not.

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

Flags

Note: The -a, -d, -c, and -s flags cannot be used together.

Note: The hostent command does recognize the following addresses: .08, .008, .09, and .009. Addresses with leading zeros are interpreted as octal, and numerals in octal cannot contain 8s or 9s.

Examples

1. To add an entry in the database associating an address with a series of host names, enter the command in the following format:

   hostent -a 192.100.201.7 -h "alpha bravo charlie"

   In example 1, the IP address 192.100.201.7 is specified as the address of the host that has a primary host name of alpha with synonyms of bravo and charlie.

   Note: If you attempt to use .08, .008, .09, or .009 in an address to add, you will get an error message that states "IP Address Address already exists," although the address is not in the /etc/hosts file.

2. To show an entry in the database matching a host name, enter the command in the following format:

   hostent -s alpha

   In example 2, the entry to be shown matches the host name alpha.
3. To change the IP address of an entry to a new IP address, enter the command in the following format:

   hostent -c 192.100.201.7 -i 192.100.201.8

   In example 3, the old IP address is 192.100.201.7 and the new address is 192.100.201.8.

Files

Related Information

The hostname command.

Naming in AIX Version 4.3 System Management Guide: Communications and Networks.

The SMIT Interface for TCP/IP 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.