aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorSergey Poznyakoff <gray@gnu.org.ua>2015-01-21 11:05:45 +0200
committerSergey Poznyakoff <gray@gnu.org.ua>2015-01-21 11:13:33 +0200
commit5fe918d1f84af9b1f70deb152bf20d0b8a296524 (patch)
treebf97fd6460a92260a1f3563c7583febe6ca863d1 /doc
parentf896658fd2c2c2b832536adb8af5ae6789c387a2 (diff)
downloadeclat-5fe918d1f84af9b1f70deb152bf20d0b8a296524.tar.gz
eclat-5fe918d1f84af9b1f70deb152bf20d0b8a296524.tar.bz2
Add ispeek.
* src/ispeek.c: New file. * src/ispeek-cl.opt: New file * src/Makefile.am: Add ispeek * src/io.c (dump, eclat_trace_fun): Moved to the library. (eclat_io_setup): Use eclat_set_curl_trace. * NEWS: Document ispeek. * doc/Makefile.inc: Add ispeek.1 * doc/eclat.1man: Mention ispeek(1) in the "see also" section. * doc/eclat.conf.5: Update. * doc/ispeek.1: New file. * lib/Makefile.am (libeclat_a_SOURCES): Add trace.c * lib/libeclat.h (eclat_trace_fun) (eclat_set_curl_trace): New proto. * lib/trace.c: New file.
Diffstat (limited to 'doc')
-rw-r--r--doc/Makefile.inc3
-rw-r--r--doc/eclat.1man7
-rw-r--r--doc/eclat.conf.54
-rw-r--r--doc/ispeek.197
4 files changed, 105 insertions, 6 deletions
diff --git a/doc/Makefile.inc b/doc/Makefile.inc
index f777f59..8d9ae4c 100644
--- a/doc/Makefile.inc
+++ b/doc/Makefile.inc
@@ -59,7 +59,8 @@ MANPAGES1=\
eclat-setsattr.1\
eclat-sg.1\
eclat-start.1\
- eclat-stop.1
+ eclat-stop.1\
+ ispeek.1
MANPAGES5=\
eclat.conf.5
diff --git a/doc/eclat.1man b/doc/eclat.1man
index 5030d7f..50cc3e2 100644
--- a/doc/eclat.1man
+++ b/doc/eclat.1man
@@ -13,7 +13,7 @@
.\"
.\" 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 "January 20, 2015" "ECLAT" "Eclat User Reference"
+.TH ECLAT 1 "January 21, 2015" "ECLAT" "Eclat User Reference"
.SH NAME
eclat \- EC2 Command Line Administrator Tool
.SH SYNOPSIS
@@ -530,13 +530,14 @@ These options are processed before the actual command line options.
.SH "SEE ALSO"
.BR eclat.conf (5),
.so xref.man
-.BR forlan (5).
+.BR forlan (5),
+.BR ispeek (1).
.SH AUTHORS
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.conf.5 b/doc/eclat.conf.5
index adf3796..dd9489c 100644
--- a/doc/eclat.conf.5
+++ b/doc/eclat.conf.5
@@ -13,7 +13,7 @@
.\"
.\" 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.CONF 5 "January 20, 2015" "ECLAT" "Eclat User Reference"
+.TH ECLAT.CONF 5 "January 21, 2015" "ECLAT" "Eclat User Reference"
.SH NAME
eclat.conf \- configuration file for
.BR eclat (1).
@@ -914,7 +914,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/ispeek.1 b/doc/ispeek.1
new file mode 100644
index 0000000..2cfba44
--- /dev/null
+++ b/doc/ispeek.1
@@ -0,0 +1,97 @@
+.\" 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 INSPEEK 1 "January 21, 2015" "INSPEEK" "Eclat User Reference"
+.SH NAME
+ispeek \- EC2 instance store lister
+.SH SYNOPSIS
+\fBispeek\fR\
+ [\fB\-Ndr\fR]\
+ [\fB\-b\fR \fIURL\fR]\
+ [\fB\-p\fR \fINUMBER\fR]\
+ [\fB\-\-no\-names\fR]\
+ [\fB\-\-base\-url=\fIURL\fR]\
+ [\fB\-\-port=\fINUMBER\fR]\
+ \fIPATH\fR\
+ [\fIKEY\fR...]
+.br
+\fBispeek\fR\
+ [\fB\-Vh\fR]\
+ [\fB\-\-help\fR]\
+ [\fB\-\-usage\fR]\
+ [\fB\-\-version\fR]
+.SH DESCRIPTION
+Lists contents of the EC2 instance store. The \fIPATH\fR argument
+specifies the pathname to list. It is relative to
+.BR http://169.254.169.254/latest .
+If \fIPATH\fR ends with a slash, it is treated as a directory and
+its content is listed. Otherwise, it is treated as a file.
+.PP
+Optional \fIKEY\fR arguments are allowed when listing content of a
+file. If one or more \fIKEY\fRs are given, the file is parsed as
+a JSON object. For each \fIKEY\fR, a corresponding value is looked
+up in the resulting object and printed on a separate line, prefixed
+with \fIKEY\fR and a colon.
+.PP
+The utility must be run from a EC2 instance.
+.SH OPTIONS
+.TP
+\fB\-N\fR, \fB\-\-no\-names
+Don't print key names. This option takes effect only if at least one
+\fIKEY\fR is given.
+.TP
+\fB\-b\fR, \fB\-\-base=\fIURL\fR
+Base URL to use, instead of
+.BR http://169.254.169.254/latest .
+.TP
+\fB\-d\fR, \fB-\-debug\fR
+Increase debugging level.
+.TP
+\fB\-p\fR, \fB\-\-port=\fINUMBER\fR
+Set remote port number, instead of the default \fB80\fR.
+.TP
+\fB\-r\fR, \fB\-\-recursive
+List directories recursively.
+.TP
+\fB\-V\fR, \fB\-\-version\fR
+Print program version.
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Give a concise help summary.
+.TP
+\fB\-\-usage\fR
+Give a short usage message.
+.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-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:

Return to:

Send suggestions and report system problems to the System administrator.