emo/shadow
1
0
Fork 0
Code Issues Pull Requests Packages Releases Activity
3010ec11ae
shadow/man
History
Alejandro Colomar 0c4fa6ee0a libmisc, man: Drop old check and advice for complex character sets in passwords 
Add the relevant XKCD to the passwd(1) manual page.  It already explains
most of the rationale behind this patch.

Add also reference to makepasswd(1), which is a good way to generate
strong passwords.  Personally, I commonly run `makepasswd --chars 64` to
create my passwords, or 32 for passwords I need to type interactively
often.

The strength of a password is an exponential formula, where the base is
the size of the character set, and the exponent is the length of the
password.  That already shows why long passwords of just lowercase
letters are better than short Pa$sw0rdZ3.  But an even more important
point is that humans, when forced to use symbols in a password, are more
likely to do trivial substitutions on simple passwords, which doesn't
increase strength, and can instead give a false sense of strength, which
is dangerous.

Closes: <https://github.com/shadow-maint/shadow/issues/688>
Link: <https://xkcd.com/936/>
Cc: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
2023-04-27 09:16:08 +02:00
..
cs manpages: fix 'File Formats and Conversions" 2021-10-15 16:28:12 -05:00
da * NEWS, man/generate_mans.mak: Generate manpages in man1, man3, 2012-05-20 10:18:33 +00:00
de * NEWS, man/generate_mans.mak: Generate manpages in man1, man3, 2012-05-20 10:18:33 +00:00
es Update licensing info 2021-12-23 19:36:50 -06:00
fi * man/*.xml: Add author based on copyright statement. 2012-05-25 11:45:21 +00:00
fr Allow disabling of subordinate IDs. 2013-08-11 15:46:59 +02:00
hu Update licensing info 2021-12-23 19:36:50 -06:00
id * man/*.xml: Add author based on copyright statement. 2012-05-25 11:45:21 +00:00
it * NEWS, man/generate_mans.mak: Generate manpages in man1, man3, 2012-05-20 10:18:33 +00:00
ja Update licensing info 2021-12-23 19:36:50 -06:00
ko Update licensing info 2021-12-23 19:36:50 -06:00
login.defs.d Improve TTYGROUP description in login.defs manpage 2023-02-02 22:03:45 -06:00
pl * NEWS, man/generate_mans.mak: Generate manpages in man1, man3, 2012-05-20 10:18:33 +00:00
po fix typos 2023-04-26 17:35:58 -05:00
pt_BR Update licensing info 2021-12-23 19:36:50 -06:00
ru * NEWS, man/generate_mans.mak: Generate manpages in man1, man3, 2012-05-20 10:18:33 +00:00
sv * NEWS, man/generate_mans.mak: Generate manpages in man1, man3, 2012-05-20 10:18:33 +00:00
tr Update licensing info 2021-12-23 19:36:50 -06:00
uk uk has no limits.5 translation 2022-08-12 13:24:24 -05:00
zh_CN * NEWS, man/generate_mans.mak: Generate manpages in man1, man3, 2012-05-20 10:18:33 +00:00
zh_TW Update licensing info 2021-12-23 19:36:50 -06:00
.gitignore 2012-02-13 Mike Frysinger <vapier@gentoo.org> 2012-02-13 20:04:40 +00:00
chage.1.xml libmisc/root_flag: add tips for --root flag only support abspath 2022-08-06 15:04:06 -05:00
chfn.1.xml libmisc/root_flag: add tips for --root flag only support abspath 2022-08-06 15:04:06 -05:00
chgpasswd.8.xml libmisc/root_flag: add tips for --root flag only support abspath 2022-08-06 15:04:06 -05:00
chpasswd.8.xml libmisc/root_flag: add tips for --root flag only support abspath 2022-08-06 15:04:06 -05:00
chsh.1.xml Supporting vendor given -shells- configuration file 2023-01-26 22:45:32 -06:00
config.xml.in * man/*.xml, man/config.xml.in: Add source and version 2011-07-08 19:49:09 +00:00
expiry.1.xml Update licensing info 2021-12-23 19:36:50 -06:00
faillog.5.xml Update licensing info 2021-12-23 19:36:50 -06:00
faillog.8.xml libmisc/root_flag: add tips for --root flag only support abspath 2022-08-06 15:04:06 -05:00
generate_mans.mak Fix VPATH build 2023-02-13 10:01:17 +01:00
generate_translations.mak Fix VPATH build 2023-02-13 10:01:17 +01:00
getsubids.1.xml Merge pull request #451 from hallyn/2021-12-05/license 2022-01-02 18:38:42 -06:00
gpasswd.1.xml libmisc/root_flag: add tips for --root flag only support abspath 2022-08-06 15:04:06 -05:00
groupadd.8.xml shadow: use relaxed usernames 2022-09-02 20:27:14 -05:00
groupdel.8.xml libmisc/root_flag: add tips for --root flag only support abspath 2022-08-06 15:04:06 -05:00
groupmems.8.xml changing lock mechanism 2022-12-29 13:58:49 -06:00
groupmod.8.xml libmisc/root_flag: add tips for --root flag only support abspath 2022-08-06 15:04:06 -05:00
groups.1.xml Improve groups and id manpages 2022-03-06 18:00:20 -06:00
grpck.8.xml libmisc/root_flag: add tips for --root flag only support abspath 2022-08-06 15:04:06 -05:00
gshadow.5.xml Update licensing info 2021-12-23 19:36:50 -06:00
id.1.xml Improve groups and id manpages 2022-03-06 18:00:20 -06:00
lastlog.8.xml libmisc/root_flag: add tips for --root flag only support abspath 2022-08-06 15:04:06 -05:00
limits.5.xml Update licensing info 2021-12-23 19:36:50 -06:00
login.1.xml Update licensing info 2021-12-23 19:36:50 -06:00
login.access.5.xml Update licensing info 2021-12-23 19:36:50 -06:00
login.defs.5.xml Update licensing info 2021-12-23 19:36:50 -06:00
logoutd.8.xml Update licensing info 2021-12-23 19:36:50 -06:00
Makefile.am Fix VPATH build 2023-02-13 10:01:17 +01:00
newgidmap.1.xml newuidmap and newgidmap: support passing pid as fd 2023-02-24 12:35:49 -06:00
newgrp.1.xml Update licensing info 2021-12-23 19:36:50 -06:00
newuidmap.1.xml newuidmap and newgidmap: support passing pid as fd 2023-02-24 12:35:49 -06:00
newusers.8.xml libmisc/root_flag: add tips for --root flag only support abspath 2022-08-06 15:04:06 -05:00
nologin.8.xml Update licensing info 2021-12-23 19:36:50 -06:00
passwd.1.xml libmisc, man: Drop old check and advice for complex character sets in passwords 2023-04-27 09:16:08 +02:00
passwd.5.xml Update licensing info 2021-12-23 19:36:50 -06:00
porttime.5.xml Update licensing info 2021-12-23 19:36:50 -06:00
pwck.8.xml libmisc/root_flag: add tips for --root flag only support abspath 2022-08-06 15:04:06 -05:00
pwconv.8.xml libmisc/root_flag: add tips for --root flag only support abspath 2022-08-06 15:04:06 -05:00
README.md man: generate translations using itstool instead of xml2po 2019-11-03 13:04:17 +01:00
sg.1.xml Update licensing info 2021-12-23 19:36:50 -06:00
shadow-man.xsl Supporting vendor given -shells- configuration file 2023-01-26 22:45:32 -06:00
shadow.3.xml Update licensing info 2021-12-23 19:36:50 -06:00
shadow.5.xml Update licensing info 2021-12-23 19:36:50 -06:00
su.1.xml Update licensing info 2021-12-23 19:36:50 -06:00
suauth.5.xml Update licensing info 2021-12-23 19:36:50 -06:00
subgid.5.xml Update licensing info 2021-12-23 19:36:50 -06:00
subuid.5.xml Update licensing info 2021-12-23 19:36:50 -06:00
sulogin.8.xml Update licensing info 2021-12-23 19:36:50 -06:00
useradd.8.xml useradd/usermod: add --selinux-range argument 2023-04-19 09:19:19 +02:00
userdel.8.xml libmisc/root_flag: add tips for --root flag only support abspath 2022-08-06 15:04:06 -05:00
usermod.8.xml useradd/usermod: add --selinux-range argument 2023-04-19 09:19:19 +02:00
vipw.8.xml trivial: vipw.8: fix grammar 2023-04-03 13:06:14 +02:00

README.md

The official releases ship with pre-built manpages.

The content of the man pages however is dependent on compile flags. So the pre-built ones might not fit your version of shadow. To build them yourself use --enable-man. Furthermore the following build requirements will be needed:

  • xsltproc
  • docbook 4
  • docbook stylesheets
  • itstool