1RLM_DBM_PARSER(8)           System Manager's Manual          RLM_DBM_PARSER(8)
2
3
4

NAME

6       rlm_dbm_parser - transforms simple syntax into rlm_dbm format
7

SYNOPSIS

9       rlm_dbm_parser [-c] [-d raddb] [-i inputfile] [-o outputfile] [-x] [-v]
10       [-q] [username ...]
11
12

DESCRIPTION

14       rlm_dbm_parser reads a file of the syntax defined below, and  writes  a
15       database file usable by rlm_dbm or edits current database.
16

INPUT FORMAT

18       rlm_dbm_parser reads a format similar to the one used by the files mod‐
19       ule. In incomplete RFC2234 ABNF, it looks like this:
20
21       entries     = *entry
22       entry       = identifier TAB definition
23       identifier  = username / group-name
24       username    = +PCHAR
25       groupname   = +PCHAR
26       definition  = (check-item ",")* LF ( *( reply-item ",") / ";" ) LF
27       check-item  = AS IN FILES
28       reply-item  = AS IN FILES
29       * need definition of username and groupname
30
31       As an example, these are the standard files definitions (files module).
32
33       DEFAULT   Service-Type == Framed-User
34                 Framed-IP-Address = 255.255.255.254,
35                 Framed-MTU = 576,
36                 Service-Type = Framed-User,
37                 Fall-Through = Yes
38
39       #except who call from number 555-666
40       DEFAULT   Auth-Type := Reject,Service-Type ==Framed-User,
41                 Calling-Station-ID == "555-666"
42
43       #or call number 555-667
44       DEFAULT   Auth-Type := Reject,Service-Type ==Framed-User,
45                 Calling-Station-ID == "555-667"
46
47       To be a valid rlm_dbm input file, it should look like this:
48
49       DEFAULT   Service-Type == Framed-User                     # (1)
50                 Framed-IP-Address = 255.255.255.254,            # comma, list cont'd
51                 Framed-MTU = 576,
52                 Service-Type = Framed-User,
53                 Fall-Through =  Yes                             # \n, end of list
54                 Auth-Type := Reject,Service-Type ==Framed-User, # (2)
55                 Calling-Station-ID == "555-666"
56                 ;                                               # ;, no reply items
57                 Auth-Type := Reject,Service-Type ==Framed-User, # (3)
58                 Calling-Station-ID == "555-667"
59                 ;                                               # ditto
60
61       This user (the DEFAULT user) contains three entries, 1, 2  and  3.  The
62       first entry has a list of reply items, terminated by a reply item with‐
63       out a trailing comma. Entries 2 and 3 has empty reply lists,  as  indi‐
64       cated  by  the  semicolon.  This is necessary to separate an empty line
65       (which is ignored) from the empty list.  Definition Fall-Through =  Yes
66       used  in  order  to  say  module to check next record. By default Fall-
67       Through = Yes.
68
69

OPTIONS

71       -d raddb
72              Use raddb as the radiusd configuration directory.
73
74       -i inputfile
75              Use file as the input file. If not  defined  then  use  standard
76              input.
77
78       -o outputfile
79              Use file as the output file.
80
81       -c     Create a new database (empty output file before writing)
82
83       -x     Enable debug mode. Multiple x flags increase debug level.
84
85       -q     Do not print statistics (quiet).
86
87       -v     Print the version and exit.
88
89       -r     Remove a username or group name from the database.
90
91

SEE ALSO

93       radiusd(8)
94

AUTHORS

96       Author:
97              Andrei Koulik <rlm_dbm@agk.nnov.ru>
98
99       Documentation:
100              Bjørn Nordbø  <bn@nextra.com>
101
102
103
104                                                             RLM_DBM_PARSER(8)
Impressum