Annotation of src/usr.bin/htpasswd/htpasswd.1, Revision 1.9
1.9 ! naddy 1: .\" $OpenBSD: htpasswd.1,v 1.8 2017/07/07 16:30:06 schwarze Exp $
1.1 florian 2: .\"
3: .\" Copyright (c) 2014 Florian Obser <florian@openbsd.org>
4: .\"
5: .\" Permission to use, copy, modify, and distribute this software for any
6: .\" purpose with or without fee is hereby granted, provided that the above
7: .\" copyright notice and this permission notice appear in all copies.
8: .\"
9: .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10: .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11: .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12: .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13: .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14: .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15: .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16: .\"
1.9 ! naddy 17: .Dd $Mdocdate: July 7 2017 $
1.1 florian 18: .Dt HTPASSWD 1
19: .Os
20: .Sh NAME
21: .Nm htpasswd
22: .Nd create and update user authentication files
23: .Sh SYNOPSIS
24: .Nm
25: .Op Ar file
26: .Ar login
1.4 florian 27: .Nm
1.5 florian 28: .Fl I
1.4 florian 29: .Op Ar file
1.1 florian 30: .Sh DESCRIPTION
31: .Nm
32: is used to create and update user authentication files for
1.6 robert 33: HTTP daemons.
1.3 jmc 34: .Pp
1.4 florian 35: The options are as follows:
36: .Bl -tag -width Ds
1.5 florian 37: .It Fl I
1.4 florian 38: Switch to batch mode.
39: .Nm
40: reads exactly one line from standard input and splits it at the first
41: .Qo : Qc .
42: The first part is the login, the second part is the password which
43: .Nm
44: then hashes using
45: .Xr bcrypt 3 .
46: .El
47: .Pp
1.1 florian 48: .Nm
49: prompts for a password and generates a hash using
50: .Xr bcrypt 3 .
1.6 robert 51: A line suitable for a password file is written to the standard output.
1.3 jmc 52: If invoked with two arguments
1.4 florian 53: .Po
54: or one argument if the
1.5 florian 55: .Fl I
1.4 florian 56: flag is used
1.9 ! naddy 57: .Pc ,
1.3 jmc 58: user authentication
1.1 florian 59: .Ar file
1.3 jmc 60: is updated.
1.1 florian 61: .Sh SEE ALSO
1.7 jmc 62: .Xr bcrypt 3
1.1 florian 63: .Sh HISTORY
64: This reimplemented version of
65: .Nm
66: has been available since
67: .Ox 5.6 .
68: .Sh AUTHORS
69: .An Florian Obser Aq Mt florian@openbsd.org
70: implemented
71: .Nm
1.8 schwarze 72: from scratch after Apache httpd was removed from
1.1 florian 73: .Ox
74: base.