summaryrefslogtreecommitdiffhomepage
path: root/doc/brpaste.adoc
blob: d15518fa5a0e877b0382a69d940da0dc4e746335 (plain) (blame)
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
= brpaste(1)
Chloe Kudryavtsev
v2.0.0
:doctype: manpage

== Name

brpaste - a pastebin service that's so fast, it burns rubber.

== Synopsis

*brpaste* [_OPTIONS_]

== Options

*-bind*=_BIND_ADDRESS_::
    Bind to address _BIND_ADDRESS_.
*-redis*=_REDIS_URI_::
    Connect to Redis using _REDIS_URI_.
*-storage*=_STORAGE_SYSTEM_::
    What storage system to use. See valid options in <<_storage_systems>>.

== Endpoints

_GET_ */*::
    Index.
    Provides simplified table of this section.
    Provides examples.
    Includes submission form.

_GET_ */:id*::
    User-facing viewer of paste _id_.
    Standard view.

_GET_ */:id/:syntax*::
    Same as */:id*.
    If javascript is available, attempt to highlight the paste as _syntax_.

_GET_ */:id/raw*::
    Raw contents of paste _id_.
    Mime is set to plaintext.

_POST_ */* _data_=*content*::
    Pastebin *content*.
    The _id_ will be the the base64 representation of content's murmurhash3 hash.
    If that _id_ already exists, it is overwritten.

_PUT_ */:id* _data_=*content*::
    Put *content* into _id_.
    If _id_ already exists, abort.

== Storage Systems

Memory::
Selected with "memory".
Not persistent, but very fast.

Redis::
Selected with "redis".
Also the default and recommended option.
Fast and simple.