[LUDOC-148] Please document mb_groups buddy cache proc output

• Type: Task
• Resolution: Fixed
• Priority: Major
• Labels: QContent
• Business Value: 20
• Assignee: Linda Bebernes (Inactive)
• Reporter: Colin Faber [X] (Inactive)

Description

Currently both ext4 and ldiskfs provide /proc/fs/

{ext4 | ldiskfs}

/<dev>/mb_groups output. This file is referenced in many kernel documents however other than noting that it's providing data on buddy group cache info, it doesn't bother documenting any further.

Below is sample output from this file, it would be extremely useful for this to be fully documented and understood.

#0 : 23147 1 9280 [ 1 1 0 1 0 1 1 0 0 1 0 1 1 2 ]
#1 : 1156 41 1025 [ 42 15 5 3 3 3 2 2 2 0 0 0 0 0 ]
#2 : 782 46 8194 [ 38 28 10 5 4 3 1 1 1 0 0 0 0 0 ]
#3 : 624 7 1025 [ 10 9 5 4 2 2 1 1 1 0 0 0 0 0 ]
#4 : 1065 6 12802 [ 3 5 3 2 2 1 1 1 1 1 0 0 0 0 ]
#5 : 1023 1 1025 [ 1 1 1 1 1 1 1 1 1 1 0 0 0 0 ]
#6 : 0 0 32768 [ 0 0 0 0 0 0 0 0 0 0 0 0 0 0 ]
#7 : 1023 1 1025 [ 1 1 1 1 1 1 1 1 1 1 0 0 0 0 ]
#8 : 1022 1 19458 [ 0 1 1 1 1 1 1 1 1 1 0 0 0 0 ]
#9 : 1784 4 1025 [ 2 3 2 3 3 3 1 2 1 2 0 0 0 0 ]

Comments

[Linda Bebernes (Inactive)]

Approved and merged. Marking this resolved.

[Linda Bebernes (Inactive)]

Change pushed to gerrit for review http://review.whamcloud.com/#/c/7728/

[Alex Zhuravlev]

well, this isn't an option. this is stats available to the users/administrators/developers so they can see/analyze on-disk fragmentation. not to be used often, I guess.

[Linda Bebernes (Inactive)]

Alex - Thanks for the column definitions. Should mb_groups be documented as an option in the table in Section 31.2 "Tuning Multi-Block Alocation (mballoc)? Or does it go somewhere else?
http://build.whamcloud.com/job/lustre-manual/lastSuccessfulBuild/artifact/lustre_manual.xhtml#idp8394512

[Alex Zhuravlev]

hm, I actually see slightly different format in the master branch:

1. cat /proc/fs/ldiskfs/loop0/mb_groups
   #group: free free frags first pa [ 2^0 2^1 2^2 2^3 2^4 2^5 2^6 2^7 2^8 2^9 2^10 2^11 2^12 2^13 ]
   #0 : 2936 2936 1 42 0 [ 0 0 0 1 1 1 1 2 0 1 2 0 0 0 ]

where columns are:

• #group number
• available blocks in the group
• blocks free on a disk
• number of free fragments
• the very first free block in the group
• number of preallocated chunks (not blocks)
• a series of available chunks of different sizes