summaryrefslogtreecommitdiff
path: root/modules/pam_unix/unix_update.8.xml
blob: 076959510e2431136b08422e28eaa126b3ddaf29 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
<?xml version="1.0" encoding='UTF-8'?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
	"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">

<refentry id="unix_update">

  <refmeta>
    <refentrytitle>unix_update</refentrytitle>
    <manvolnum>8</manvolnum>
    <refmiscinfo class="sectdesc">Linux-PAM Manual</refmiscinfo>
  </refmeta>

  <refnamediv id="unix_update-name">
    <refname>unix_update</refname>
    <refpurpose>Helper binary that updates the password of a given user</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis id="unix_update-cmdsynopsis">
      <command>unix_update</command>
      <arg choice="opt">
        ...
      </arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1 id="unix_update-description">

    <title>DESCRIPTION</title>

    <para>
      <emphasis>unix_update</emphasis> is a helper program for the
      <emphasis>pam_unix</emphasis> module that updates the
      password of a given user. It is not intended to be run directly
      from the command line and logs a security violation if done so.
    </para>

    <para>
      The purpose of the helper is to enable tighter confinement of
      login and password changing services. The helper is thus called only
      when SELinux is enabled and in the enforcing mode on the system.
    </para>

    <para>
      The interface of the helper - command line options, and input/output
      data format are internal to the <emphasis>pam_unix</emphasis>
      module and it should not be called directly from applications.
    </para>
  </refsect1>

  <refsect1 id='unix_update-see_also'>
    <title>SEE ALSO</title>
    <para>
      <citerefentry>
	<refentrytitle>pam_unix</refentrytitle><manvolnum>8</manvolnum>
      </citerefentry>
    </para>
  </refsect1>

  <refsect1 id='unix_update-author'>
    <title>AUTHOR</title>
      <para>
        Written by Tomas Mraz and other various people.
      </para>
  </refsect1>

</refentry>