1UPGRADE_SYMPA_PASSWORD(1)        sympa 6.2.70        UPGRADE_SYMPA_PASSWORD(1)
2
3
4

NAME

6       upgrade_sympa_password, upgrade_sympa_password.pl - Upgrading password
7       in database
8

SYNOPSIS

10         upgrade_sympa_password.pl [--dry_run|-n] [--debug|d] [--verbose|v] [--config file ] [--cache file] [--nosavecache] [--noupdateuser] [--limit|l number_of_users]
11

OPTIONS

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

DESCRIPTION

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

HISTORY

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
71
726.2.70                            2022-12-11         UPGRADE_SYMPA_PASSWORD(1)