From efbb008c0636e0163c9da416d0604f617d5542e7 Mon Sep 17 00:00:00 2001 From: Andre Noll Date: Sun, 10 Jul 2022 13:49:25 +0200 Subject: [PATCH 01/16] fs: Add two LWN links to NFS articles by Neil Brown. As always, these are a nice read. --- Filesystems.m4 | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/Filesystems.m4 b/Filesystems.m4 index 903b0b3..1a77ef8 100644 --- a/Filesystems.m4 +++ b/Filesystems.m4 @@ -1513,4 +1513,8 @@ SECTION(«Further Reading»)
  • rfc 5531: Remote Procedure Call Protocol, Version 2 (2009)
  • Birell, A.D. and Nelson, B.J.: Implementing Remote Procedure Calls (1984)
    • +
  • NFS: the early + years and NFS: the new + millennium, two articles on the design and history of NFS by Neil + Brown.
    • -- 2.39.2 From e3c589a6655ed60a54eef2cf0ad0cd8b3edb50b0 Mon Sep 17 00:00:00 2001 From: Andre Noll Date: Thu, 6 Oct 2022 13:18:25 +0200 Subject: [PATCH 02/16] FS: Remove Link to xfs.org page. Code: 500 Can't connect to xfs.org:443 (Connection timed out) Quoting XFS developer Darrick J. Wong on lkml: > Is there a replacement URL for the xfs documentation? None that I know of. Some of it went to xfs.org but then we lost control of it. I tried to push other pieces went to xfs.wiki.kernel.org but then we lost control of that too. Some of it is slowly migrating to the kernel source code, but most of the old stuff is probably not movable because people are afraid of mixing GPL and CC licensed data in the same git repo/git server. --- Filesystems.m4 | 1 - 1 file changed, 1 deletion(-) diff --git a/Filesystems.m4 b/Filesystems.m4 index 1a77ef8..e04f799 100644 --- a/Filesystems.m4 +++ b/Filesystems.m4 @@ -1508,7 +1508,6 @@ SECTION(«Further Reading»)
  • Dominic Giampaolo: Practical File System Design
  • Cormen
  • Darrick Wong: XFS Filesystem Disk Structures
    • -
  • The xfs FAQ
  • Documentation/filesystems/path-lookup.rst
  • rfc 5531: Remote Procedure Call Protocol, Version 2 (2009)
  • Birell, A.D. and Nelson, B.J.: Implementing Remote Procedure Calls -- 2.39.2 From a7c4b1241cc0ce84713a63b622cb4b3cb26cea72 Mon Sep 17 00:00:00 2001 From: Andre Noll Date: Thu, 6 Oct 2022 13:25:02 +0200 Subject: [PATCH 03/16] FS: Replace http link to nfs sourceforge page by https. checklink complains as follows: Code: 301 -> 200 OK To do: This is a permanent redirect. The link should be updated. --- Filesystems.m4 | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Filesystems.m4 b/Filesystems.m4 index e04f799..24bff39 100644 --- a/Filesystems.m4 +++ b/Filesystems.m4 @@ -1432,7 +1432,7 @@ EXERCISES()
  • In an nfs-mounted directory (nfs version 4.0 or earlier), run cat > foo &. Note that the cat process automatically receives the STOP signal. Run rm foo; ls -ltra. Read - section D2 of the nfs HOWTO + section D2 of the nfs HOWTO for the explanation.
  • In an nfs-mounted directory, run { while :; do echo; sleep @@ -1441,7 +1441,7 @@ EXERCISES()
  • Discuss the pros and cons of hard vs. soft mounts.
    • -
  • Read section A10 of the nfs +
  • Read section A10 of the nfs HOWTO to learn about common reasons for stale nfs handles.
  • Can every local filesystem be exported via nfs?
    • -- 2.39.2 From 1278f8074be63e309cde1b92ead1c1d45a8a30e8 Mon Sep 17 00:00:00 2001 From: Andre Noll Date: Wed, 11 Oct 2023 11:09:26 +0200 Subject: [PATCH 04/16] Filesytems: Fix trivial grammar issue. --- Filesystems.m4 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Filesystems.m4 b/Filesystems.m4 index 24bff39..40dedd1 100644 --- a/Filesystems.m4 +++ b/Filesystems.m4 @@ -1385,7 +1385,7 @@ silly renames: An NFS4.1 server knows when it its safe to unlink a file and communicates this information to the client.

    The file handle which an nfs client received through some earlier -rpc can become invalid at any time due to operations on a different +rpc can become invalid at any time due to operations on different hosts. This happens, for example, if the file was deleted on the server or on a different nfs client, or when the directory that contains the file is no longer exported by the server due to a configuration -- 2.39.2 From c8dbbdc20bbcf726672198332ecbda1b3ae642e8 Mon Sep 17 00:00:00 2001 From: Andre Noll Date: Sat, 14 Oct 2023 15:59:26 +0200 Subject: [PATCH 05/16] Networking: Slightly reword veth paragraph. Don't imply that eth0 is always a physical interface and fix a typo/braino: one instance of pair needs to be peer. --- Networking.m4 | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/Networking.m4 b/Networking.m4 index a3a5d65..6acf215 100644 --- a/Networking.m4 +++ b/Networking.m4 @@ -156,15 +156,15 @@ section aim to get the reader started with both tools.

    SUBSECTION(«Virtual Ethernet Interfaces») -

    A bridge can accommodate physical devices like eth0 -as well as virtual devices. On Linux systems the common approach -to equip virtual machines with network interfaces employs the -virtual ethernet (veth) device driver. This driver provides -virtual pairs of devices where each pair represents an ethernet -tunnel. Ethernet frames received by one end appear on its pair. To -set up the network interface for a virtual machine, one end of the -pair is added to a bridge on the host system while the other end -represents the ethernet device of the virtual machine.

    +

    A bridge can accommodate physical devices as well as virtual +devices. On Linux systems the common approach to equip virtual machines +with network interfaces employs the virtual ethernet device +driver, veth. This driver provides virtual pairs of devices where +each pair represents an ethernet tunnel. Ethernet frames received +by one end appear on its peer. To set up the network interface for +a virtual machine, one end of the pair is added to a bridge on the +host system while the other end represents the ethernet device of +the virtual machine.

    EXERCISES()
      -- 2.39.2 From 17dd39db7ffa639bc59ee504bad1419651540c67 Mon Sep 17 00:00:00 2001 From: Andre Noll Date: Sat, 14 Oct 2023 17:07:16 +0200 Subject: [PATCH 06/16] Networking: Fix typo. Remove the duplicate "on". --- Networking.m4 | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/Networking.m4 b/Networking.m4 index 6acf215..f64b341 100644 --- a/Networking.m4 +++ b/Networking.m4 @@ -333,11 +333,11 @@ works and how it can be used to identify networking problems. SECTION(«Transport Layer») -

      The protocols of the transport layer provide message transfer services -which are on one hand independent of the underlying network type, -and on the other hand independent of the application. Different -network services on running on the same host are distinguished by - port numbers, which are 16 bit identifiers. Several well +

      The protocols of the transport layer provide message transfer +services which are on one hand independent of the underlying network +type, and on the other hand independent of the application. Different +network services running on the same host are distinguished by +port numbers, which are 16 bit identifiers. Several well known port numbers are are associated with specific applications. The two dominant transport layer protocols on top of IP, TCP and UDP, are discussed in the following subsections.

      -- 2.39.2 From f2c84ee322431aaf9cce469c66c9d9aa619bc3fe Mon Sep 17 00:00:00 2001 From: Andre Noll Date: Sun, 10 Jul 2022 21:13:43 +0200 Subject: [PATCH 07/16] Improve table of contents menu and style sheet. Major changes to the macros and the .css files which should improve the look and feel of the pages a bit. Most notable is the increased font size and the new layout of the table of contents dropdown menu. No content changes. --- include/css/aple.css | 64 ++++++++++++++++++++++++------------- include/m4/aple.m4 | 76 ++++++++++++++++++++++---------------------- 2 files changed, 80 insertions(+), 60 deletions(-) diff --git a/include/css/aple.css b/include/css/aple.css index e422518..da4c70c 100644 --- a/include/css/aple.css +++ b/include/css/aple.css @@ -1,26 +1,47 @@ body { - background-color: #aacccc; + color: #000; + background-color: #acc; text-align: justify; padding: 0px 30px 0px 25px; - + font-size: 110%; } h1 { - font-size: 150%; + font-size: 160%; +} + +h2 { + font-size: 130%; +} + +h3 { + font-size: 110%; +} + +p { + padding: 0px 0px 0px 0px; } + .logo { border: 0px; - padding: 0em 20px 0px 0px; - margin-left: 0px; - margin-right: 0px; - border: 0px; } table { - margin-left: auto; + margin-left: 0px; margin-right: auto; border: none; + padding: 10px 0px 10px 0px; +} + +table.menu { + padding: none; + border: 0px; + border-spacing: 0px; +} + +table.logo { + margin-left: 0px; } td { @@ -28,6 +49,15 @@ td { padding: 5px; } +td.logo { + border: none; +} + +td.menu { + border: none; + vertical-align: top; +} + svg { float: left; } @@ -38,14 +68,9 @@ svg { border: 0px; } -#overview_heading { - text-align: center; - font-weight: bold; -} - -#overview_text { +.overview { margin: 1% 5% 1% 5%; - font-size: 95%; + font-size: 90%; } div.solution { @@ -69,10 +94,6 @@ dt { text-decoration: underline; } -#chapter_list { - font-size: 120%; -} - .dropdown { position: fixed; top: 0; /* Position the navbar at the top of the page */ @@ -82,11 +103,10 @@ dt { .dropdown-content { display: none; background-color: #8aa; - min-width: 300px; - padding: 12px 12px; - font-size: 75%; + padding: 6px 25px 0px 30px; } .dropdown:hover .dropdown-content { display: block; + font-size: 80%; } diff --git a/include/m4/aple.m4 b/include/m4/aple.m4 index c209513..7b23385 100644 --- a/include/m4/aple.m4 +++ b/include/m4/aple.m4 @@ -13,22 +13,18 @@ define(«REFERENCE», [«REMOVE_NEWLINE(«$2»)»](««#»»«LOCAL_LINK_NAME(« define(«XREFERENCE», «[$2]»«($1)») define(«EMPH», ««_»REMOVE_NEWLINE(«$1»)«_»») define(«CMD», «`REMOVE_NEWLINE(«$1»)`») -define(«SECTION», « -divert(«0») -
    • $1
      • -divert(«2») - -») -define(«SUBSECTION», « -») +define(«SECTION», « divert(«0») $1
      divert(«2»)

      $1

      ») define(«SUBSECTION», +« ») define(«OVERVIEW», « -
      -ifelse(«$2», «», «Overview», «$2») -
      -
      -$1 +
      +
      + ifelse(«$2», «», «Overview», «$2») +
      + $1
      ») define(«EXERCISES», «

      Exercises

      ») @@ -63,7 +59,7 @@ define(«HEADER», « -