You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
114 lines
4.6 KiB
114 lines
4.6 KiB
From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001 |
|
From: Benjamin Marzinski <bmarzins@redhat.com> |
|
Date: Wed, 10 Nov 2021 18:34:08 -0600 |
|
Subject: [PATCH] libmultipath: deprecate file and directory config options |
|
|
|
Having multipath able to select pathnames for the files and directories |
|
it needs causes unnecessary maintainer headaches. Mark these as |
|
deprecated, but still support them for now. |
|
|
|
Signed-off-by: Benjamin Marzinski <bmarzins@redhat.com> |
|
--- |
|
libmultipath/dict.c | 19 +++++++++++++++---- |
|
multipath/multipath.conf.5 | 5 +++++ |
|
2 files changed, 20 insertions(+), 4 deletions(-) |
|
|
|
diff --git a/libmultipath/dict.c b/libmultipath/dict.c |
|
index 149d3348..d14be340 100644 |
|
--- a/libmultipath/dict.c |
|
+++ b/libmultipath/dict.c |
|
@@ -268,6 +268,15 @@ def_ ## option ## _handler (struct config *conf, vector strvec, \ |
|
return function (strvec, &conf->option, file, line_nr); \ |
|
} |
|
|
|
+#define declare_def_warn_handler(option, function) \ |
|
+static int \ |
|
+def_ ## option ## _handler (struct config *conf, vector strvec, \ |
|
+ const char *file, int line_nr) \ |
|
+{ \ |
|
+ condlog(2, "%s line %d, \"" #option "\" is deprecated and will be disabled in a future release", file, line_nr); \ |
|
+ return function (strvec, &conf->option, file, line_nr); \ |
|
+} |
|
+ |
|
#define declare_def_range_handler(option, minval, maxval) \ |
|
static int \ |
|
def_ ## option ## _handler (struct config *conf, vector strvec, \ |
|
@@ -421,7 +430,7 @@ declare_def_snprint(verbosity, print_int) |
|
declare_def_handler(reassign_maps, set_yes_no) |
|
declare_def_snprint(reassign_maps, print_yes_no) |
|
|
|
-declare_def_handler(multipath_dir, set_dir) |
|
+declare_def_warn_handler(multipath_dir, set_dir) |
|
declare_def_snprint(multipath_dir, print_str) |
|
|
|
static int def_partition_delim_handler(struct config *conf, vector strvec, |
|
@@ -654,13 +663,13 @@ declare_hw_snprint(user_friendly_names, print_yes_no_undef) |
|
declare_mp_handler(user_friendly_names, set_yes_no_undef) |
|
declare_mp_snprint(user_friendly_names, print_yes_no_undef) |
|
|
|
-declare_def_handler(bindings_file, set_path) |
|
+declare_def_warn_handler(bindings_file, set_path) |
|
declare_def_snprint(bindings_file, print_str) |
|
|
|
-declare_def_handler(wwids_file, set_path) |
|
+declare_def_warn_handler(wwids_file, set_path) |
|
declare_def_snprint(wwids_file, print_str) |
|
|
|
-declare_def_handler(prkeys_file, set_path) |
|
+declare_def_warn_handler(prkeys_file, set_path) |
|
declare_def_snprint(prkeys_file, print_str) |
|
|
|
declare_def_handler(retain_hwhandler, set_yes_no_undef) |
|
@@ -760,6 +769,8 @@ def_config_dir_handler(struct config *conf, vector strvec, const char *file, |
|
/* this is only valid in the main config file */ |
|
if (conf->processed_main_config) |
|
return 0; |
|
+ condlog(2, "%s line %d, \"config_dir\" is deprecated and will be disabled in a future release", |
|
+ file, line_nr); |
|
return set_path(strvec, &conf->config_dir, file, line_nr); |
|
} |
|
declare_def_snprint(config_dir, print_str) |
|
diff --git a/multipath/multipath.conf.5 b/multipath/multipath.conf.5 |
|
index dd9f4dc7..7f85f766 100644 |
|
--- a/multipath/multipath.conf.5 |
|
+++ b/multipath/multipath.conf.5 |
|
@@ -178,6 +178,7 @@ The default is: \fBno\fR |
|
. |
|
.TP |
|
.B multipath_dir |
|
+This option is deprecated, and will be removed in a future release. |
|
Directory where the dynamic shared objects are stored. Defined at compile time, |
|
commonly \fI/lib64/multipath/\fR or \fI/lib/multipath/\fR. |
|
.RS |
|
@@ -742,6 +743,7 @@ The default is: \fB<unset>\fR |
|
. |
|
.TP |
|
.B bindings_file |
|
+This option is deprecated, and will be removed in a future release. |
|
The full pathname of the binding file to be used when the user_friendly_names |
|
option is set. |
|
.RS |
|
@@ -752,6 +754,7 @@ The default is: \fB/etc/multipath/bindings\fR |
|
. |
|
.TP |
|
.B wwids_file |
|
+This option is deprecated, and will be removed in a future release. |
|
The full pathname of the WWIDs file, which is used by multipath to keep track |
|
of the WWIDs for LUNs it has created multipath devices on in the past. |
|
.RS |
|
@@ -762,6 +765,7 @@ The default is: \fB/etc/multipath/wwids\fR |
|
. |
|
.TP |
|
.B prkeys_file |
|
+This option is deprecated, and will be removed in a future release. |
|
The full pathname of the prkeys file, which is used by multipathd to keep |
|
track of the persistent reservation key used for a specific WWID, when |
|
\fIreservation_key\fR is set to \fBfile\fR. |
|
@@ -933,6 +937,7 @@ The default is: \fB<unset>\fR |
|
. |
|
.TP |
|
.B config_dir |
|
+This option is deprecated, and will be removed in a future release. |
|
If set to anything other than "", multipath will search this directory |
|
alphabetically for file ending in ".conf" and it will read configuration |
|
information from them, just as if it was in \fI/etc/multipath.conf\fR.
|
|
|