1 .\" Generated from openpam_get_feature.c by gendoc.pl
2 .\" $Id: openpam_get_feature.c 648 2013-03-05 17:54:27Z des $
4 .Dt OPENPAM_GET_FEATURE 3
7 .Nm openpam_get_feature
8 .Nd query the state of an optional feature
13 .In security/pam_appl.h
14 .In security/openpam.h
16 .Fn openpam_get_feature "int feature" "int *onoff"
19 This function is experimental and may be modified or removed in a future release without prior warning.
23 .Fn openpam_get_feature
24 function stores the current state of the
25 specified feature in the variable pointed to by its
29 The following features are recognized:
31 .It Dv OPENPAM_RESTRICT_SERVICE_NAME
32 Disallow path separators in service names.
33 This feature is enabled by default.
34 Disabling it allows the application to specify the path to
35 the desired policy file directly.
36 .It Dv OPENPAM_VERIFY_POLICY_FILE
37 Verify the ownership and permissions of the policy file
38 and the path leading up to it.
39 This feature is enabled by default.
40 .It Dv OPENPAM_RESTRICT_MODULE_NAME
41 Disallow path separators in module names.
42 This feature is disabled by default.
43 Enabling it prevents the use of modules in non-standard
45 .It Dv OPENPAM_VERIFY_MODULE_FILE
46 Verify the ownership and permissions of each loadable
47 module and the path leading up to it.
48 This feature is enabled by default.
52 .Fn openpam_get_feature
53 function returns one of the following values:
55 .It Bq Er PAM_SYMBOL_ERR
59 .Xr openpam_set_feature 3 ,
64 .Fn openpam_get_feature
65 function is an OpenPAM extension.
68 .Fn openpam_get_feature
69 function and this manual page were
71 .An Dag-Erling Sm\(/orgrav Aq des@des.no .