doc/man/pam_open_session.3

   1 .\" Generated from pam_open_session.c by gendoc.pl
   2 .\" $Id: pam_open_session.c 648 2013-03-05 17:54:27Z des $
   3 .Dd February 19, 2017
   4 .Dt PAM_OPEN_SESSION 3
   5 .Os
   6 .Sh NAME
   7 .Nm pam_open_session
   8 .Nd open a user session
   9 .Sh SYNOPSIS
  10 .In sys/types.h
  11 .In security/pam_appl.h
  12 .Ft "int"
  13 .Fn pam_open_session "pam_handle_t *pamh" "int flags"
  14 .Sh DESCRIPTION
  15 The
  16 .Fn pam_open_session
  17 sets up a user session for a previously
  18 authenticated user.
  19 The session should later be torn down by a call to
  20 .Xr pam_close_session 3 .
  21 .Pp
  22 The
  23 .Fa flags
  24 argument is the binary or of zero or more of the following
  25 values:
  26 .Bl -tag -width 18n
  27 .It Dv PAM_SILENT
  28 Do not emit any messages.
  29 .El
  30 .Pp
  31 If any other bits are set,
  32 .Fn pam_open_session
  33 will return
  34 .Dv PAM_SYMBOL_ERR .
  35 .Sh RETURN VALUES
  36 The
  37 .Fn pam_open_session
  38 function returns one of the following values:
  39 .Bl -tag -width 18n
  40 .It Bq Er PAM_ABORT
  41 General failure.
  42 .It Bq Er PAM_BUF_ERR
  43 Memory buffer error.
  44 .It Bq Er PAM_CONV_ERR
  45 Conversation failure.
  46 .It Bq Er PAM_PERM_DENIED
  47 Permission denied.
  48 .It Bq Er PAM_SERVICE_ERR
  49 Error in service module.
  50 .It Bq Er PAM_SESSION_ERR
  51 Session failure.
  52 .It Bq Er PAM_SYMBOL_ERR
  53 Invalid symbol.
  54 .It Bq Er PAM_SYSTEM_ERR
  55 System error.
  56 .El
  57 .Sh SEE ALSO
  58 .Xr pam 3 ,
  59 .Xr pam_close_session 3 ,
  60 .Xr pam_strerror 3
  61 .Sh STANDARDS
  62 .Rs
  63 .%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
  64 .%D "June 1997"
  65 .Re
  66 .Sh AUTHORS
  67 The
  68 .Fn pam_open_session
  69 function and this manual page were
  70 developed for the
  71 .Fx
  72 Project by ThinkSec AS and Network Associates Laboratories, the
  73 Security Research Division of Network Associates, Inc.\& under
  74 DARPA/SPAWAR contract N66001-01-C-8035
  75 .Pq Dq CBOSS ,
  76 as part of the DARPA CHATS research program.
  77 .Pp
  78 The OpenPAM library is maintained by
  79 .An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .