docs/80416: Add information on how to use AllowUsers to the OpenSSH section

[Brad Davis]

The following reply was made to PR docs/80416; it has been noted by GNATS.

From: Brad Davis <so14k at so14k.com>
To: bug-followup at freebsd.org, blackend at freebsd.org
Cc:  
Subject: Re: docs/80416: Add information on how to use AllowUsers to the OpenSSH section
Date: Wed, 27 Apr 2005 18:18:34 -0600

 Add <varname> tags in the title around AllowUsers so that it is visiable
 (for those who know what they are looking for...).
 
 
 
 --- doc-ori/en_US.ISO8859-1/books/handbook/security/chapter.sgml	Wed Apr 27 01:28:51 2005
 +++ doc/en_US.ISO8859-1/books/handbook/security/chapter.sgml	Wed Apr 27 18:16:38 2005
 @@ -4546,6 +4546,41 @@
      </sect2>
  
      <sect2>
 +      <title><varname>AllowUsers</varname> - Controlling What Users Are
 +        Allowed to Login and From Where</title>
 +
 +      <para>It is often a good idea to only allow users to login from a
 +        certain host and not allow other users to login at all.  The
 +        <literal>AllowUsers</literal> options is a good way to
 +        accomplish this.  For example, to only allow the root user to
 +        login from <hostid role="ipaddr">192.168.1.32</hostid>,
 +        something like this would be appropriate in the
 +        <filename>/etc/ssh/sshd_config</filename> file:</para>
 +
 +      <programlisting>AllowUsers root at 192.168.1.32</programlisting>
 +
 +      <para>To allow a user, <username>admin</username>, to login from
 +        anywhere, just list the username by itself:</para>
 +
 +      <programlisting>AllowUsers admin</programlisting>
 +
 +      <para>Multiple users will all be listed on the same line:</para>
 +
 +      <programlisting>AllowUsers root at 192.168.1.32 admin</programlisting>
 +
 +      <note>
 +        <para>It is important that you list each user that needs to
 +          login to this machine, otherwise they will be locked out.</para>
 +      </note>
 +
 +      <para>After making any changes to
 +         <filename>/etc/ssh/sshd_config</filename> you must tell
 +         &man.sshd.8; to reload it's config files, by running:</para>
 +
 +      <programlisting>&prompt.root; /etc/rc.d/sshd reload</programlisting>
 +    </sect2>
 +
 +    <sect2>
        <title>Further Reading</title>
        <para><ulink url="http://www.openssh.com/">OpenSSH</ulink></para>
        <para>&man.ssh.1; &man.scp.1; &man.ssh-keygen.1;