[PATCH iproute2 1/2] man: explain the naming convention of files under .d dir

[PATCH iproute2 1/2] man: explain the naming convention of files under .d dir

[Masatake YAMATO]

Signed-off-by: Masatake YAMATO <yamato@redhat.com>
---
 man/man8/ip-address.8.in | 7 +++++++
 man/man8/ip-link.8.in    | 7 +++++--
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/man/man8/ip-address.8.in b/man/man8/ip-address.8.in
index 79942c1a..e88a114f 100644
--- a/man/man8/ip-address.8.in
+++ b/man/man8/ip-address.8.in
@@ -331,6 +331,13 @@ values have a fixed interpretation. Namely:
 The rest of the values are not reserved and the administrator is free
 to assign (or not to assign) protocol tags.
 
+When scanning
+.BR rt_addrprotos.d
+directory, only files ending
+.BR .conf
+are considered.
+Files beginning with a dot are ignored.
+
 .SS ip address delete - delete protocol address
 .B Arguments:
 coincide with the arguments of
diff --git a/man/man8/ip-link.8.in b/man/man8/ip-link.8.in
index ef45fe08..67f9e2f0 100644
--- a/man/man8/ip-link.8.in
+++ b/man/man8/ip-link.8.in
@@ -2315,8 +2315,11 @@ down on the switch port.
 .BR "protodown_reason PREASON on " or " off"
 set
 .B PROTODOWN
-reasons on the device. protodown reason bit names can be enumerated under
-/etc/iproute2/protodown_reasons.d/. possible reasons bits 0-31
+reasons on the device. protodown reason bit names can be enumerated in the
+.BR *.conf
+files under
+.BR @SYSCONF_USR_DIR@/protodown_reasons.d " or " @SYSCONF_ETC_DIR@/protodown_reasons.d "."
+possible reasons bits 0-31
 
 .TP
 .BR "dynamic on " or " dynamic off"
-- 
2.51.0

Re: [PATCH iproute2 1/2] man: explain the naming convention of files under .d dir

[Stephen Hemminger]

On Thu, 18 Dec 2025 00:43:53 +0900
Masatake YAMATO <yamato@redhat.com> wrote:

> Signed-off-by: Masatake YAMATO <yamato@redhat.com>
> ---
>  man/man8/ip-address.8.in | 7 +++++++
>  man/man8/ip-link.8.in    | 7 +++++--
>  2 files changed, 12 insertions(+), 2 deletions(-)
> 
> diff --git a/man/man8/ip-address.8.in b/man/man8/ip-address.8.in
> index 79942c1a..e88a114f 100644
> --- a/man/man8/ip-address.8.in
> +++ b/man/man8/ip-address.8.in
> @@ -331,6 +331,13 @@ values have a fixed interpretation. Namely:
>  The rest of the values are not reserved and the administrator is free
>  to assign (or not to assign) protocol tags.
>  
> +When scanning
> +.BR rt_addrprotos.d
> +directory, only files ending
> +.BR .conf
> +are considered.
> +Files beginning with a dot are ignored.
> +
>  .SS ip address delete - delete protocol address
>  .B Arguments:
>  coincide with the arguments of
> diff --git a/man/man8/ip-link.8.in b/man/man8/ip-link.8.in
> index ef45fe08..67f9e2f0 100644
> --- a/man/man8/ip-link.8.in
> +++ b/man/man8/ip-link.8.in
> @@ -2315,8 +2315,11 @@ down on the switch port.
>  .BR "protodown_reason PREASON on " or " off"
>  set
>  .B PROTODOWN
> -reasons on the device. protodown reason bit names can be enumerated under
> -/etc/iproute2/protodown_reasons.d/. possible reasons bits 0-31
> +reasons on the device. protodown reason bit names can be enumerated in the
> +.BR *.conf
> +files under
> +.BR @SYSCONF_USR_DIR@/protodown_reasons.d " or " @SYSCONF_ETC_DIR@/protodown_reasons.d "."
> +possible reasons bits 0-31
>  
>  .TP
>  .BR "dynamic on " or " dynamic off"


The man page is slightly redundant here. Already have a README file in the
directory.

Re: [PATCH iproute2 1/2] man: explain the naming convention of files under .d dir

[Masatake YAMATO]

From: Stephen Hemminger <stephen@networkplumber.org>
Subject: Re: [PATCH iproute2 1/2] man: explain the naming convention of files under .d dir
Date: Mon, 22 Dec 2025 10:32:09 -0800

> On Thu, 18 Dec 2025 00:43:53 +0900
> Masatake YAMATO <yamato@redhat.com> wrote:
> 
>> Signed-off-by: Masatake YAMATO <yamato@redhat.com>
>> ---
>>  man/man8/ip-address.8.in | 7 +++++++
>>  man/man8/ip-link.8.in    | 7 +++++--
>>  2 files changed, 12 insertions(+), 2 deletions(-)
>> 
>> diff --git a/man/man8/ip-address.8.in b/man/man8/ip-address.8.in
>> index 79942c1a..e88a114f 100644
>> --- a/man/man8/ip-address.8.in
>> +++ b/man/man8/ip-address.8.in
>> @@ -331,6 +331,13 @@ values have a fixed interpretation. Namely:
>>  The rest of the values are not reserved and the administrator is free
>>  to assign (or not to assign) protocol tags.
>>  
>> +When scanning
>> +.BR rt_addrprotos.d
>> +directory, only files ending
>> +.BR .conf
>> +are considered.
>> +Files beginning with a dot are ignored.
>> +
>>  .SS ip address delete - delete protocol address
>>  .B Arguments:
>>  coincide with the arguments of
>> diff --git a/man/man8/ip-link.8.in b/man/man8/ip-link.8.in
>> index ef45fe08..67f9e2f0 100644
>> --- a/man/man8/ip-link.8.in
>> +++ b/man/man8/ip-link.8.in
>> @@ -2315,8 +2315,11 @@ down on the switch port.
>>  .BR "protodown_reason PREASON on " or " off"
>>  set
>>  .B PROTODOWN
>> -reasons on the device. protodown reason bit names can be enumerated under
>> -/etc/iproute2/protodown_reasons.d/. possible reasons bits 0-31
>> +reasons on the device. protodown reason bit names can be enumerated in the
>> +.BR *.conf
>> +files under
>> +.BR @SYSCONF_USR_DIR@/protodown_reasons.d " or " @SYSCONF_ETC_DIR@/protodown_reasons.d "."
>> +possible reasons bits 0-31
>>  
>>  .TP
>>  .BR "dynamic on " or " dynamic off"
> 
> 
> The man page is slightly redundant here. Already have a README file in the
> directory.
> 

I didn't know the README files. I would like to withdraw the proposal of
this change.

Masatake YAMATO