Annotation of src/usr.bin/htpasswd/htpasswd.1, Revision 1.3
1.3 ! jmc 1: .\" $OpenBSD: htpasswd.1,v 1.2 2014/03/17 13:42:02 jmc 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.2 jmc 17: .Dd $Mdocdate: March 17 2014 $
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
27: .Sh DESCRIPTION
28: .Nm
29: is used to create and update user authentication files for
1.3 ! jmc 30: HTTP daemons such as
! 31: .Xr nginx 8 .
! 32: .Pp
1.1 florian 33: .Nm
34: prompts for a password and generates a hash using
35: .Xr bcrypt 3 .
1.3 ! jmc 36: A line suitable for a password file,
! 37: such as
1.1 florian 38: .Ic auth_basic_user_file
1.3 ! jmc 39: in
! 40: .Xr nginx 8 ,
! 41: is written to standard output.
! 42: If invoked with two arguments
! 43: user authentication
1.1 florian 44: .Ar file
1.3 ! jmc 45: is updated.
1.1 florian 46: .Sh SEE ALSO
47: .Xr bcrypt 3 ,
1.2 jmc 48: .Xr nginx.conf 5 ,
49: .Xr nginx 8
1.1 florian 50: .Sh HISTORY
51: This reimplemented version of
52: .Nm
53: has been available since
54: .Ox 5.6 .
55: .Sh AUTHORS
56: .An Florian Obser Aq Mt florian@openbsd.org
57: implemented
58: .Nm
59: from scratch after httpd was removed from
60: .Ox
61: base.