From 3a9a357e65f006994b1702c0cf6bb4264a10faad Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Love=20H=C3=B6rnquist=20=C3=85strand?= <lha@kth.se>
Date: Tue, 13 Apr 2004 12:33:10 +0000
Subject: [PATCH] some text about krb5_prompter_posix

git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@13705 ec53bebd-3082-4978-b11e-865c3cabbd6b
---
 lib/krb5/krb5_get_init_creds.3 | 51 +++++++++++++++++++++++++++++++++-
 1 file changed, 50 insertions(+), 1 deletion(-)

diff --git a/lib/krb5/krb5_get_init_creds.3 b/lib/krb5/krb5_get_init_creds.3
index c8e05f9e5..123ac3fe7 100644
--- a/lib/krb5/krb5_get_init_creds.3
+++ b/lib/krb5/krb5_get_init_creds.3
@@ -54,7 +54,9 @@
 .Nm krb5_get_init_creds_opt_set_rewew_life ,
 .Nm krb5_get_init_creds_opt_set_salt ,
 .Nm krb5_get_init_creds_opt_set_tkt_life ,
-.Nm krb5_get_init_creds_password
+.Nm krb5_get_init_creds_password ,
+.Nm krb5_prompt ,
+.Nm krb5_prompter_posix
 .Nd kerberos 5 initial authentication functions.
 .Sh LIBRARY
 Kerberos 5 Library (libkrb5, -lkrb5)
@@ -203,6 +205,15 @@ Kerberos 5 Library (libkrb5, -lkrb5)
 .Fa "const char *in_tkt_service"
 .Fa "krb5_get_init_creds_opt *options"
 .Fc
+.Ft int
+.Fo krb5_prompter_posix
+.Fa "krb5_context context"
+.Fa "void *data"
+.Fa "const char *name"
+.Fa "const char *banner"
+.Fa "int num_prompts"
+.Fa "krb5_prompt prompts[]"
+.Fc
 .Sh DESCRIPTION
 Getting initial credential ticket for a principal.
 This interface that replaces the deprecated
@@ -233,6 +244,44 @@ is the least specialized function and can, with the right in data,
 behave like the later two.
 The later two are there for compatibly with older releases and that
 they are slightly easier to use.
+.Pp
+.Li krb5_prompt
+is a structure containing the following elements:
+.Bd -literal
+typedef struct {
+    const char *prompt;
+    int hidden;
+    krb5_data *reply;
+    krb5_prompt_type type
+} krb5_prompt;
+.Ed
+.Pp
+.Fa prompt
+is the prompt that should shown to the user
+If
+.Fa hidden
+is set, the prompter function shouldn't echo the output to the display
+device.
+.Fa reply
+must be preallocated, it will not be allocated in by the prompter
+function.
+Possible value for the
+.Fa type
+element are:
+.Bl -tag -compact -offset indent
+.It KRB5_PROMPT_TYPE_PASSWORD
+.It KRB5_PROMPT_TYPE_NEW_PASSWORD
+.It KRB5_PROMPT_TYPE_NEW_PASSWORD_AGAIN
+.It KRB5_PROMPT_TYPE_PREAUTH
+.El
+.Pp
+.Fn krb5_prompter_posix
+is a the default prompter function in a posix environment.
+It matches the
+.Fa krb5_prompter_fct
+and can be used in the
+.Fa krb5_get_init_creds
+functions.
 .Sh SEE ALSO
 .Xr krb5 3 ,
 .Xr krb5_creds 3 ,