.\" This file is part of Eclat -*- nroff -*-
.\" Copyright (C) 2012-2015 Sergey Poznyakoff
.\"
.\" Eclat is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 3, or (at your option)
.\" any later version.
.\"
.\" Eclat is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with Eclat.  If not, see <http://www.gnu.org/licenses/>.
.TH ECLAT-RMADDR 1 "January 26, 2015" "ECLAT" "Eclat User Reference"
.SH NAME
eclat-rmaddr, eclat-release-address \- release Elastic IP address.
.SH SYNOPSIS
.nh
.na
\fBeclat rmaddr\fR [\fB\-\-vpc\fR] [\fB\-v\fR] \fIIP\-OR\-ALLOCID\fR
.PP
\fBeclat rmaddr\fR \fB\-\-help\fR
.ad
.hy
.SH DESCRIPTION
This command releases an Elastic IP address.  The address must have been
previously allocated using the
.B mkaddr
command.
.SH OPTIONS
.TP
\fB\-v\fR, \fB\-\-vpc\fR
Release a VPC Elastic IP address.  If this option is given, the
argument is treated as the allocation ID corresponding to the VPC
Elastic IP address.
.SH "OUTPUT AND RETURN VALUE"
The default output format does not display anything if the operation
succeeds.  Otherwise it prints on the standard error the diagnostic
message returned by the Amazon, and returns code 1 to the shell.
.PP
The code 2 is returned if
.B eclat
is unable to recognize the response.
.PP
The code 16 is returned if the operation is not confirmed.
.SH EXAMPLES
.SS 1.
Release the Elastic IP:
.P
.EX
$ eclat rmaddr 192.0.2.1
Really release IP 192.0.2.1 [Y/n] y
.EE
.SS 2.
Same, with confirmation disabled:
.P
.EX
$ eclat -Y rmaddr 192.0.2.1
.EE
.SS 3.
Release the VPC Elastic IP:
.P
.EX
eclat rmaddr \-\-vpc eipalloc\-5723d13e
.EE
.SH "SEE ALSO"
.BR eclat (1),
.BR eclat\-mkaddr (1),
.BR eclat\-assocaddr (1),
.BR eclat\-disassaddr (1).
.SH AUTHORS
Sergey Poznyakoff
.SH "BUG REPORTS"
Report bugs to <bug\-eclat@gnu.org.ua>.
.SH COPYRIGHT
Copyright \(co 2012-2015 Sergey Poznyakoff
.br
.na
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
.br
.ad
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.\" Local variables:
.\" eval: (add-hook 'write-file-hooks 'time-stamp)
.\" time-stamp-start: ".TH [A-Z_][A-Z0-9_.\\-]* [0-9] \""
.\" time-stamp-format: "%:B %:d, %:y"
.\" time-stamp-end: "\""
.\" time-stamp-line-limit: 20
.\" end: