svn commit: r361311 - in stable: 11/usr.sbin/inetd 12/usr.sbin/inetd

[Kyle Evans]

Author: kevans
Date: Thu May 21 01:53:03 2020
New Revision: 361311
URL: https://svnweb.freebsd.org/changeset/base/361311

Log:
  MFC r361000, r361036: improve inetd(8) examples
  
  r361000:
  inetd(8): Provide HTTP proxy example using netcat
  
  One of the fortunes that are included in freebsd-tips talks about how
  the superserver can be used to proxy connections with netcat, but there are
  no examples provided. This commit adds an example with comment explaining
  what it does.
  
  r361036:
  inetd(8): Add comments to all examples

Modified:
  stable/12/usr.sbin/inetd/inetd.8
Directory Properties:
  stable/12/   (props changed)

Changes in other areas also in this revision:
Modified:
  stable/11/usr.sbin/inetd/inetd.8
Directory Properties:
  stable/11/   (props changed)

Modified: stable/12/usr.sbin/inetd/inetd.8
==============================================================================
--- stable/12/usr.sbin/inetd/inetd.8	Thu May 21 01:23:59 2020	(r361310)
+++ stable/12/usr.sbin/inetd/inetd.8	Thu May 21 01:53:03 2020	(r361311)
@@ -28,7 +28,7 @@
 .\"     from: @(#)inetd.8	8.3 (Berkeley) 4/13/94
 .\" $FreeBSD$
 .\"
-.Dd January 12, 2008
+.Dd May 14, 2020
 .Dt INETD 8
 .Os
 .Sh NAME
@@ -793,14 +793,30 @@ the pid of the currently running
 .Sh "EXAMPLES"
 Here are several example service entries for the various types of services:
 .Bd -literal
+# The first four launch the relevant daemon when a connection on a port
+# as defined by /etc/services is opened.
 ftp          stream  tcp   nowait root  /usr/libexec/ftpd        ftpd -l
 ntalk        dgram   udp   wait   root  /usr/libexec/ntalkd      ntalkd
 telnet       stream  tcp6  nowait root  /usr/libexec/telnetd  telnetd
 shell        stream  tcp46  nowait root  /usr/libexec/rshd rshd
+
+# Let the system respond to date requests via tcpmux
 tcpmux/+date stream  tcp   nowait guest /bin/date                date
+
+# Let people access the system phonebook via tcpmux
 tcpmux/phonebook stream tcp nowait guest /usr/local/bin/phonebook phonebook
+
+# Make kernel statistics accessible
 rstatd/1-3   dgram   rpc/udp wait root  /usr/libexec/rpc.rstatd  rpc.rstatd
-/var/run/echo stream unix  nowait root	internal
+
+# Use netcat as a one-shot HTTP proxy with nc (from freebsd-tips fortune)
+http         stream  tcp   nowait nobody /usr/bin/nc nc -N dest-ip 80
+
+# Set up a unix socket at /var/run/echo that echo's back whatever is written
+# to it.
+/var/run/echo stream unix  nowait root  internal
+
+# Run chargen for IPsec Authentication Headers
 #@ ipsec ah/require
 chargen      stream  tcp   nowait root  internal
 #@
@@ -914,6 +930,7 @@ in the
 database.
 .El
 .Sh SEE ALSO
+.Xr nc 1 ,
 .Xr ipsec_set_policy 3 ,
 .Xr hosts_access 5 ,
 .Xr hosts_options 5 ,