File: radclient.1

package info (click to toggle)
xtradius 1.2.1-beta2-1
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 1,252 kB
  • ctags: 921
  • sloc: ansic: 10,181; perl: 733; sh: 260; makefile: 149; sql: 21
file content (80 lines) | stat: -rw-r--r-- 2,469 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
.TH RADCLIENT 1 "24 Februari 2001" "" "Cistron Radius Daemon"
.SH NAME
radclient -- send packets to a RADIUS server, show reply
.SH SYNOPSIS
.B radclient
.RB [ \-d
.IR raddb_directory ]
.RB [ \-f
.IR file ]
.RB [ \-i
.IR source_ip ]
\fIserver acct|auth secret\fP
.SH DESCRIPTION
\fBRadclient\fP is a radius client program. It can send arbitrary radius
packets to a radius server, then shows the reply. It can be used to
test changes you mande in the configuration of the radius server,
or it can be used to monitor if a radius server is up.
.PP
\fBRadclient\fP reads radius attribute/value pairs from it standard
input, or from a file specified on the command line. It then encodes
these attribute/value pairs using the dictionary, and sends them
to the remote server.
.PP
The \fIPassword\fP attribute is automatically encrypted by \fIradclient\fP.

.SH OPTIONS

.IP "\-d \fIraddb_directory\fP"
The directory that contains the RADIUS dictionary files. Defaults to
\fI/etc/raddb\fP.

.IP "\-f \fIfile\fP"
File to read the attribute/value pairs from. If this is not specified,
they are read from stdin.

.IP \-i \fIsource_ip\fP"
The source IP address to use for sending radius packets.

.IP "server[:port]"
The hostname or IP address of the remote server. Optionally a UDP port
can be specified. If no UDP port is specified, it is looked up in
\fI/etc/services\fP. The service name looked for is \fBradacct\fP for
accounting packets, and \fBradius\fP for all other requests. If a
service is not found in \fI/etc/services\fP, 1646 and 1645 are used
respectively.

.IP "acct|auth"
Use \fBauth\fP to send an authentication packet, or \fBacct\fP to send
an accounting packet. Instead of \fBauth\fP or \fBacct\fP, you can
also use a decimal code here. For example, code 12 is \fBStatus-Server\fP.

.IP secret
The shared secret for this client. Needs to be defined on the radius
server side too, for the IP address you are sending the radius packets
from.

.SH EXAMPLE

A sample session that queries the remote server for \fIStatus-Server\fP
(not all servers support this, but Cistron Radius does since version
1.6.5):
.RS
.sp
.nf
.ne 3

$ echo "User-Name = fnord" | radclient 192.168.1.42 12 s3cr3t
Sending request to server 192.168.1.42, port 1645.
radrecv: Packet from host 192.168.1.42 code=2, id=140, length=54
    Reply-Message = "Cistron Radius up 21 days, 02:05"

.fi
.sp
.RE

.SH SEE ALSO
radiusd(8),
radtest(1).
.SH AUTHOR
Miquel van Smoorenburg, miquels@cistron.nl.