diff options
author | Sergey Poznyakoff <gray@gnu.org.ua> | 2015-01-21 11:05:45 +0200 |
---|---|---|
committer | Sergey Poznyakoff <gray@gnu.org.ua> | 2015-01-21 11:13:33 +0200 |
commit | 5fe918d1f84af9b1f70deb152bf20d0b8a296524 (patch) | |
tree | bf97fd6460a92260a1f3563c7583febe6ca863d1 /doc | |
parent | f896658fd2c2c2b832536adb8af5ae6789c387a2 (diff) | |
download | eclat-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.inc | 3 | ||||
-rw-r--r-- | doc/eclat.1man | 7 | ||||
-rw-r--r-- | doc/eclat.conf.5 | 4 | ||||
-rw-r--r-- | doc/ispeek.1 | 97 |
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: |