install-and-document-klog-krb5-20080627
[openafs.git] / doc / xml / AdminReference / sect5 / kaserverauxdb.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <refentry id="kaserverauxdb5">
3   <refmeta>
4     <refentrytitle>kaserverauxdb</refentrytitle>
5     <manvolnum>5</manvolnum>
6   </refmeta>
7   <refnamediv>
8     <refname>kaserverauxdb</refname>
9     <refpurpose>Records failed authentication attempts</refpurpose>
10   </refnamediv>
11   <refsect1>
12     <title>Description</title>
13     <para>The file <replaceable>kaserverauxdb</replaceable> records failed authentication attempts for the
14     local Authentication Server. The server creates it automatically in the
15     <replaceable>/usr/afs/local</replaceable> directory by default; use the <emphasis role="bold">-localfiles</emphasis> argument to
16     the <emphasis role="bold">kaserver</emphasis> command to specify an alternate directory.</para>
17
18     <para>The <replaceable>kaserverauxdb</replaceable> file is an internal database used by the
19     Authentication Server to prevent access by users who have exceeded the
20     limit on failed authentication attempts defined in their Authentication
21     Database entry. The Authentication Server refuses further attempts to
22     authenticate to an account listed in the database until either an AFS
23     system administrator issues the <emphasis role="bold">kas unlock</emphasis> command to unlock the
24     account, or the timeout period defined in the user's Authentication
25     Database entry passes.</para>
26
27     <para>The <replaceable>kaserverauxdb</replaceable> file is in binary format, so its contents are not
28     directly accessible. However, the output from the <emphasis role="bold">kas examine</emphasis> command
29     reports an account's maximum number of failed attempts, the lockout time,
30     and whether the account is currently locked.</para>
31
32   </refsect1>
33   <refsect1>
34     <title>See Also</title>
35     <para><link linkend="kaserver_DB05">kaserver.DB0(5)</link>,
36     <link linkend="kas_examine8">kas_examine(8)</link>,
37     <link linkend="kas_unlock8">kas_unlock(8)</link>,
38     <link linkend="kaserver8">kaserver(8)</link></para>
39
40   </refsect1>
41   <refsect1>
42     <title>Copyright</title>
43     <para>IBM Corporation 2000. &lt;http://www.ibm.com/&gt; All Rights Reserved.</para>
44
45     <para>This documentation is covered by the IBM Public License Version 1.0.  It was
46     converted from HTML to POD by software written by Chas Williams and Russ
47     Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.</para>
48
49   </refsect1>
50 </refentry>