openssl-passwd.pod.in 2.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122
  1. =pod
  2. {- OpenSSL::safe::output_do_not_edit_headers(); -}
  3. =head1 NAME
  4. openssl-passwd - compute password hashes
  5. =head1 SYNOPSIS
  6. B<openssl passwd>
  7. [B<-help>]
  8. [B<-1>]
  9. [B<-apr1>]
  10. [B<-aixmd5>]
  11. [B<-5>]
  12. [B<-6>]
  13. [B<-salt> I<string>]
  14. [B<-in> I<file>]
  15. [B<-stdin>]
  16. [B<-noverify>]
  17. [B<-quiet>]
  18. [B<-table>]
  19. [B<-reverse>]
  20. {- $OpenSSL::safe::opt_r_synopsis -}
  21. {- $OpenSSL::safe::opt_provider_synopsis -}
  22. [I<password>]
  23. =head1 DESCRIPTION
  24. This command computes the hash of a password typed at
  25. run-time or the hash of each password in a list. The password list is
  26. taken from the named file for option B<-in>, from stdin for
  27. option B<-stdin>, or from the command line, or from the terminal otherwise.
  28. =head1 OPTIONS
  29. =over 4
  30. =item B<-help>
  31. Print out a usage message.
  32. =item B<-1>
  33. Use the MD5 based BSD password algorithm B<1> (default).
  34. =item B<-apr1>
  35. Use the B<apr1> algorithm (Apache variant of the BSD algorithm).
  36. =item B<-aixmd5>
  37. Use the B<AIX MD5> algorithm (AIX variant of the BSD algorithm).
  38. =item B<-5>
  39. =item B<-6>
  40. Use the B<SHA256> / B<SHA512> based algorithms defined by Ulrich Drepper.
  41. See L<https://www.akkadia.org/drepper/SHA-crypt.txt>.
  42. =item B<-salt> I<string>
  43. Use the specified salt.
  44. When reading a password from the terminal, this implies B<-noverify>.
  45. =item B<-in> I<file>
  46. Read passwords from I<file>.
  47. =item B<-stdin>
  48. Read passwords from B<stdin>.
  49. =item B<-noverify>
  50. Don't verify when reading a password from the terminal.
  51. =item B<-quiet>
  52. Don't output warnings when passwords given at the command line are truncated.
  53. =item B<-table>
  54. In the output list, prepend the cleartext password and a TAB character
  55. to each password hash.
  56. =item B<-reverse>
  57. When the B<-table> option is used, reverse the order of cleartext and hash.
  58. {- $OpenSSL::safe::opt_r_item -}
  59. {- $OpenSSL::safe::opt_provider_item -}
  60. =back
  61. =head1 EXAMPLES
  62. % openssl passwd -1 -salt xxxxxxxx password
  63. $1$xxxxxxxx$UYCIxa628.9qXjpQCjM4a.
  64. % openssl passwd -apr1 -salt xxxxxxxx password
  65. $apr1$xxxxxxxx$dxHfLAsjHkDRmG83UXe8K0
  66. % openssl passwd -aixmd5 -salt xxxxxxxx password
  67. xxxxxxxx$8Oaipk/GPKhC64w/YVeFD/
  68. =head1 HISTORY
  69. The B<-crypt> option was removed in OpenSSL 3.0.
  70. =head1 COPYRIGHT
  71. Copyright 2000-2021 The OpenSSL Project Authors. All Rights Reserved.
  72. Licensed under the Apache License 2.0 (the "License"). You may not use
  73. this file except in compliance with the License. You can obtain a copy
  74. in the file LICENSE in the source distribution or at
  75. L<https://www.openssl.org/source/license.html>.
  76. =cut