subscribe iconSubscribe to this information

chtcpip command

Purpose

Changes the Virtual I/O Server TCP/IP settings and parameters.

Syntax

To change a network interface:

chtcpip [-interface Interface -inetaddr Address -netmask SubnetMask]

chtcpip [-interface Interface -gateway -add New_gateway_address -remove Old_gateway_address]

chtcpip -ip6-interface Interface [-inetaddr Address] [-plen pfixlen ] [-gateway]

Description

The chtcpip command changes the TCP/IP settings and configuration on the Virtual I/O Server.

Flags

-add New_Gateway_Address Specifies the new default gateway address to add.
-inetaddr Address Changes the IP address of the host. Specify the address in dotted decimal notation.
-interface Interface Specifies a particular network interface, for example en0.
-ip6 Specifies to use the IPv6 version of this command. The -ip6 flag allows you to change an existing IPv6 address, state, prefix length, and default gateway.
-gateway Gateway Changes the gateway address for a static route. Specify both the current address and new address in dotted decimal notation.
-netmask SubnetMask Specifies the subnet mask of the gateway, which is used to route through the appropriate subnetwork.
-plen prefixLen Specifies the prefix length of the IPv6 interface.
-remove Old_Gateway_Address Specifies the old default gateway address to remove.

Exit Status

0 The command completed successfully.
>0 An error occurred.

Examples

  1. To changes the current network address and mask to the new settings, type:
    chtcpip -interface en0 -inetaddr 9.1.1.1 -netmask 255.255.255.0
  2. To changes the default gateway from 9.1.2.3 to 9.2.3.4, type:
    chtcpip -interface en0 -gateway -add 9.2.3.4 -remove 9.1.2.3
    Note: If more than one default gateway is defined, an error will occur. Only one default gateway can be defined by the mktcpip command.

Send feedback | Rate this page

Last updated: Fri, Oct 30, 2009