aboutsummaryrefslogtreecommitdiffstats
path: root/doc/man3/UI_new.pod
diff options
context:
space:
mode:
authorRichard Levitte <levitte@openssl.org>2017-03-11 00:51:53 +0100
committerRichard Levitte <levitte@openssl.org>2017-03-11 00:51:53 +0100
commit5469600e367a1a4cf3dd929159b5bc8091db49de (patch)
treec65df4ee9493b119003d7b6b2f8b042c0636cad2 /doc/man3/UI_new.pod
parentd61461a7525322d188f9c6e3f90cfc93916cc636 (diff)
downloadopenssl-5469600e367a1a4cf3dd929159b5bc8091db49de.tar.gz
Document UI_METHOD and UI_STRING, both useful for UI_METHOD creators
Reviewed-by: Tim Hudson <tjh@openssl.org> (Merged from https://github.com/openssl/openssl/pull/2903)
Diffstat (limited to 'doc/man3/UI_new.pod')
-rw-r--r--doc/man3/UI_new.pod8
1 files changed, 4 insertions, 4 deletions
diff --git a/doc/man3/UI_new.pod b/doc/man3/UI_new.pod
index 08400d3492..8d4ae659a6 100644
--- a/doc/man3/UI_new.pod
+++ b/doc/man3/UI_new.pod
@@ -2,7 +2,7 @@
=head1 NAME
-UI, UI_METHOD,
+UI,
UI_new, UI_new_method, UI_free, UI_add_input_string, UI_dup_input_string,
UI_add_verify_string, UI_dup_verify_string, UI_add_input_boolean,
UI_dup_input_boolean, UI_add_info_string, UI_dup_info_string,
@@ -16,7 +16,6 @@ UI_set_method, UI_OpenSSL, UI_null - user interface
#include <openssl/ui.h>
typedef struct ui_st UI;
- typedef struct ui_method_st UI_METHOD;
UI *UI_new(void);
UI *UI_new_method(const UI_METHOD *method);
@@ -65,7 +64,7 @@ UI_set_method, UI_OpenSSL, UI_null - user interface
UI stands for User Interface, and is general purpose set of routines to
prompt the user for text-based information. Through user-written methods
-(see L<ui_create(3)>), prompting can be done in any way
+(see L<UI_create_method(3)>), prompting can be done in any way
imaginable, be it plain text prompting, through dialog boxes or from a
cell phone.
@@ -159,7 +158,8 @@ UI_get0_result() returns a pointer to the result buffer associated with
the information indexed by I<i>.
UI_process() goes through the information given so far, does all the printing
-and prompting and returns.
+and prompting and returns the final status, which is -2 on out-of-band events
+(Interrupt, Cancel, ...), -1 on error and 0 on success.
UI_ctrl() adds extra control for the application author. For now, it
understands two commands: B<UI_CTRL_PRINT_ERRORS>, which makes UI_process()