source: squid-ssl/trunk/fuentes/helpers/basic_auth/DB/basic_db_auth.8 @ 5496

Last change on this file since 5496 was 5496, checked in by Juanma, 22 months ago

Initial release

File size: 7.1 KB
Line 
1.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)
2.\"
3.\" Standard preamble:
4.\" ========================================================================
5.de Sp \" Vertical space (when we can't use .PP)
6.if t .sp .5v
7.if n .sp
8..
9.de Vb \" Begin verbatim text
10.ft CW
11.nf
12.ne \\$1
13..
14.de Ve \" End verbatim text
15.ft R
16.fi
17..
18.\" Set up some character translations and predefined strings.  \*(-- will
19.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
20.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
21.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
22.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
23.\" nothing in troff, for use with C<>.
24.tr \(*W-
25.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
26.ie n \{\
27.    ds -- \(*W-
28.    ds PI pi
29.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
31.    ds L" ""
32.    ds R" ""
33.    ds C` ""
34.    ds C' ""
35'br\}
36.el\{\
37.    ds -- \|\(em\|
38.    ds PI \(*p
39.    ds L" ``
40.    ds R" ''
41.    ds C`
42.    ds C'
43'br\}
44.\"
45.\" Escape single quotes in literal strings from groff's Unicode transform.
46.ie \n(.g .ds Aq \(aq
47.el       .ds Aq '
48.\"
49.\" If the F register is turned on, we'll generate index entries on stderr for
50.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
51.\" entries marked with X<> in POD.  Of course, you'll have to process the
52.\" output yourself in some meaningful fashion.
53.\"
54.\" Avoid warning from groff about undefined register 'F'.
55.de IX
56..
57.nr rF 0
58.if \n(.g .if rF .nr rF 1
59.if (\n(rF:(\n(.g==0)) \{
60.    if \nF \{
61.        de IX
62.        tm Index:\\$1\t\\n%\t"\\$2"
63..
64.        if !\nF==2 \{
65.            nr % 0
66.            nr F 2
67.        \}
68.    \}
69.\}
70.rr rF
71.\"
72.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
73.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
74.    \" fudge factors for nroff and troff
75.if n \{\
76.    ds #H 0
77.    ds #V .8m
78.    ds #F .3m
79.    ds #[ \f1
80.    ds #] \fP
81.\}
82.if t \{\
83.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
84.    ds #V .6m
85.    ds #F 0
86.    ds #[ \&
87.    ds #] \&
88.\}
89.    \" simple accents for nroff and troff
90.if n \{\
91.    ds ' \&
92.    ds ` \&
93.    ds ^ \&
94.    ds , \&
95.    ds ~ ~
96.    ds /
97.\}
98.if t \{\
99.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
100.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
101.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
102.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
103.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
104.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
105.\}
106.    \" troff and (daisy-wheel) nroff accents
107.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
108.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
109.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
110.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
111.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
112.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
113.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
114.ds ae a\h'-(\w'a'u*4/10)'e
115.ds Ae A\h'-(\w'A'u*4/10)'E
116.    \" corrections for vroff
117.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
118.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
119.    \" for low resolution devices (crt and lpr)
120.if \n(.H>23 .if \n(.V>19 \
121\{\
122.    ds : e
123.    ds 8 ss
124.    ds o a
125.    ds d- d\h'-1'\(ga
126.    ds D- D\h'-1'\(hy
127.    ds th \o'bp'
128.    ds Th \o'LP'
129.    ds ae ae
130.    ds Ae AE
131.\}
132.rm #[ #] #H #V #F C
133.\" ========================================================================
134.\"
135.IX Title "BASIC_DB_AUTH 8"
136.TH BASIC_DB_AUTH 8 "2015-11-28" "perl v5.20.2" "User Contributed Perl Documentation"
137.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
138.\" way too many mistakes in technical documents.
139.if n .ad l
140.nh
141.SH "NAME"
142.Vb 1
143\& basic_db_auth \- Database auth helper for Squid
144.Ve
145.SH "SYNOPSIS"
146.IX Header "SYNOPSIS"
147.Vb 1
148\& basic_db_auth [options]
149.Ve
150.SH "DESCRIPTOIN"
151.IX Header "DESCRIPTOIN"
152This program verifies username & password to a database
153.SH "OPTIONS"
154.IX Header "OPTIONS"
155.IP "\fB\-\-debug\fR" 12
156.IX Item "--debug"
157Write debug info to stderr.
158.IP "\fB\-\-dsn\fR" 12
159.IX Item "--dsn"
160Database \s-1DSN.\s0 Default \*(L"DBI:mysql:database=squid\*(R"
161.IP "\fB\-\-user\fR" 12
162.IX Item "--user"
163Database User
164.IP "\fB\-\-password\fR" 12
165.IX Item "--password"
166Database password
167.IP "\fB\-\-table\fR" 12
168.IX Item "--table"
169Database table. Default \*(L"passwd\*(R".
170.IP "\fB\-\-usercol\fR" 12
171.IX Item "--usercol"
172Username column. Default \*(L"user\*(R".
173.IP "\fB\-\-passwdcol\fR" 12
174.IX Item "--passwdcol"
175Password column. Default \*(L"password\*(R".
176.IP "\fB\-\-cond\fR" 12
177.IX Item "--cond"
178Condition, defaults to enabled=1. Specify 1 or "" for no condition
179If you use \-\-joomla flag, this condition will be changed to block=0
180.IP "\fB\-\-plaintext\fR" 12
181.IX Item "--plaintext"
182Database contains plain-text passwords
183.IP "\fB\-\-md5\fR" 12
184.IX Item "--md5"
185Database contains unsalted md5 passwords
186.IP "\fB\-\-salt\fR" 12
187.IX Item "--salt"
188Selects the correct salt to evaluate passwords
189.IP "\fB\-\-persist\fR" 12
190.IX Item "--persist"
191Keep a persistent database connection open between queries.
192.IP "\fB\-\-joomla\fR" 12
193.IX Item "--joomla"
194Tells helper that user database is Joomla \s-1DB. \s0 So their unusual salt
195hashing is understood.
196.SH "AUTHOR"
197.IX Header "AUTHOR"
198This program was written by
199\&\fIHenrik Nordstrom <henrik@henriknordstrom.net\fR> and
200\&\fILuis Daniel Lucio Quiroz <dlucio@okay.com.mx\fR>
201.PP
202This manual was written by \fIHenrik Nordstrom <henrik@henriknordstrom.net\fR>
203.SH "COPYRIGHT"
204.IX Header "COPYRIGHT"
205.Vb 5
206\& * Copyright (C) 1996\-2015 The Squid Software Foundation and contributors
207\& *
208\& * Squid software is distributed under GPLv2+ license and includes
209\& * contributions from numerous individuals and organizations.
210\& * Please see the COPYING and CONTRIBUTORS files for details.
211.Ve
212.PP
213Copyright (C) 2007 Henrik Nordstrom <henrik@henriknordstrom.net>
214Copyright (C) 2010 Luis Daniel Lucio Quiroz <dlucio@okay.com.mx> (Joomla support)
215This program is free software. You may redistribute copies of it under the
216terms of the \s-1GNU\s0 General Public License version 2, or (at youropinion) any
217later version.
218.SH "QUESTIONS"
219.IX Header "QUESTIONS"
220Questions on the usage of this program can be sent to the \fISquid Users mailing list <squid\-users@squid\-cache.org\fR>
221.SH "REPORTING BUGS"
222.IX Header "REPORTING BUGS"
223Bug reports need to be made in English.
224See http://wiki.squid\-cache.org/SquidFaq/BugReporting for details of what you need to include with your bug report.
225.PP
226Report bugs or bug fixes using http://bugs.squid\-cache.org/
227.PP
228Report serious security bugs to \fISquid Bugs <squid\-bugs@squid\-cache.org\fR>
229.PP
230Report ideas for new improvements to the \fISquid Developers mailing list <squid\-dev@squid\-cache.org\fR>
231.SH "SEE ALSO"
232.IX Header "SEE ALSO"
233squid (8), \s-1GPL \\fIs0\fR\|(7),
234.PP
235The Squid \s-1FAQ\s0 wiki http://wiki.squid\-cache.org/SquidFaq
236.PP
237The Squid Configuration Manual http://www.squid\-cache.org/Doc/config/
Note: See TracBrowser for help on using the repository browser.