e0b126b78ee9df7027f6d73ab9aab82e666433ca
[gnupg.git] / g10 / status.c
1 /* status.c
2  * Copyright (C) 1998, 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
3  *
4  * This file is part of GnuPG.
5  *
6  * GnuPG is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * GnuPG is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software
18  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
19  */
20
21 #include <config.h>
22 #include <stdio.h>
23 #include <stdlib.h>
24 #include <string.h>
25 #include <errno.h>
26 #include <unistd.h>
27 #include <signal.h>
28 #ifdef USE_SHM_COPROCESSING
29   #ifdef USE_CAPABILITIES
30     #include <sys/capability.h>
31   #endif
32   #ifdef HAVE_SYS_IPC_H
33     #include <sys/types.h>
34     #include <sys/ipc.h>
35   #endif
36   #ifdef HAVE_SYS_SHM_H
37     #include <sys/shm.h>
38   #endif
39   #if defined(HAVE_MLOCK)
40     #include <sys/mman.h>
41   #endif
42 #endif
43 #include "util.h"
44 #include "status.h"
45 #include "ttyio.h"
46 #include "options.h"
47 #include "main.h"
48 #include "i18n.h"
49 #include "cipher.h" /* for progress functions */
50
51 #define CONTROL_D ('D' - 'A' + 1)
52
53
54
55 static FILE *statusfp;
56
57 #ifdef USE_SHM_COPROCESSING
58   static int shm_id = -1;
59   static volatile char *shm_area;
60   static size_t shm_size;
61   static int shm_is_locked;
62 #endif /*USE_SHM_COPROCESSING*/
63
64
65 static void
66 progress_cb ( void *ctx, int c )
67 {
68     char buf[50];
69
70     if ( c == '\n' )
71         sprintf ( buf, "%.20s X 100 100", (char*)ctx );
72     else
73         sprintf ( buf, "%.20s %c 0 0", (char*)ctx, c );
74     write_status_text ( STATUS_PROGRESS, buf );
75 }
76
77 static const char *
78 get_status_string ( int no ) 
79 {
80     const char *s;
81
82     switch( no ) {
83       case STATUS_ENTER  : s = "ENTER"; break;
84       case STATUS_LEAVE  : s = "LEAVE"; break;
85       case STATUS_ABORT  : s = "ABORT"; break;
86       case STATUS_GOODSIG: s = "GOODSIG"; break;
87       case STATUS_KEYEXPIRED: s = "KEYEXPIRED"; break;
88       case STATUS_KEYREVOKED: s = "KEYREVOKED"; break;
89       case STATUS_BADSIG : s = "BADSIG"; break;
90       case STATUS_ERRSIG : s = "ERRSIG"; break;
91       case STATUS_BADARMOR : s = "BADARMOR"; break;
92       case STATUS_RSA_OR_IDEA : s= "RSA_OR_IDEA"; break;
93       case STATUS_TRUST_UNDEFINED: s = "TRUST_UNDEFINED"; break;
94       case STATUS_TRUST_NEVER    : s = "TRUST_NEVER"; break;
95       case STATUS_TRUST_MARGINAL : s = "TRUST_MARGINAL"; break;
96       case STATUS_TRUST_FULLY    : s = "TRUST_FULLY"; break;
97       case STATUS_TRUST_ULTIMATE : s = "TRUST_ULTIMATE"; break;
98       case STATUS_GET_BOOL       : s = "GET_BOOL"; break;
99       case STATUS_GET_LINE       : s = "GET_LINE"; break;
100       case STATUS_GET_HIDDEN     : s = "GET_HIDDEN"; break;
101       case STATUS_GOT_IT         : s = "GOT_IT"; break;
102       case STATUS_SHM_INFO       : s = "SHM_INFO"; break;
103       case STATUS_SHM_GET        : s = "SHM_GET"; break;
104       case STATUS_SHM_GET_BOOL   : s = "SHM_GET_BOOL"; break;
105       case STATUS_SHM_GET_HIDDEN : s = "SHM_GET_HIDDEN"; break;
106       case STATUS_NEED_PASSPHRASE: s = "NEED_PASSPHRASE"; break;
107       case STATUS_VALIDSIG       : s = "VALIDSIG"; break;
108       case STATUS_SIG_ID         : s = "SIG_ID"; break;
109       case STATUS_ENC_TO         : s = "ENC_TO"; break;
110       case STATUS_NODATA         : s = "NODATA"; break;
111       case STATUS_BAD_PASSPHRASE : s = "BAD_PASSPHRASE"; break;
112       case STATUS_NO_PUBKEY      : s = "NO_PUBKEY"; break;
113       case STATUS_NO_SECKEY      : s = "NO_SECKEY"; break;
114       case STATUS_NEED_PASSPHRASE_SYM: s = "NEED_PASSPHRASE_SYM"; break;
115       case STATUS_DECRYPTION_FAILED: s = "DECRYPTION_FAILED"; break;
116       case STATUS_DECRYPTION_OKAY: s = "DECRYPTION_OKAY"; break;
117       case STATUS_MISSING_PASSPHRASE: s = "MISSING_PASSPHRASE"; break;
118       case STATUS_GOOD_PASSPHRASE : s = "GOOD_PASSPHRASE"; break;
119       case STATUS_GOODMDC        : s = "GOODMDC"; break;
120       case STATUS_BADMDC         : s = "BADMDC"; break;
121       case STATUS_ERRMDC         : s = "ERRMDC"; break;
122       case STATUS_IMPORTED       : s = "IMPORTED"; break;
123       case STATUS_IMPORT_RES     : s = "IMPORT_RES"; break;
124       case STATUS_FILE_START     : s = "FILE_START"; break;
125       case STATUS_FILE_DONE      : s = "FILE_DONE"; break;
126       case STATUS_FILE_ERROR     : s = "FILE_ERROR"; break;
127       case STATUS_BEGIN_DECRYPTION:s = "BEGIN_DECRYPTION"; break;
128       case STATUS_END_DECRYPTION : s = "END_DECRYPTION"; break;
129       case STATUS_BEGIN_ENCRYPTION:s = "BEGIN_ENCRYPTION"; break;
130       case STATUS_END_ENCRYPTION : s = "END_ENCRYPTION"; break;
131       case STATUS_DELETE_PROBLEM : s = "DELETE_PROBLEM"; break;
132       case STATUS_PROGRESS       : s = "PROGRESS"; break;
133       case STATUS_SIG_CREATED    : s = "SIG_CREATED"; break;
134       case STATUS_SESSION_KEY    : s = "SESSION_KEY"; break;
135       case STATUS_NOTATION_NAME  : s = "NOTATION_NAME" ; break;
136       case STATUS_NOTATION_DATA  : s = "NOTATION_DATA" ; break;
137       case STATUS_POLICY_URL     : s = "POLICY_URL" ; break;
138       case STATUS_BEGIN_STREAM   : s = "BEGIN_STREAM"; break;
139       case STATUS_END_STREAM     : s = "END_STREAM"; break;
140       case STATUS_KEY_CREATED    : s = "KEY_CREATED"; break;
141       case STATUS_USERID_HINT    : s = "USERID_HINT"; break;
142       case STATUS_UNEXPECTED     : s = "UNEXPECTED"; break;
143       case STATUS_INV_RECP       : s = "INV_RECP"; break;
144       case STATUS_NO_RECP        : s = "NO_RECP"; break;
145       case STATUS_ALREADY_SIGNED : s = "ALREADY_SIGNED"; break;
146       case STATUS_SIGEXPIRED     : s = "SIGEXPIRED deprecated-use-keyexpired-instead"; break;
147       case STATUS_EXPSIG         : s = "EXPSIG"; break;
148       case STATUS_EXPKEYSIG      : s = "EXPKEYSIG"; break;
149       case STATUS_ATTRIBUTE      : s = "ATTRIBUTE"; break;
150       default: s = "?"; break;
151     }
152     return s;
153 }
154
155 void
156 set_status_fd ( int fd )
157 {
158     static int last_fd = -1;
159
160     if ( fd != -1 && last_fd == fd )
161         return;
162
163     if ( statusfp && statusfp != stdout && statusfp != stderr )
164         fclose (statusfp);
165     statusfp = NULL;
166     if ( fd == -1 ) 
167         return;
168
169     if( fd == 1 )
170         statusfp = stdout;
171     else if( fd == 2 )
172         statusfp = stderr;
173     else
174         statusfp = fdopen( fd, "w" );
175     if( !statusfp ) {
176         log_fatal("can't open fd %d for status output: %s\n",
177                   fd, strerror(errno));
178     }
179     last_fd = fd;
180     register_primegen_progress ( progress_cb, "primegen" );
181     register_pk_dsa_progress ( progress_cb, "pk_dsa" );
182     register_pk_elg_progress ( progress_cb, "pk_elg" );
183 }
184
185 int
186 is_status_enabled()
187 {
188     return !!statusfp;
189 }
190
191 void
192 write_status ( int no )
193 {
194     write_status_text( no, NULL );
195 }
196
197 void
198 write_status_text ( int no, const char *text)
199 {
200     if( !statusfp )
201         return;  /* not enabled */
202
203     fputs ( "[GNUPG:] ", statusfp );
204     fputs ( get_status_string (no), statusfp );
205     if( text ) {
206         putc ( ' ', statusfp );
207         for (; *text; text++) {
208             if (*text == '\n')
209                 fputs ( "\\n", statusfp );
210             else if (*text == '\r')
211                 fputs ( "\\r", statusfp );
212             else 
213                 putc ( *(const byte *)text,  statusfp );
214         }
215     }
216     putc ('\n',statusfp);
217     fflush (statusfp);
218 }
219
220
221 /*
222  * Write a status line with a buffer using %XX escapes.  If WRAP is >
223  * 0 wrap the line after this length.  If STRING is not NULL it will
224  * be prepended to the buffer, no escaping is done for string.
225  * A wrap of -1 forces spaces not to be encoded as %20.
226  */
227 void
228 write_status_text_and_buffer ( int no, const char *string,
229                                const char *buffer, size_t len, int wrap )
230 {
231     const char *s, *text;
232     int esc, first;
233     int lower_limit = ' ';
234     size_t n, count, dowrap;
235
236     if( !statusfp )
237         return;  /* not enabled */
238     
239     if (wrap == -1) {
240         lower_limit--;
241         wrap = 0;
242     }
243
244     text = get_status_string (no);
245     count = dowrap = first = 1;
246     do {
247         if (dowrap) {
248             fprintf (statusfp, "[GNUPG:] %s ", text );
249             count = dowrap = 0;
250             if (first && string) {
251                 fputs (string, statusfp);
252                 count += strlen (string);
253             }
254             first = 0;
255         }
256         for (esc=0, s=buffer, n=len; n && !esc; s++, n-- ) {
257             if ( *s == '%' || *(const byte*)s <= lower_limit 
258                            || *(const byte*)s == 127 ) 
259                 esc = 1;
260             if ( wrap && ++count > wrap ) {
261                 dowrap=1;
262                 break;
263             }
264         }
265         if (esc) {
266             s--; n++;
267         }
268         if (s != buffer) 
269             fwrite (buffer, s-buffer, 1, statusfp );
270         if ( esc ) {
271             fprintf (statusfp, "%%%02X", *(const byte*)s );
272             s++; n--;
273         }
274         buffer = s;
275         len = n;
276         if ( dowrap && len )
277             putc ( '\n', statusfp );
278     } while ( len );
279
280     putc ('\n',statusfp);
281     fflush (statusfp);
282 }
283
284 void
285 write_status_buffer ( int no, const char *buffer, size_t len, int wrap )
286 {
287     write_status_text_and_buffer (no, NULL, buffer, len, wrap);
288 }
289
290
291
292 #ifdef USE_SHM_COPROCESSING
293
294 #ifndef IPC_RMID_DEFERRED_RELEASE
295 static void
296 remove_shmid( void )
297 {
298     if( shm_id != -1 ) {
299         shmctl ( shm_id, IPC_RMID, 0);
300         shm_id = -1;
301     }
302 }
303 #endif
304
305 void
306 init_shm_coprocessing ( ulong requested_shm_size, int lock_mem )
307 {
308     char buf[100];
309     struct shmid_ds shmds;
310
311   #ifndef IPC_RMID_DEFERRED_RELEASE
312     atexit( remove_shmid );
313   #endif
314     requested_shm_size = (requested_shm_size + 4095) & ~4095;
315     if ( requested_shm_size > 2 * 4096 )
316         log_fatal("too much shared memory requested; only 8k are allowed\n");
317     shm_size = 4096 /* one page for us */ + requested_shm_size;
318
319     shm_id = shmget( IPC_PRIVATE, shm_size, IPC_CREAT | 0700 );
320     if ( shm_id == -1 )
321         log_fatal("can't get %uk of shared memory: %s\n",
322                                 (unsigned)shm_size/1024, strerror(errno));
323
324   #if !defined(IPC_HAVE_SHM_LOCK) \
325       && defined(HAVE_MLOCK) && !defined(HAVE_BROKEN_MLOCK)
326     /* part of the old code which uses mlock */
327     shm_area = shmat( shm_id, 0, 0 );
328     if ( shm_area == (char*)-1 )
329         log_fatal("can't attach %uk shared memory: %s\n",
330                                 (unsigned)shm_size/1024, strerror(errno));
331     log_debug("mapped %uk shared memory at %p, id=%d\n",
332                             (unsigned)shm_size/1024, shm_area, shm_id );
333     if( lock_mem ) {
334       #ifdef USE_CAPABILITIES
335         cap_set_proc( cap_from_text("cap_ipc_lock+ep") );
336       #endif
337         /* (need the cast for Solaris with Sun's workshop compilers) */
338         if ( mlock ( (char*)shm_area, shm_size) )
339             log_info("locking shared memory %d failed: %s\n",
340                                 shm_id, strerror(errno));
341         else
342             shm_is_locked = 1;
343       #ifdef USE_CAPABILITIES
344         cap_set_proc( cap_from_text("cap_ipc_lock+p") );
345       #endif
346     }
347
348   #ifdef IPC_RMID_DEFERRED_RELEASE
349     if( shmctl( shm_id, IPC_RMID, 0) )
350         log_fatal("shmctl IPC_RMDID of %d failed: %s\n",
351                                             shm_id, strerror(errno));
352   #endif
353
354     if( shmctl( shm_id, IPC_STAT, &shmds ) )
355         log_fatal("shmctl IPC_STAT of %d failed: %s\n",
356                                             shm_id, strerror(errno));
357     if( shmds.shm_perm.uid != getuid() ) {
358         shmds.shm_perm.uid = getuid();
359         if( shmctl( shm_id, IPC_SET, &shmds ) )
360             log_fatal("shmctl IPC_SET of %d failed: %s\n",
361                                                 shm_id, strerror(errno));
362     }
363
364   #else /* this is the new code which handles the changes in the SHM semantics
365          * introduced with Linux 2.4.  The changes is that we now change the
366          * permissions and then attach to the memory.
367          */
368
369     if( lock_mem ) {
370       #ifdef USE_CAPABILITIES
371         cap_set_proc( cap_from_text("cap_ipc_lock+ep") );
372       #endif
373       #ifdef IPC_HAVE_SHM_LOCK
374         if ( shmctl (shm_id, SHM_LOCK, 0) )
375             log_info("locking shared memory %d failed: %s\n",
376                                 shm_id, strerror(errno));
377         else
378             shm_is_locked = 1;
379       #else
380         log_info("Locking shared memory %d failed: No way to do it\n", shm_id );
381       #endif
382       #ifdef USE_CAPABILITIES
383         cap_set_proc( cap_from_text("cap_ipc_lock+p") );
384       #endif
385     }
386
387     if( shmctl( shm_id, IPC_STAT, &shmds ) )
388         log_fatal("shmctl IPC_STAT of %d failed: %s\n",
389                                             shm_id, strerror(errno));
390     if( shmds.shm_perm.uid != getuid() ) {
391         shmds.shm_perm.uid = getuid();
392         if( shmctl( shm_id, IPC_SET, &shmds ) )
393             log_fatal("shmctl IPC_SET of %d failed: %s\n",
394                                                 shm_id, strerror(errno));
395     }
396
397     shm_area = shmat( shm_id, 0, 0 );
398     if ( shm_area == (char*)-1 )
399         log_fatal("can't attach %uk shared memory: %s\n",
400                                 (unsigned)shm_size/1024, strerror(errno));
401     log_debug("mapped %uk shared memory at %p, id=%d\n",
402                             (unsigned)shm_size/1024, shm_area, shm_id );
403
404   #ifdef IPC_RMID_DEFERRED_RELEASE
405     if( shmctl( shm_id, IPC_RMID, 0) )
406         log_fatal("shmctl IPC_RMDID of %d failed: %s\n",
407                                             shm_id, strerror(errno));
408   #endif
409
410   #endif
411     /* write info; Protocol version, id, size, locked size */
412     sprintf( buf, "pv=1 pid=%d shmid=%d sz=%u lz=%u", (int)getpid(),
413             shm_id, (unsigned)shm_size, shm_is_locked? (unsigned)shm_size:0 );
414     write_status_text( STATUS_SHM_INFO, buf );
415 }
416
417 /****************
418  * Request a string from client
419  * If bool, returns static string on true (do not free) or NULL for false
420  */
421 static char *
422 do_shm_get( const char *keyword, int hidden, int bool )
423 {
424     size_t n;
425     byte *p;
426     char *string;
427
428     if( !shm_area )
429         BUG();
430
431     shm_area[0] = 0;  /* msb of length of control block */
432     shm_area[1] = 32; /* and lsb */
433     shm_area[2] = 1;  /* indicate that we are waiting on a reply */
434     shm_area[3] = 0;  /* clear data available flag */
435
436     write_status_text( bool? STATUS_SHM_GET_BOOL :
437                        hidden? STATUS_SHM_GET_HIDDEN : STATUS_SHM_GET, keyword );
438
439     do {
440         pause_on_sigusr(1);
441         if( shm_area[0] || shm_area[1] != 32 || shm_area[2] != 1 )
442             log_fatal("client modified shm control block - abort\n");
443     } while( !shm_area[3] );
444     shm_area[2] = 0; /* reset request flag */
445     p = (byte*)shm_area+32;
446     n = p[0] << 8 | p[1];
447     p += 2;
448     if( n+32+2+1 > 4095 )
449         log_fatal("client returns too large data (%u bytes)\n", (unsigned)n );
450
451     if( bool )
452         return p[0]? "" : NULL;
453
454     string = hidden? m_alloc_secure( n+1 ) : m_alloc( n+1 );
455     memcpy(string, p, n );
456     string[n] = 0; /* make sure it is a string */
457     if( hidden ) /* invalidate the memory */
458         memset( p, 0, n );
459
460     return string;
461 }
462
463 #endif /* USE_SHM_COPROCESSING */
464
465 static int
466 myread(int fd, void *buf, size_t count)
467 {
468     int rc;
469     do {
470         rc = read( fd, buf, count );
471     } while ( rc == -1 && errno == EINTR );
472     if ( !rc && count ) {
473         static int eof_emmited=0;
474         if ( eof_emmited < 3 ) {
475             *(char*)buf = CONTROL_D;
476             rc = 1;
477             eof_emmited++;
478         }
479         else { /* Ctrl-D not caught - do something reasonable */
480           #ifdef HAVE_DOSISH_SYSTEM
481             raise (SIGINT);  /* nothing to hangup under DOS */
482           #else
483             raise (SIGHUP); /* no more input data */
484           #endif
485         }
486     }    
487     return rc;
488 }
489
490
491
492 /****************
493  * Request a string from the client over the command-fd
494  * If bool, returns static string on true (do not free) or NULL for false
495  */
496 static char *
497 do_get_from_fd( const char *keyword, int hidden, int bool )
498 {
499     int i, len;
500     char *string;
501
502     write_status_text( bool? STATUS_GET_BOOL :
503                        hidden? STATUS_GET_HIDDEN : STATUS_GET_LINE, keyword );
504
505     for( string = NULL, i = len = 200; ; i++ ) {
506         if( i >= len-1 ) {
507             char *save = string;
508             len += 100;
509             string = hidden? m_alloc_secure ( len ) : m_alloc ( len );
510             if( save )
511                 memcpy(string, save, i );
512             else
513                 i=0;
514         }
515         /* Hmmm: why not use our read_line function here */
516         if( myread( opt.command_fd, string+i, 1) != 1 || string[i] == '\n'  )
517             break;
518         else if ( string[i] == CONTROL_D ) {
519             /* found ETX - cancel the line and return a sole ETX */
520             string[0] = CONTROL_D;
521             i=1;
522             break;
523         }
524     }
525     string[i] = 0;
526
527     write_status( STATUS_GOT_IT );
528
529     if( bool )   /* Fixme: is this correct??? */
530         return string[0] == 'Y' ? "" : NULL;
531
532     return string;
533 }
534
535
536
537 int
538 cpr_enabled()
539 {
540     if( opt.command_fd != -1 )
541         return 1;
542   #ifdef USE_SHM_COPROCESSING
543     if( opt.shm_coprocess )
544         return 1;
545   #endif
546     return 0;
547 }
548
549 char *
550 cpr_get_no_help( const char *keyword, const char *prompt )
551 {
552     char *p;
553
554     if( opt.command_fd != -1 )
555         return do_get_from_fd ( keyword, 0, 0 );
556   #ifdef USE_SHM_COPROCESSING
557     if( opt.shm_coprocess )
558         return do_shm_get( keyword, 0, 0 );
559   #endif
560     for(;;) {
561         p = tty_get( prompt );
562         return p;
563     }
564 }
565
566 char *
567 cpr_get( const char *keyword, const char *prompt )
568 {
569     char *p;
570
571     if( opt.command_fd != -1 )
572         return do_get_from_fd ( keyword, 0, 0 );
573   #ifdef USE_SHM_COPROCESSING
574     if( opt.shm_coprocess )
575         return do_shm_get( keyword, 0, 0 );
576   #endif
577     for(;;) {
578         p = tty_get( prompt );
579         if( *p=='?' && !p[1] && !(keyword && !*keyword)) {
580             m_free(p);
581             display_online_help( keyword );
582         }
583         else
584             return p;
585     }
586 }
587
588
589 char *
590 cpr_get_utf8( const char *keyword, const char *prompt )
591 {
592     char *p;
593     p = cpr_get( keyword, prompt );
594     if( p ) {
595         char *utf8 = native_to_utf8( p );
596         m_free( p );
597         p = utf8;
598     }
599     return p;
600 }
601
602 char *
603 cpr_get_hidden( const char *keyword, const char *prompt )
604 {
605     char *p;
606
607     if( opt.command_fd != -1 )
608         return do_get_from_fd ( keyword, 1, 0 );
609   #ifdef USE_SHM_COPROCESSING
610     if( opt.shm_coprocess )
611         return do_shm_get( keyword, 1, 0 );
612   #endif
613     for(;;) {
614         p = tty_get_hidden( prompt );
615         if( *p == '?' && !p[1] ) {
616             m_free(p);
617             display_online_help( keyword );
618         }
619         else
620             return p;
621     }
622 }
623
624 void
625 cpr_kill_prompt(void)
626 {
627     if( opt.command_fd != -1 )
628         return;
629   #ifdef USE_SHM_COPROCESSING
630     if( opt.shm_coprocess )
631         return;
632   #endif
633     tty_kill_prompt();
634     return;
635 }
636
637 int
638 cpr_get_answer_is_yes( const char *keyword, const char *prompt )
639 {
640     int yes;
641     char *p;
642
643     if( opt.command_fd != -1 )
644         return !!do_get_from_fd ( keyword, 0, 1 );
645   #ifdef USE_SHM_COPROCESSING
646     if( opt.shm_coprocess )
647         return !!do_shm_get( keyword, 0, 1 );
648   #endif
649     for(;;) {
650         p = tty_get( prompt );
651         trim_spaces(p); /* it is okay to do this here */
652         if( *p == '?' && !p[1] ) {
653             m_free(p);
654             display_online_help( keyword );
655         }
656         else {
657             tty_kill_prompt();
658             yes = answer_is_yes(p);
659             m_free(p);
660             return yes;
661         }
662     }
663 }
664
665 int
666 cpr_get_answer_yes_no_quit( const char *keyword, const char *prompt )
667 {
668     int yes;
669     char *p;
670
671     if( opt.command_fd != -1 )
672         return !!do_get_from_fd ( keyword, 0, 1 );
673   #ifdef USE_SHM_COPROCESSING
674     if( opt.shm_coprocess )
675         return !!do_shm_get( keyword, 0, 1 );
676   #endif
677     for(;;) {
678         p = tty_get( prompt );
679         trim_spaces(p); /* it is okay to do this here */
680         if( *p == '?' && !p[1] ) {
681             m_free(p);
682             display_online_help( keyword );
683         }
684         else {
685             tty_kill_prompt();
686             yes = answer_is_yes_no_quit(p);
687             m_free(p);
688             return yes;
689         }
690     }
691 }
692