contrib/openpam/doc/man/pam_end.3

   1 .\" Generated from pam_end.c by gendoc.pl
   2 .\" $Id: pam_end.c 913 2017-01-21 15:11:12Z des $
   3 .Dd February 19, 2017
   4 .Dt PAM_END 3
   5 .Os
   6 .Sh NAME
   7 .Nm pam_end
   8 .Nd terminate the PAM transaction
   9 .Sh SYNOPSIS
  10 .In sys/types.h
  11 .In security/pam_appl.h
  12 .Ft "int"
  13 .Fn pam_end "pam_handle_t *pamh" "int status"
  14 .Sh DESCRIPTION
  15 The
  16 .Fn pam_end
  17 function terminates a PAM transaction and destroys the
  18 corresponding PAM context, releasing all resources allocated to it.
  19 .Pp
  20 The
  21 .Fa status
  22 argument should be set to the error code returned by the
  23 last API call before the call to
  24 .Fn pam_end .
  25 .Sh RETURN VALUES
  26 The
  27 .Fn pam_end
  28 function returns 0 on success and -1 on failure.
  29 .Sh SEE ALSO
  30 .Xr pam 3 ,
  31 .Xr pam_strerror 3
  32 .Sh STANDARDS
  33 .Rs
  34 .%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
  35 .%D "June 1997"
  36 .Re
  37 .Sh AUTHORS
  38 The
  39 .Fn pam_end
  40 function and this manual page were
  41 developed for the
  42 .Fx
  43 Project by ThinkSec AS and Network Associates Laboratories, the
  44 Security Research Division of Network Associates, Inc.\& under
  45 DARPA/SPAWAR contract N66001-01-C-8035
  46 .Pq Dq CBOSS ,
  47 as part of the DARPA CHATS research program.
  48 .Pp
  49 The OpenPAM library is maintained by
  50 .An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .