From: Peter Rajnoha Date: Wed, 14 Aug 2024 12:59:07 +0000 (+0200) Subject: tools: args: update description for --refresh X-Git-Tag: v2_03_26~11 X-Git-Url: https://sourceware.org/git/?a=commitdiff_plain;h=9472e9c5a04d059bf7d0c0d3c355095b7c157493;p=lvm2.git tools: args: update description for --refresh --- diff --git a/man/lvchange.8_pregen b/man/lvchange.8_pregen index 661130105..80bc0e680 100644 --- a/man/lvchange.8_pregen +++ b/man/lvchange.8_pregen @@ -848,9 +848,12 @@ See \fBlvmraid\fP(7) for more information. \fB--refresh\fP .br If the LV is active, reload its metadata. -This is not necessary in normal operation, but may be useful -if something has gone wrong, or if some form of manual LV -sharing is being used. +In an environment where udev is used to manage the /dev content, +usage of this option is highly recommended. This is because refresh +also regenerates udev events for an LV based on which existing udev +rules are applied to set the /dev content and permissions. +Also, this operation may be useful if something has gone wrong, +or if some form of manual LV sharing is being used. . .HP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP diff --git a/man/vgchange.8_pregen b/man/vgchange.8_pregen index bbe914c4c..f67e04d0b 100644 --- a/man/vgchange.8_pregen +++ b/man/vgchange.8_pregen @@ -783,9 +783,12 @@ metadata updates. \fB--refresh\fP .br If the LV is active, reload its metadata. -This is not necessary in normal operation, but may be useful -if something has gone wrong, or if some form of manual LV -sharing is being used. +In an environment where udev is used to manage the /dev content, +usage of this option is highly recommended. This is because refresh +also regenerates udev events for an LV based on which existing udev +rules are applied to set the /dev content and permissions. +Also, this operation may be useful if something has gone wrong, +or if some form of manual LV sharing is being used. . .HP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP diff --git a/man/vgmknodes.8_pregen b/man/vgmknodes.8_pregen index c099fbb56..c766a8f90 100644 --- a/man/vgmknodes.8_pregen +++ b/man/vgmknodes.8_pregen @@ -192,9 +192,12 @@ Repeat once to also suppress any prompts with answer 'no'. \fB--refresh\fP .br If the LV is active, reload its metadata. -This is not necessary in normal operation, but may be useful -if something has gone wrong, or if some form of manual LV -sharing is being used. +In an environment where udev is used to manage the /dev content, +usage of this option is highly recommended. This is because refresh +also regenerates udev events for an LV based on which existing udev +rules are applied to set the /dev content and permissions. +Also, this operation may be useful if something has gone wrong, +or if some form of manual LV sharing is being used. . .HP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP diff --git a/tools/args.h b/tools/args.h index 7fc225171..6b4192400 100644 --- a/tools/args.h +++ b/tools/args.h @@ -689,9 +689,12 @@ arg(refresh_ARG, '\0', "refresh", 0, 0, 0, "#lvchange\n" "#vgmknodes\n" "If the LV is active, reload its metadata.\n" - "This is not necessary in normal operation, but may be useful\n" - "if something has gone wrong, or if some form of manual LV\n" - "sharing is being used.\n") + "In an environment where udev is used to manage the /dev content,\n" + "usage of this option is highly recommended. This is because refresh\n" + "also regenerates udev events for an LV based on which existing udev \n" + "rules are applied to set the /dev content and permissions.\n" + "Also, this operation may be useful if something has gone wrong,\n" + "or if some form of manual LV sharing is being used.\n") arg(removemissing_ARG, '\0', "removemissing", 0, 0, 0, "Removes all missing PVs from the VG, if there are no LVs allocated\n"