aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorjbranso@dismail.de <jbranso@dismail.de>2024-10-16 19:30:27 -0400
committerSamuel Thibault <samuel.thibault@ens-lyon.org>2024-11-12 00:40:39 +0100
commita4661b7733f84cceb0ef5bce3f9615493de1f7cf (patch)
tree79a9da9134fb094e49f77a529ea6157d11c4dbf1
parentad5071bf6cfd5626eb3e03253e46d90dce54f68a (diff)
downloadweb-a4661b7733f84cceb0ef5bce3f9615493de1f7cf.tar.gz
web-a4661b7733f84cceb0ef5bce3f9615493de1f7cf.tar.bz2
web-a4661b7733f84cceb0ef5bce3f9615493de1f7cf.zip
add translator/ftpfs page
* hurd/translator.mdwn: add a link to ftpfs * hurd/translator/ftpfs.mdwn: document the fptfs translator with an example. Message-ID: <20241016233039.17856-11-jbranso@dismail.de>
-rw-r--r--hurd/translator.mdwn1
-rw-r--r--hurd/translator/ftpfs.mdwn40
2 files changed, 41 insertions, 0 deletions
diff --git a/hurd/translator.mdwn b/hurd/translator.mdwn
index 720c3b3b..67014a3c 100644
--- a/hurd/translator.mdwn
+++ b/hurd/translator.mdwn
@@ -106,6 +106,7 @@ The [[concept|concepts]] of translators creates its own problems, too:
* [[streamio]]
* [[ext2fs]]
* [[fatfs]]
+* [[ftpfs]]
* [[magic]]
* [[mtab]]
* [[unionfs]]
diff --git a/hurd/translator/ftpfs.mdwn b/hurd/translator/ftpfs.mdwn
new file mode 100644
index 00000000..ac04890c
--- /dev/null
+++ b/hurd/translator/ftpfs.mdwn
@@ -0,0 +1,40 @@
+[[!meta copyright="Copyright © 2024 Free Software Foundation, Inc."]]
+
+[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable
+id="license" text="Permission is granted to copy, distribute and/or modify this
+document under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with no Invariant
+Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license
+is included in the section entitled [[GNU Free Documentation
+License|/fdl]]."]]"""]]
+
+[[!tag stable_URL]]
+
+[[!toc]]
+
+The File Transfer Protocol is a old, simple, and insecure method of
+sharing files between computers. The Hurd supports it via `ftpfs`.
+
+ $ settrans gnu.org /hurd/ftpfs ftp://ftp.gnu.org
+ $ cat ftp\:/ftp.gnu.org/README | grep GNU | head -n 2
+ This is ftp.gnu.org, the FTP server of the the GNU project.
+ gnu/ Contains GNU programs and documents that we develop for the GNU
+
+So it's actually pretty cool to use standard command line utilities to
+search through a remote file. But it is slightly a hassle to set up
+`ftpfs` by hand for each server like this.
+With the Hurd's [[hostmux]] you can actually skip that first
+settrans command, and type in any FTP server and automatically connect
+to it. On my box, this just works:
+
+ $ ls ~/ftp://ftp.gnu.org/
+
+`~/ftp:` is already set up to re-route any path lookup to the correct
+FTP server. You can set up `~/ftp:` on your Hurd OS via the
+[[hostmux]] translator:
+
+ $ settrans -c $HOME/ftp: /hurd/hostmux /hurd/ftpfs /
+
+The [[translator primer|hurd/documentation/translator_primer]] shows
+you how you can use ftpfs to mount a remote iso file and examine its
+contents.