pbput

pbput(1)                           bikeshed                           pbput(1)

NAME
       pbput - compress and encode arbitrary files to pastebin.com

       pbputs - compress, encrypt, encode arbitrary files to pastebin.com

       pbget - decode and decompress arbitrary files from pastebin.com

SYNOPSIS
       pbput [FILENAME]

       cat foo | pbput

       pbputs [FILENAME] [GPG_USER]

       cat foo | pbputs [GPG_USER]

       pbget URL [DIRECTORY]

DESCRIPTION
       pbput  is  a program that can upload text files, binary files or entire
       directory structures to a pastebin, such as pastebin.com.

       pbget is a program that be used  to  retrieve  content  uploaded  to  a
       pastebin by pbput.

       pbputs  operates  exactly  like pbput, except it encrypts the data.  An
       optional GPG_USER argument is allowed, which will sign and encrypt  the
       data  to  the  target  user in one's keyring (which could be oneself!).
       Otherwise, the user is prompted for a symmetric passphrase for encrypt-
       ing the content with gpg(1) before uploading.  pbget will automatically
       prompt the receiving user for the pre-shared passphrase.

       pbput and pbputs can take its input either on STDIN, or as  a  FILENAME
       argument.
         - If STDIN is used, then the receiving user's pbget will simply paste
       the input on STDOUT.
         - If a FILENAME or DIRECTORY is passed as an  argument,  then  it  is
       first  archived  using  tar(1)  to  preserve the file and directory at-
       tributes

       pbget takes a URL as its first,  mandatory  argument.   Optionally,  it
       takes  a  DIRECTORY  as a second parameter.  If the incoming data is in
       fact a file or file structure in a tar(1) archive, then that data  will
       be extracted in the specified DIRECTORY.  If no DIRECTORY is specified,
       then a temporary directory is created using mktemp(1).

       In any case the uploaded/downloaded data is optionally tar(1) archived,
       always  lzma(1)  compressed,  optionally  gpg(1)  encrypted, and always
       base64(1) encoded.  http://pastebin.com is used by default.

EXAMPLES
         $ pbput /sbin/init
         http://pastebin.com/BstNzasK
         $ pbget http://pastebin.com/BstNzasK
         sbin/init
         INFO: Output is in [/tmp/pbget.bG67DwY6Zl]

         $ cat /etc/lsb-release | pbput
         http://pastebin.com/p43gJv6Z
         $ pbget http://pastebin.com/p43gJv6Z
         DISTRIB_ID=Ubuntu
         DISTRIB_RELEASE=11.04
         DISTRIB_CODENAME=natty
         DISTRIB_DESCRIPTION="Ubuntu 11.04"

         $ pbputs /etc/shadow
         Enter passphrase:
         http://pastebin.com/t2ZaCYr3
         $ pbget http://pastebin.com/t2ZaCYr3
         Enter passphrase:
         root:09cc6d2d9d63371a425076e217f77698:15096:0:99999:7:::
         daemon:*:15089:0:99999:7:::
         bin:*:15089:0:99999:7:::
         sys:*:15089:0:99999:7:::
         ....

SEE ALSO
       pastebinit(1), lzma(1), base64(1), tar(1), gpg(1), mktemp(1)

AUTHOR
       This manpage and the utility was  written  by  Dustin  Kirkland  <kirk-
       land@ubuntu.com>  for Ubuntu systems (but may be used by others).  Per-
       mission is granted to copy, distribute and/or modify this document  un-
       der  the  terms  of  the GNU General Public License, Version 2 or later
       published by the Free Software Foundation.

       On Debian systems, the complete text of the GNU General Public  License
       can  be  found  in  /usr/share/common-licenses/GPL,  or  on  the web at
       http://www.gnu.org/licenses/gpl.txt.

bikeshed                          6 Oct 2010                          pbput(1)