98 lines
		
	
	
		
			3.6 KiB
		
	
	
	
		
			XML
		
	
	
	
	
	
			
		
		
	
	
			98 lines
		
	
	
		
			3.6 KiB
		
	
	
	
		
			XML
		
	
	
	
	
	
<?xml version="1.0" encoding="UTF-8"?>
 | 
						|
<!--
 | 
						|
   Copyright (c) 1989 - 1994, Julianne Frances Haugh
 | 
						|
   Copyright (c) 2007 - 2008, Nicolas François
 | 
						|
   All rights reserved.
 | 
						|
  
 | 
						|
   Redistribution and use in source and binary forms, with or without
 | 
						|
   modification, are permitted provided that the following conditions
 | 
						|
   are met:
 | 
						|
   1. Redistributions of source code must retain the above copyright
 | 
						|
      notice, this list of conditions and the following disclaimer.
 | 
						|
   2. Redistributions in binary form must reproduce the above copyright
 | 
						|
      notice, this list of conditions and the following disclaimer in the
 | 
						|
      documentation and/or other materials provided with the distribution.
 | 
						|
   3. The name of the copyright holders or contributors may not be used to
 | 
						|
      endorse or promote products derived from this software without
 | 
						|
      specific prior written permission.
 | 
						|
  
 | 
						|
   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 | 
						|
   ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 | 
						|
   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
 | 
						|
   PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT
 | 
						|
   HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 | 
						|
   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 | 
						|
   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 | 
						|
   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 | 
						|
   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 | 
						|
   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 | 
						|
   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 | 
						|
-->
 | 
						|
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.5//EN"
 | 
						|
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
 | 
						|
<!-- SHADOW-CONFIG-HERE -->
 | 
						|
]>
 | 
						|
<refentry id='faillog.5'>
 | 
						|
  <!-- $Id$ -->
 | 
						|
  <refmeta>
 | 
						|
    <refentrytitle>faillog</refentrytitle>
 | 
						|
    <manvolnum>5</manvolnum>
 | 
						|
    <refmiscinfo class="sectdesc"> File Formats and Conversions</refmiscinfo>
 | 
						|
    <refmiscinfo class="source">shadow-utils</refmiscinfo>
 | 
						|
    <refmiscinfo class="version">&SHADOW_UTILS_VERSION;</refmiscinfo>
 | 
						|
  </refmeta>
 | 
						|
  <refnamediv id='name'>
 | 
						|
    <refname>faillog</refname>
 | 
						|
    <refpurpose>login failure logging file</refpurpose>
 | 
						|
  </refnamediv>
 | 
						|
 | 
						|
  <refsect1 id='description'>
 | 
						|
    <title>DESCRIPTION</title>
 | 
						|
    <para>
 | 
						|
      <filename>/var/log/faillog</filename> maintains a count of login
 | 
						|
      failures and the limits for each account.
 | 
						|
    </para>
 | 
						|
    <para>
 | 
						|
      The file contains fixed length
 | 
						|
      records, indexed by numerical UID. Each record contains the count of
 | 
						|
      login failures since the last successful login; the maximum number of
 | 
						|
      failures before the account is disabled; the line on which the last login
 | 
						|
      failure occurred; the date of the last login failure;
 | 
						|
      and the duration (in seconds) during which the account will be locked after
 | 
						|
      a failure.
 | 
						|
    </para>
 | 
						|
 | 
						|
    <para>The structure of the file is:</para>
 | 
						|
      <programlisting>
 | 
						|
struct	faillog {
 | 
						|
	short   fail_cnt;
 | 
						|
	short   fail_max;
 | 
						|
	char    fail_line[12];
 | 
						|
	time_t  fail_time;
 | 
						|
	long    fail_locktime;
 | 
						|
};</programlisting>
 | 
						|
  </refsect1>
 | 
						|
 | 
						|
  <refsect1 id='files'>
 | 
						|
    <title>FILES</title>
 | 
						|
    <variablelist>
 | 
						|
      <varlistentry>
 | 
						|
	<term><filename>/var/log/faillog</filename></term>
 | 
						|
	<listitem>
 | 
						|
	  <para>Failure logging file.</para>
 | 
						|
	</listitem>
 | 
						|
      </varlistentry>
 | 
						|
    </variablelist>
 | 
						|
  </refsect1>
 | 
						|
 | 
						|
  <refsect1 id='see_also'>
 | 
						|
    <title>SEE ALSO</title>
 | 
						|
    <para>
 | 
						|
      <citerefentry>
 | 
						|
	<refentrytitle>faillog</refentrytitle><manvolnum>8</manvolnum>
 | 
						|
      </citerefentry>
 | 
						|
    </para>
 | 
						|
  </refsect1>
 | 
						|
</refentry>
 | 
						|
 |