|A bridge between your data, and Infinite Storage
JS3tream -h usage output
JS3tream v0.6.2 - December 19, 2007
Protected under the LGPL
Copyright (c) Shane Powell 2007
[-K,--keyfile] <file> - A key/secret properties file. This is the preferred
method. The property file must have 2 entries each on it's own line
key=<your key id>
secret=<your s3 secret>
[-k,--key] - The Amazon S3 Key ID. Not needed with -K option.
[-s,--secret] - The Amazon S3 Secret Key. It is not a good idea
to use this option Because someone can do a 'ps' on your system, and see
the full command line, including your Secret and key.
Use the -K method instead.
[-b,--bucket] <bucket><:prefix> - The Amazon S3 bucket. This is what we
refer to as an S3 Archive. You can also specify an optional object
prefix with the ":" character. This allows a single bucket to hold
multiple streams of data. For example "bucket-1234:A" puts all the
data into bucket "bucket-1234" and prefixes each data block with "A".
You can then put another stream into "bucket-1234:B" and they will
not impact each other.
[-i,--in] Read the STDIN stream, and send it to S3.
[-o,--out] - Read the data from S3, and pipe it to STDOUT
[-l,--list] - List the archives on S3. This is basically the list of S3
buckets. If you provide a bucket name, it it will list the contents of
[-d,--delete] - Delete the S3 archive. If you specified a prefix, then only
the data associated with that bucket:prefix combo is deleted. If you
did not specify a prefix then ALL bucket data, and the bucket itself
will be deleted
[-t,--tag] - Add a description tag to the s3 stream. This will be displayed
with the -l option.
[-p,--pretend] - Pretend to perform the requested action and output what
would have happened to stderr. Implies -v option.
[-f,--file] - Buffer all stream data into temp file rather than memory.
This is affected by the -z option. Use this when you want to send
very large stream parts.
[-z,--size] - Specify the size in bytes that the stream will be broken into
inside the bucket. Default is 5000000 This can impact memory requirements
on your system, as a buffer if this size is created in memroy or on file
based on the -f option. This is only used when sending data to S3 with
the -i option.
[-n,--neverdie] - Specify this option to tell JS3tream to NEVER giveup try
to send data to S3. The default is to make 5 attempts, then quit.
But, if this happens, then we must restart the entire operation.
However, specify the -n option, and JS3tream will trying to complete the
operation, unless broken by the user. After 5 failed attempts in a row,
JS3tream will wait 30 minutes, and start another 5 retries. This will
[-v,--verbose] - Output Verbose activity messages to stderr.
This has no impact on your stdin or sdtout streams
[-V, --version] - Output the JS3tream version.
[--debug] - Turn on Debugging output. This will result in more detailed
[-h,--help] - Print this usage.