PAMSTART(3) Application Programmers' Manual PAMSTART(3)

NAME
       pamstart, pamend - activating Linux-PAM


SYNOPSIS
       ##iinncclluuddee <>

       iinntt  ppaammssttaarrtt((ccoonnsstt  cchhaarr  *service,,  ccoonnsstt  cchhaarr  *user,, ccoonnsstt ssttrruucctt
       ppaammccoonnvv *conv,, ppaammhhaannddlleett **pamhp));;

       iinntt ppaammeenndd((ppaammhhaannddlleett *pamh,, iinntt pamstatus));;



DESCRIPTION
       ppaammssttaarrtt
              Initialize the Linux-PAM library.  Identifying  the  application
              with a particular service name.  The username can take the value
              NULL, if not known at the time  the  interface  is  initialized.
              The conversation structure is passed to the library via the conv
              argument.  (For a complete description of this and other  struc-
              tures  the  reader  is  directed  to  the more verbose Linux-PAM
              application developers' guide).  Upon successful initialization,
              an  opaque  pointer-handle  for  future access to the library is
              returned through the contents of the pamhp pointer.


       ppaammeenndd
              Terminate the LLiinnuuxx-PPAAMM library.  The service application  asso-
              ciated  with  the  pamh  handle,  is  terminated.  The argument,
              pamstatus, passes the  value  most  recently  returned  to  the
              application  from  the library; it indicates the manner in which
              the library should  be  shutdown.   Besides  carrying  a  return
              value,  this argument may be logically OR'd with PAMDATASILENT
              to indicate that the module should not treat the call too  seri-
              ously. It is generally used to indicate that the current closing
              of the library is in a fork(2)ed process, and  that  the  parent
              will  take  care of cleaning up things that exist outside of the
              current process space (files etc.).


RREETTUURRNN VVAALLUUEE
       ppaammssttaarrtt

       ppaammeenndd
              On success, PPAAMMSSUUCCCCEESSSS is returned


EERRRROORRSS
       May be translated to text with ppaammssttrreerrrroorr(3).


CCOONNFFOORRMMIINNGG TTOO
       DCE-RFC 86.0, October 1995.

       Note, the PPAAMMDDAATTAASSIILLEENNTT flag is pending acceptance with the  DCE  (as
       of 1996/12/4).


BUGS
       None known.


SEE ALSO
       ffoorrkk(2),  ppaammaauutthheennttiiccaattee(3),  ppaammaaccccttmmggmmtt(3),  ppaammooppeennsseessssiioonn(3),
       and ppaammcchhaauutthhttookk(3).

       Also, see the three LLiinnuuxx-PPAAMM Guides, for SSyysstteemm aaddmmiinniissttrraattoorrss, mmoodduullee
       ddeevveellooppeerrss, and aapppplliiccaattiioonn ddeevveellooppeerrss.



Linux-PAM 0.56                    1997 Feb 15                     PAMSTART(3)