 |
Click this button to go to the index for this section. |
netconfig(8X)
NAME
netconfig - Manages network configuration processes
SYNOPSIS
/usr/sbin/netconfig [-ui cli [clioptions]|gui [x resources]|menu]
OPTIONS
-ui Specifies the user interface to be invoked. The choices are:
cli Specifies command line interface
gui Specifies graphical user interface
menu
Specifies menu interface
[clioptions]
Specific command line options that will be used to interact with
netconfig. The syntax is as follows:
-Help Provides a brief help message, listing all the configurable
components along with the actions that can be performed on
those components. Configurable components are indicated in
Help output by a "-" prefix.
-<configurable_component>Help
Provides a detailed help message on how to configure the
specified configurable component. Each action will be listed
on a separate line with the attributes that can be used for the
action.
-<configurable_component> <action>[attr=value...]
Used to perform a specific action on the selected component,
optionally by altering the attribute's value for the selected
component. A list of actions and their specific attribute-
value pair will be listed by the clioption
-configurable_component>Help. The actions are:
create
Causes a new configuration to be created on the system for
the selected component
modify
Modifies an existing configuration for the selected
component
add Adds a new value to an attribute on an existing
configuration for the selected component
remove
Deletes a value of an attribute on an existing
configuration for the selected component
purge
Removes an existing configuration for the selected
component
list
Lists all the attribute-value pairs for the selected
component on the system
The x resources are standard X11 resource options. For more information,
see the X(1X) reference page.
DESCRIPTION
The Network Configuration application can be used to configure and modify
the configuration of a TCP/IP network on a DIGITAL UNIX(R) system.
Use the Network Configuration application, netconfig, to do the following:
· Configure network interfaces, such as Ethernet, FDDI and Token Ring
· Enable and disable the following daemons: gated, joind, routed, and
rwhod
· Configure the system as an IP router
· Add, modify, and delete entries in the following files: /etc/routes,
/etc/gateways, etc/hosts, /etc/hosts.equiv, and /etc/networks
You must have root privileges to run this application.
The netconfig command has three user interface options:
· Graphical user interface (GUI)
· Command line interface (CLI)
· Menu interface (Menu)
Running the Graphical User Interface Option:
To start netconfig from the graphical user interface, do the following:
1. Click on the Application Manager icon on the CDE front panel.
2. Double click on the System_Admin application group icon.
3. Double click on the Configuration application group icon.
4. Double click on the Network icon.
To start netconfig from the xterm, enter the following command from the
xterm:
netconfig -ui gui [xresource options]
Running the Command Line Interface Option:
To start the netconfig command line interface, enter the following command
from the xterm:
netconfig -ui cli [clioptions]
Running the Menu Interface Option:
To start the netconfig menu interface, enter the following command from the
xterm:
netconfig -ui menu
Proceed through each menu by entering your choice. After selecting the
item to be configured, enter the configuration information by answering a
set of questions. Default answers are shown in square brackets ([]) where
possible. To use a default answer, press the Return key. Changes are
committed after you confirm the configuration.
Exit netconfig as follows:
· Enter exit at the main menu prompt to exit netconfig immediately.
· Enter exit at any other menu prompt to return to the previous menu.
· Enter exit at any other prompt to return you to the previous menu. The
last changes made are ignored.
Quit netconfig as follows:
1. Enter quit at any menu prompt to exit netconfig immediately.
2. Enter quit at any other prompt to return to the previous menu and
ignore the last changes made.
Running Online Help:
You can view the Network Configuration online help volume without running
the application. To open the Network Configuration help volume from the
command line, enter the following command:
/usr/dt/bin/dthelpview -helpVolume \
/usr/dt/appconfig/help/C/NetConfig.sdl
You can also view online help for this application by choosing Help from
the menu bar in the GUI version. The Help pulldown menu is displayed,
providing the following options:
Overview
Displays the Overview section of the help volume, which describes the
purpose of the application, how to run the application, and how to exit
the application.
Tasks
Displays the Tasks section of the help volume, which describes how to
use the application to perform various tasks.
Reference
Displays the Reference section of the help volume, which describes all
dialog boxes and dialog box components in the application.
On Item
Activates the On Item help functionality by displaying a question mark
as the cursor. When the cursor is positioned on any component in the
application and you click on the component, a Help Viewer window is
opened and the help for the selected component is displayed in the
window.
Using Help
Displays the standard CDE instructions on how to use the Help Viewer.
About
Displays version, copyright and trademark information for the
application.
EXAMPLES
The following example shows how to configure an entry in the /etc/hosts
file using the command line interface:
· Enter the following command to add a host named myhost.mydomain whose
IP address is 123.45.67.89:
netconfig -ui cli -host create name=myhost.mydomain \
address=123.45.67.89 alias=myhost
The following example shows how to configure an entry in the /etc/hosts
file using the command line interface:
1. Enter netconfig -ui menu at the command line.
2. Enter the appropriate number from the displayed menu to select
Configuration Files.
3. Enter the appropriate number from the displayed menu to select Hosts
File.
4. Enter the appropriate number from the displayed menu to select Add.
5. Enter the IP address of the host.
6. Enter the official host name.
7. If you want to assign an unofficial name (alias) to the host, enter
one or more aliases, separating each name by a space. If there are no
aliases, press the Return key.
8. If you want to enter a comment, enter the desired text. If there are
no comments, press the Return key.
9. Enter Y to confirm that the entry is correct. The entry is then added
to the /etc/hosts file.
FILES
/etc/rc.config
Specifies the environment variables that define the netconfig
configuration on your system
/etc/gateways
Specifies Internet routing information
/etc/hosts
Specifies the host name file
/etc/hosts.equiv
Specifies the trusted hosts file
/etc/networks
Specifies the network name file
/etc/routes
Specifies Internet static routing information
SEE ALSO
Commands: network_manual_setup(7), netsetup(8), ifconfig(8), rcinet(8),
gateways(4), hosts(4), hosts.equiv(4), networks(4), rc.config(4), routes(4)