UPLD.IS(1)                     User Commands                     UPLD.IS(1)

 NAME
     upld.is - no bullshit command line pastebin

 SYNOPSIS
     * Web browser    :  Press <Ctrl/Cmd + V>
     * View helptext  :  curl upld.is -L | less
     * Upload file    :  curl upld.is -LT <file path>
     * Upload stdin   :  <command> | curl upld.is -LT -

 DESCRIPTION
     A simple, no bullshit, tamper-proof command line pastebin.

     Pastes are created using HTTP PUT requests, which returns a URL
     based on the hash of the content. Filenames are ignored and can
     be added, modified, or removed entirely.

     Upload URLs and downloaded content can be optionally verified by
     hashing the content with blake3 and encoding the raw hash with
     base58. If the id in the URL does not match, the server response
     is invalid and the service has been tampered with.

     Pastes are always deleted from storage after some time, however,
     the content will remain available in regions that have it cached
     still. Content can always be re-uploaded to the same paste URL.

 NOTES
     * Maximum file size   :  24 MiB
     * Storage TTL         :  7days
     * Regional cache TTL  :  30days
     * All time uploads    :  50

 EXAMPLES
     * Upload from stdin:
         $ echo 'testing' | curl upld.is -LT -
           https://upld.is/p/Ag1BhjbD
         $ curl https://upld.is/p/Ag1BhjbD
           testing

     * Sending and applying a git patch:
         $ git diff | curl upld.is -LT -
           https://upld.is/p/deadbeef
         $ git apply <(curl https://upld.is/p/deadbeef)

     * Password encryption (using gpg):
         $ echo 'testing' | gpg -o- -c | curl upld.is -LT -
           https://upld.is/p/exmpLhsh
         $ curl https://upld.is/p/exmpLhsh | gpg -d
           gpg: AES256.CFB encrypted data
           gpg: encrypted with 1 passphrase
           testing

     * Verified upload (using b3sum + bs58-cli):
         $ echo 'testing' > file
         $ b3sum file --raw | bs58
           Ag1BhjbDQMUjq2rEQVgTNMPFEm8gTUmaJTRw4LUx1u78
         $ curl upld.is -LT file
           https://upld.is/p/Ag1BhjbD

     * Verified download (using b3sum + bs58-cli):
         $ curl https://upld.is/p/Ag1BhjbD | tee file | b3sum --raw | bs58
           Ag1BhjbDQMUjq2rEQVgTNMPFEm8gTUmaJTRw4LUx1u78
         $ cat ./file
           testing

 HISTORY
     * v0.1.0 | May 2017 | sprunge.me
         Single host, disk-backed sprunge.us copy written in golang.
         Featured syntax highlighting via pygments like the original.

     * v1.0.0 | Jul 2017 | comp.st
         Enhanced with many features like automatic paste deletion,
         custom upload directories, markdown rendering, throwaway email
         addresses, and virustotal scanning.

     * v2.0.0 | Dec 2021 | upld.is
         Resurfaced source code and removed complex features.

     * v2.1.0 | Mar 2022 | upld.is
         Moved to an ipfs based storage approach, added an interactive
         HTML frontend.

     * v3.0.0 | Oct 2024 | 0dd.sh, upld.is
         We're back :) Tamper-proof edge service, rewritten from
         scratch in rust. Shorter urls, while still keeping everything
         verifiable using blake3. Removed legacy POST upload method.

 SEE ALSO
     curl(1), gpg(1), b3sum, bs58-cli

     * Privacy policy   :  https://upld.is/privacy
     * Source code      :  https://github.com/ozwaldorf/0dd.sh
     * Favicon by       :  https://icons8.com
     * Donations - ETH  :  0x45b2c262fae9c449f9067d65dcc82ba18d087241

     Copyright (c) 2024 Ossian Mapes, MIT license

upld.is 3.0.0                   2024-10-23                       UPLD.IS(1)