lib/libpam/modules/pam_lastlog/pam_lastlog.8

   1 .\" $NetBSD: pam_lastlog.8,v 1.6 2005/02/26 15:58:35 thorpej Exp $
   2 .\" Copyright (c) 2001 Mark R V Murray
   3 .\" All rights reserved.
   4 .\" Copyright (c) 2001 Networks Associates Technology, Inc.
   5 .\" All rights reserved.
   6 .\"
   7 .\" Portions of this software were developed for the FreeBSD Project by
   8 .\" ThinkSec AS and NAI Labs, the Security Research Division of Network
   9 .\" Associates, Inc.  under DARPA/SPAWAR contract N66001-01-C-8035
  10 .\" ("CBOSS"), as part of the DARPA CHATS research program.
  11 .\"
  12 .\" Redistribution and use in source and binary forms, with or without
  13 .\" modification, are permitted provided that the following conditions
  14 .\" are met:
  15 .\" 1. Redistributions of source code must retain the above copyright
  16 .\"    notice, this list of conditions and the following disclaimer.
  17 .\" 2. Redistributions in binary form must reproduce the above copyright
  18 .\"    notice, this list of conditions and the following disclaimer in the
  19 .\"    documentation and/or other materials provided with the distribution.
  20 .\" 3. The name of the author may not be used to endorse or promote
  21 .\"    products derived from this software without specific prior written
  22 .\"    permission.
  23 .\"
  24 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  25 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  26 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  27 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  28 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  29 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  30 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  31 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  32 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  33 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  34 .\" SUCH DAMAGE.
  35 .\"
  36 .\" $FreeBSD: src/lib/libpam/modules/pam_lastlog/pam_lastlog.8,v 1.7 2005/01/21 10:38:42 ru Exp $
  37 .\"
  38 .Dd March 2, 2005
  39 .Dt PAM_LASTLOG 8
  40 .Os
  41 .Sh NAME
  42 .Nm pam_lastlog
  43 .Nd login accounting PAM module
  44 .Sh SYNOPSIS
  45 .Op Ar service-name
  46 .Ar module-type
  47 .Ar control-flag
  48 .Pa pam_lastlog
  49 .Op Ar options
  50 .Sh DESCRIPTION
  51 The login accounting service module for PAM
  52 provides functionality for only one PAM category:
  53 session management.
  54 In terms of the
  55 .Ar module-type
  56 parameter, this is the
  57 .Dq Li session
  58 feature.
  59 .Ss Login Accounting Session Management Module
  60 The login accounting session management component provides functions
  61 to initiate
  62 .Pq Fn pam_sm_open_session
  63 and terminate
  64 .Pq Fn pam_sm_close_session
  65 sessions.
  66 The
  67 .Fn pam_sm_open_session
  68 function records the session in the
  69 .Xr utmp 5 ,
  70 .Xr utmpx 5 ,
  71 .Xr wtmp 5 ,
  72 .Xr wtmpx 5 ,
  73 .Xr lastlog 5 ,
  74 and
  75 .Xr lastlogx 5
  76 databases.
  77 The
  78 .Fn pam_sm_close_session
  79 function does nothing.
  80 .Pp
  81 The following options may be passed to the authentication module:
  82 .Bl -tag -width ".Cm no_nested"
  83 .It Cm debug
  84 .Xr syslog 3
  85 debugging information at
  86 .Dv LOG_DEBUG
  87 level.
  88 .It Cm no_nested
  89 Don't update records or print messages if the user is
  90 .Dq nested ,
  91 i.e. logged in on the same tty on top of another user.
  92 .It Cm no_warn
  93 suppress warning messages to the user.
  94 .It Cm no_fail
  95 Ignore I/O failures.
  96 .El
  97 .Sh SEE ALSO
  98 .Xr last 1 ,
  99 .Xr w 1 ,
 100 .Xr login 3 ,
 101 .Xr loginx 3 ,
 102 .Xr logout 3 ,
 103 .Xr logoutx 3 ,
 104 .Xr pam.conf 5 ,
 105 .Xr utmp 5 ,
 106 .Xr utmpx 5 ,
 107 .Xr lastlogin 8 ,
 108 .Xr pam 8
 109 .Sh AUTHORS
 110 The
 111 .Nm
 112 module and this manual page were developed for the
 113 .Fx
 114 Project by
 115 ThinkSec AS and NAI Labs, the Security Research Division of Network
 116 Associates, Inc.\& under DARPA/SPAWAR contract N66001-01-C-8035
 117 .Pq Dq CBOSS ,
 118 as part of the DARPA CHATS research program.