Commands Reference, Volume 1

cfgif Method

Purpose

Configures or activates one or all network interface (IF) instance(s) defined in the system configuration database.

Syntax

cfgif [ -l InterfaceInstance ]

Description

The cfgif method configures or activates one or all IF instance(s) of TCP/IP defined in the system configuration database. The cfgif method performs the following steps:

Retrieves the attributes associated with the Interface Program from the customized database. The attributes may include network address, network mask, security level and other related information.
Invokes the ifconfig command to load the IF instance using the customized attributes. The ifconfig command will load the appropriate interface program if it has not already been loaded.
Calls the ifconfig command to attach a routine to establish a path between the interface instance and the adapter.
Sets the status of a particular IF instance to "AVAILABLE" in the customized database. All the IF instances are set to "DEFINED" at system reboot. When the cfgif method is invoked during boot time or from the command line, the IF instance(s) are then made available.

Flags

-l InterfaceInstance	Specifies the interface instance to configure. If the instance name is specified, only that Interface instance is configured. If this flag is not used, all Interface instances in the defined state are configured.
-2	Indicates that ifconfig will be invoked from the second phase of IPL so that a hex value will be shown on the front panel display. This flag should not be used during runtime.

Examples

To configure a particular token-ring IF instance, enter the following command. Note that tr0 is the logical name for the token-ring IF instance. It should be defined using the defif method.
```
cfgif -l tr0 
```
To configure all IF instances, use the following command:
```
cfgif
```

Related Information

The chdev command, defif method, definet method, ifconfig command, mkdev command.

The cfginet method.

The odm_run_method subroutine.

Object Data Manager (ODM) Overview for Programmers in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.

Writing a Device Method in AIX 5L Version 5.1 Kernel Extensions and Device Support Programming Concepts.

TCP/IP Network Interfaces, TCP/IP Addressing in AIX 5L Version 5.1 System Management Guide: Communications and Networks.