Skip to contentSkip to conversation

man/rpcbind: Mention systemd socket in -h

PATCH In review Petr Vorel 2 participants 2 messages Jun 5, 2020 – Jun 9, 2020

Subsystems (2)
lore
Share & tools
lore

Petr Vorel

author
#0 lore raw

PATCH 1/1 man/rpcbind: Mention systemd socket in -h

and reformat doc a bit.

Based on Olaf Kirch's patch for openSUSE.

---
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(-)
man/rpcbind.8 +22 -10
index af6200f..fbf0ace 100644
@@ -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.
Signature · 1 line
2.26.2
#1 lore raw
Quoted 5 lines · Petr Vorel

and reformat doc a bit.

Based on Olaf Kirch's patch for openSUSE.

Committed... (tag: rpcbind-1_2_6-rc6)

steved.

Quoted 69 lines

---
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(-)
man/rpcbind.8 +22 -10
index af6200f..fbf0ace 100644
@@ -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.