README 1.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263
  1. Hello!
  2. Thanks for downloading Linux-PAM.
  3. NOTES:
  4. How to use it is as follows:
  5. Please look at the ci/install_dependencies.sh for the necessary
  6. prerequisite packages to be able to build the Linux-PAM. The script
  7. is targeted at Debian based Linux distributions so the package
  8. names and availability might differ on other distributions.
  9. If you check out the sources from git, install Autotools and generate
  10. configuration scripts, ensuring you have the minimum packages installed,
  11. the ci scripts may help here:
  12. ./autogen.sh
  13. Then compile:
  14. ./configure --help | less
  15. ./configure <your-options>
  16. make
  17. To make sure everything was compiled correct, run:
  18. make check
  19. If a test fails, you should not continue to install this build.
  20. These tests require a suitable file /etc/pam.d/other; if necessary,
  21. create such a file containing, e.g., these five lines (not indented)
  22. #%PAM-1.0
  23. auth required pam_deny.so
  24. account required pam_deny.so
  25. password required pam_deny.so
  26. session required pam_deny.so
  27. Note, if you are worried - don't even think about doing the next line
  28. (most Linux distributions already support PAM out of the box, so if
  29. something goes wrong with installing the code from this version your
  30. box may stop working..)
  31. make install
  32. That said, please report problems to the bug reporting database
  33. at https://github.com/linux-pam/linux-pam/issues .
  34. You can run additional checks after installing by executing
  35. make xtests
  36. as root.
  37. WARNING: Running "make xtests" can overwrite configuration data
  38. or make the system insecure/unfunctional for a short time!
  39. Backup all important data before!
  40. To regenerate manual pages from the XML source files you need the
  41. docbook-xsl stylesheets in version 1.69.1 or newer, older versions had
  42. a bug which generates a broken layout.