1DHCPCLIENT(1)                  FreeRADIUS Daemon                 DHCPCLIENT(1)
2
3
4

NAME

6       dhcpclient  -  Send  a DHCP request with provided RADIUS attributes and
7       get the output response.
8

SYNOPSIS

10       dhcpclient [-d raddb_directory]  [-D  dictionary_directory]  [-f  file]
11       [-h]   [-i  interface]  [-t  timeout]  [-v]  [-x]  server[:port]  {dis‐
12       cover|request|decline|release|inform|auto}
13

DESCRIPTION

15       dhcpclient is a DHCP test client program. It can  send  arbitrary  DHCP
16       packets to the FreeRADIUS server running as DHCP server, then shows the
17       reply.  It can be used to test changes you made in the configuration of
18       the  radius  server, or it can be used to monitor if a radius server is
19       up.
20
21       dhcpclient reads radius attribute/value pairs from its standard  input,
22       or  from  a  file  specified on the command line. It then encodes these
23       attribute/value pairs using the  dictionary,  and  sends  them  to  the
24       local/remote server.
25

OPTIONS

27       -d raddb_directory
28              The  directory  that contains the user dictionary file. Defaults
29              to /etc/raddb.
30
31       -D dictionary_directory
32              The directory that contains the main dictionary  file.  Defaults
33              to /usr/share/freeradius.
34
35       -f file[:file]
36              File  to  read  the  attribute/value  pairs from. If this is not
37              specified, they are read from stdin.  This option can be  speci‐
38              fied  multiple times, in which case packets are sent in order by
39              file, and within each file, by first packet to last  packet.   A
40              blank line separates logical packets within a file.
41
42       -h     Print usage help information.
43
44       -i interface
45              Select  which interface to send/receive at packet level on a raw
46              socket.
47
48       -t timeout
49              Wait timeout seconds  before  deciding  that  the  NAS  has  not
50              responded to a request, and re-sending the packet. This may be a
51              floating point number, e.g. 2.2.
52
53       -v     Print out program version information.
54
55       -x     Print out debugging information.
56
57       server[:port]
58              The hostname or IP address of the remote  server.  Optionally  a
59              UDP  port  can  be specified. If no UDP port is specified, it is
60              looked up in /etc/services.  The  service  name  looked  for  is
61              radacct  for  accounting  packets,  and  radius  for  all  other
62              requests. If a service is not found in /etc/services,  1813  and
63              1812 are used respectively.
64
65       discover | request | decline | release | inform | auto
66              DHCP options - use the type relevant for testing
67
68

SEE ALSO

70       radiusd(8)
71

AUTHORS

73       Alan DeKok <aland@freeradius.org>
74
75
76
77                               19 September 2016                 DHCPCLIENT(1)