1 e5f060f0 2023-07-24 op .\" Copyright (c) 2023 Omar Polo <op@omarpolo.com>
3 e5f060f0 2023-07-24 op .\" Permission to use, copy, modify, and distribute this software for any
4 e5f060f0 2023-07-24 op .\" purpose with or without fee is hereby granted, provided that the above
5 e5f060f0 2023-07-24 op .\" copyright notice and this permission notice appear in all copies.
7 e5f060f0 2023-07-24 op .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
8 e5f060f0 2023-07-24 op .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
9 e5f060f0 2023-07-24 op .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
10 e5f060f0 2023-07-24 op .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
11 e5f060f0 2023-07-24 op .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
12 e5f060f0 2023-07-24 op .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
13 e5f060f0 2023-07-24 op .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
14 f5229719 2023-10-20 op .Dd October 20, 2023
19 f5229719 2023-10-20 op .Nd Titan client
23 e5f060f0 2023-07-24 op .Op Fl C Ar cert
24 e5f060f0 2023-07-24 op .Op Fl K Ar key
25 e5f060f0 2023-07-24 op .Op Fl m Ar mime
26 e5f060f0 2023-07-24 op .Op Fl t Ar token
30 e5f060f0 2023-07-24 op .Sh DESCRIPTION
32 797c527a 2023-10-19 op allows to upload data to a Titan server.
35 e5f060f0 2023-07-24 op is given on the command line,
37 e5f060f0 2023-07-24 op reads from standard input.
39 e5f060f0 2023-07-24 op The options are as follows:
40 e5f060f0 2023-07-24 op .Bl -tag -width Ds
41 e5f060f0 2023-07-24 op .It Fl C Ar cert
42 e5f060f0 2023-07-24 op Specify the TLS client certificate to use.
43 e5f060f0 2023-07-24 op .It Fl K Ar cert
44 e5f060f0 2023-07-24 op Specify the TLS client certificate key to use.
48 e5f060f0 2023-07-24 op .It Fl m Ar mime
49 e5f060f0 2023-07-24 op Specify the mime of the content being sent.
50 e5f060f0 2023-07-24 op Unset by default.
51 e5f060f0 2023-07-24 op .It Fl t Ar token
52 e5f060f0 2023-07-24 op Specify the token for the transaction.
53 e5f060f0 2023-07-24 op Unset by default.
57 797c527a 2023-10-19 op alters the passed
59 797c527a 2023-10-19 op to include the parameter for the file size as well as the MIME and the
65 e5f060f0 2023-07-24 op .Sh EXIT STATUS
68 e5f060f0 2023-07-24 op utility exits with one of the following values:
70 e5f060f0 2023-07-24 op .Bl -tag -width Ds -offset indent -compact
72 e5f060f0 2023-07-24 op The trasaction completed successfully and the response code was in the
73 e5f060f0 2023-07-24 op 2x or 3x range.
75 e5f060f0 2023-07-24 op An error occurred.
77 e5f060f0 2023-07-24 op The response code was not in the 2x or 3x range.
84 e5f060f0 2023-07-24 op implements the
85 e5f060f0 2023-07-24 op .Dq Titan Specification
86 e5f060f0 2023-07-24 op .Lk gemini://transjovian.org/titan/page/The%20Titan%20Specification
91 e5f060f0 2023-07-24 op utility was written by
92 e5f060f0 2023-07-24 op .An Omar Polo Aq Mt op@omarpolo.com .
95 797c527a 2023-10-19 op doesn't perform TOFU
96 e5f060f0 2023-07-24 op .Pq Trust On First Use
97 e5f060f0 2023-07-24 op or any X.509 certificate validation beyond the name verification.