builddbm

NAME
     builddbm ‐ build a DBM database from the Radius users file

SYNOPSIS
     builddbm [‐dehuv]

DESCRIPTION
    The builddbm utility builds a DBM database from a Radius
flat‐file
    users file.  It prints any diagnostics about the users file
format to
    stdout. It is not strictly necessary to correct any warnings,
since
    builddbm attempts to be intelligent about what the users file
is
    trying to say; nevertheless, it *is* advisable to correct the
file
    format, if only for your peace of mind. Builddbm checks for
and will
    warn about duplicate names in the users file; it discards all
but
    the first record with a given name.

    Premature end‐of‐file will not generally fool builddbm; if
all that is
    missing is a blank line (this provides an indication of end‐
of‐record,
    when the previous record line had a trailing comma) then end‐
of‐record
    will be assumed.

    The options are:

    ‐d dir      Specify the directory for the users info,
’/etc/raddb’ by
                default. The users file will be searched for in
this                 directory and the .pag and .dir files will
be put here as                 well.
    ‐e          Use stdout instead of stderr. Useful mainly when
logging                 the combined record info and warnings; it
allows you to                 do this by redirecting stdout only,
rather than requiring                 that you redirect both
stdout and stderr.
    ‐h          Display help.
    ‐u file     Specify the name of the users file, ’users’ by
default.
                This name will be used as the basename for the
.dir and                 .pag files.
    ‐v          Print to stdout the records which are being put
into the                 database.  Provides confirmation that
the database                 contains what you think it should
contain, and may ease                 troubleshooting any
warnings about the users file format.

USAGE
     $ builddbm

BUGS
    Builddbm can get fooled by pathologically incorrect file
formats.

SEE ALSO
    radiusd(8), users‐file‐syntax(1)

HISTORY
    Originally developed by Livingston Enterprises, Inc.  This
version
    includes many changes designed to consistently detect and
accomodate
    flat‐file format errors, and to ensure that the DBM file
produced
    from the flat file will perform identically when referenced
    by the DBM Radius daemon as the flat file would if referenced
directly
    by the flat‐file Radius daemon.