From 5904db9a088d01c5470fe5a5a8d7b950dafe32df Mon Sep 17 00:00:00 2001 From: aland Date: Tue, 13 Mar 2001 18:11:11 +0000 Subject: [PATCH] Copied from Cistron 1.6.5, with minor changes for FreeRADIUS --- man/man1/radlast.1 | 22 +++++++++++++++++++- man/man1/radtest.1 | 53 ++++++++++++++++++++++++++++++++++++++++++++++- man/man1/raduse.1 | 30 ++++++++++++++++++++++++++- man/man1/radwho.1 | 59 ++++++++++++++++++++++++++++++++++++++++++++++++++++- man/man1/radzap.1 | 35 ++++++++++++++++++++++++++++++- man/man8/radwatch.8 | 21 ++++++++++++++++++- 6 files changed, 214 insertions(+), 6 deletions(-) diff --git a/man/man1/radlast.1 b/man/man1/radlast.1 index 939c9a1..afc7084 100644 --- a/man/man1/radlast.1 +++ b/man/man1/radlast.1 @@ -1 +1,21 @@ -.so man7/undocumented.7 +.TH RADLAST 1 "22 February 2001" "" "FreeRADIUS Daemon" +.SH NAME +radlast -- show "last" info from the radwtmp file +.SH SYNOPSIS +.B radlast +.IR [ options ] +.SH DESCRIPTION +The FreeRADIUS server can write an accounting log in the +\fIwtmp\fP format of the local system. \fBRadlast\fP is a frontend +for the systems \fBlast\fP command - it just calls \fBlast\fP +with the \fI-f path_to_radwtmp_file\fP argument, and passes all +options on the command line to the system \fBlast\fP command. +.SH OPTIONS +See the manpage of the system \fBlast\fP command. +.SH SEE ALSO +radiusd(8), +radiusd.conf(5), +wtmp(5), +last(1). +.SH AUTHOR +Miquel van Smoorenburg, miquels@cistron.nl. diff --git a/man/man1/radtest.1 b/man/man1/radtest.1 index 939c9a1..09db52b 100644 --- a/man/man1/radtest.1 +++ b/man/man1/radtest.1 @@ -1 +1,52 @@ -.so man7/undocumented.7 +.TH RADTEST 1 "24 February 2001" "" "FreeRADIUS Daemon" +.SH NAME +radtest -- send packets to a RADIUS server, show reply +.SH SYNOPSIS +.B radtest +.RB [ \-d +.IR raddb_directory ] +.I user password radius-server nas-port-id secret +.RB [ ppphint ] +.RB [ nasname ] +.SH DESCRIPTION +\fBRadtest\fP is a frontend to \fBradclient\fP(1). It generates a +list of attribute/value pairs based on the command line arguments, +and feeds these into \fBradclient\fP. It's a fast and convenient +way to test a radius server. + +.SH OPTIONS + +.IP "\-d \fIraddb_directory\fP" +The directory that contains the RADIUS dictionary files. Defaults to +\fI/etc/raddb\fP. + +.IP user +Username to send. + +.IP password +Password of the user. + +.IP radius-server +Hostname or IP address of the radius server. + +.IP nas-port-id +The value of the NAS-Port-Id attribute. Is an integer between 0 and 2^31, +and it really doesn't matter what you put here. \fI10\fP will do fine. + +.IP secret +The shared secret for this client. + +.IP ppphint +If you put an integer > 0 here, radtest (or actually radclient) will +add the attribute \fIFramed-Protocol = PPP\fP to the request packet. + +.IP nasname +If present, this will be resolved to an IP address and added to +the request packet as the \fINAS-IP-Address\fP attribute. If you +don't specify it, the local hostname of the system will be used. + +.SH SEE ALSO +radiusd(8), +radclient(1). +.SH AUTHOR +Miquel van Smoorenburg, miquels@cistron.nl. diff --git a/man/man1/raduse.1 b/man/man1/raduse.1 index 939c9a1..034e809 100644 --- a/man/man1/raduse.1 +++ b/man/man1/raduse.1 @@ -1 +1,29 @@ -.so man7/undocumented.7 +.TH RADUSE 1 "24 February 2001" "" "FreeRADIUS Daemon" +.SH NAME +rasuse -- Shows the usage of the modem lines on a terminal server. +.SH SYNOPSIS +.B raduse +.RB [ \-w ] +.RB [ \-o +.IR offset ] +.I terminal-server +.SH DESCRIPTION +\fBRaduse\fP Shows the usage of the modem lines on a terminal server. +This program gets its info from the radwtmp file, which +is sloooww on larger servers, and the data from the +radwtmp file can't be trusted 100% either. +.PP +It is deprecated and not documented very well. Don't use it. +.SH OPTIONS +.IP \-w +Wide output format +.IP "\-o \fIoffset\fP" +Start showing nas-port from this offset. +.IP terminal-server +The NAS to show. +.SH SEE ALSO +radiusd(8), +wtmp(5), +last(1). +.SH AUTHOR +Miquel van Smoorenburg, miquels@cistron.nl. diff --git a/man/man1/radwho.1 b/man/man1/radwho.1 index 939c9a1..8f84062 100644 --- a/man/man1/radwho.1 +++ b/man/man1/radwho.1 @@ -1 +1,58 @@ -.so man7/undocumented.7 +.TH RADWHO 1 "23 February 2001" "" "FreeRADIUS Daemon" +.SH NAME +radwho -- show online users +.SH SYNOPSIS +.B radwho +.RB [ \-l ] +.RB [ \-h ] +.RB [ \-f ] +.RB [ \-n ] +.RB [ \-s ] +.RB [ \-i ] +.RB [ \-p ] +.RB [ \-c ] +.RB [ \-r ] +.SH DESCRIPTION +The FreeRADIUS server can be configured to maintain an active session +database in a file called \fIradutmp\fP. This utility shows the +content of that session database. +.SH OPTIONS +.IP \-l +Show local shell users too. In this case, \fBradwho\fP reads the +local "session database" aka the systems \fIutmp\fP file as well +and shows the contents of that file before the contents of the +radius "session database" aka the \fIradutmp\fP file, in the +same format. +.IP \-h +Hide shell users. Doesn't show the entries for users that do not +have a SLIP or PPP session. +.IP \-f +Behave as the 'fingerd' daemon - waits for one line of input, then +prints the output with lines \\r\\n terminated. +.IP \-n +Normally radwho looks up the username in the systems password file, +and shows the full username as well. The \fB-n\fP flags prevents this. +.IP \-s +Show full name. +.IP \-i +Shows the session ID instead of the full name. +.IP \-p +Adds an extra column for the port type - I for ISDN, A for Analog. +.IP \-c +Shows caller ID (if available) instead of the full name. +.IP \-r +Outputs all data in \fIraw\fP format - no headers, no formatting, +fields are comma-seperated. + +.SH SEE ALSO +radiusd(8). +.SH AUTHOR +Miquel van Smoorenburg, miquels@cistron.nl. + +.SH SEE ALSO +radiusd(8), +radiusd.conf(5), +wtmp(5), +last(1). +.SH AUTHOR +Miquel van Smoorenburg, miquels@cistron.nl. diff --git a/man/man1/radzap.1 b/man/man1/radzap.1 index 939c9a1..db21b83 100644 --- a/man/man1/radzap.1 +++ b/man/man1/radzap.1 @@ -1 +1,34 @@ -.so man7/undocumented.7 +.TH RADZAP 1 "22 February 2001" "" "FreeRadius Daemon" +.SH NAME +radzap -- remove rogue entries from the active sessions database +.SH SYNOPSIS +.B radzap +.RB [ \-v ] +.I nas +.RB [ port ] +.RB [ username ] +.SH DESCRIPTION +The FreeRadius server can be configured to maintain an active session +database in a file called \fIradutmp\fP. Commands like \fBradwho\fP(1) +use this database. Sometimes that database can get out of sync, and +then it might contain rogue entries. \fBRadzap\fP can clean up this +database. +.SH OPTIONS +.IP \-v +Verbose. Shows you what it is doing. +.IP nas +Hostname or IP address of the NAS (Network Access Server, sometimes +called "terminal server") of the session you want to remove. +.IP port +Port of the session you want to remove. This is the NAS-Port +radius attribute, it doesn't have anything to do with UDP port +numbers. Must be an integer. \fB-1\fP means "any", and is the +default if this option is not specified. +.IP username +Optional: the username of the session you want to remove. +.SH SEE ALSO +radwho(1), +radiusd(8), +radiusd.conf(5). +.SH AUTHOR +Miquel van Smoorenburg, miquels@cistron.nl. diff --git a/man/man8/radwatch.8 b/man/man8/radwatch.8 index 939c9a1..08e9d39 100644 --- a/man/man8/radwatch.8 +++ b/man/man8/radwatch.8 @@ -1 +1,20 @@ -.so man7/undocumented.7 +.TH RADWATCH 8 "24 February 2001" "" "FreeRADIUS Daemon" +.SH NAME +radwatch -- wrapper for radiusd +.SH SYNOPSIS +.B radwatch +.IR [ options ] +.SH DESCRIPTION +This is a wrapper for \fIradiusd\fP. It starts the radius server, then +waits for it to terminate, which should never happen. If it does +happen, \fBradwatch\fP sends mail to \fIroot\fP informing her of +the event, waits 10 seconds, then restarts the server. +.PP +The FreeRADIUS server should now stable enough that this wrapper +is probably no longer needed. +.SH OPTIONS +Passed directly to the radius server - see the manpage of \fBradiusd\fP. +.SH SEE ALSO +radiusd(8). +.SH AUTHOR +Miquel van Smoorenburg, miquels@cistron.nl. -- 2.1.4