aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorSergey Poznyakoff <gray@gnu.org.ua>2015-01-22 17:32:33 +0200
committerSergey Poznyakoff <gray@gnu.org.ua>2015-01-22 17:49:08 +0200
commitf158212743c51bf1ebd44d27ee07a6c2b4867426 (patch)
treed50ec63da5173113bae52b9dfa39bf2ab370cfc6 /doc
parent90262e24c2a3ec8b1e3fa189f80b41166a347555 (diff)
downloadeclat-f158212743c51bf1ebd44d27ee07a6c2b4867426.tar.gz
eclat-f158212743c51bf1ebd44d27ee07a6c2b4867426.tar.bz2
Improve setting UserData attribute. Change lsistat defaults.
* NEWS: Update. * doc/eclat-setiattr.1: Document new options. * doc/eclat-lsistat.1: Update. * etc/describe-instance-attribute.fln: Decode userData. * grecs: Upgrade. * src/setiattr-cl.opt: New file. * src/Makefile.am (OPTFILES): Add setiattr-cl.opt * src/setiattr.c: Encode UserData. * src/eclat.h (read_file): New proto. * src/lsistat-cl.opt: New option -r (--running). * src/lsistat.c: Change default to show all instances, no matter their state. * src/mkinst-cl.opt (read_user_data): Remove. Use read_file instead. * src/sg.c: Add missing include. * src/util.c (read_file): New function.
Diffstat (limited to 'doc')
-rw-r--r--doc/eclat-lsistat.119
-rw-r--r--doc/eclat-setiattr.126
2 files changed, 33 insertions, 12 deletions
diff --git a/doc/eclat-lsistat.1 b/doc/eclat-lsistat.1
index 6d1b9a3..a222701 100644
--- a/doc/eclat-lsistat.1
+++ b/doc/eclat-lsistat.1
@@ -1,5 +1,5 @@
.\" This file is part of Eclat -*- nroff -*-
-.\" Copyright (C) 2012-2014 Sergey Poznyakoff
+.\" 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
@@ -13,11 +13,16 @@
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with Eclat. If not, see <http://www.gnu.org/licenses/>.
-.TH LSISTAT 1 "February 13, 2014" "ECLAT" "Eclat User Reference"
+.TH LSISTAT 1 "January 22, 2015" "ECLAT" "Eclat User Reference"
.SH NAME
eclat lsistat, describe\-instance\-status \- describe status of EC2 instances
.SH SYNOPSIS
-\fBeclat lsistat\fR [\fB\-a\fR] [\fB\-\-all\fR] [\fIFILTER\fR...]
+\fBeclat\fR\
+ \fBlsistat\fR
+ [\fB\-ar\fR]\
+ [\fB\-\-all\fR]\
+ [\fB\-\-running\fR]\
+ [\fIFILTER\fR...]
.PP
\fBeclat lsistat\fR \fB\-\-help\fR
.SH DESCRIPTION
@@ -44,8 +49,10 @@ services it runs, etc.)
.SH OPTIONS
.TP
\fB\-a\fR, \fB\-\-all\fR
-Return the status for all instances. By default, only running
-instances are described.
+Return the status for all instances. This is the default.
+.TP
+\fB\-r\fR, \fB\-\-running\fR
+Show only running instances.
.SH FILTERS
The following filters are defined:
.TP
@@ -162,7 +169,7 @@ Sergey Poznyakoff
.SH "BUG REPORTS"
Report bugs to <bug\-eclat@gnu.org.ua>.
.SH COPYRIGHT
-Copyright \(co 2012-2014 Sergey Poznyakoff
+Copyright \(co 2012-2015 Sergey Poznyakoff
.br
.na
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
diff --git a/doc/eclat-setiattr.1 b/doc/eclat-setiattr.1
index c121f8a..363c9b9 100644
--- a/doc/eclat-setiattr.1
+++ b/doc/eclat-setiattr.1
@@ -1,5 +1,5 @@
.\" This file is part of Eclat -*- nroff -*-
-.\" Copyright (C) 2012-2014 Sergey Poznyakoff
+.\" 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
@@ -13,13 +13,15 @@
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with Eclat. If not, see <http://www.gnu.org/licenses/>.
-.TH SETIATTR 1 "February 13, 2014" "ECLAT" "Eclat User Reference"
+.TH SETIATTR 1 "January 22, 2015" "ECLAT" "Eclat User Reference"
.SH NAME
eclat setiattr, modify\-instance\-attribute \- modifies attribute of an instance
.SH SYNOPSIS
-.nh
-.na
-\fBeclat setiattr\fR \fIINSTANCE-ID\fR \fIATTR\fR\
+\fBeclat setiattr\fR\
+ [\fB\-bf\fR]\
+ [\fB\-\-base64\fR]\
+ [\fB\-\-file\fR]\
+ \fIINSTANCE-ID\fR \fIATTR\fR\
\fIVALUE\fR [\fIVALUE\fR...]
.PP
\fBeclat setiattr\fR \fB\-\-help\fR
@@ -34,6 +36,18 @@ in
.BR eclat (1)),
this command uses the \fBInstanceId\fR map to translate \fIINSTANCE-ID\fR to
the corresponding identifier.
+.SH OPTIONS
+Both options are valid only when setting the value of
+.BR UserData :
+.TP
+\fB\-b\fR, \fB\-\-base64\fR
+Value is already base64-encoded. If that option is not given,
+.B eclat
+assumes the value is plaintext and will encode it.
+.TP
+\fB\-f\fR, \fB\-\-file\fR
+Treat the \fIVALUE\fR argument as the name of file to read the value
+from. To read from the standard input, use \fB\-\fR (a dash).
.SH ATTRIBUTES
The \fIATTR\fR argument can be one of the following:
.TP
@@ -92,7 +106,7 @@ Sergey Poznyakoff
.SH "BUG REPORTS"
Report bugs to <bug\-eclat@gnu.org.ua>.
.SH COPYRIGHT
-Copyright \(co 2012-2014 Sergey Poznyakoff
+Copyright \(co 2012-2015 Sergey Poznyakoff
.br
.na
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>

Return to:

Send suggestions and report system problems to the System administrator.