summaryrefslogtreecommitdiffstats
path: root/docs/man/httxt2dbm.1
blob: 2a06b0c9aecda3557388b4bbdf8d2afeb2c6e1b1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "HTTXT2DBM" 1 "2019-11-13" "Apache HTTP Server" "httxt2dbm"

.SH NAME
httxt2dbm \- Generate dbm files for use with RewriteMap

.SH "SYNOPSIS"
 
.PP
\fB\fBhttxt2dbm\fR [ -\fBv\fR ] [ -\fBf\fR \fIDBM_TYPE\fR ] -\fBi\fR \fISOURCE_TXT\fR -\fBo\fR \fIOUTPUT_DBM\fR \fR
 

.SH "SUMMARY"
 
.PP
\fBhttxt2dbm\fR is used to generate dbm files from text input, for use in RewriteMap with the \fBdbm\fR map type\&.
 
.PP
If the output file already exists, it will not be truncated\&. New keys will be added and existing keys will be updated\&.
 

.SH "OPTIONS"
 
 
.TP
\fB-v\fR
More verbose output  
.TP
\fB-f \fIDBM_TYPE\fR\fR
Specify the DBM type to be used for the output\&. If not specified, will use the APR Default\&. Available types are: \fBGDBM\fR for GDBM files, \fBSDBM\fR for SDBM files, \fBDB\fR for berkeley DB files, \fBNDBM\fR for NDBM files, \fBdefault\fR for the default DBM type\&.  
.TP
\fB-i \fISOURCE_TXT\fR\fR
Input file from which the dbm is to be created\&. The file should be formatted with one record per line, of the form: \fBkey value\fR\&. See the documentation for RewriteMap for further details of this file's format and meaning\&.  
.TP
\fB-o \fIOUTPUT_DBM\fR\fR
Name of the output dbm files\&.  
 
.SH "EXAMPLES"
 
.nf

      httxt2dbm -i rewritemap\&.txt -o rewritemap\&.dbm
      httxt2dbm -f SDBM -i rewritemap\&.txt -o rewritemap\&.dbm 
.fi