.Dd December 21, 2007
.Dt PAM_UNSETENV 3
.Os
.Sh NAME
.Nm pam_unsetenv
.Nd mirrors unsetenv(3)
.Sh LIBRARY
.Lb libpam
.Sh SYNOPSIS
.In sys/types.h
.In security/pam_appl.h
.Ft "int"
.Fn pam_unsetenv "pam_handle_t *pamh" "const char *name"
.Sh DESCRIPTION
The
.Nm
function unsets a environment variable.
Its semantics are similar to those of
.Xr unsetenv 3 ,
but it modifies the PAM
context's environment list instead of the application's.
.Pp
.Sh RETURN VALUES
The
.Nm
function returns one of the following values:
.Bl -tag -width 18n
.It Bq Er PAM_SYSTEM_ERR
System error.
.El
.Sh SEE ALSO
.Xr pam 3 ,
.Xr pam_getenv 3 ,
.Xr pam_getenvlist 3 ,
.Xr pam_putenv 3 ,
.Xr pam_strerror 3 ,
.Xr setenv 3
.Sh STANDARDS
The
.Nm
function is an OpenPAM extension.