.\"  Licensed to the Apache Software Foundation (ASF) under one .\"
.\"  or more contributor license agreements.  See the NOTICE file .\"
.\"  distributed with this work for additional information .\"
.\"  regarding copyright ownership.  The ASF licenses this file .\"
.\"  to you under the Apache License, Version 2.0 (the .\"
.\"  "License"); you may not use this file except in compliance .\"
.\"  with the License.  You may obtain a copy of the License at .\"
.\" .\"
.\"      http://www.apache.org/licenses/LICENSE-2.0 .\"
.\" .\"
.\"  Unless required by applicable law or agreed to in writing, software .\"
.\"  distributed under the License is distributed on an "AS IS" BASIS, .\"
.\"  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. .\"
.\"  See the License for the specific language governing permissions and .\"
.\"  limitations under the License. .\"
.TH "config:network"
.SH NAME
config:network \- Configures system network settings.
.SH SYNOPSIS
config:network [options]
.SH DESCRIPTION
The config:network command enables you to configure network settings such as hostname, 
defaultrouter, search-domain, dns, and interface settings.
You must use one of the options described below.
.SH OPTIONS
The following options are supported for the config:network command:
.SS "hostname <string>"
Specifies the fully qualified hostname.
.SS "defaultrouter <x.x.x.x>"
Specifies the IP address of the default router.
.SS "search-domain <string>"
Specifies the search domain.
.SS "dns <a.a.a.a b.b.b.b c.c.c.c>"
Specifies the IP addresses of one or more DNS servers.
.SS "int"
Displays the Network Interfaces.
.SS "int <interface>"
Displays information pertaining to a Network Interface.
.SS "int <interface> down"
Bring down a Network Interface.
.SS "int <interface> up <onboot | not-onboot> <static | dhcp> <ip> <netmask> <gateway>"
Bring up a Network Interface with the specified settings: boot status, static IP versus DHCP, IP address, netmask, and gateway IP (or default).
.SS "int <interface> <onboot | not-onboot>"
Specify the boot status of a Network Interface.  NIC must already be up.
.SS "int <interface> <static | dhcp>
Specify static IP or DHCP for a Network Interface.  NIC must already be up.
.SS "int <interface> ip <x.x.x.x>"
Specify the IP address of a network interface.  NIC must already be up.
.SS "int <interface> netmask <x.x.x.x>"
Specify the netmask of a network interface.  NIC must already be up.
.SS "int <interface> gateway <x.x.x.x | default>"
Specify the gateway IP address, or default to use the defaultrouter.
.SH EXAMPLES
.SS "Example 1. Specifying the hostname"
.PP
.nf
traffic_shell> config:network hostname host.example.com
traffic_shell> 
.SS "Example 2. Specifying multiple DNS servers"
.PP
.nf
traffic_shell> config:network dns "x.x.x.x y.y.y.y z.z.z.z"
traffic_shell> 
.SS "Example 3. Listing the Network Interfaces"
traffic_shell> config:network int
eth0
eth1
traffic_shell> 
.SS "Example 4. Bringing up a Network Interface with IP address x.x.x.x and netmask y.y.y.y"
.PP
.nf
traffic_shell> config:network int eth0 onboot static x.x.x.x y.y.y.y default
traffic_shell>
.SH "SEE ALSO"
show:network