man-pages/man1/pbput.1.html
2021-03-31 01:06:50 +01:00

106 lines
5.8 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of pbput</TITLE>
</HEAD><BODY>
<H1>pbput</H1>
Section: bikeshed (1)<BR>Updated: 6 Oct 2010<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
pbput - compress and encode arbitrary files to pastebin.com
<P>
pbputs - compress, encrypt, encode arbitrary files to pastebin.com
<P>
pbget - decode and decompress arbitrary files from pastebin.com
<P>
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>pbput</B> [FILENAME]
<P>
cat foo | <B>pbput</B>
<P>
<B>pbputs</B> [FILENAME] [GPG_USER]
<P>
cat foo | <B>pbputs [GPG_USER]</B>
<P>
<B>pbget</B> URL [DIRECTORY]
<P>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<B>pbput</B> is a program that can upload text files, binary files or entire directory structures to a pastebin, such as pastebin.com.
<P>
<B>pbget</B> is a program that be used to retrieve content uploaded to a pastebin by <B>pbput</B>.
<P>
<B>pbputs</B> operates exactly like <B>pbput</B>, 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 <B><A HREF="/cgi-bin/man/man2html?1+gpg">gpg</A></B>(1) before uploading. <B>pbget</B> will automatically prompt the receiving user for the pre-shared passphrase.
<P>
<B>pbput</B> and <B>pbputs</B> can take its input either on STDIN, or as a FILENAME argument.
<BR>&nbsp;&nbsp;-&nbsp;If&nbsp;STDIN&nbsp;is&nbsp;used,&nbsp;then&nbsp;the&nbsp;receiving&nbsp;user's&nbsp;<B>pbget</B>&nbsp;will&nbsp;simply&nbsp;paste&nbsp;the&nbsp;input&nbsp;on&nbsp;STDOUT.
<BR>&nbsp;&nbsp;-&nbsp;If&nbsp;a&nbsp;FILENAME&nbsp;or&nbsp;DIRECTORY&nbsp;is&nbsp;passed&nbsp;as&nbsp;an&nbsp;argument,&nbsp;then&nbsp;it&nbsp;is&nbsp;first&nbsp;archived&nbsp;using&nbsp;<B><A HREF="/cgi-bin/man/man2html?1+tar">tar</A></B>(1)&nbsp;to&nbsp;preserve&nbsp;the&nbsp;file&nbsp;and&nbsp;directory&nbsp;attributes
<P>
<B>pbget</B> 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 <B><A HREF="/cgi-bin/man/man2html?1+tar">tar</A></B>(1) archive, then that data will be extracted in the specified DIRECTORY. If no DIRECTORY is specified, then a temporary directory is created using <B><A HREF="/cgi-bin/man/man2html?1+mktemp">mktemp</A></B>(1).
<P>
In any case the uploaded/downloaded data is optionally <B><A HREF="/cgi-bin/man/man2html?1+tar">tar</A></B>(1) archived, always <B><A HREF="/cgi-bin/man/man2html?1+lzma">lzma</A></B>(1) compressed, optionally <B><A HREF="/cgi-bin/man/man2html?1+gpg">gpg</A></B>(1) encrypted, and always <B><A HREF="/cgi-bin/man/man2html?1+base64">base64</A></B>(1) encoded. <I><A HREF="http://pastebin.com">http://pastebin.com</A></I> is used by default.
<P>
<A NAME="lbAE">&nbsp;</A>
<H2>EXAMPLES</H2>
<BR>&nbsp;&nbsp;$&nbsp;pbput&nbsp;/sbin/init
<BR>&nbsp;&nbsp;<A HREF="http://pastebin.com/BstNzasK">http://pastebin.com/BstNzasK</A>
<BR>&nbsp;&nbsp;$&nbsp;pbget&nbsp;<A HREF="http://pastebin.com/BstNzasK">http://pastebin.com/BstNzasK</A>
<BR>&nbsp;&nbsp;sbin/init
<BR>&nbsp;&nbsp;INFO:&nbsp;Output&nbsp;is&nbsp;in&nbsp;[/tmp/pbget.bG67DwY6Zl]
<P>
<BR>&nbsp;&nbsp;$&nbsp;cat&nbsp;/etc/lsb-release&nbsp;|&nbsp;pbput
<BR>&nbsp;&nbsp;<A HREF="http://pastebin.com/p43gJv6Z">http://pastebin.com/p43gJv6Z</A>
<BR>&nbsp;&nbsp;$&nbsp;pbget&nbsp;<A HREF="http://pastebin.com/p43gJv6Z">http://pastebin.com/p43gJv6Z</A>
<BR>&nbsp;&nbsp;DISTRIB_ID=Ubuntu
<BR>&nbsp;&nbsp;DISTRIB_RELEASE=11.04
<BR>&nbsp;&nbsp;DISTRIB_CODENAME=natty
<BR>&nbsp;&nbsp;DISTRIB_DESCRIPTION=&quot;Ubuntu&nbsp;11.04&quot;
<P>
<BR>&nbsp;&nbsp;$&nbsp;pbputs&nbsp;/etc/shadow
<BR>&nbsp;&nbsp;Enter&nbsp;passphrase:
<BR>&nbsp;&nbsp;<A HREF="http://pastebin.com/t2ZaCYr3">http://pastebin.com/t2ZaCYr3</A>
<BR>&nbsp;&nbsp;$&nbsp;pbget&nbsp;<A HREF="http://pastebin.com/t2ZaCYr3">http://pastebin.com/t2ZaCYr3</A>
<BR>&nbsp;&nbsp;Enter&nbsp;passphrase:
<BR>&nbsp;&nbsp;root:09cc6d2d9d63371a425076e217f77698:15096:0:99999:7:::
<BR>&nbsp;&nbsp;daemon:*:15089:0:99999:7:::
<BR>&nbsp;&nbsp;bin:*:15089:0:99999:7:::
<BR>&nbsp;&nbsp;sys:*:15089:0:99999:7:::
<BR>&nbsp;&nbsp;....
<P>
<A NAME="lbAF">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?1+pastebinit">pastebinit</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?1+lzma">lzma</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?1+base64">base64</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?1+tar">tar</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?1+gpg">gpg</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?1+mktemp">mktemp</A></B>(1)
<P>
<A NAME="lbAG">&nbsp;</A>
<H2>AUTHOR</H2>
This manpage and the utility was written by Dustin Kirkland &lt;<A HREF="mailto:kirkland@ubuntu.com">kirkland@ubuntu.com</A>&gt; 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.
<P>
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 <I><A HREF="http://www.gnu.org/licenses/gpl.txt">http://www.gnu.org/licenses/gpl.txt</A></I>.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="1"><A HREF="#lbAB">NAME</A><DD>
<DT id="2"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="3"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="4"><A HREF="#lbAE">EXAMPLES</A><DD>
<DT id="5"><A HREF="#lbAF">SEE ALSO</A><DD>
<DT id="6"><A HREF="#lbAG">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:22 GMT, March 31, 2021
</BODY>
</HTML>