[rpcbind,1/1] man/rpcbind: Mention systemd socket in -h
diff mbox series

Message ID 20200605075332.14564-1-pvorel@suse.cz
State New
Headers show
Series
  • [rpcbind,1/1] man/rpcbind: Mention systemd socket in -h
Related show

Commit Message

Petr Vorel June 5, 2020, 7:53 a.m. UTC
and reformat doc a bit.

Based on Olaf Kirch's patch for openSUSE.

Signed-off-by: Petr Vorel <pvorel@suse.cz>
---
Hi Steve,

original patch:
https://build.opensuse.org/package/view_file/openSUSE:Factory/rpcbind/0031-rpcbind-manpage.patch?expand=1

Olaf removed note about multi-homed host and about adding 127.0.0.1 an
::1. I kept them, but maybe multi-homed is not relevant any more or not
limited only to UDP. Feel free to modify the text to better accommodate
to current usage.

Kind regards,
Petr

 man/rpcbind.8 | 32 ++++++++++++++++++++++----------
 1 file changed, 22 insertions(+), 10 deletions(-)

Comments

Steve Dickson June 9, 2020, 1:47 p.m. UTC | #1
On 6/5/20 3:53 AM, Petr Vorel wrote:
> and reformat doc a bit.
> 
> Based on Olaf Kirch's patch for openSUSE.
> 
> Signed-off-by: Petr Vorel <pvorel@suse.cz>
Committed... (tag: rpcbind-1_2_6-rc6)

steved.

> ---
> Hi Steve,
> 
> original patch:
> https://build.opensuse.org/package/view_file/openSUSE:Factory/rpcbind/0031-rpcbind-manpage.patch?expand=1
> 
> Olaf removed note about multi-homed host and about adding 127.0.0.1 an
> ::1. I kept them, but maybe multi-homed is not relevant any more or not
> limited only to UDP. Feel free to modify the text to better accommodate
> to current usage.
> 
> Kind regards,
> Petr
> 
>  man/rpcbind.8 | 32 ++++++++++++++++++++++----------
>  1 file changed, 22 insertions(+), 10 deletions(-)
> 
> diff --git a/man/rpcbind.8 b/man/rpcbind.8
> index af6200f..fbf0ace 100644
> --- a/man/rpcbind.8
> +++ b/man/rpcbind.8
> @@ -86,9 +86,16 @@ checks are shown in detail.
>  Do not fork and become a background process.
>  .It Fl h
>  Specify specific IP addresses to bind to for UDP requests.
> -This option
> -may be specified multiple times and is typically necessary when running
> -on a multi-homed host.
> +This option may be specified multiple times and can be used to
> +restrict the interfaces rpcbind will respond to.
> +When specifying IP addresses with
> +.Fl h ,
> +.Nm
> +will automatically add
> +.Li 127.0.0.1
> +and if IPv6 is enabled,
> +.Li ::1
> +to the list.
>  If no
>  .Fl h
>  option is specified,
> @@ -99,14 +106,19 @@ which could lead to problems on a multi-homed host due to
>  .Nm
>  returning a UDP packet from a different IP address than it was
>  sent to.
> -Note that when specifying IP addresses with
> -.Fl h ,
> +Note that when
>  .Nm
> -will automatically add
> -.Li 127.0.0.1
> -and if IPv6 is enabled,
> -.Li ::1
> -to the list.
> +is controlled via systemd's socket activation,
> +the
> +.Fl h
> +option is ignored. In this case, you need to edit
> +the
> +.Nm ListenStream
> +and
> +.Nm ListenDgram
> +definitions in
> +.Nm /usr/lib/systemd/system/rpcbind.socket
> +instead.
>  .It Fl i
>  .Dq Insecure
>  mode.
>

Patch
diff mbox series

diff --git a/man/rpcbind.8 b/man/rpcbind.8
index af6200f..fbf0ace 100644
--- a/man/rpcbind.8
+++ b/man/rpcbind.8
@@ -86,9 +86,16 @@  checks are shown in detail.
 Do not fork and become a background process.
 .It Fl h
 Specify specific IP addresses to bind to for UDP requests.
-This option
-may be specified multiple times and is typically necessary when running
-on a multi-homed host.
+This option may be specified multiple times and can be used to
+restrict the interfaces rpcbind will respond to.
+When specifying IP addresses with
+.Fl h ,
+.Nm
+will automatically add
+.Li 127.0.0.1
+and if IPv6 is enabled,
+.Li ::1
+to the list.
 If no
 .Fl h
 option is specified,
@@ -99,14 +106,19 @@  which could lead to problems on a multi-homed host due to
 .Nm
 returning a UDP packet from a different IP address than it was
 sent to.
-Note that when specifying IP addresses with
-.Fl h ,
+Note that when
 .Nm
-will automatically add
-.Li 127.0.0.1
-and if IPv6 is enabled,
-.Li ::1
-to the list.
+is controlled via systemd's socket activation,
+the
+.Fl h
+option is ignored. In this case, you need to edit
+the
+.Nm ListenStream
+and
+.Nm ListenDgram
+definitions in
+.Nm /usr/lib/systemd/system/rpcbind.socket
+instead.
 .It Fl i
 .Dq Insecure
 mode.