.\" This file is part of Eclat -*- nroff -*-
.\" Copyright (C) 2012, 2013 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 .
.TH ASSOCADDR 1 "April 20, 2013" "ECLAT" "Eclat User Reference"
.SH NAME
eclat assocaddr, associate\-address \- associate an IP address with an instance
.SH SYNOPSIS
\fBeclat assocaddr\fR [\fIOPTIONS\fR] \fIINSTANCE\fR \fIIP\fR
\fBeclat assocaddr\fR [\fIOPTIONS\fR] \fIINSTANCE\fR \fIALLOC\-ID\fR
\fBeclat assocaddr\fR \fB\-\-help\fR
.SH DESCRIPTION
The
.B assocaddr
command associates an Elastic IP address with an non-VPC instance or
associates a VPC Elastic IP address with an instance in your VPC.
.PP
The first argument is always the ID of the instance to operate upon.
The meaning of the second argument depends on the \fB\-\-vpc\fR command
line option. If that option is given, the second argument supplies the
allocation ID that AWS returned when you allocated the Elastic IP
address for use with Amazon VPC. Otherwise, it is the Elastic IP to
assign to the non-VPC instance.
.SH OPTIONS
.TP
\fB\-A\fR, \fB\-\-allow\-reassociation\fR
Allows an already associated address to be re-associated with the
specified instance (VPC only).
.TP
\fB\-i\fR, \fB\-\-interface\fR=\fIIFACE\fR
A network interface ID to associate with the instance (vpc only).
.TP
\fB\-p\fR, \fB\-\-private\-address\fR=\fIADDRESS\fR
Private IP address to associate with the Elastic IP address (vpc
only).
.TP
\fB\-v\fR, \fB\-\-vpc\fR
Assign VPC addresses.
.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.
.SH EXAMPLES
.SS 1.
Assign an Elastic IP to the instance:
.P
.nf
.B eclat assocaddr i\-2ea64347 192.0.2.1
.fi
.SS 2.
Associate an IP address with an instance in the VPC:
.P
.nf
.B eclat assocaddr \-\-vpc i\-4fd2431a eipalloc\-5723d13e
.fi
.SH "SEE ALSO"
.BR eclat (1),
.BR eclat\-allocaddr (1),
.BR eclat\-freeaddr (1),
.BR eclat\-disassaddr (1).
.SH AUTHORS
Sergey Poznyakoff
.SH "BUG REPORTS"
Report bugs to .
.SH COPYRIGHT
Copyright \(co 2012, 2013 Sergey Poznyakoff
.br
.na
License GPLv3+: GNU GPL version 3 or later
.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: