pb/pb.1

77 lines
1.7 KiB
Groff
Raw Normal View History

.TH PB 1 "03 November 2022" "v2022.11.03"
2018-10-10 00:32:36 +00:00
.SH NAME
pb \- a helper utility for using 0x0 pastebin services
2018-10-10 00:32:36 +00:00
.SH SYNOPSIS
2018-10-10 00:44:27 +00:00
.B pb
2020-10-27 01:59:49 +00:00
[-fucvh] [-s server_endpoint] [-e bin_extension]
.P
2018-10-10 00:32:36 +00:00
.SH DESRIPTION
.B pb
provides an easy-to-use interface for uploading images
or piping output to a 0x0 pastebin service. While it
comes pre-configured with a specific pastebin, the
service endpoint can be overridden.
2018-10-10 00:32:36 +00:00
Data input can be provided as an argument or via stdin.
The data will be processed as binary or text
based on the context.
2018-10-10 00:32:36 +00:00
The options are as follows:
.TP
.B -f
2018-10-10 00:32:36 +00:00
Explicitly interpret stdin as filename or names.
.TP
2018-10-10 00:40:54 +00:00
.BI -s " server_address"
2018-10-10 00:32:36 +00:00
Use alternative pastebin server address.
.TP
.BI -e " bin_extension"
Specifes the file extension used in the upload of binary content passed to
.B pb
via standard input.
2018-10-10 00:21:18 +00:00
.TP
.B -c
2018-10-10 00:32:36 +00:00
Pretty color output.
.TP
.B -v
Display current version information.
.TP
.B -h
Show the help.
2018-10-10 00:32:36 +00:00
2018-10-10 00:40:54 +00:00
.SH EXIT STATUS
The
.B pb
utility exits 0 on success, and >0 if an error occurs.
2018-10-10 00:32:36 +00:00
.SH EXAMPLES
.TP
.B pb scores.txt
Upload 'scores.txt' to the pastebin
.TP
2020-01-20 14:39:00 +00:00
.B pb < script.sh
Upload executable 'script.sh' as plain text to the pastebin
.TP
2018-10-10 00:32:36 +00:00
.B echo 'Secret info' | pb
Upload piped output to the pastebin
.TP
.B find . -type f -name '*.js' -print | pb -f
Upload a list of files to the pastebin individually
2020-01-20 14:33:57 +00:00
.TP
2018-10-10 00:32:36 +00:00
.B pb -s http://0x0.st scores.txt
Upload a file to a different pastebin endpoint
.TP
2020-10-27 01:51:01 +00:00
.B curl -s https://some/image/file.png | pb -e "png"
Download a binary file and re-upload it to the pastebin with an explicit binary
type and extension.
2018-10-10 00:32:36 +00:00
.SH BUGS
2018-10-10 00:32:36 +00:00
Report issues at the git repository at
.B https://tildegit.org/tomasino/pb
.SH AUTHOR
2020-06-10 22:48:37 +00:00
James Tomasino <james (at) tomasino (dot) org>