Skip to contentSkip to conversation

sysfs layout for btrfs

survey Anand Jain 3 participants 3 messages Aug 14, 2015 – Aug 18, 2015 Btrfs file system

lore
Share & tools
lore

Anand Jain

author
#0 lore raw

Hello,

as of now btrfs sysfs does not include the attributes for the volume manager part in its sysfs layout, so its being developed and there are two types of layout here below, so I have a quick survey to know which will be preferred. contenders are:
1. FS and VM (volume manager) attributes[1] merged sysfs layout
2. FS and VM attributes separated sysfs layout.

These two choices differ whether the VM attributes are amalgamate with existing FS attributes or if VM attributes are put under a kobject named "pools/volumes" under /sys/fs/btrfs. More in the below example. which would highlight the trade off between these two.

Eg for #1 (above):
The existing sysfs for btrfs, has the top kobject <fsid>

/sys/fs/btrfs/<fsid> <-- holds FS attr, VM attr will be added here. /sys/fs/btrfs/<fsid>/devices/<uuid [2] > <-- btrfs_devices attr here /sys/fs/btrfs/<fsid>/devices/<uuid>/state /sys/fs/btrfs/<fsid>/devices/<uuid>/offline

we won't be able to change the sysfs entries which is already there. However we could change the context in which they are created and destroyed that is, from mount and unmount, to device scan and module unload respectively. And so this will enable us to implement the # 1 (above).

Eg for #2 (above):
For the 2nd choice, a new 'pools or volumes' kobject will be created under existing /sys/fs/btrfs/ which will hold the VM attributes. (however note that: there will be duplicate kobjects like <fsid> both under FS and VM in this choice #2).

/sys/fs/btrfs/<fsid> <--- as is, will continue to hold fs attributes. /sys/fs/btrfs/pools/<fsid>/ <-- will hold VM attributes /sys/fs/btrfs/pools/<fsid>/devices/<sdx> <-- btrfs_devices attr here /sys/fs/btrfs/pools/<fsid>/devices/<sdx>/state /sys/fs/btrfs/pools/<fsid>/devices/<sdx>/offline

There is certainly a small trade-off between these two. Your comments / feedback are kindly appreciated.

Thanks, Anand

[1] attributes will be of the btrfs_fs_devices structure. And few newly introduced attributes like 'state', to state the volume current state.

[2] note that we can not use <sdx> here since a link to the block device already exists with that name.

#1 lore raw
Quoted 10 lines · Anand Jain

Hello,

as of now btrfs sysfs does not include the attributes for the volume manager part in its sysfs layout, so its being developed and there are two types of layout here below, so I have a quick survey to know which will be preferred. contenders are:
1. FS and VM (volume manager) attributes[1] merged sysfs layout

/sys/fs/btrfs/<fsid> <-- holds FS attr, VM attr will be added here. /sys/fs/btrfs/<fsid>/devices/<uuid [2] > <-- btrfs_devices attr here

My vote is for the first one.
Lengthening the UI/API with /pools/ seems unnecessary, and it's better to get attributes exposed earlier.

Quoted 5 lines

2. FS and VM attributes separated sysfs layout.

/sys/fs/btrfs/<fsid> <--- as is, will continue to hold fs attributes. /sys/fs/btrfs/pools/<fsid>/ <-- will hold VM attributes /sys/fs/btrfs/pools/<fsid>/devices/<sdx> <-- btrfs_devices attr here

#2 lore raw
In reply to Anand Jain

Hi

Quoted 21 lines · Anand Jain

Hello,

as of now btrfs sysfs does not include the attributes for the volume manager part in its sysfs layout, so its being developed and there are two types of layout here below, so I have a quick survey to know which will be preferred. contenders are:
1. FS and VM (volume manager) attributes[1] merged sysfs layout
2. FS and VM attributes separated sysfs layout.

These two choices differ whether the VM attributes are amalgamate with existing FS attributes or if VM attributes are put under a kobject named "pools/volumes" under /sys/fs/btrfs. More in the below example. which would highlight the trade off between these two.

Eg for #1 (above):
The existing sysfs for btrfs, has the top kobject <fsid>

/sys/fs/btrfs/<fsid> <-- holds FS attr, VM attr will be added here. /sys/fs/btrfs/<fsid>/devices/<uuid [2] > <-- btrfs_devices attr here /sys/fs/btrfs/<fsid>/devices/<uuid>/state /sys/fs/btrfs/<fsid>/devices/<uuid>/offline

we won't be able to change the sysfs entries which is already there. However we could change the context in which they are created and destroyed that is, from mount and unmount, to device scan and module unload respectively. And so this will enable us to implement the # 1 (above).

Eg for #2 (above):
For the 2nd choice, a new 'pools or volumes' kobject will be created under existing /sys/fs/btrfs/ which will hold the VM attributes. (however note that: there will be duplicate kobjects like <fsid> both under FS and VM in this choice #2).

Quoted 7 lines

/sys/fs/btrfs/<fsid> <--- as is, will continue to hold fs attributes. /sys/fs/btrfs/pools/<fsid>/ <-- will hold VM attributes /sys/fs/btrfs/pools/<fsid>/devices/<sdx> <-- btrfs_devices attr here /sys/fs/btrfs/pools/<fsid>/devices/<sdx>/state /sys/fs/btrfs/pools/<fsid>/devices/<sdx>/offline

There is certainly a small trade-off between these two. Your comments / feedback are kindly appreciated.

If the info "VM attributes" are per filesystem, I don't see any reason to put these under another subdirectory. So for this I vote #1

However I find more interesting to discuss where put the <uuid> entries.
What confusing me is that under <fsid>/devices/ there are both a link to the devices, and a directory <uuid> with disk-information..

It could be possible to get rid of the <devX> link ? I know that the official answer is "the backward compatibility must be preserved"; but who use these link today ?
Otherwise it could be possible to create another directory (called dev-uuid/ for example) where put the <dev-uuid> ? My rationale is: if there is a collection of homogeneous entries (like a list of disk-uuid or filesystem-uuid), this collection (and only this collection) must be put in a dedicated directory.

BR
G.Baroncelli

Quoted 11 lines

Thanks, Anand

[1] attributes will be of the btrfs_fs_devices structure. And few newly introduced attributes like 'state', to state the volume current state.

[2] note that we can not use <sdx> here since a link to the block device already exists with that name.

Signature · 3 lines
To unsubscribe from this list: send the line "unsubscribe linux-btrfs" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Signature · 2 lines
gpg @keyserver.linux.it: Goffredo Baroncelli <kreijackATinwind.it>
Key fingerprint BBF5 1610 0B64 DAC6 5F7D  17B2 0EDA 9B37 8B82 E0B5