xref: /freebsd/contrib/openpam/doc/man/openpam_get_feature.3 (revision 49e56509dbc8fd972cf527b2966bf56ce9c0726e)
1ce77a8d6SDag-Erling Smørgrav.\" Generated from openpam_get_feature.c by gendoc.pl
2*49e56509SDag-Erling Smørgrav.\" $OpenPAM: openpam_get_feature.c 938 2017-04-30 21:34:42Z des $
3*49e56509SDag-Erling Smørgrav.Dd April 30, 2017
42f3ed619SDag-Erling Smørgrav.Dt OPENPAM_GET_FEATURE 3
52f3ed619SDag-Erling Smørgrav.Os
62f3ed619SDag-Erling Smørgrav.Sh NAME
72f3ed619SDag-Erling Smørgrav.Nm openpam_get_feature
82f3ed619SDag-Erling Smørgrav.Nd query the state of an optional feature
92f3ed619SDag-Erling Smørgrav.Sh SYNOPSIS
102f3ed619SDag-Erling Smørgrav.In sys/types.h
112f3ed619SDag-Erling Smørgrav.In security/pam_appl.h
122f3ed619SDag-Erling Smørgrav.In security/openpam.h
132f3ed619SDag-Erling Smørgrav.Ft "int"
142f3ed619SDag-Erling Smørgrav.Fn openpam_get_feature "int feature" "int *onoff"
152f3ed619SDag-Erling Smørgrav.Sh DESCRIPTION
162f3ed619SDag-Erling Smørgrav.Bf Sy
17ce77a8d6SDag-Erling SmørgravThis function is experimental and may be modified or removed in a future release without prior warning.
182f3ed619SDag-Erling Smørgrav.Ef
192f3ed619SDag-Erling Smørgrav.Pp
202f3ed619SDag-Erling SmørgravThe
212f3ed619SDag-Erling Smørgrav.Fn openpam_get_feature
222f3ed619SDag-Erling Smørgravfunction stores the current state of the
232f3ed619SDag-Erling Smørgravspecified feature in the variable pointed to by its
242f3ed619SDag-Erling Smørgrav.Fa onoff
252f3ed619SDag-Erling Smørgravargument.
262f3ed619SDag-Erling Smørgrav.Pp
272f3ed619SDag-Erling SmørgravThe following features are recognized:
282f3ed619SDag-Erling Smørgrav.Bl -tag -width 18n
292f3ed619SDag-Erling Smørgrav.It Dv OPENPAM_RESTRICT_SERVICE_NAME
302f3ed619SDag-Erling SmørgravDisallow path separators in service names.
312f3ed619SDag-Erling SmørgravThis feature is enabled by default.
322f3ed619SDag-Erling SmørgravDisabling it allows the application to specify the path to
332f3ed619SDag-Erling Smørgravthe desired policy file directly.
342f3ed619SDag-Erling Smørgrav.It Dv OPENPAM_VERIFY_POLICY_FILE
352f3ed619SDag-Erling SmørgravVerify the ownership and permissions of the policy file
362f3ed619SDag-Erling Smørgravand the path leading up to it.
372f3ed619SDag-Erling SmørgravThis feature is enabled by default.
382f3ed619SDag-Erling Smørgrav.It Dv OPENPAM_RESTRICT_MODULE_NAME
392f3ed619SDag-Erling SmørgravDisallow path separators in module names.
402f3ed619SDag-Erling SmørgravThis feature is disabled by default.
412f3ed619SDag-Erling SmørgravEnabling it prevents the use of modules in non-standard
422f3ed619SDag-Erling Smørgravlocations.
432f3ed619SDag-Erling Smørgrav.It Dv OPENPAM_VERIFY_MODULE_FILE
442f3ed619SDag-Erling SmørgravVerify the ownership and permissions of each loadable
452f3ed619SDag-Erling Smørgravmodule and the path leading up to it.
462f3ed619SDag-Erling SmørgravThis feature is enabled by default.
472f3ed619SDag-Erling Smørgrav.El
482f3ed619SDag-Erling Smørgrav.Sh RETURN VALUES
492f3ed619SDag-Erling SmørgravThe
502f3ed619SDag-Erling Smørgrav.Fn openpam_get_feature
512f3ed619SDag-Erling Smørgravfunction returns one of the following values:
522f3ed619SDag-Erling Smørgrav.Bl -tag -width 18n
53*49e56509SDag-Erling Smørgrav.It Bq Er PAM_SUCCESS
54*49e56509SDag-Erling SmørgravSuccess.
55*49e56509SDag-Erling Smørgrav.It Bq Er PAM_BAD_FEATURE
56*49e56509SDag-Erling SmørgravUnrecognized or restricted feature.
572f3ed619SDag-Erling Smørgrav.El
582f3ed619SDag-Erling Smørgrav.Sh SEE ALSO
592f3ed619SDag-Erling Smørgrav.Xr openpam_set_feature 3 ,
602f3ed619SDag-Erling Smørgrav.Xr pam 3 ,
612f3ed619SDag-Erling Smørgrav.Xr pam_strerror 3
622f3ed619SDag-Erling Smørgrav.Sh STANDARDS
632f3ed619SDag-Erling SmørgravThe
642f3ed619SDag-Erling Smørgrav.Fn openpam_get_feature
652f3ed619SDag-Erling Smørgravfunction is an OpenPAM extension.
662f3ed619SDag-Erling Smørgrav.Sh AUTHORS
672f3ed619SDag-Erling SmørgravThe
682f3ed619SDag-Erling Smørgrav.Fn openpam_get_feature
692f3ed619SDag-Erling Smørgravfunction and this manual page were
702f3ed619SDag-Erling Smørgravdeveloped by
71f3b0ac34SDag-Erling Smørgrav.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .
72