From 3a7bbd73c8e364d290175ae5afee60f6d825ea36 Mon Sep 17 00:00:00 2001 From: Thomas Schwinge Date: Fri, 14 Sep 2007 18:23:56 +0200 Subject: Even more page naming consistency. --- hurd/concepts.mdwn | 4 ++-- hurd/hurd_hacking_guide.mdwn | 20 ++++++++++++++++++++ hurd/hurdhackingguide.mdwn | 20 -------------------- hurd/translator.mdwn | 9 +++++---- hurd/virtual_file_system.mdwn | 34 ++++++++++++++++++++++++++++++++++ hurd/virtualfilesystem.mdwn | 34 ---------------------------------- 6 files changed, 61 insertions(+), 60 deletions(-) create mode 100644 hurd/hurd_hacking_guide.mdwn delete mode 100644 hurd/hurdhackingguide.mdwn create mode 100644 hurd/virtual_file_system.mdwn delete mode 100644 hurd/virtualfilesystem.mdwn (limited to 'hurd') diff --git a/hurd/concepts.mdwn b/hurd/concepts.mdwn index a2bbc2bc..dca95ed9 100644 --- a/hurd/concepts.mdwn +++ b/hurd/concepts.mdwn @@ -16,6 +16,6 @@ redistribute your contributions. """]] * [[Translator]] -* [[VirtualFileSystem]] +* [[Virtual_File_System]] * [[Authentication]] -* [[NeighborHurd]] +* [[Neighborhurd]] diff --git a/hurd/hurd_hacking_guide.mdwn b/hurd/hurd_hacking_guide.mdwn new file mode 100644 index 00000000..91b33bcf --- /dev/null +++ b/hurd/hurd_hacking_guide.mdwn @@ -0,0 +1,20 @@ +[[license text=""" +Copyright © 2007 Free Software Foundation, Inc. + +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.txt]]. + +By contributing to this page, you agree to assign copyright for your +contribution to the Free Software Foundation. The Free Software Foundation +promises to always use either a verbatim copying license or a free +documentation license when publishing your contribution. We grant you back all +your rights under copyright, including the rights to copy, modify, and +redistribute your contributions. +"""]] + +Originally written by Wolfgang Jährling, the [Hurd Hacking Guide](http://www.gnu.org/software/hurd/hacking-guide/hhg.html) +contains an overview of some of the Hurd's features. +Also contains a tutorial on writing your own [[translator]]. diff --git a/hurd/hurdhackingguide.mdwn b/hurd/hurdhackingguide.mdwn deleted file mode 100644 index 7fba69c9..00000000 --- a/hurd/hurdhackingguide.mdwn +++ /dev/null @@ -1,20 +0,0 @@ -[[license text=""" -Copyright © 2007 Free Software Foundation, Inc. - -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.txt]]. - -By contributing to this page, you agree to assign copyright for your -contribution to the Free Software Foundation. The Free Software Foundation -promises to always use either a verbatim copying license or a free -documentation license when publishing your contribution. We grant you back all -your rights under copyright, including the rights to copy, modify, and -redistribute your contributions. -"""]] - -Originally written by Wolfgang Jährling, the [Hurd Hacking Guide](http://www.gnu.org/software/hurd/hacking-guide/hhg.html) -contains an overview of some of the Hurd's features. -Also contains a tutorial on writing your own translator. diff --git a/hurd/translator.mdwn b/hurd/translator.mdwn index 3265fac4..645f05ca 100644 --- a/hurd/translator.mdwn +++ b/hurd/translator.mdwn @@ -17,7 +17,7 @@ redistribute your contributions. A translator is simply a normal program acting as an object server and participating in the Hurd's -distributed [[VirtualFileSystem]]. It is so-called +distributed [[virtual_file_system]]. It is so-called because it typically exports a file system (although need not: cf. [[auth]], [[proc]] and [[pfinet]]) and thus translates object invocations @@ -27,7 +27,7 @@ into calls appropriate for the backing store Translators do not require any special privilege to run. The privilege they require is simply that to access the indiviudal resources they use. -This is primarily the backing store and the node +This is primarily the [[backing_store]] and the node they attach to. Typically, a translator can only be attached to a node by the node's owner. On Unix this is not possible because file systems @@ -36,8 +36,9 @@ kernel and thus have absolute access to the machine. As the protocols do not require any special privilege to implement, this is not an issue on the Hurd. -See [[Translators]] for a list of Hurd translators. + + To learn how to write a translator, read the code! It is well documented, in particular, the header files. -The [[HurdHackingGuide]] also has a tutorial. +The [[Hurd_Hacking_Guide]] also has a tutorial. diff --git a/hurd/virtual_file_system.mdwn b/hurd/virtual_file_system.mdwn new file mode 100644 index 00000000..33e4f8a7 --- /dev/null +++ b/hurd/virtual_file_system.mdwn @@ -0,0 +1,34 @@ +[[license text=""" +Copyright © 2007 Free Software Foundation, Inc. + +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.txt]]. + +By contributing to this page, you agree to assign copyright for your +contribution to the Free Software Foundation. The Free Software Foundation +promises to always use either a verbatim copying license or a free +documentation license when publishing your contribution. We grant you back all +your rights under copyright, including the rights to copy, modify, and +redistribute your contributions. +"""]] + +Path names are resolved using a distributed protocol. +No single entity is responsible for the resolution of +path names. A file system server (a [[translator]]) +attaches to translators (`fs.defs:file_set_translator`). + +When a process resolves an aboslute path, it queries +its root file system server by invoking the `fs.defs:dir_lookup` +method in the capability in its root directory slot. The +file system server resolves as much as it knows about locally +and when it encounters a translator, it replies to the client +indicating how much it resolved and where to continue its +lookup. This continues until the name is fully resolved +or an error occurs. The same happens for relative path +names but a different capability is used. + +For a more detailed explanation of the protocol, look at the section +2.2 of the [[critique]]. diff --git a/hurd/virtualfilesystem.mdwn b/hurd/virtualfilesystem.mdwn deleted file mode 100644 index 33e4f8a7..00000000 --- a/hurd/virtualfilesystem.mdwn +++ /dev/null @@ -1,34 +0,0 @@ -[[license text=""" -Copyright © 2007 Free Software Foundation, Inc. - -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.txt]]. - -By contributing to this page, you agree to assign copyright for your -contribution to the Free Software Foundation. The Free Software Foundation -promises to always use either a verbatim copying license or a free -documentation license when publishing your contribution. We grant you back all -your rights under copyright, including the rights to copy, modify, and -redistribute your contributions. -"""]] - -Path names are resolved using a distributed protocol. -No single entity is responsible for the resolution of -path names. A file system server (a [[translator]]) -attaches to translators (`fs.defs:file_set_translator`). - -When a process resolves an aboslute path, it queries -its root file system server by invoking the `fs.defs:dir_lookup` -method in the capability in its root directory slot. The -file system server resolves as much as it knows about locally -and when it encounters a translator, it replies to the client -indicating how much it resolved and where to continue its -lookup. This continues until the name is fully resolved -or an error occurs. The same happens for relative path -names but a different capability is used. - -For a more detailed explanation of the protocol, look at the section -2.2 of the [[critique]]. -- cgit v1.2.3