[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH 5/6] trivial hurd manual changes.
From: |
Joshua Branson |
Subject: |
[PATCH 5/6] trivial hurd manual changes. |
Date: |
Thu, 21 Sep 2023 12:48:21 -0400 |
From: "jbranso@dismail.de" <jbranso@dismail.de>
* doc/hurd.texi (Special Files): added a reference to the zero store.
* doc/hurd.texi (Translators): added a sentence about /dev/random.
* doc/hurd.texi (Invoking 'mount'): added a short explanation.
* doc/hurd.texi (Trivfs Callbacks): added @code{FSTYPE_MISC}.
---
doc/hurd.texi | 19 +++++++++++++++----
1 file changed, 15 insertions(+), 4 deletions(-)
diff --git a/doc/hurd.texi b/doc/hurd.texi
index eb994656..4a89cbec 100644
--- a/doc/hurd.texi
+++ b/doc/hurd.texi
@@ -1943,8 +1943,8 @@ Network filesystems, such as @code{nfs} and @code{ftpfs}
(@pxref{Distributed Filesystems}).
@item
-Single files with dynamic content, such as FIXME: we need a good
-example.
+Single files with dynamic content, such as the @code{random}
+translator.
@item
@c FIXME: reword
@@ -2110,6 +2110,15 @@ Only display files that have translators.
@node Invoking mount
@subsection Invoking @code{mount}
+One does not mount filesystem partitions on the Hurd. Instead one
+sets a translator, which translates the device into a filesystem.
+
+# @kbd{settrans /mnt /hurd/ext2fs /dev/hd0s8}
+
+You can still unmount a filesystem partition, via the @kbd{umount}
+command.
+
+# @kbd{umount /dev/hd0s8}
@node Invoking fsysopts
@subsection Invoking @code{fsysopts}
@@ -2307,7 +2316,8 @@ These variables are returned in the @var{st_fstype} and
@var{st_fsid}
fields of @code{struct stat}. @var{trivfs_fstype} should be chosen
from the @code{FSTYPE_*} constants found in
@code{<hurd/hurd_types.h>}. If @code{trivfs_fsid} is zero, trivfs
-will use the pid of the translator instead.
+will use the pid of the translator instead. Most trivial translators
+will want to use @code{FSTYPE_MISC}.
@end deftypevar
@deftypevar {extern int} trivfs_allow_open
@@ -2952,7 +2962,7 @@ with Unix.
This chapter does not discuss @file{/dev/zero} or any of the
microkernel-based devices, since these are translated by the generalized
-storeio server (FIXME xref).
+storeio server's zero store. @xref{the zero store}.
FIXME: finish
@@ -3351,6 +3361,7 @@ consuming the @var{task} send right.
@end deftypevar
@subsubsection @code{zero} store
+@anchor{the zero store}
@cindex @code{zero} store
@deftypevar {extern const struct store_class} store_zero_class
--
2.40.1