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
|
.Dd December 8, 2014
.Dt RATOX 1
.Os
.Sh NAME
.Nm ratox
.Nd FIFO based tox client
.Sh SYNOPSIS
.Nm
.Op Fl 4 | Fl 6
.Op Fl E | Fl e
.Op Fl tp
.Op Ar savefile
.Sh DESCRIPTION
.Nm
is a client implementation of the rather popular tox protocol.
Unlike other clients relying on GUIs as an interface to the user, ratox is
developed with the UNIX-philosophy in mind and allows complete
interaction through FIFOs.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl 4
Switch to IPv4-only mode. This is the default.
.It Fl 6
Switch to IPv6-only mode.
.It Fl E
Enable save file encryption.
.It Fl e
Disable save file encryption.
.It Fl t
Enable TCP mode. By default, tox operates with UDP and is recommended, as TCP mode implies certain security considerations.
.It Fl p
Enable TCP SOCKS5 proxy as specified in \fIconfig.h\fR when the package was built.
By default when this option is enabled, ratox will use a proxy on \fB127.0.0.1:8080\fR.
.It Ar savefile
Specify the path of the save file to load a profile from or create a new one at.
.El
.Sh CONFIGURATION
.Nm
is configured by modifying \fIconfig.h\fR and recompiling the code. Apart from
the command line options there are a few more options that can be tweaked at compile
time.
.Pp
You can encrypt/decrypt your save file by setting \fBencryptsavefile\fR to \fB1\fR | \fB0\fR or
specifying
.Fl E
|
.Fl e
respectively. In the former case it will prompt you for a new passphrase, in the latter it will ask you to enter your current passphrase and will then write the save file unencrypted.
.Pp
Trying to load or decrypt an encrypted save file,
.Nm
will ask you to supply a passphrase.
.Sh FILESYSTEM STRUCTURE
.Ss Global slots
Each of the following global slots contain an \fBin\fR, \fBout\fR and
\fBerr\fR file or directory respectively. Piping data into the \fBin\fR FIFO
modifies the state of the respective slot. If any output is expected it will
be found by reading \fBout\fR. Errors are reported via \fBerr\fR.
.Pp
.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
.It Ar name/in
Change the name.
.It Ar name/out
Contains the current name.
.It Ar nospam/in
Change the nospam value.
.It Ar nospam/out
Contains the current nospam.
.It Ar state/in
Change the user state. Possible values are \fBnone\fR,
\fBaway\fR and \fBbusy\fR.
.It Ar state/out
Contains the current user state.
.It Ar status/in
Change the status message.
.It Ar status/out
Contains the current status message.
.It Ar request/in
Initiate a friend request by echoing your friend's tox-id to the input FIFO.
.It Ar request/out/<tox-id>
Echo \fB1\fR or \fB0\fR to accept or reject the friend request respectively.
.El
.Ss Friend slots
Friend slots allow you to communicate with your friends. They handle sending
text messages, files or starting a voice call.
.Pp
.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
.It Ar call_in
Initiate a call by attaching an audio source to this FIFO. For example
arecord -r 48000 -c 1 -f S16_LE > \fBcall_in\fR.
.It Ar call_out
Answer an incoming call by piping it into an audio sink. For example
aplay -r 48000 -c 1 -f S16_LE < \fBcall_out\fR.
.It Ar call_state
Reports the call state, possible values are \fBnone\fR, \fBpending\fR
and \fBactive\fR.
.It Ar file_in
Initiate a file transfer. For example cat file > \fBfile_in\fR.
.It Ar file_out
Accept an incoming file transfer. For example cat \fBfile_out\fR
> file.
.It Ar file_pending
Contains the filename if transfer is pending, empty otherwise.
.It Ar name
The friend's name.
.It Ar online
It is \fB1\fR if the friend is online, \fB0\fR otherwise.
.It Ar remove
Echo \fB1\fR to remove a friend.
.It Ar state
The friend's user state. Possible values are \fBnone\fR,
\fBaway\fR and \fBbusy\fR.
.It Ar status
The friend's status message.
.It Ar text_in
Send a text message to the friend by echoing data to this
FIFO.
.It Ar text_out
Receive text messages from the friend by reading from this
file. For example tail -f \fBtext_out\fR.
.El
.Ss Misc files
.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
.It Ar id
Contains your tox-id.
.El
.Sh AUTHORS
.Nm
was written by Dimitris Papastamos <sin@2f30.org> and
Laslo Hunhold <dev@frign.de>.
|
