debian man page for rlm_dbm_parse

RLM_DBM_PARSE(8)					      System Manager's Manual						  RLM_DBM_PARSE(8)

NAME
       rlm_dbm_parse - transforms simple syntax into rlm_dbm format

SYNOPSIS
       rlm_dbm_parse [-c] [-d raddb] [-i inputfile] [-o outputfile] [-x] [-v] [-q] [username ...]

DESCRIPTION
       rlm_dbm_parse reads a file of the syntax defined below, and writes a database file usable by rlm_dbm or edits current database.

INPUT FORMAT
       rlm_dbm_parse reads a format similar to the one used by the files module. In incomplete RFC2234 ABNF, it looks like this:

       entries	   = *entry
       entry	   = identifier TAB definition
       identifier  = username / group-name
       username    = +PCHAR
       groupname   = +PCHAR
       definition  = (check-item ",")* LF ( *( reply-item ",") / ";" ) LF
       check-item  = AS IN FILES
       reply-item  = AS IN FILES
       * need definition of username and groupname

       As an example, these are the standard files definitions (files module).

       DEFAULT	 Service-Type == Framed-User
		 Framed-IP-Address = 255.255.255.254,
		 Framed-MTU = 576,
		 Service-Type = Framed-User,
		 Fall-Through = Yes

       #except who call from number 555-666
       DEFAULT	 Auth-Type := Reject,Service-Type ==Framed-User,
		 Calling-Station-ID == "555-666"

       #or call number 555-667
       DEFAULT	 Auth-Type := Reject,Service-Type ==Framed-User,
		 Calling-Station-ID == "555-667"

       To be a valid rlm_dbm input file, it should look like this:

       DEFAULT	 Service-Type == Framed-User			 # (1)
		 Framed-IP-Address = 255.255.255.254,		 # comma, list cont'd
		 Framed-MTU = 576,
		 Service-Type = Framed-User,
		 Fall-Through =  Yes				 # 
, end of list
		 Auth-Type := Reject,Service-Type ==Framed-User, # (2)
		 Calling-Station-ID == "555-666"
		 ;						 # ;, no reply items
		 Auth-Type := Reject,Service-Type ==Framed-User, # (3)
		 Calling-Station-ID == "555-667"
		 ;						 # ditto

       This  user  (the  DEFAULT  user)  contains three entries, 1, 2 and 3. The first entry has a list of reply items, terminated by a reply item
       without a trailing comma. Entries 2 and 3 has empty reply lists, as indicated by the semicolon. This is necessary to separate an empty line
       (which  is  ignored) from the empty list.  Definition Fall-Through = Yes used in order to say module to check next record. By default Fall-
       Through = Yes.

OPTIONS
       -d raddb
	      Use raddb as the radiusd configuration directory.

       -i inputfile
	      Use file as the input file. If not defined then use standard input.

       -o outputfile
	      Use file as the output file.

       -c     Create a new database (empty output file before writing)

       -x     Enable debug mode. Multiple x flags increase debug level.

       -q     Do not print statistics (quiet).

       -v     Print the version and exit.

       -r     Remove a username or group name from the database.

SEE ALSO
       radiusd(8)

AUTHORS
       Author:
	      Andrei Koulik <rlm_dbm@agk.nnov.ru>

       Documentation:
	      Bjorn Nordbo  <bn@nextra.com>

																  RLM_DBM_PARSE(8)