docs/113390: [PATCH] geli option for to onetime encryption algorithm has changed on FreeBSD 6.2 and later

[Beat Gaetzi]

>Number:         113390
>Category:       docs
>Synopsis:       [PATCH] geli option for to onetime encryption algorithm has changed on FreeBSD 6.2 and later
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jun 05 20:50:04 GMT 2007
>Closed-Date:
>Last-Modified:
>Originator:     Beat Gätzi
>Release:        FreeBSD 6.2-RELEASE-p3 i386
>Organization:
>Environment:
System: FreeBSD daedalus.network.local 6.2-RELEASE-p3 FreeBSD 6.2-RELEASE-p3 #0: Sun Mar 18 12:42:52 CET 2007 root at daedalus.network.local:/usr/obj/usr/src/sys/BEASTIE i386


	
>Description:
	Since FreeBSD 6.2 the option to define the encryption algorithm to encrypt the swap partition has changed from -a to -e.
	
>How-To-Repeat:
	Encrypt the swap partition on a FreeBSD 6.2 as described in the handbook, 
	copy the geli_swap_flags line into the rc.conf and restart the system.

	Compare the onetime paragraph in geli(8) for 6.1 and 6.2:
	http://www.freebsd.org/cgi/man.cgi?query=geli&apropos=0&sektion=0&manpath=FreeBSD+6.1-RELEASE&format=html
	http://www.freebsd.org/cgi/man.cgi?query=geli&apropos=0&sektion=0&manpath=FreeBSD+6.2-RELEASE&format=html
	
>Fix:

	

--- chapter.sgml.patch begins here ---
diff -Naur doc.ori/en_US.ISO8859-1/books/handbook/disks/chapter.sgml doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml
--- doc.ori/en_US.ISO8859-1/books/handbook/disks/chapter.sgml	Tue Jun  5 22:10:17 2007
+++ doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml	Tue Jun  5 22:16:53 2007
@@ -4106,7 +4106,11 @@
 	a sectorsize of 4 kilobytes and the <quote>detach on last close</quote>
 	option set:</para>
 
-      <programlisting>geli_swap_flags="-a blowfish -l 128 -s 4096 -d"</programlisting>
+      <programlisting>geli_swap_flags="-e blowfish -l 128 -s 4096 -d"</programlisting>
+
+      <para>For systems prior to &os; 6.2-RELEASE, use the following line:</para>
+
+	  <programlisting>geli_swap_flags="-a blowfish -l 128 -s 4096 -d"</programlisting>
 
       <para>Please refer to the description of the <command>onetime</command> command
 	in the &man.geli.8; manual page for a list of possible options.</para>
--- chapter.sgml.patch ends here ---


>Release-Note:
>Audit-Trail:
>Unformatted: