On Mon, Sep 13, 2010 at 09:18:10AM -0500, Marco Peereboom wrote: > I don't like detach. bioctl is a generic tool and the intent of that > command is to "delete" a logical disk of a "controller". The fact that > softraid detaches the disk is a side-effect. On mfi, for example, that > is a pretty destructive command. >
ok. alright with the rest of the diff? jmc Index: bioctl.8 =================================================================== RCS file: /cvs/src/sbin/bioctl/bioctl.8,v retrieving revision 1.80 diff -u -r1.80 bioctl.8 --- bioctl.8 31 Dec 2009 14:00:45 -0000 1.80 +++ bioctl.8 13 Sep 2010 14:29:28 -0000 @@ -119,7 +119,9 @@ promote it to being a .Dq Hot Spare . .It Fl h -Where necessary, produce "human-readable" output. +Where necessary, produce +.Dq human-readable +output. Use unit suffixes: Byte, Kilobyte, Megabyte, Gigabyte, Terabyte, Petabyte, Exabyte in order to reduce the number of digits to four or less. @@ -223,7 +225,7 @@ It cannot be used during the initial creation of the crypto volume. .It Fl r Ar rounds When creating an encrypted volume, specifies the number of iterations of -the algorithm used to convert a passphrase into a key. +the PBKDF2 algorithm used to convert a passphrase into a key. Higher iteration counts take more time, but offer more resistance to key guessing attacks. The minimum is 1000 rounds and the default is 8192. @@ -245,7 +247,7 @@ .Ed .Pp .Nm -will ask for a passphrase, that will be needed to unlock the encrypted +will ask for a passphrase, which will be needed to unlock the encrypted disk. After creating a newly encrypted disk, the first megabyte of it should be zeroed, so tools like @@ -267,6 +269,11 @@ .Xr bio 4 , .Xr scsi 4 , .Xr softraid 4 +.Rs +.%R RFC 2898 +.%T "PKCS #5: Password-Based Cryptography Specification Version 2.0" +.%D 2000 +.Re .Sh HISTORY The .Nm @@ -278,4 +285,4 @@ interface was written by .An Marco Peereboom Aq ma...@openbsd.org . .Sh CAVEATS -Use of the crypto & RAID 4/5 disciplines are currently considered experimental. +Use of the CRYPTO & RAID 4/5 disciplines are currently considered experimental.