pam_get_authtok.3 (94670) | pam_get_authtok.3 (94970) |
---|---|
1.\"- 2.\" Copyright (c) 2002 Networks Associates Technology, Inc. 3.\" All rights reserved. 4.\" 5.\" This software was developed for the FreeBSD Project by ThinkSec AS and 6.\" NAI Labs, the Security Research Division of Network Associates, Inc. 7.\" under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part of the 8.\" DARPA CHATS research program. --- 17 unchanged lines hidden (view full) --- 26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 32.\" SUCH DAMAGE. 33.\" | 1.\"- 2.\" Copyright (c) 2002 Networks Associates Technology, Inc. 3.\" All rights reserved. 4.\" 5.\" This software was developed for the FreeBSD Project by ThinkSec AS and 6.\" NAI Labs, the Security Research Division of Network Associates, Inc. 7.\" under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part of the 8.\" DARPA CHATS research program. --- 17 unchanged lines hidden (view full) --- 26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 32.\" SUCH DAMAGE. 33.\" |
34.\" $P4: //depot/projects/openpam/doc/man/pam_get_authtok.3#12 $ | 34.\" $P4: //depot/projects/openpam/doc/man/pam_get_authtok.3#13 $ |
35.\" 36.Dd April 14, 2002 37.Dt PAM_GET_AUTHTOK 3 38.Os 39.Sh NAME 40.Nm pam_get_authtok 41.Nd retrieve authentication token 42.Sh LIBRARY --- 10 unchanged lines hidden (view full) --- 53pointer to the authentication token is stored in the location pointed 54to by the 55.Va authtok 56argument. 57.Pp 58The 59.Va item 60argument must have one of the following values: | 35.\" 36.Dd April 14, 2002 37.Dt PAM_GET_AUTHTOK 3 38.Os 39.Sh NAME 40.Nm pam_get_authtok 41.Nd retrieve authentication token 42.Sh LIBRARY --- 10 unchanged lines hidden (view full) --- 53pointer to the authentication token is stored in the location pointed 54to by the 55.Va authtok 56argument. 57.Pp 58The 59.Va item 60argument must have one of the following values: |
61.Pp 62.Bd -literal 63 =PAM_AUTHTOK 64 Returns the current authentication token, or the new token 65 when changing authentication tokens. 66 =PAM_OLDAUTHTOK 67 Returns the previous authentication token when changing 68 authentication tokens. 69 70.Ed | 61.Bl -tag -width 18n 62.It Dv PAM_AUTHTOK 63Returns the current authentication token, or the new token 64when changing authentication tokens. 65.It Dv PAM_OLDAUTHTOK 66Returns the previous authentication token when changing 67authentication tokens. 68.El |
71The 72.Va prompt 73argument specifies a prompt to use if no token is cached. | 69The 70.Va prompt 71argument specifies a prompt to use if no token is cached. |
74.Ed | |
75If it is 76.Dv NULL , 77the 78.Dv PAM_AUTHTOK_PROMPT 79or 80.Dv PAM_OLDAUTHTOK_PROMPT 81item, | 72If it is 73.Dv NULL , 74the 75.Dv PAM_AUTHTOK_PROMPT 76or 77.Dv PAM_OLDAUTHTOK_PROMPT 78item, |
82.Ed | |
83as appropriate, will be used. If that item is also 84.Dv NULL , 85a hardcoded | 79as appropriate, will be used. If that item is also 80.Dv NULL , 81a hardcoded |
86.Ed | |
87default prompt will be used. | 82default prompt will be used. |
88 89.Ed | 83.Pp |
90If 91.Va item 92is set to 93.Dv PAM_AUTHTOK 94and there is a non-null 95.Dv PAM_OLDAUTHTOK | 84If 85.Va item 86is set to 87.Dv PAM_AUTHTOK 88and there is a non-null 89.Dv PAM_OLDAUTHTOK |
96.Ed | |
97item, 98.Nm 99will ask the user to confirm the new token by | 90item, 91.Nm 92will ask the user to confirm the new token by |
100.Ed | |
101retyping it. If there is a mismatch, 102.Nm 103will return | 93retyping it. If there is a mismatch, 94.Nm 95will return |
104.Ed | |
105.Dv PAM_TRY_AGAIN . | 96.Dv PAM_TRY_AGAIN . |
106 | 97.Pp |
107.Sh RETURN VALUES 108The 109.Nm 110function returns one of the following values: 111.Bl -tag -width 18n 112.It Bq Er PAM_BUF_ERR 113Memory buffer error. 114.It Bq Er PAM_CONV_ERR --- 23 unchanged lines hidden --- | 98.Sh RETURN VALUES 99The 100.Nm 101function returns one of the following values: 102.Bl -tag -width 18n 103.It Bq Er PAM_BUF_ERR 104Memory buffer error. 105.It Bq Er PAM_CONV_ERR --- 23 unchanged lines hidden --- |