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

[Stephen Hemminger <stephen@networkplumber.org>]

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.