%general-entities; ]> Shadow-&shadow-version; Shadow <para>The Shadow package contains programs for handling passwords in a secure way.</para> </sect2> <sect2 role="installation"> <title>Installation of Shadow If you would like to enforce the use of strong passwords, refer to for installing Cracklib prior to building Shadow. Then add --with-libcrack to the configure command below. The following patch fixes an issue in useradd, where it only accepts group names, not group id numbers: patch -Np1 -i ../&shadow-useradd_fix-patch; Create a config.cache containing information about a test that cannot be run when cross-compiling: echo "ac_cv_func_setpgrp_void=yes" > config.cache Prepare Shadow for compilation: ./configure --build=${CLFS_HOST} --host=${CLFS_TARGET} \ --libdir=/lib --sysconfdir=/etc --enable-shared \ --without-libpam --without-audit --without-selinux \ --cache-file=config.cache The meaning of the configure options: --sysconfdir=/etc Tells Shadow to install its configuration files into /etc, rather than /usr/etc. --without-libpam Support for Linux-PAM is enabled by default in Shadow, however PAM is not installed on a base CLFS system, so this switch disables PAM support in Shadow. For instructions to install PAM and link Shadow to it, you can look at . --without-audit Support for auditing is enabled by default, but a library that it needs is not installed in a base CLFS system. This switch disables auditing support. --without-selinux Support for selinux is enabled by default, but selinux is not built in a base CLFS system and configure will fail without this switch. Disable the installation of the groups program and its man pages, as Coreutils provides a better version: cp src/Makefile{,.orig} sed 's/groups$(EXEEXT) //' src/Makefile.orig > src/Makefile cp man/Makefile{,.orig} sed -e '/groups1.xml/d' \ -e 's/groups.1//' man/Makefile.orig > man/Makefile Compile the package: make Install the package: make DESTDIR=${CLFS} install Instead of using the default crypt method, use the more secure MD5 method of password encryption, which also allows passwords longer than 8 characters. It is also necessary to change the obsolete /var/spool/mail location for user mailboxes that Shadow uses by default to the /var/mail location used currently. Use the following sed command to make these changes to the appropriate configuration file: /etc/login.defs cp ${CLFS}/etc/login.defs login.defs.orig sed -e's@#MD5_CRYPT_ENAB.no@MD5_CRYPT_ENAB yes@' \ -e 's@/var/spool/mail@/var/mail@' \ login.defs.orig > ${CLFS}/etc/login.defs If you built Shadow with Cracklib support, execute this sed to correct the path to the Cracklib dictionary: cp ${CLFS}/etc/login.defs login.defs.orig sed 's@DICTPATH.*@DICTPATH\t/lib/cracklib/pw_dict@' login.defs.orig > ${CLFS}/etc/login.defs Move a misplaced program to its proper location: mv -v ${CLFS}/usr/bin/passwd ${CLFS}/bin Move Shadow's dynamic libraries to a more appropriate location: mv -v ${CLFS}/lib/libshadow.*a ${CLFS}/usr/lib rm -v ${CLFS}/lib/libshadow.so ln -svf ../../lib/libshadow.so.0 ${CLFS}/usr/lib/libshadow.so Configuring Shadow Shadow configuring This package contains utilities to add, modify, and delete users and groups; set and change their passwords; and perform other administrative tasks. For a full explanation of what password shadowing means, see the doc/HOWTO file within the unpacked source tree. If using Shadow support, keep in mind that programs which need to verify passwords (display managers, FTP programs, pop3 daemons, etc.) must be Shadow-compliant. That is, they need to be able to work with shadowed passwords. To enable shadowed passwords, run the following command: ${CLFS_TARGET}-pwconv To enable shadowed group passwords, run: ${CLFS_TARGET}-grpconv To view or change the default settings for new user accounts that you create, you can edit /etc/default/useradd. See man useradd or for more information. Setting the root password Choose a password for user root and set it by running: ${CLFS_TARGET}-passwd root Contents of Shadow Installed programs Installed libraries chage, chfn, chpasswd, chgpasswd, chsh, expiry, faillog, gpasswd, groupadd, groupdel, groupmod, grpck, grpconv, grpunconv, lastlog, login, logoutd, newgrp, newusers, nologin, passwd, pwck, pwconv, pwunconv, sg (link to newgrp), useradd, userdel, usermod, vigr (link to vipw), and vipw libshadow.[a,so] Short Descriptions chage Used to change the maximum number of days between obligatory password changes chage chfn Used to change a user's full name and other information chfn chgpasswd Used to update group passwords in batch mode chgpasswd chpasswd Used to update the passwords of an entire series of user accounts chpasswd chsh Used to change a user's default login shell chsh expiry Checks and enforces the current password expiration policy expiry faillog Is used to examine the log of login failures, to set a maximum number of failures before an account is blocked, or to reset the failure count faillog gpasswd Is used to add and delete members and administrators to groups gpasswd groupadd Creates a group with the given name groupadd groupdel Deletes the group with the given name groupdel groupmod Is used to modify the given group's name or GID groupmod grpck Verifies the integrity of the group files /etc/group and /etc/gshadow grpck grpconv Creates or updates the shadow group file from the normal group file grpconv grpunconv Updates /etc/group from /etc/gshadow and then deletes the latter grpunconv lastlog Reports the most recent login of all users or of a given user lastlog login Is used by the system to let users sign on login logoutd Is a daemon used to enforce restrictions on log-on time and ports logoutd newgrp Is used to change the current GID during a login session newgrp newusers Is used to create or update an entire series of user accounts newusers nologin Displays a message that an account is not available. Designed to be used as the default shell for accounts that have been disabled nologin passwd Is used to change the password for a user or group account passwd pwck Verifies the integrity of the password files /etc/passwd and /etc/shadow pwck pwconv Creates or updates the shadow password file from the normal password file pwconv pwunconv Updates /etc/passwd from /etc/shadow and then deletes the latter pwunconv sg Executes a given command while the user's GID is set to that of the given group sg su Runs a shell with substitute user and group IDs su useradd Creates a new user with the given name, or updates the default new-user information useradd userdel Deletes the given user account userdel usermod Is used to modify the given user's login name, User Identification (UID), shell, initial group, home directory, etc. usermod vigr Edits the /etc/group or /etc/gshadow files vigr vipw Edits the /etc/passwd or /etc/shadow files vipw libshadow Contains functions used by most programs in this package libshadow