.\" @(#)fw.address.1 1.3 99/03/31 SMI;
.\" Copyright (c) 1999, Sun Microsystems, Inc.
.\" All Rights Reserved
.TH fw.address 1 "31 March 1999" " "
.SH NAME
fw.address \- manipulate firewall configuration address definitions
.SH SYNOPSIS
.B fw.address add
.I name
.BI HOST " ip "
\f3"\f2comment\f3"\f1
.LP
.B fw.address add
.I name
.BI RANGE " begin_ip end_ip"
\f3"\f2comment\f3"\f1
.LP
.BI "fw.address delete " name
.LP
.BI "fw.address list " name
.SH DESCRIPTION
.IX "manipulate firewall configuration address definitions" "" "manipulate firewall configuration address definitions \(em \fLfw.address\fP"
.IX "fw.address" "" "\fLfw.address\fP \(em manipulate firewall configuration address definitions"
The
.B fw.address
utility maintains address definitions in firewall  configurations.
.LP
The addresses "localhost" and "*" are predefined and cannot be redefined
or modified in any way.
An IP address is in the form: XX.XX.XX.XX.
.SH OPTIONS
The following options are supported:
.TP
\f3add \f2name \f3HOST \f2 ip \f3"\f2comment\f3"\f1
Create the named address.
If the address already exists, it is updated.
The 
.I name
argument is the name supplied by the user
that refers to the HOST whose IP address is
.IR ip .
The 
.I comment
argument
is a character string stored as a human-readable
description of the address, contained within quotation marks.
.TP 
\f3add \f2name \f3RANGE \f2begin_ip end_ip \f3"\f2comment\f3"\f1
Create a range of addresses.  The
.I name
argument is the name supplied by the user for the RANGE.  The
.I begin_ip
and
.I end_ip
arguments indicate
the beginning and ending IP addresses of
the RANGE address.
The 
.I comment
argument
is a character string stored as a human-readable
description of the address, contained within quotation marks.
.TP
\f3delete \f2name\f1
Delete the address specified by
.IR name .
If the named address does not exist, no change occurs.
.TP
\f3list \f2name\f1
List only the address specified by name.
.IR name .
If the named address does not exist, no output is produced.
.SH ATTRIBUTES
Interface Stability:
.br
Sun Microsystems, Inc., reserves the right to change the interface
definitions in a minor release. However, Sun Microsystems, Inc.,
will make every effort to preserve the minimal interface definitions presented; 
they were chosen in a hope to fulfill a goal of not changing them.
In the future, it is intended that a stronger commitment will be made
to these interface definitions, which will guarantee them across 
minor releases.
.SH EXAMPLES
.TP 3
.B 1.
The following example creates the HOST address named "host".
.LP
.RS 5
.ft 3
fw.address add host HOST 1.1.1.1 "An example HOST address"
.ft 1
.RE
.TP 3
.B 2.
The following example creates the RANGE address named "myhome"
that represents all addresses inclusive between 1.1.1.1 and 1.1.1.5.
.LP
.RS 5
.ft3
fw.address add myhome RANGE 1.1.1.1 1.1.1.5 "A range address"
.ft 1
.RE
.TP 3
.B 3.
The following example deletes the address named "myhome".
.LP
.RS 5
.ft 3
fw.address delete myhome
.ft 1
.RE
.TP 3
.B 4.
The following example lists the address currently defined as "myhome".
.LP
.RS 5
.ft 3
fw.address list myhome
.ft 1
.RE