1sympa-upgrade-password(1)        sympa 6.2.72        sympa-upgrade-password(1)
2
3
4

NAME

6       sympa-upgrade-password - Upgrading password in database
7

SYNOPSIS

9         sympa upgrade password [--dry_run|-n] [--debug|d] [--verbose|v] [--config file ] [--cache file] [--nosavecache] [--noupdateuser] [--limit|l number_of_users]
10

OPTIONS

12       --dry_run|-n
13           Shows what will be done but won't really perform the upgrade
14           process.
15
16       --debug|-d
17           Print additional debugging information during the upgrade process.
18
19       --verbose|-v
20           Print verbose logging messages during the upgrade process.
21
22       --config FILENAME
23           Specify the pathname of the file to use as the Sympa configuration
24           file.  Otherwise the system default Sympa configuration file is
25           used.
26
27       --cache FILENAME
28           Specify the pathname of a file to store precalculated hashes for
29           reuse on subsequent runs of the script.
30
31           The file is created if it does not already exist.
32
33           This option is useful for large sites using intentionally expensive
34           password hashes such as bcrypt. In that case this script can be run
35           in advance to precalculate hashes and reduce the time required
36           during the final upgrade process.
37
38           WARNING: since it contains sensitive password data, this file
39           should be protected as carefully as any other password file, or a
40           database dump of the Sympa user_table.
41
42       --nosavecache
43           Disables updates of the cache. The cache is still consulted if
44           specified with "--cache".
45
46       --noupdateuser
47           Disables updates of the user_table. Mostly useful when
48           precalculating user hashes in advance.
49

DESCRIPTION

51       Versions later than 5.4 use one-way hashes instead of symmetric
52       encryption to store passwords. This script upgrades any symmetric
53       encrypted passwords it finds to one-way hashes.
54
55       Versions later than 6.2.26 support bcrypt.
56
57       This upgrade requires to rewriting user password entries in the
58       database.  This upgrade IS NOT REVERSIBLE.
59

HISTORY

61   Password storage
62       As of Sympa 3.1b.7, passwords may be stored into user table with
63       encrypted form by reversible RC4.
64
65       Sympa 5.4 or later uses MD5 one-way hash function to encode user
66       passwords.
67
68       Sympa 6.2.26 or later has optional support for bcrypt.
69
70   Utilities for upgrading passwords
71       "sympa.pl --md5_encode_password" appeared on Sympa 6.0.
72
73       It was obsoleted by upgrade_sympa_password.pl on Sympa 6.2.
74
75       Its function was moved to "sympa upgrade password" command line on
76       Sympa 6.2.71b.
77
78
79
806.2.72                            2023-07-22         sympa-upgrade-password(1)
Impressum