Pulled from branch_1_1
[freeradius.git] / man / man1 / radtest.1
1 .TH RADTEST 1 "24 February 2001" "" "FreeRADIUS Daemon"
2 .SH NAME
3 radtest - send packets to a RADIUS server, show reply
4 .SH SYNOPSIS
5 .B radtest
6 .RB [ \-d
7 .IR raddb_directory ]
8 .I user password radius-server nas-port-number secret
9 .RB [ ppphint ]
10 .RB [ nasname ]
11 .SH DESCRIPTION
12 \fBradtest\fP is a frontend to \fBradclient\fP(1). It generates a
13 list of attribute/value pairs based on the command line arguments,
14 and feeds these into \fBradclient\fP. It's a fast and convenient
15 way to test a radius server.
16
17 .SH OPTIONS
18
19 .IP "\-d \fIraddb_directory\fP"
20 The directory that contains the RADIUS dictionary files. Defaults to
21 \fI/etc/raddb\fP.
22
23 .IP user
24 Username to send.
25
26 .IP password
27 Password of the user.
28
29 .IP radius-server
30 Hostname or IP address of the radius server. Optionally, you may specify a
31 port by appending :port
32
33 .IP nas-port-number
34 The value of the NAS-Port attribute. Is an integer between 0 and 2^31,
35 and it really doesn't matter what you put here. \fI10\fP will do fine.
36
37 .IP secret
38 The shared secret for this client.
39
40 .IP ppphint
41 If you put an integer > 0 here, radtest (or actually radclient) will
42 add the attribute \fIFramed-Protocol = PPP\fP to the request packet.
43
44 .IP nasname
45 If present, this will be resolved to an IP address and added to
46 the request packet as the \fINAS-IP-Address\fP attribute. If you
47 don't specify it, the local hostname of the system will be used.
48
49 .SH SEE ALSO
50 radiusd(8),
51 radclient(1).
52 .SH AUTHOR
53 Miquel van Smoorenburg, miquels@cistron.nl.