granicus.if.org Git - linux-pam/blob - modules/pam_unix/unix_chkpwd.8.xml

   1 <?xml version="1.0" encoding='UTF-8'?>
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
   3         "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
   4
   5 <refentry id="unix_chkpwd">
   6
   7   <refmeta>
   8     <refentrytitle>unix_chkpwd</refentrytitle>
   9     <manvolnum>8</manvolnum>
  10     <refmiscinfo class="sectdesc">Linux-PAM Manual</refmiscinfo>
  11   </refmeta>
  12
  13   <refnamediv id="unix_chkpwd-name">
  14     <refname>unix_chkpwd</refname>
  15     <refpurpose>Helper binary that verifies the password of the current user</refpurpose>
  16   </refnamediv>
  17
  18   <refsynopsisdiv>
  19     <cmdsynopsis id="unix_chkpwd-cmdsynopsis">
  20       <command>unix_chkpwd</command>
  21       <arg choice="opt">
  22         ...
  23       </arg>
  24     </cmdsynopsis>
  25   </refsynopsisdiv>
  26
  27   <refsect1 id="unix_chkpwd-description">
  28
  29     <title>DESCRIPTION</title>
  30
  31     <para>
  32       <emphasis>unix_chkpwd</emphasis> is a helper program for the
  33       <emphasis>pam_unix</emphasis> module that verifies the
  34       password of the current user. It also checks password and account
  35       expiration dates in <emphasis>shadow</emphasis>. It is not intended to
  36       be run directly from the command line and logs a security violation if
  37       done so.
  38     </para>
  39
  40     <para>
  41       It is typically installed setuid root or setgid shadow.
  42     </para>
  43
  44     <para>
  45       The interface of the helper - command line options, and input/output
  46       data format are internal to the <emphasis>pam_unix</emphasis>
  47       module and it should not be called directly from applications.
  48     </para>
  49   </refsect1>
  50
  51   <refsect1 id='unix_chkpwd-see_also'>
  52     <title>SEE ALSO</title>
  53     <para>
  54       <citerefentry>
  55         <refentrytitle>pam_unix</refentrytitle><manvolnum>8</manvolnum>
  56       </citerefentry>
  57     </para>
  58   </refsect1>
  59
  60   <refsect1 id='unix_chkpwd-author'>
  61     <title>AUTHOR</title>
  62       <para>
  63         Written by Andrew Morgan and other various people.
  64       </para>
  65   </refsect1>
  66
  67 </refentry>