1 e5f060f0 2023-07-24 op .\" Copyright (c) 2023 Omar Polo <op@omarpolo.com>
 2 e5f060f0 2023-07-24 op .\"
 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.
 6 e5f060f0 2023-07-24 op .\"
 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
15 e5f060f0 2023-07-24 op .Dt TITAN 1
16 e5f060f0 2023-07-24 op .Os
17 e5f060f0 2023-07-24 op .Sh NAME
18 e5f060f0 2023-07-24 op .Nm titan
19 f5229719 2023-10-20 op .Nd Titan client
20 e5f060f0 2023-07-24 op .Sh SYNOPSIS
21 e5f060f0 2023-07-24 op .Nm
22 e5f060f0 2023-07-24 op .Bk -words
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
27 e5f060f0 2023-07-24 op .Ar url
28 e5f060f0 2023-07-24 op .Op Ar file
29 e5f060f0 2023-07-24 op .Ek
30 e5f060f0 2023-07-24 op .Sh DESCRIPTION
31 e5f060f0 2023-07-24 op .Nm
32 797c527a 2023-10-19 op allows to upload data to a Titan server.
33 e5f060f0 2023-07-24 op If no
34 e5f060f0 2023-07-24 op .Ar file
35 e5f060f0 2023-07-24 op is given on the command line,
36 e5f060f0 2023-07-24 op .Nm
37 e5f060f0 2023-07-24 op reads from standard input.
38 e5f060f0 2023-07-24 op .Pp
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.
45 e5f060f0 2023-07-24 op Defaults to
46 e5f060f0 2023-07-24 op .Fl C
47 e5f060f0 2023-07-24 op if provided.
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.
54 e5f060f0 2023-07-24 op .El
55 e5f060f0 2023-07-24 op .Pp
56 797c527a 2023-10-19 op .Nm
57 797c527a 2023-10-19 op alters the passed
58 797c527a 2023-10-19 op .Ar url
59 797c527a 2023-10-19 op to include the parameter for the file size as well as the MIME and the
60 797c527a 2023-10-19 op token if
61 e5f060f0 2023-07-24 op .Fl m
62 e5f060f0 2023-07-24 op or
63 e5f060f0 2023-07-24 op .Fl t
64 797c527a 2023-10-19 op are given.
65 e5f060f0 2023-07-24 op .Sh EXIT STATUS
66 e5f060f0 2023-07-24 op The
67 e5f060f0 2023-07-24 op .Nm
68 e5f060f0 2023-07-24 op utility exits with one of the following values:
69 e5f060f0 2023-07-24 op .Pp
70 e5f060f0 2023-07-24 op .Bl -tag -width Ds -offset indent -compact
71 e5f060f0 2023-07-24 op .It 0
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.
74 e5f060f0 2023-07-24 op .It 1
75 e5f060f0 2023-07-24 op An error occurred.
76 e5f060f0 2023-07-24 op .It 2
77 e5f060f0 2023-07-24 op The response code was not in the 2x or 3x range.
78 e5f060f0 2023-07-24 op .El
79 dba9907a 2023-10-18 op .Sh SEE ALSO
80 dba9907a 2023-10-18 op .Xr ftp 1 ,
81 dba9907a 2023-10-18 op .Xr gg 1
82 e5f060f0 2023-07-24 op .Sh STANDARDS
83 e5f060f0 2023-07-24 op .Nm
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
87 e5f060f0 2023-07-24 op .Sh AUTHORS
88 e5f060f0 2023-07-24 op .An -nosplit
89 e5f060f0 2023-07-24 op The
90 e5f060f0 2023-07-24 op .Nm
91 e5f060f0 2023-07-24 op utility was written by
92 e5f060f0 2023-07-24 op .An Omar Polo Aq Mt op@omarpolo.com .
93 e5f060f0 2023-07-24 op .Sh CAVEATS
94 e5f060f0 2023-07-24 op .Nm
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.