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.

