What is the dataset's top layer called? Is it the file system?

So this might be a newbie question but I just want to get my terms right.

so if I have a dataset with no snapshots, is what is exposed called the file sysytem?

If there are changes from after a snapshot was made then there is a layer of deltas which combined with the snapshot below presents as the file system.

Have I got the names and basic concept right here.? I just wonders if there was a name other than Files system to describe what is exposed from the dataset irrelevant of whether there are any snapshots.

thanks

In general, it is somewhat irrelevant if their are snapshots, clones or such on a Dataset / file system.

There is an odd case of the pool top level dataset. For NAS purposes, (and specifically TrueNAS), it is not advisable to share directly this top level dataset. Basically the pool name, like tank, is also a dataset called tank. But, it does not follow child dataset rules, like tank/tank, just simply tank.

You may know some or all of the below. In which case, this can be for future readers…

ZFS uses COW, Copy On Write. This means the “layer of deltas” is not like other systems that support snapshots. For example, both VMWare and Linux LVM snapshots are not meant to be kept more than a few hours, or days at most. They act more like write transaction log storage locations. And upon removal, it takes time to apply all the changes back to the “real” file system. Sometimes a long time, slowing down the server.

ZFS on the other hand, uses block pointers. So both the original dataset and snapshots can exist just fine, even for years. Each has pointers to their own version of the data. Similar behavior for cloned file systems. Just pointers in the pool. Any update to a file, causes the updated location to be allocated from empty space, and the block pointers for that specific dataset or clone is updated. (Snapshots are immutable… they always point to pre-existing data at the time of the snapshot.)

Thanks for the info, but how you refer to the exposed layer in a dataset, is it just called the file system, layer 1 etc.. it must have a specific name and I cannot figure out what it is called. :grinning_face_with_smiling_eyes:

The term I’ve heard used most often is “root dataset.”

No that not what I am after. That is the dataset level, I am on about within the dataset.

Do you mean the share be it SMB or NFS?

No, but the layer those exposed.

Does this term mean anything: ZFS POSIX Layer (ZPL) , I asked AI.

I suppose that would be “the current content”, or whatever synonym you’re happy with.

the current content is a great way of explaining it, but there must be a proper name for it, I know File System is used often.

Snapshots are the current content at a point in time

Snapshot
A read-only version of a file system or volume at a given point in time. It is specified as filesystem@name or volume@name

So I am guessing then file system is the right term, or maybe active file system

Happy to be proven wrong… but I think that this assumption is false.

This might help.

Assume there is only a single dataset in a pool.

  • The truck is the total capacity.
  • Empty sections are free space.
  • Boxes are data blocks.
  • White stickers, taken as a whole, represent the live filesystem.
  • A complete set of stickers of a certain color (red, blue, or green), taken as a whole, represent a snapshot and the read-only filesystem that it is.[1]

A faded box is not seen by the live filesystem, but it remains and takes up space because it still has at least one colored sticker on it. (Referenced and protected by a snapshot.)

You can get an idea of what a snapshot’s read-only filesystem looks like by only considering the boxes that have a certain shared color, such as red, blue, or green.


  1. All snapshots of a dataset are their own read-only filesystems, but they share blocks with the dataset’s live filesystem and other snapshots. This is why they don’t “add” used space equal to the amount of referenced data. More accurately, snapshots never “add” to the used space. They can only hold data that would otherwise be freed. ↩︎

Top Layer Terms

  • Dataset = Live filesystem
    • Every thing points to wards using the term Live filesystem because snapshots also refer to filesystems.
  • Zvols = Live volume
    • This follows the nomenclature as dataset

Both name tie in with the ZFS configuration options:

type=filesystem   (dataset)
type=volume       (zvol)

Common Top Layer Terms
The following are terms that can apply to both a dataset and zvol but are not as clear.

  • Current dataset state (Best generic description)
  • Live state
  • Current state

Some prior snapshot explanations from @winnielinnie