Update clients(5) man page
Remove attribute description from clients.conf(5) source as it is outdated, lists just a few attributes and wasn't updated for more than a year. Refer to clients.conf file itself, instead. Remove references to non-existent naslist and clients manpages as they are confusing. Resolves: bug#1147464
This commit is contained in:
parent
f683c66d9f
commit
46c7f7b947
100
freeradius-man-remove-client-attribute-description.patch
Normal file
100
freeradius-man-remove-client-attribute-description.patch
Normal file
@ -0,0 +1,100 @@
|
|||||||
|
From ca2eedaad0bc27dd6a540e61c583f0b745641a84 Mon Sep 17 00:00:00 2001
|
||||||
|
From: Nikolai Kondrashov <Nikolai.Kondrashov@redhat.com>
|
||||||
|
Date: Tue, 2 Dec 2014 16:39:28 +0200
|
||||||
|
Subject: [PATCH 1/2] man: Remove client attribute description
|
||||||
|
|
||||||
|
Remove attribute description from clients.conf(5) source as it is
|
||||||
|
outdated, lists just a few attributes and wasn't updated for more than a
|
||||||
|
year. Refer to clients.conf file itself, instead.
|
||||||
|
---
|
||||||
|
man/man5/clients.conf.5 | 74 +++----------------------------------------------
|
||||||
|
1 file changed, 4 insertions(+), 70 deletions(-)
|
||||||
|
|
||||||
|
diff --git a/man/man5/clients.conf.5 b/man/man5/clients.conf.5
|
||||||
|
index 9af246a..f9207d1 100644
|
||||||
|
--- a/man/man5/clients.conf.5
|
||||||
|
+++ b/man/man5/clients.conf.5
|
||||||
|
@@ -26,76 +26,10 @@ client <short-name> {
|
||||||
|
<attribute> = <value>
|
||||||
|
}
|
||||||
|
.fi
|
||||||
|
-.SH ATTRIBUTES
|
||||||
|
-The attributes that can appear in a
|
||||||
|
-.B client
|
||||||
|
-section are listed below. Required attributes are labelled as
|
||||||
|
-such. All other attributes are optional.
|
||||||
|
-.TP 0.5i
|
||||||
|
-.B ipaddr [Required]
|
||||||
|
-The IP address of the client. For IPv6, use "ipv6addr"
|
||||||
|
-.TP 0.5i
|
||||||
|
-.B secret [Required]
|
||||||
|
-The RADIUS shared secret used for communication between the client/NAS
|
||||||
|
-and the RADIUS server.
|
||||||
|
-.TP 0.5i
|
||||||
|
-.B shortname [optional]
|
||||||
|
-A short alias that can be used in place of the IP address or fully
|
||||||
|
-qualified hostname provided in the first line of the section.
|
||||||
|
-.TP 0.5i
|
||||||
|
-.B nas_type
|
||||||
|
-The nas_type attribute is used to tell the
|
||||||
|
-.BR checkrad.pl
|
||||||
|
-script which NAS-specific method it should use when checking
|
||||||
|
-simultaneous use.
|
||||||
|
-
|
||||||
|
-The following values are currently recognized:
|
||||||
|
-.nf
|
||||||
|
-cisco
|
||||||
|
-computone
|
||||||
|
-livingston
|
||||||
|
-max40xx
|
||||||
|
-multitech
|
||||||
|
-netserver
|
||||||
|
-pathras
|
||||||
|
-patton
|
||||||
|
-portslave
|
||||||
|
-tc
|
||||||
|
-usrhiper
|
||||||
|
-other
|
||||||
|
-.fi
|
||||||
|
-.TP 0.5i
|
||||||
|
-.B login
|
||||||
|
-Reserved for future use.
|
||||||
|
-.TP 0.5i
|
||||||
|
-.B password
|
||||||
|
-Reserved for future use.
|
||||||
|
-.SH EXAMPLES
|
||||||
|
-.IP
|
||||||
|
-.nf
|
||||||
|
-client localhost {
|
||||||
|
- ipaddr = 127.0.0.1
|
||||||
|
- secret = testing123
|
||||||
|
- shortname = localhost
|
||||||
|
- nas_type = other
|
||||||
|
-}
|
||||||
|
-.fi
|
||||||
|
-.LP
|
||||||
|
-This adds a client for the loopback address. This is useful in testing
|
||||||
|
-the
|
||||||
|
-server locally, for example with
|
||||||
|
-.BR radclient (1).
|
||||||
|
-.IP
|
||||||
|
-.nf
|
||||||
|
-client private-network-1 {
|
||||||
|
- ipaddr = 192.0.2.0
|
||||||
|
- netmask = 24
|
||||||
|
- secret = testing123-1
|
||||||
|
- shortname = private-network-1
|
||||||
|
-}
|
||||||
|
-.fi
|
||||||
|
-.LP
|
||||||
|
-This entry represents any client from the 192.0.2.0/24 network.
|
||||||
|
+.PP
|
||||||
|
+Clients have many configuration parameters. Most are documented in the file
|
||||||
|
+itself as comments. This page documents only the format of the file. Please
|
||||||
|
+read the \fBclients.conf\fP file itself for more information.
|
||||||
|
|
||||||
|
The old-style format from 1.x is still accepted by the server, but
|
||||||
|
that form is deprecated.
|
||||||
|
--
|
||||||
|
2.1.3
|
||||||
|
|
@ -0,0 +1,67 @@
|
|||||||
|
From 55a489a7885608158f66823686d89eb7cf54d5a9 Mon Sep 17 00:00:00 2001
|
||||||
|
From: Nikolai Kondrashov <Nikolai.Kondrashov@redhat.com>
|
||||||
|
Date: Tue, 2 Dec 2014 16:43:49 +0200
|
||||||
|
Subject: [PATCH 2/2] man: Remove references to naslist and clients
|
||||||
|
|
||||||
|
Remove references to non-existent naslist and clients manpages as they
|
||||||
|
are confusing.
|
||||||
|
---
|
||||||
|
man/man5/clients.conf.5 | 8 +++-----
|
||||||
|
man/man5/dictionary.5 | 1 -
|
||||||
|
man/man5/users.5 | 1 -
|
||||||
|
3 files changed, 3 insertions(+), 7 deletions(-)
|
||||||
|
|
||||||
|
diff --git a/man/man5/clients.conf.5 b/man/man5/clients.conf.5
|
||||||
|
index f9207d1..6c6b3ee 100644
|
||||||
|
--- a/man/man5/clients.conf.5
|
||||||
|
+++ b/man/man5/clients.conf.5
|
||||||
|
@@ -8,9 +8,9 @@ file contains definitions of RADIUS clients.
|
||||||
|
.PP
|
||||||
|
The information in this file overrides any information provided in
|
||||||
|
the deprecated
|
||||||
|
-.BR clients (5)
|
||||||
|
+.BR clients
|
||||||
|
and
|
||||||
|
-.BR naslist (5)
|
||||||
|
+.BR naslist
|
||||||
|
files.
|
||||||
|
.PP
|
||||||
|
The file format is the same as that used for
|
||||||
|
@@ -39,9 +39,7 @@ that form is deprecated.
|
||||||
|
.I /etc/raddb/radiusd.conf
|
||||||
|
.SH "SEE ALSO"
|
||||||
|
.BR radiusd (8),
|
||||||
|
-.BR radiusd.conf (5),
|
||||||
|
-.BR clients (5),
|
||||||
|
-.BR naslist (5)
|
||||||
|
+.BR radiusd.conf (5)
|
||||||
|
|
||||||
|
.SH AUTHOR
|
||||||
|
FreeRADIUS is authored by the FreeRADIUS team.
|
||||||
|
diff --git a/man/man5/dictionary.5 b/man/man5/dictionary.5
|
||||||
|
index 6b60602..d685081 100644
|
||||||
|
--- a/man/man5/dictionary.5
|
||||||
|
+++ b/man/man5/dictionary.5
|
||||||
|
@@ -176,7 +176,6 @@ the attribute number should be used instead.
|
||||||
|
.I /usr/share/freeradius/dictionary.*
|
||||||
|
.SH "SEE ALSO"
|
||||||
|
.BR radiusd (8),
|
||||||
|
-.BR naslist (5),
|
||||||
|
.BR RFC2865,
|
||||||
|
.BR RFC2866,
|
||||||
|
.BR RFC2868
|
||||||
|
diff --git a/man/man5/users.5 b/man/man5/users.5
|
||||||
|
index ed8f471..c9aef82 100644
|
||||||
|
--- a/man/man5/users.5
|
||||||
|
+++ b/man/man5/users.5
|
||||||
|
@@ -243,7 +243,6 @@ entries that set reply attributes.
|
||||||
|
.BR radclient (1),
|
||||||
|
.BR radiusd (8),
|
||||||
|
.BR dictionary (5),
|
||||||
|
-.BR naslist (5)
|
||||||
|
|
||||||
|
.SH AUTHOR
|
||||||
|
The FreeRADIUS team.
|
||||||
|
--
|
||||||
|
2.1.3
|
||||||
|
|
@ -42,6 +42,8 @@ Patch18: freeradius-raddb-update-triggers-in-trigger.conf.patch
|
|||||||
Patch19: freeradius-make-grp-tallo-c-too.patch
|
Patch19: freeradius-make-grp-tallo-c-too.patch
|
||||||
Patch20: freeradius-fix-checks-for-PW_TYPE_FILE_INPUT.patch
|
Patch20: freeradius-fix-checks-for-PW_TYPE_FILE_INPUT.patch
|
||||||
Patch21: freeradius-added-D-option-to-mirror-radclient.patch
|
Patch21: freeradius-added-D-option-to-mirror-radclient.patch
|
||||||
|
Patch22: freeradius-man-remove-client-attribute-description.patch
|
||||||
|
Patch23: freeradius-man-remove-references-to-naslist-and-clients.patch
|
||||||
|
|
||||||
%global docdir %{?_pkgdocdir}%{!?_pkgdocdir:%{_docdir}/%{name}-%{version}}
|
%global docdir %{?_pkgdocdir}%{!?_pkgdocdir:%{_docdir}/%{name}-%{version}}
|
||||||
|
|
||||||
@ -219,6 +221,8 @@ This plugin provides the unixODBC support for the FreeRADIUS server project.
|
|||||||
%patch19 -p1
|
%patch19 -p1
|
||||||
%patch20 -p1
|
%patch20 -p1
|
||||||
%patch21 -p1
|
%patch21 -p1
|
||||||
|
%patch22 -p1
|
||||||
|
%patch23 -p1
|
||||||
|
|
||||||
%build
|
%build
|
||||||
# Force compile/link options, extra security for network facing daemon
|
# Force compile/link options, extra security for network facing daemon
|
||||||
|
Loading…
Reference in New Issue
Block a user