Difference between revisions of "Documentation"

From OpenZFS
Jump to navigation Jump to search
(Move user/sysadmin documentation to its own page.)
 
(29 intermediate revisions by 10 users not shown)
Line 1: Line 1:
== High-Level ZFS Documentation ==
== [[System Administration | General documentation aimed at users / system administrators]] ==
* manual pages ''from illumos; better-rendered pages would be appreciated''
** [http://illumos.org/man/1m/zpool zpool] [http://illumos.org/man/1m/zfs zfs] [http://illumos.org/man/5/zpool-features zpool-features] [http://illumos.org/man/1m/zdb zdb] [http://illumos.org/man/1m/zstreamdump zstreamdump]
* Oracle's ZFS [http://docs.oracle.com/cd/E26505_01/html/E37384/index.html Adminmistration Guide] is largely applicable
* The ZFS [http://maczfs.googlecode.com/files/ZFSOnDiskFormat.pdf On-Disk Format] document is a good overview, although sorely out of date
* The [http://java.net/projects/solaris-zfs/pages/Sourcetour source tour] describes the various subcomponents in ZFS.
* [http://www.snia.org/sites/default/files2/sdc_archives/2008_presentations/monday/JeffBonwick-BillMoore_ZFS.pdf slides] from a ZFS overview at SNIA 2008
* Blog posts on specific ZFS features
** [https://blogs.oracle.com/ahrens/entry/is_it_magic snapshots]
** [https://blogs.oracle.com/ahrens/entry/new_scrub_code scrub/resilver]
** [https://blogs.oracle.com/perrin/entry/the_lumberjack ZIL] (ZFS Intent Log)
** [https://blogs.oracle.com/bonwick/entry/space_maps space maps] and [https://blogs.oracle.com/bonwick/en_US/entry/zfs_block_allocation block allocation]
** [https://blogs.oracle.com/eschrock/entry/zfs_hot_spares Hot spares]
** [https://blogs.oracle.com/bonwick/en_US/entry/zfs_dedup Deduplication]
** [https://blogs.oracle.com/bonwick/en_US/entry/raid_z RAID-Z]


* Architectural/high-level documentation about ZFS as a whole
== [[Developer resources | Implementation documentation for developers]] ==
** We should collaborate on this with a wiki before the launch
** Might also have a common set of documentation that can be used for all distributions as a starting point and just modified
 
Matt, George, and Chris Siden are working on writing the architectural/high-level documentation. We probably need to think about the common user documentation.
 
== Repo-Specific Developer Documentation ==
* Information about how to develop ZFS for the different distributions/pointers to them (e.g., how to build illumos)
** In particular, documentation about how to test and possibly scripts for building
** Needs to be written/links provided by reps from those communities
 
== Distribution-Specific User Documentation ==
* Links to user documentation (distribution)
''Do we want this here or should this just be part of the links to other distributions?''

Latest revision as of 16:45, 6 August 2015