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 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.
6 Oct 2010 | bikeshed |