Annotation of src/usr.bin/htpasswd/htpasswd.1, Revision 1.1
1.1 ! florian 1: .\" $OpenBSD$
! 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: .\"
! 17: .Dd $Mdocdate$
! 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
! 30: .Xr nginx 8
! 31: and other http daemons.
! 32: .Nm
! 33: prompts for a password and generates a hash using
! 34: .Xr bcrypt 3 .
! 35: A line suitable for e.g.
! 36: .Xr nginx 8
! 37: .Ic auth_basic_user_file
! 38: is written on standard output if
! 39: .Nm
! 40: is invoked with one argument.
! 41: If invoked with two arguments the
! 42: .Ar file
! 43: user authentication file is updated.
! 44: .Sh SEE ALSO
! 45: .Xr bcrypt 3 ,
! 46: .Xr nginx 8 ,
! 47: .Xr nginx.conf 5
! 48: .Sh HISTORY
! 49: This reimplemented version of
! 50: .Nm
! 51: has been available since
! 52: .Ox 5.6 .
! 53: .Sh AUTHORS
! 54: .An Florian Obser Aq Mt florian@openbsd.org
! 55: implemented
! 56: .Nm
! 57: from scratch after httpd was removed from
! 58: .Ox
! 59: base.