$Id: openpam_get_feature.c 648 2013-03-05 17:54:27Z des $
.Dd September 12, 2014 .Dt OPENPAM_GET_FEATURE 3 .Os .Sh NAME .Nm openpam_get_feature .Nd query the state of an optional feature .Sh LIBRARY .Lb libpam .Sh SYNOPSIS n sys/types.h n security/pam_appl.h n security/openpam.h .Ft "int" .Fn openpam_get_feature "int feature" "int *onoff" .Sh DESCRIPTION f Sy This function is experimental and may be modified or removed in a future release without prior warning. .Ef
p The .Fn openpam_get_feature function stores the current state of the specified feature in the variable pointed to by its .Fa onoff argument.
p The following features are recognized: l -tag -width 18n t Dv OPENPAM_RESTRICT_SERVICE_NAME Disallow path separators in service names. This feature is enabled by default. Disabling it allows the application to specify the path to the desired policy file directly. t Dv OPENPAM_VERIFY_POLICY_FILE Verify the ownership and permissions of the policy file and the path leading up to it. This feature is enabled by default. t Dv OPENPAM_RESTRICT_MODULE_NAME Disallow path separators in module names. This feature is disabled by default. Enabling it prevents the use of modules in non-standard locations. t Dv OPENPAM_VERIFY_MODULE_FILE Verify the ownership and permissions of each loadable module and the path leading up to it. This feature is enabled by default. .El .Sh RETURN VALUES The .Fn openpam_get_feature function returns one of the following values: l -tag -width 18n t Bq Er PAM_SYMBOL_ERR Invalid symbol. .El .Sh SEE ALSO .Xr openpam_set_feature 3 , .Xr pam 3 , .Xr pam_strerror 3 .Sh STANDARDS The .Fn openpam_get_feature function is an OpenPAM extension. .Sh AUTHORS The .Fn openpam_get_feature function and this manual page were developed by .An Dag-Erling Sm\(/orgrav Aq des@des.no .