1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
|
.\" Copyright (c) 2010 Florian Pritz, flo at xssn.at
.\" 2011 Moritz Wilhelmy, mw at wzff.de
.\"
.\" DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
.\" Version 2, December 2004
.\"
.\" 14 rue de Plaisance, 75014 Paris, France
.\" Everyone is permitted to copy and distribute verbatim or modified
.\" copies of this license document, and changing it is allowed as long
.\" as the name is changed.
.\"
.\" DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
.\" TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
.\"
.\" 0. You just DO WHAT THE FUCK YOU WANT TO.
.\"
.Dd September 12, 2011
.Dt FB 1
.Os
.Sh NAME
.Nm fb
.Nd a shell-script client for http://paste.xinu.at
.Sh SYNOPSIS
.Nm
.Ar file/directory ...
.Nm
.Op Fl dg
.Ar ID/URL ...
.Nm
.Op Fl hv
.Sh DESCRIPTION
.Nm
is a client to http://paste.xinu.at which allows the user to easily upload,
delete or download files.
By default, files will be uploaded as-is and a link to the file will be printed
to stdout after each upload.
.Pp
Before terminating,
.Nm
will try to copy all links into the X clipboard if
.Xr xclip 1
is installed.
Folders will be packed into a tarball with
.Xr tar 1 and the resulting
.Pa upload.tar
file will be uploaded.
If no arguments are given, data will be read from stdin into a temporary file
that will be uploaded as soon as EOF is received..
If the file being uploaded is bigger than 10MB
.Nm
will query the server for the maximum upload size and abort the upload if the
file would be rejected.
.Pp
Following options are supported:
.Bl -tag -width Ds
.It Fl d
Delete the IDs. You can no longer upload files in this mode. If the argument is a URL,
.Nm
will try to extract the ID.
.It Fl g
Download the IDs and output on stdout. Please take care when using this, as
binary data may cause unexpected results when being output directly to a
terminal. You can no longer upload files in this mode. If the argument is a
URL,
.Nm
will try to extract the ID.
.It Fl h
Display a short help message.
.It Fl v
Display the client version.
.It Fl e Ar extension
Change the extension used for highlighting. You can also do this if you
have already uploaded the file by appending the extension to the URL.
http://paste.xinu.at/<ID>/bash will change the syntax highlighting to bash.
.It Fl t
Upload a tar file containing all files and directories specified on the
command line.
.It Fl c
Compress the files to be uploaded using
.Xr gzip 1 .
This affects all files including piped content and folders.
If specified twice,
.Xr xz 1
will be used rather than gzip.
.El
.Pp
If you want to be able to delete files, you have to add the following lines to
.Pa ~/.netrc :
.Pp
.Bd -literal -offset indent
machine paste.xinu.at
password <your_secret_password>
.Ed
.Sh ENVIRONMENT
Some options can be changed by modifying environment variables:
.Bl -tag -width XZ_OPTS
.It Ev GZIP
Assigning GZIP will make the gzip-program treat it's value as if they had been
appended to the command line.
.It Ev XZ_OPTS
The XZ_OPTS environment variable can be used in order to pass additional
options to xz, in case xz is used for compression.
.It TMPDIR
Setting TMPDIR to some directory where
.Nm
create temporary files inside this directory rather than /tmp, if the
underlying mktemp program supports it.
.Sh EXAMPLES
.Bl -tag
.It Nm Fl tc Ar folder file
This will create a .tar archive containing the folder and the file and compress
it using gzip and upload one archive.
.It Nm Fl c Ar folder file
This will create a .tar archive containing only the folder. Both (folder and
file) will be compressed using gzip and uploaded independently.
.It Nm Fl cc Ar folder
This will create a .tar archive containing only the folder and compress it using xz.
.It Ic make \&|\&& Nm
This will upload the output of make (stdout and stderr) in csh and similar shells.
.El
.Sh SEE ALSO
.Xr curl 1 ,
.Xr gzip 1 ,
.Xr mktemp 1 ,
.Xr tar 1 ,
.Xr xz 1 ,
.Xr xclip 1
.Sh AUTHORS
.An -nosplit
.Nm
was written by
.Bl -bullet -compact
.It
.\" mdoc has clever spam protection ;)
.An Florian Pritz Aq fl\&o@xssn.at
.It
.An Moritz Wilhelmy Aq mor\&itz@wzff.de
.El
and may be copied under the terms of the WTFPL.
.Sh BUGS
curl has a nasty comma expansion bug.
When filenames containing a comma are being uploaded, The main branch tries to
address this problem by providing a binary helper that links against libcurl in
order to work around this bug.
The legacy branch, from which this version of fb was obtained is supposed to
remain a plain shell-script client, focusing on fixing all fixable bugs
(i.e. not the curl one) and making it work on all POSIX platforms by removing
code that only works with GNU bash.
|
