Fix section for bug #3133
authordillon <dillon@web>
Tue, 8 May 2018 04:38:20 +0000 (04:38 +0000)
committerIkiWiki <ikiwiki.info>
Tue, 8 May 2018 04:38:20 +0000 (04:38 +0000)
docs/handbook/Configuration/index.mdwn

index 45c7f0d..d143591 100644 (file)
@@ -1113,11 +1113,13 @@ The best way to add swap, of course, is to use this as an excuse to add another
 
 ### Swapping over NFS 
 
-Swapping over NFS is only recommended if you do not have a local hard disk to swap to. Even though DragonFly has an excellent NFS implementation, NFS swapping will be limited by the available network bandwidth and puts an additional burden on the NFS server.
+Swapping over NFS is only recommended if you do not have local storage to swap to. Even though DragonFly has an excellent NFS implementation, NFS swapping will be limited by the available network bandwidth and puts an additional burden on the NFS server.
 
 ### Swapfiles 
 
-You can create a file of a specified size to use as a swap file. In our example here we will use a 64MB file called `/usr/swap0`. You can use any name you want, of course.
+We do NOT recommend swapping to a file.  At best you can use this technique to swap to a file over NFS, but generally speaking paging to a file can lead to system deadlocks in low-memory situations due to resources needed by the filesystem itself to execute the paging operation.
+
+You can create a file of a specified size to use as a swap file. In our example here we will use a 64M file called `/usr/swap0`. You can use any name you want, of course.  On a real system you will want to size the swap to at least be the same as the amount of physical ram in the machine, and as already mentioned, we do NOT recommend swapping to a file due to the deadlock risk.
 
  **Example 6-1. Creating a Swapfile** 
 
@@ -1129,10 +1131,11 @@ You can create a file of a specified size to use as a swap file. In our example
 
   
 
-  1. Create a swapfile (`/usr/swap0`):
-
-      
+  1. Create a swapfile (`/usr/swap0`):  Ensure there is sufficient space on the filesystem for the swapfile.  Pre-zero the file.  On HAMMER2, also disable the check mode and compression to prevent block reallocation on write.  The following sequence is for HAMMER2.
 
+         # echo -n > /usr/swap0
+         # hammer2 setcheck none /usr/swap0
+         # hammer2 setcomp none /usr/swap0 
          # dd if=/dev/zero of=/usr/swap0 bs=1024k count=64
 
   
@@ -1157,7 +1160,7 @@ You can create a file of a specified size to use as a swap file. In our example
 
       
 
-         # vnconfig -e /dev/vn0b /usr/swap0 swap
+         # vnconfig -e /dev/vn0 /usr/swap0 swap