paste.0x42.sh
				 =============

	  A simple machine to share stuff with people on the internet.



				  Downloading
				  -----------

Download stuff with a simple HTTP GET operation. Tools like curl can do this:

    $ curl https://paste.0x42.sh/index.txt | less
    $ curl https://paste.0x42.sh/favicon.ico --output favicon.ico



				   Uploading
				   ---------

NOTE: Uploads are limited to 128MBs.

You can upload stuff via HTTP POST requests:

    $ echo "hello" | curl -F 'file=@-' https://paste.0x42.sh

Any type of stuff is supported:

    $ curl -F 'file=@picture.jpg' https://paste.0x42.sh

You can upload a file from another URL using the 'remote' form:

    $ curl -F 'remote=https://example.com/picture.jpg' https://paste.0x42.sh

The 'filename' header will override the random file name typically generated:
(cybersquatting rules apply)

    $ curl -F 'file=@x.txt' -H 'filename: example.txt' https://paste.0x42.sh

You can also shorten URLs by using the 'url' form:

    $ curl -F 'url=https://example.com/" https://paste.0x42.sh

I suggest using aliases to simplify the curl commands:

    function paste() {
        curl -F "file=@$1" https://paste.0x42.sh
    }
    function shorten() {
        curl -F "url=$1" https://paste.0x42.sh
    }

for short memorable one-liners like:

    $ echo "hello" | paste -
    $ paste picture.jpg

or:

    $ shorten https://..........



				  Reclamation
				  -----------

Anything uploaded will automatically erase after six months. You can change
this by adding the 'expire' header to the POST request:

    $ curl -F "file=@x.txt" -H "expire: 10min" https://paste.0x42.sh

Available units are:

    - nsec, ns
    - usec, us
    - msec, ms
    - seconds, second, sec, s
    - minutes, minute, min, m
    - hours, hour, hr, h
    - days, day ,d
    - weeks, week, w
    - months, month, M
    - years, year, y

You can also contact me to ask a file be removed:

    - Fedi: @bb@toot.works
    - email: hello @ bryanbrattlof.com

				    Oneshot
				    -------

The 'oneshot' form allows you to limit the upload to a single download before
the information is deleted regardless of expiration date:

    $ curl -F "oneshot=@x.txt" https://paste.0x42.sh

This works for URLs as well with the 'oneshot_url' form:

    $ curl -F 'oneshot_url=https://example.com' https://paste.0x42.sh



				   Supporting
				   ----------

If you wish to support this machine financially, please consider donating to liberapay:
		      https://liberapay.com/bryanb/donate


Happy Hacking
~Bryan