xref: /netbsd-src/external/bsd/openpam/dist/doc/man/openpam_set_feature.3 (revision 6a493d6bc668897c91594964a732d38505b70cbb)
1.\"	$NetBSD: openpam_set_feature.3,v 1.3 2013/12/27 20:10:20 christos Exp $
2.\"
3.\" Generated from openpam_set_feature.c by gendoc.pl
4.\" Id: openpam_set_feature.c 648 2013-03-05 17:54:27Z des
5.Dd September 7, 2013
6.Dt OPENPAM_SET_FEATURE 3
7.Os
8.Sh NAME
9.Nm openpam_set_feature
10.Nd enable or disable an optional feature
11.Sh LIBRARY
12.Lb libpam
13.Sh SYNOPSIS
14.In sys/types.h
15.In security/pam_appl.h
16.In security/openpam.h
17.Ft "int"
18.Fn openpam_set_feature "int feature" "int onoff"
19.Sh DESCRIPTION
20.Bf Sy
21This function is experimental and may be modified or removed in a future release without prior warning.
22.Ef
23.Pp
24The
25.Fn openpam_set_feature
26function sets the state of the specified
27feature to the value specified by the
28.Fa onoff
29argument.
30See
31.Xr openpam_get_feature 3
32for a list of recognized features.
33.Pp
34.Sh RETURN VALUES
35The
36.Fn openpam_set_feature
37function returns one of the following values:
38.Bl -tag -width 18n
39.It Bq Er PAM_SYMBOL_ERR
40Invalid symbol.
41.El
42.Sh SEE ALSO
43.Xr openpam_get_feature 3 ,
44.Xr pam 3 ,
45.Xr pam_strerror 3
46.Sh STANDARDS
47The
48.Fn openpam_set_feature
49function is an OpenPAM extension.
50.Sh AUTHORS
51The
52.Fn openpam_set_feature
53function and this manual page were
54developed by
55.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .
56