summaryrefslogtreecommitdiffstats
path: root/network/tnfs-fuse/tnfs-fuse.rst
blob: 85b717dcf6e915c169f9826781c4173b15562abd (plain)
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
.. RST source for tnfs-fuse(1) man page. Convert with:
..   rst2man.py tnfs-fuse.rst > tnfs-fuse.1
.. rst2man.py comes from the SBo development/docutils package.

.. |version| replace:: 20130127_fd46ff
.. |date| date::

=========
tnfs-fuse
=========

---------------------------------
trivial network filesystem client
---------------------------------

:Manual section: 1
:Manual group: SlackBuilds.org
:Date: |date|
:Version: |version|

SYNOPSIS
========

tnfs-fuse **directory** **-o address=host**\[:*port*]

DESCRIPTION
===========

TNFS is a simplified Internet file transfer protocol, designed for
simplicity and ease of implementation on small systems, such as 8-bit
computers. It's simpler than NFS, SMB, or FTP. It's similar to TFTP,
but has features TFTP lacks.

**tnfs-fuse** is a client for the TNFS protocol.

Note that **tnfs-fuse** uses TCP to communicate with the TNFS server.
Most TNFS clients are written for smaller systems (e.g. Atari or
Spectrum 8-bit computers) and use UDP. This isn't an actual problem,
but it's a factor to take into account when e.g. setting up firewall
rules to allow TNFS traffic. Also, when troubleshooting a failed
TNFS connection from an 8-bit client, just because you can connect
with **tnfs-fuse** using TCP, doesn't mean the UDP port is open and
working.

When working with mounted TNFS directories, some error messages will
be wrong, e.g. instead of "Permission denied", you may get "Bad file
descriptor".

OPTIONS
=======

**-o address=host**\[:*port*]
  The hostname or IP address of the TNFS server to mount. If *:port* is
  not given, the default TNFS port (16384) is used.

**-o ro**
  Mount read-only.

**tnfs-fuse** supports the full set of **fuse** options. See
**fuse**\(8) or **tnfs-fuse --help** for the list.

EXAMPLE
=======

To mount the TNFS server at **fujinet.online**::

  mkdir fujinet
  tnfs-fuse fujinet -o address=fujinet.online

Now the contents of the TNFS server are visible under fujinet/ (or
whatever name you chose). You might also want to add **-o ro** to mount
read-only.

COPYRIGHT
=========

See the file /usr/doc/tnfs-fuse-|version|/COPYING for license information.

AUTHORS
=======

tnfs-fuse was written by Radu Cristescu.

This man page written for the SlackBuilds.org project
by B. Watson, and is licensed under the WTFPL.

SEE ALSO
========

**tnfsd**\(1), **fuse**\(8)