home | help 
INSPEEK(1)		      Eclat User Reference		      INSPEEK(1)

NAME
     ispeek - EC2 instance store lister

SYNOPSIS
     ispeek [-NQTdr] [-D STRING] [-b URL] [-p NUMBER] [--base-url=URL] [--delim-
     iter=STRING] [--names] [--quote] [--type] [--port=NUMBER] PATH [KEY...]
     ispeek [-Vh] [--help] [--usage] [--version]

DESCRIPTION
     Lists  contents of the EC2 instance store.  The PATH argument specifies the
     pathname to list.	It is  relative  to  http://169.254.169.254/latest.   If
     PATH  ends  with  a  slash, it is treated as a directory and its content is
     listed.  Otherwise, it is treated as a file.

     Optional KEY arguments are allowed when listing content of a file.  If  one
     or more KEYs are given, the file is parsed as a JSON object.  For each KEY,
     a corresponding value is looked up in the resulting object and printed on a
     separate line, prefixed with KEY and a colon.

     The utility must be run from a EC2 instance.

OPTIONS
     -b, --base=URL
	    Base URL to use, instead of http://169.254.169.254/latest.

     -d, --debug
	    Increase debugging level.

     -p, --port=NUMBER
	    Set remote port number, instead of the default 80.

     Following option applies only when listing directories:

     -r, --recursive
	    List directories recursively.

     The options below configure output if at least one KEY is given:

     -D, --delimiter=STRING
	    Delimit output values with STRING.	Default delimiter is a colon.

     -N, --names
	    Print key names.

     -Q, --quote
	    Quote  string  values.   String  values  will be enclosed in double-
	    quotes.  Double-quote  and	backslash  characters  appearing  within
	    strings will be escaped with backslashes.

     -T, --type
	    Print  type  character.  Type characters are: 0, for null values, b,
	    for booleans, n, for numeric values, s, for strings , a, for arrays,
	    and o, for objects.

     The order of printing is: key name, type, value.

     -V, --version
	    Print program version.

     -h, --help
	    Give a concise help summary.

     --usage
	    Give a short usage message.

EXAMPLES
   Get instance ID
     $ ispeek /meta-data/instance-id
     i-deadbeef

   Print instance data
     $ ispeek /dynamic/instance-identity/document
     {
       "instanceId" : "i-deadbeef",
       "billingProducts" : null,
       ...

   Read availability region and instance type
     $ ispeek /dynamic/instance-identity/document region instanceType
     eu-west-1
     m3.xlarge

   Same, including key names and types in the output
     $ ispeek -NT /dynamic/instance-identity/document region instanceType
     region:s:eu-west-1
     instanceType:s:m3.xlarge

   Recursively list the contents of /meta-data/iam:
     $ ispeek -r meta-data/iam /meta-data/iam/info  /meta-data/iam/security-cre-
     dentials/ /meta-data/iam/security-credentials/user

SEE ALSO
     eclat(1).

AUTHORS
     Sergey Poznyakoff

BUG REPORTS
     Report bugs to <bug-eclat@gnu.org.ua>.

COPYRIGHT
     Copyright (C) 2012-2018 Sergey Poznyakoff
     License GPLv3+: GNU GPL version 3 or later <http://gnu.org/li-
     censes/gpl.html>
     This  is  free software: you are free to change and redistribute it.  There
     is NO WARRANTY, to the extent permitted by law.

INSPEEK 			January 21, 2015		      INSPEEK(1)
home | help