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 encrypting 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 attributes

       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 <kirkland@ubuntu.com> for Ubuntu systems (but
       may be used by others).  Permission is granted to copy, distribute and/or modify this document under  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)