110b5fe87SSascha Wildner.\" Generated from openpam_get_feature.c by gendoc.pl 210b5fe87SSascha Wildner.\" $OpenPAM: openpam_get_feature.c 938 2017-04-30 21:34:42Z des $ 3*4c84ab30SSascha Wildner.Dd February 24, 2019 4577efdeeSPeter Avalos.Dt OPENPAM_GET_FEATURE 3 5577efdeeSPeter Avalos.Os 6577efdeeSPeter Avalos.Sh NAME 7577efdeeSPeter Avalos.Nm openpam_get_feature 8577efdeeSPeter Avalos.Nd query the state of an optional feature 9577efdeeSPeter Avalos.Sh SYNOPSIS 10577efdeeSPeter Avalos.In sys/types.h 11577efdeeSPeter Avalos.In security/pam_appl.h 12577efdeeSPeter Avalos.In security/openpam.h 13577efdeeSPeter Avalos.Ft "int" 14577efdeeSPeter Avalos.Fn openpam_get_feature "int feature" "int *onoff" 15577efdeeSPeter Avalos.Sh DESCRIPTION 16577efdeeSPeter Avalos.Bf Sy 1710b5fe87SSascha WildnerThis function is experimental and may be modified or removed in a future release without prior warning. 18577efdeeSPeter Avalos.Ef 19577efdeeSPeter Avalos.Pp 20577efdeeSPeter AvalosThe 21577efdeeSPeter Avalos.Fn openpam_get_feature 22577efdeeSPeter Avalosfunction stores the current state of the 23577efdeeSPeter Avalosspecified feature in the variable pointed to by its 24577efdeeSPeter Avalos.Fa onoff 25577efdeeSPeter Avalosargument. 26577efdeeSPeter Avalos.Pp 27577efdeeSPeter AvalosThe following features are recognized: 28577efdeeSPeter Avalos.Bl -tag -width 18n 29577efdeeSPeter Avalos.It Dv OPENPAM_RESTRICT_SERVICE_NAME 30577efdeeSPeter AvalosDisallow path separators in service names. 31577efdeeSPeter AvalosThis feature is enabled by default. 32577efdeeSPeter AvalosDisabling it allows the application to specify the path to 33577efdeeSPeter Avalosthe desired policy file directly. 34577efdeeSPeter Avalos.It Dv OPENPAM_VERIFY_POLICY_FILE 35577efdeeSPeter AvalosVerify the ownership and permissions of the policy file 36577efdeeSPeter Avalosand the path leading up to it. 37577efdeeSPeter AvalosThis feature is enabled by default. 38577efdeeSPeter Avalos.It Dv OPENPAM_RESTRICT_MODULE_NAME 39577efdeeSPeter AvalosDisallow path separators in module names. 40577efdeeSPeter AvalosThis feature is disabled by default. 41577efdeeSPeter AvalosEnabling it prevents the use of modules in non-standard 42577efdeeSPeter Avaloslocations. 43577efdeeSPeter Avalos.It Dv OPENPAM_VERIFY_MODULE_FILE 44577efdeeSPeter AvalosVerify the ownership and permissions of each loadable 45577efdeeSPeter Avalosmodule and the path leading up to it. 46577efdeeSPeter AvalosThis feature is enabled by default. 47577efdeeSPeter Avalos.El 48577efdeeSPeter Avalos.Sh RETURN VALUES 49577efdeeSPeter AvalosThe 50577efdeeSPeter Avalos.Fn openpam_get_feature 51577efdeeSPeter Avalosfunction returns one of the following values: 52577efdeeSPeter Avalos.Bl -tag -width 18n 5310b5fe87SSascha Wildner.It Bq Er PAM_SUCCESS 5410b5fe87SSascha WildnerSuccess. 5510b5fe87SSascha Wildner.It Bq Er PAM_BAD_FEATURE 5610b5fe87SSascha WildnerUnrecognized or restricted feature. 57577efdeeSPeter Avalos.El 58577efdeeSPeter Avalos.Sh SEE ALSO 59577efdeeSPeter Avalos.Xr openpam_set_feature 3 , 60577efdeeSPeter Avalos.Xr pam 3 , 61577efdeeSPeter Avalos.Xr pam_strerror 3 62577efdeeSPeter Avalos.Sh STANDARDS 63577efdeeSPeter AvalosThe 64577efdeeSPeter Avalos.Fn openpam_get_feature 65577efdeeSPeter Avalosfunction is an OpenPAM extension. 66577efdeeSPeter Avalos.Sh AUTHORS 67577efdeeSPeter AvalosThe 68577efdeeSPeter Avalos.Fn openpam_get_feature 69577efdeeSPeter Avalosfunction and this manual page were 70577efdeeSPeter Avalosdeveloped by 7110b5fe87SSascha Wildner.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no . 72