Project GRUDS: Handbook disk reorg

Warren Block wblock at wonkity.com
Mon Jul 15 23:23:11 UTC 2013


Project GRUDS (Grand Unified Disk Storage)

Goal: Edit and rewrite the scattered, repetitive, and conflicting Handbook
sections on disk storage into a unified group.  This would be a separate
<part> in the Handbook, starting where chapter 19, Storage, currently
begins.

The problem: Right now there are at least three different places in the
Handbook show disk partitioning methods and guidelines.  All are
different, and none really complete.  An in-depth chapter on
partitioning would allow sections to link to it and dispense with long
explanations that distract from the current topic.  Besides reducing
redundancy, this would make many sections shorter and let users familiar
with the concepts skip ahead easily.

It's a big project, but even as a plan would help future Handbook
contributions go in the right place.

Tentative outline:


Part 4:Disk Storage
   Introduction
     Quick start
       links to current methods for
         mirror (gmirror and ZFS)
         BIOS RAID (graid)
         RAID-5/RAID-Z (ZFS)

Disk Hardware Chapter
   Introduction
   Blocks
     512-byte
     Advanced Format
   Hardware RAID versus software RAID
     Comparison, advantages and disadvantages
   HAST?
   Device names
     SATA, IDE, SCSI, USB, most common hardware RAID device names
   Conclusion


Disk Partitions Chapter
   Introduction
   Partitioning Schemes
     Metadata (types, locations, conflicts)
     MBR
     GPT
     Others
   Conclusion


Labels Chapter (expanded from existing GEOM "Labeling Disk Devices")
   Introduction
     easy device relocatability
     provided by geom_label (others?)
   GPT labels
   Generic labels (glabel(8))
   Filesystem labels
   "Unique ID" labels
     GPT UUID
     ufsid
     others?
   Conclusion


GEOM Chapter ("Disk Device Transformations with GEOM"?)
   Introduction
     what is GEOM?
   from existing GEOM chapter
     additional section on graid(8)
     sorted in order of most common usage (gmirror, graid, ...)
   Conclusion


Filesystems Chapter
   Introduction
     what are filesystems?
   UFS
     traditional split-filesystem layout
     newer, unified everything in root layout
   Other filesystems
     ext2, NTFS, etc
     mention NFS, with pointer to NFS section in "Network Servers"
     mention ZFS, and how it is more than a filesystem, and will be
     covered in the next chapter
   Conclusion


ZFS Chapter
   neither fish nor fowl, it's a dessert topping *and* a floor wax
   both device and filesystem
   Introduction
     what is it?
     brief mention of best capabilities
   in-depth
   Conclusion


Backup Chapter
   Introduction
   UFS Backup (main part from existing Storage chapter)
   ZFS Backup
   Conclusion


More information about the freebsd-doc mailing list