Page MenuHomeFreeBSD
Files F160728395

D50603.id156289.diff
No OneTemporary
Actions

D50603.id156289.diff
View Options

diff --git a/documentation/content/en/books/handbook/zfs/_index.adoc b/content/en/books/handbook/zfs/_index.adoc
--- a/documentation/content/en/books/handbook/zfs/_index.adoc
+++ b/content/en/books/handbook/zfs/_index.adoc
@@ -98,8 +98,7 @@
# service zfs start
....
-The examples in this section assume three SCSI disks with the device names [.filename]#da0#, [.filename]#da1#, and [.filename]#da2#.
-Users of SATA hardware should instead use [.filename]#ada# device names.
+The examples in this section assume three SATA disks with the device names [.filename]#ada0#, [.filename]#ada1#, and [.filename]#ada2#.
[[zfs-quickstart-single-disk-pool]]
=== Single Disk Pool
@@ -108,19 +107,16 @@
[source,shell]
....
-# zpool create example /dev/da0
+# zpool create example /dev/ada1
....
To view the new pool, review the output of `df`:
[source,shell]
....
-# df
-Filesystem 1K-blocks Used Avail Capacity Mounted on
-/dev/ad0s1a 2026030 235230 1628718 13% /
-devfs 1 1 0 100% /dev
-/dev/ad0s1d 54098308 1032846 48737598 2% /usr
-example 17547136 0 17547136 0% /example
+# df /example
+Filesystem 1K-blocks Used Avail Capacity Mounted on
+example 17547136 0 17547136 0% /example
....
This output shows creating and mounting of the `example` pool, and that is now accessible as a file system.
@@ -163,11 +159,8 @@
....
# zfs umount example/compressed
# df
-Filesystem 1K-blocks Used Avail Capacity Mounted on
-/dev/ad0s1a 2026030 235232 1628716 13% /
-devfs 1 1 0 100% /dev
-/dev/ad0s1d 54098308 1032864 48737580 2% /usr
-example 17547008 0 17547008 0% /example
+Filesystem 1K-blocks Used Avail Capacity Mounted on
+example 17547008 0 17547008 0% /example
....
To re-mount the file system to make it accessible again, use `zfs mount` and verify with `df`:
@@ -177,9 +170,6 @@
# zfs mount example/compressed
# df
Filesystem 1K-blocks Used Avail Capacity Mounted on
-/dev/ad0s1a 2026030 235234 1628714 13% /
-devfs 1 1 0 100% /dev
-/dev/ad0s1d 54098308 1032864 48737580 2% /usr
example 17547008 0 17547008 0% /example
example/compressed 17547008 0 17547008 0% /example/compressed
....
@@ -189,9 +179,9 @@
[source,shell]
....
# mount
-/dev/ad0s1a on / (ufs, local)
+/dev/ada0p1 on / (ufs, local)
devfs on /dev (devfs, local)
-/dev/ad0s1d on /usr (ufs, local, soft-updates)
+/dev/ada0p2 on /usr (ufs, local, soft-updates)
example on /example (zfs, local)
example/compressed on /example/compressed (zfs, local)
....
@@ -212,13 +202,13 @@
[source,shell]
....
# df
-Filesystem 1K-blocks Used Avail Capacity Mounted on
-/dev/ad0s1a 2026030 235234 1628714 13% /
-devfs 1 1 0 100% /dev
-/dev/ad0s1d 54098308 1032864 48737580 2% /usr
-example 17547008 0 17547008 0% /example
-example/compressed 17547008 0 17547008 0% /example/compressed
-example/data 17547008 0 17547008 0% /example/data
+Filesystem 1K-blocks Used Avail Capacity Mounted on
+/dev/ada0p1 2026030 235234 1628714 13% /
+devfs 1 1 0 100% /dev
+/dev/ada0p2 54098308 1032864 48737580 2% /usr
+example 17547008 0 17547008 0% /example
+example/compressed 17547008 0 17547008 0% /example/compressed
+example/data 17547008 0 17547008 0% /example/data
....
Notice that all file systems in the pool have the same available space.
@@ -246,7 +236,7 @@
[source,shell]
....
-# zpool create storage raidz da0 da1 da2
+# zpool create storage raidz ada0 ada1 ada2
....
[NOTE]
@@ -333,16 +323,16 @@
[source,shell]
....
# mount
-/dev/ad0s1a on / (ufs, local)
+/dev/ada0p1 on / (ufs, local)
devfs on /dev (devfs, local)
-/dev/ad0s1d on /usr (ufs, local, soft-updates)
+/dev/ada0p2 on /usr (ufs, local, soft-updates)
storage on /storage (zfs, local)
storage/home on /home (zfs, local)
# df
Filesystem 1K-blocks Used Avail Capacity Mounted on
-/dev/ad0s1a 2026030 235240 1628708 13% /
+/dev/ada0p1 2026030 235240 1628708 13% /
devfs 1 1 0 100% /dev
-/dev/ad0s1d 54098308 1032826 48737618 2% /usr
+/dev/ada0p2 54098308 1032826 48737618 2% /usr
storage 26320512 0 26320512 0% /storage
storage/home 26320512 0 26320512 0% /home
....
@@ -391,26 +381,26 @@
NAME STATE READ WRITE CKSUM
storage DEGRADED 0 0 0
raidz1 DEGRADED 0 0 0
- da0 ONLINE 0 0 0
- da1 OFFLINE 0 0 0
- da2 ONLINE 0 0 0
+ ada0 ONLINE 0 0 0
+ ada1 OFFLINE 0 0 0
+ ada2 ONLINE 0 0 0
errors: No known data errors
....
-"OFFLINE" shows the administrator took [.filename]#da1# offline using:
+"OFFLINE" shows the administrator took [.filename]#ada1# offline using:
[source,shell]
....
-# zpool offline storage da1
+# zpool offline storage ada1
....
-Power down the computer now and replace [.filename]#da1#.
-Power up the computer and return [.filename]#da1# to the pool:
+Power down the computer now and replace [.filename]#ada1#.
+Power up the computer and return [.filename]#ada1# to the pool:
[source,shell]
....
-# zpool replace storage da1
+# zpool replace storage ada1
....
Next, check the status again, this time without `-x` to display all pools:
@@ -426,9 +416,9 @@
NAME STATE READ WRITE CKSUM
storage ONLINE 0 0 0
raidz1 ONLINE 0 0 0
- da0 ONLINE 0 0 0
- da1 ONLINE 0 0 0
- da2 ONLINE 0 0 0
+ ada0 ONLINE 0 0 0
+ ada1 ONLINE 0 0 0
+ ada2 ONLINE 0 0 0
errors: No known data errors
....
@@ -472,9 +462,9 @@
NAME STATE READ WRITE CKSUM
storage ONLINE 0 0 0
raidz1 ONLINE 0 0 0
- da0 ONLINE 0 0 0
- da1 ONLINE 0 0 0
- da2 ONLINE 0 0 0
+ ada0 ONLINE 0 0 0
+ ada1 ONLINE 0 0 0
+ ada2 ONLINE 0 0 0
errors: No known data errors
....
@@ -620,9 +610,9 @@
If you boot from pool 'mypool', you may need to update boot code on newly attached disk _ada1p3_.
-Assuming you use GPT partitioning and _da0_ is your new boot disk you may use the following command:
+Assuming you use GPT partitioning and _ada0_ is your new boot disk you may use the following command:
- gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 da0
+ gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada0
# gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada1
bootcode written to ada1
# zpool status
@@ -819,9 +809,9 @@
When booting from the pool 'zroot', update the boot code on the newly attached disk 'ada2p3'.
-Assuming GPT partitioning is used and [.filename]#da0# is the new boot disk, use the following command:
+Assuming GPT partitioning is used and [.filename]#ada0# is the new boot disk, use the following command:
- gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 da0
+ gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada0
# gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 ada2
# zpool status
pool: mypool
@@ -1208,8 +1198,8 @@
action: The pool can be imported using its name or numeric identifier.
config:
- mypool ONLINE
- ada2p3 ONLINE
+ mypool ONLINE
+ ada0 ONLINE
....
Import the pool with an alternative root directory:
@@ -2468,7 +2458,7 @@
[source,shell]
....
# zfs get used,compressratio,compression,logicalused mypool/compressed_dataset
-NAME PROPERTY VALUE SOURCE
+NAME PROPERTY VALUE SOURCE
mypool/compressed_dataset used 449G -
mypool/compressed_dataset compressratio 1.11x -
mypool/compressed_dataset compression lz4 local
@@ -2798,7 +2788,7 @@
|[[zfs-term-vdev]]vdev Types
a|A pool consists of one or more vdevs, which themselves are a single disk or a group of disks, transformed to a RAID. When using a lot of vdevs, ZFS spreads data across the vdevs to increase performance and maximize usable space. All vdevs must be at least 128 MB in size.
-* [[zfs-term-vdev-disk]] _Disk_ - The most basic vdev type is a standard block device. This can be an entire disk (such as [.filename]#/dev/ada0# or [.filename]#/dev/da0#) or a partition ([.filename]#/dev/ada0p3#). On FreeBSD, there is no performance penalty for using a partition rather than the entire disk. This differs from recommendations made by the Solaris documentation.
+* [[zfs-term-vdev-disk]] _Disk_ - The most basic vdev type is a standard block device. This can be an entire disk (such as [.filename]#/dev/ada0# or [.filename]#/dev/ada0#) or a partition ([.filename]#/dev/ada0p3#). On FreeBSD, there is no performance penalty for using a partition rather than the entire disk. This differs from recommendations made by the Solaris documentation.
+
[CAUTION]
====

File Metadata

Mime Type
text/plain
Expires
Sun, Jun 28, 6:32 AM (1 h, 52 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
34425762
Default Alt Text
D50603.id156289.diff (9 KB)

Event Timeline