aboutsummaryrefslogtreecommitdiff
path: root/doc/eclat-associate-address.1
diff options
context:
space:
mode:
Diffstat (limited to 'doc/eclat-associate-address.1')
-rw-r--r--doc/eclat-associate-address.195
1 files changed, 95 insertions, 0 deletions
diff --git a/doc/eclat-associate-address.1 b/doc/eclat-associate-address.1
new file mode 100644
index 0000000..866e914
--- /dev/null
+++ b/doc/eclat-associate-address.1
@@ -0,0 +1,95 @@
+.\" This file is part of Eclat
+.\" Copyright (C) 2012 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 1 "October 1, 2012" "ECLAT" "Eclat User Reference"
+.SH NAME
+eclat associate-address \- associate an IP address with an instance
+.SH SYNOPSIS
+eclat associate-address [\fIOPTIONS\fR] \fIINSTANCE\fR \fIIP\fR
+
+eclat associate-address [\fIOPTIONS\fR] \fIINSTANCE\fR \fIALLOC-ID\fR
+
+eclat associate-address \-\-help
+.SH DESCRIPTION
+The
+.B associate-address
+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 associate-address i-2ea64347 192.0.2.1
+.fi
+.SS 2.
+Associate an IP address with an instance in the VPC:
+.P
+.nf
+.B eclat associate-address --vpc i-4fd2431a eipalloc-5723d13e
+.fi
+.SH "SEE ALSO"
+.BR eclat (1).
+.SH AUTHORS
+Sergey Poznyakoff
+.SH "BUG REPORTS"
+Report bugs to <bug-eclat@gnu.org.ua>.
+.SH COPYRIGHT
+Copyright \(co 2012 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:
+

Return to:

Send suggestions and report system problems to the System administrator.