libeap/radius_example/README

   1 Example application using RADIUS client as a library
   2 Copyright (c) 2007, Jouni Malinen <j@w1.fi>
   3
   4 This software may be distributed under the terms of the BSD license.
   5 See the parent directory README for more details.
   6
   7
   8 This directory contains an example showing how the RADIUS client
   9 functionality from hostapd can be used as a library in another
  10 program. The example program initializes the RADIUS client and send a
  11 Access-Request using User-Name and User-Password attributes. A reply
  12 from the RADIUS authentication server will be processed and it is used
  13 as a trigger to terminate the example program.
  14
  15 The RADIUS library links in couple of helper functions from src/utils and
  16 src/crypto directories. Most of these are suitable as-is, but it may
  17 be desirable to replace the debug output code in src/utils/wpa_debug.c
  18 by dropping this file from the library and re-implementing the
  19 functions there in a way that better fits in with the main
  20 application.
  21
  22 RADIUS client implementation takes care of receiving messages,
  23 timeouts, and retransmissions of packets. Consequently, it requires
  24 functionality for registering timeouts and received packet
  25 notifications. This is implemented using the generic event loop
  26 implementation (see src/utils/eloop.h).
  27
  28 The main application may either use the included event loop
  29 implementation or alternatively, implement eloop_* wrapper functions
  30 to use whatever event loop design is used in the main program. This
  31 would involve removing src/utils/eloop.o from the library and
  32 implementing following functions defines in src/utils/eloop.h:
  33 eloop_register_timeout(), eloop_cancel_timeout(),
  34 eloop_register_read_sock(), eloop_unregister_read_sock(), and
  35 eloop_terminated().