Patch to add section on "Constructing a Filesystem" to "Disk Setup" FAQ.

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|

Patch to add section on "Constructing a Filesystem" to "Disk Setup" FAQ.

currellberry
Hello,

I find the openbsd "disk setup" FAQ to not be as helpful as it could
be because it does not mention newfs outside of the "Encrypting
external disks" section.  Creating a filesystem with newfs is a step
most people will need to do as part of setting up a disk.  Below is a
patch which adds a short section "Constructing a filesystem" to the FAQ.

Feedback is welcome.  Thanks.
-- Currell


Index: faq14.html
===================================================================
RCS file: /cvs/www/faq/faq14.html,v
retrieving revision 1.355
diff -u -r1.355 faq14.html
--- faq14.html  16 Mar 2017 19:56:31 -0000      1.355
+++ faq14.html  19 Mar 2017 07:33:45 -0000
@@ -30,6 +30,7 @@
 <li><a href="#intro"           >Disks and partitions</a>
 <li><a href="#fdisk"           >Using fdisk</a>
 <li><a href="#disklabel"       >Disk labels</a>
+<li><a href="#newfs"           >Constructing a filesystem</a>
 <li><a href="#BootAmd64"       >The amd64 boot process</a>
 <li><a href="#SoftUpdates"     >Soft updates</a>
 <li><a href="#altroot"         >Duplicating your root partition:
@@ -243,6 +244,24 @@
 the label to disk.
 Therefore, even if the area of the disk containing the disklabel is unreadable,
 you will be able to mount until the next reboot.
+
+<h2 id="newfs">Constructing a Filesystem</h2>
+Once a disk has been labeled using
+<a href="http://man.openbsd.org/disklabel">disklabel(8)</a>, the next step you
+will probably want to take is set up a file system on the disk.
+<a href="http://man.openbsd.org/newfs">newfs(8)</a> is the utility which creates
+filesystems..
+To initialize a standard openbsd filesystem on a new disklabel partion wd1d,
+run the following command:
+
+<blockquote><pre>
+# <b>newfs wd1d</b>
+/dev/rwd1d: 2861587.2MB in 5860530880 sectors of 512 bytes
+876 cylinder groups of 3266.88MB, 52270 blocks, 104704 inodes each
+</pre></blockquote>
+
+<a href="http://man.openbsd.org/newfs">newfs(8)</a> supports a number of
+optional flags and options.  See the man page for more information.
 
 <h2 id="BootAmd64">The amd64 boot process</h2>