Initialize opt.session_env.
[gnupg.git] / g13 / g13.c
1 /* g13.c - Disk Key management with GnuPG
2  * Copyright (C) 2009 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 3 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, see <http://www.gnu.org/licenses/>.
18  */
19
20 #include <config.h>
21 #include <stdio.h>
22 #include <stdlib.h>
23 #include <string.h>
24 #include <errno.h>
25 #include <ctype.h>
26 #include <unistd.h>
27 #include <fcntl.h>
28 #include <pth.h>
29
30 #include "g13.h"
31
32 #include <gcrypt.h>
33 #include <assuan.h>
34
35 #include "i18n.h"
36 #include "sysutils.h"
37 #include "gc-opt-flags.h"
38 #include "keyblob.h"
39 #include "server.h"
40 #include "runner.h"
41 #include "create.h"
42 #include "mount.h"
43 #include "mountinfo.h"
44
45
46 enum cmd_and_opt_values {
47   aNull = 0,
48   oQuiet        = 'q',
49   oVerbose      = 'v',
50   oRecipient    = 'r',
51
52   aGPGConfList  = 500,
53   aGPGConfTest,
54   aCreate,
55   aMount,
56   aUmount,
57   aServer,
58
59   oOptions,
60   oDebug,
61   oDebugLevel,
62   oDebugAll,
63   oDebugNone,
64   oDebugWait,
65   oDebugAllowCoreDump,
66   oLogFile,
67   oNoLogFile,
68   oAuditLog,
69
70   oOutput,
71
72   oAgentProgram,
73   oGpgProgram,
74
75   oDisplay,
76   oTTYname,
77   oTTYtype,
78   oLCctype,
79   oLCmessages,
80   oXauthority,
81
82   oStatusFD,
83   oLoggerFD,
84
85   oNoVerbose,
86   oNoSecmemWarn,
87   oNoGreeting,
88   oNoTTY,
89   oNoOptions,
90   oHomedir,
91   oWithColons,
92   oDryRun,
93   oNoDetach,
94
95   oNoRandomSeedFile,
96   oFakedSystemTime
97  };
98
99
100 static ARGPARSE_OPTS opts[] = {
101
102   ARGPARSE_group (300, N_("@Commands:\n ")),
103
104   ARGPARSE_c (aCreate, "create", N_("Create a new file system container")),
105   ARGPARSE_c (aMount,  "mount",  N_("Mount a file system container") ),
106   ARGPARSE_c (aUmount, "umount", N_("Unmount a file system container") ),
107   ARGPARSE_c (aServer, "server", N_("Run in server mode")),
108
109   ARGPARSE_c (aGPGConfList, "gpgconf-list", "@"),
110   ARGPARSE_c (aGPGConfTest, "gpgconf-test", "@"),
111
112   ARGPARSE_group (301, N_("@\nOptions:\n ")),
113
114   ARGPARSE_s_s (oRecipient, "recipient", N_("|USER-ID|encrypt for USER-ID")),
115
116   ARGPARSE_s_s (oOutput, "output", N_("|FILE|write output to FILE")),
117   ARGPARSE_s_n (oVerbose, "verbose", N_("verbose")),
118   ARGPARSE_s_n (oQuiet, "quiet",  N_("be somewhat more quiet")),
119   ARGPARSE_s_n (oNoTTY, "no-tty", N_("don't use the terminal at all")),
120   ARGPARSE_s_n (oNoDetach, "no-detach", N_("do not detach from the console")),
121   ARGPARSE_s_s (oLogFile, "log-file",  N_("|FILE|write log output to FILE")),
122   ARGPARSE_s_n (oNoLogFile, "no-log-file", "@"),
123   ARGPARSE_s_i (oLoggerFD, "logger-fd", "@"),
124
125   ARGPARSE_s_n (oDryRun, "dry-run", N_("do not make any changes")),
126
127   ARGPARSE_s_s (oOptions, "options", N_("|FILE|read options from FILE")),
128
129   ARGPARSE_p_u (oDebug, "debug", "@"),
130   ARGPARSE_s_s (oDebugLevel, "debug-level",
131                 N_("|LEVEL|set the debugging level to LEVEL")),
132   ARGPARSE_s_n (oDebugAll, "debug-all", "@"),
133   ARGPARSE_s_n (oDebugNone, "debug-none", "@"),
134   ARGPARSE_s_i (oDebugWait, "debug-wait", "@"),
135   ARGPARSE_s_n (oDebugAllowCoreDump, "debug-allow-core-dump", "@"),
136
137   ARGPARSE_s_i (oStatusFD, "status-fd",
138                 N_("|FD|write status info to this FD")),
139
140   ARGPARSE_group (302, N_(
141   "@\n(See the man page for a complete listing of all commands and options)\n"
142   )),
143
144   ARGPARSE_group (303, N_("@\nExamples:\n\n"
145     " blurb\n"
146                           " blurb\n")),
147
148   /* Hidden options. */
149   ARGPARSE_s_n (oNoVerbose, "no-verbose", "@"),
150   ARGPARSE_s_n (oNoSecmemWarn, "no-secmem-warning", "@"), 
151   ARGPARSE_s_n (oNoGreeting, "no-greeting", "@"),
152   ARGPARSE_s_n (oNoOptions, "no-options", "@"),
153   ARGPARSE_s_s (oHomedir, "homedir", "@"),   
154   ARGPARSE_s_s (oAgentProgram, "agent-program", "@"),
155   ARGPARSE_s_s (oGpgProgram, "gpg-program", "@"),
156   ARGPARSE_s_s (oDisplay,    "display", "@"),
157   ARGPARSE_s_s (oTTYname,    "ttyname", "@"),
158   ARGPARSE_s_s (oTTYtype,    "ttytype", "@"),
159   ARGPARSE_s_s (oLCctype,    "lc-ctype", "@"),
160   ARGPARSE_s_s (oLCmessages, "lc-messages", "@"),
161   ARGPARSE_s_s (oXauthority, "xauthority", "@"),
162   ARGPARSE_s_s (oFakedSystemTime, "faked-system-time", "@"),
163   ARGPARSE_s_n (oWithColons, "with-colons", "@"),
164   ARGPARSE_s_n (oNoRandomSeedFile,  "no-random-seed-file", "@"),
165
166   /* Command aliases.  */
167
168   ARGPARSE_end ()
169 };
170
171
172 /* The timer tick interval used by the idle task.  */
173 #define TIMERTICK_INTERVAL_SEC     (1)
174
175
176 /* Global variable to keep an error count. */
177 int g13_errors_seen = 0;
178
179 /* It is possible that we are currently running under setuid permissions.  */
180 static int maybe_setuid = 1;
181
182 /* Helper to implement --debug-level and --debug.  */
183 static const char *debug_level;
184 static unsigned int debug_value;
185
186 /* Flag to indicate that a shutdown was requested.  */
187 static int shutdown_pending;
188
189 /* The thread id of the idle task.  */
190 static pth_t idle_task_tid;
191
192
193 \f
194 static void set_cmd (enum cmd_and_opt_values *ret_cmd,
195                      enum cmd_and_opt_values new_cmd );
196
197 static void emergency_cleanup (void);
198 static void start_idle_task (void);
199 static void join_idle_task (void);
200
201
202 \f
203 /* Begin Pth wrapper functions. */
204 ASSUAN_SYSTEM_PTH_IMPL;
205
206 GCRY_THREAD_OPTION_PTH_IMPL;
207 static int fixed_gcry_pth_init (void)
208 {
209   return pth_self ()? 0 : (pth_init () == FALSE) ? errno : 0;
210 }
211 /* End Pth wrapper functions. */
212
213
214 static const char *
215 my_strusage( int level )
216 {
217   const char *p;
218
219   switch (level)
220     {
221     case 11: p = "g13 (GnuPG)";
222       break;
223     case 13: p = VERSION; break;
224     case 17: p = PRINTABLE_OS_NAME; break;
225     case 19: p = _("Please report bugs to <" PACKAGE_BUGREPORT ">.\n");
226       break;
227     case 1:
228     case 40: p = _("Usage: g13 [options] [files] (-h for help)");
229       break;
230     case 41:
231       p = _("Syntax: g13 [options] [files]\n"
232             "Create, mount or unmount an encrypted file system container\n");
233       break;
234
235     case 31: p = "\nHome: "; break;
236     case 32: p = opt.homedir; break;
237      
238     default: p = NULL; break;
239     }
240   return p;
241 }
242
243
244 static void
245 wrong_args (const char *text)
246 {
247   fputs (_("usage: g13 [options] "), stderr);
248   fputs (text, stderr);
249   putc ('\n', stderr);
250   g13_exit (2);
251 }
252
253
254 /* Setup the debugging.  With a DEBUG_LEVEL of NULL only the active
255    debug flags are propagated to the subsystems.  With DEBUG_LEVEL
256    set, a specific set of debug flags is set; and individual debugging
257    flags will be added on top.  */
258 static void
259 set_debug (void)
260 {
261   if (!debug_level)
262     ;
263   else if (!strcmp (debug_level, "none"))
264     opt.debug = 0;
265   else if (!strcmp (debug_level, "basic"))
266     opt.debug = DBG_ASSUAN_VALUE|DBG_MOUNT_VALUE;
267   else if (!strcmp (debug_level, "advanced"))
268     opt.debug = DBG_ASSUAN_VALUE|DBG_MOUNT_VALUE;
269   else if (!strcmp (debug_level, "expert"))
270     opt.debug = (DBG_ASSUAN_VALUE|DBG_MOUNT_VALUE|DBG_CRYPTO_VALUE);
271   else if (!strcmp (debug_level, "guru"))
272     opt.debug = ~0;
273   else
274     {
275       log_error (_("invalid debug-level `%s' given\n"), debug_level);
276       g13_exit(2);
277     }
278
279   opt.debug |= debug_value;
280
281   if (opt.debug && !opt.verbose)
282     opt.verbose = 1;
283   if (opt.debug)
284     opt.quiet = 0;
285
286   if (opt.debug & DBG_CRYPTO_VALUE )
287     gcry_control (GCRYCTL_SET_DEBUG_FLAGS, 1);
288   gcry_control (GCRYCTL_SET_VERBOSITY, (int)opt.verbose);
289 }
290  
291
292
293 static void
294 set_cmd (enum cmd_and_opt_values *ret_cmd, enum cmd_and_opt_values new_cmd)
295 {
296   enum cmd_and_opt_values cmd = *ret_cmd;
297
298   if (!cmd || cmd == new_cmd)
299     cmd = new_cmd;
300   else 
301     {
302       log_error (_("conflicting commands\n"));
303       g13_exit (2);
304     }
305
306   *ret_cmd = cmd;
307 }
308
309
310 int
311 main ( int argc, char **argv)
312 {
313   ARGPARSE_ARGS pargs;
314   int orig_argc;
315   char **orig_argv;
316   gpg_error_t err;
317   const char *fname;
318   int may_coredump;
319   FILE *configfp = NULL;
320   char *configname = NULL;
321   unsigned configlineno;
322   int parse_debug = 0;
323   int no_more_options = 0;
324   int default_config =1;
325   char *logfile = NULL;
326   int greeting = 0;
327   int nogreeting = 0;
328   int debug_wait = 0;
329   int use_random_seed = 1;
330   int nodetach = 0;
331   int nokeysetup = 0;
332   enum cmd_and_opt_values cmd = 0;
333   struct server_control_s ctrl;
334   strlist_t recipients = NULL;
335
336   /*mtrace();*/
337
338   gnupg_reopen_std ("g13");
339   set_strusage (my_strusage);
340   gcry_control (GCRYCTL_SUSPEND_SECMEM_WARN);
341
342   log_set_prefix ("g13", 1);
343
344   /* Make sure that our subsystems are ready.  */
345   i18n_init ();
346   init_common_subsystems ();
347
348   /* Libgcrypt requires us to register the threading model first.
349      Note that this will also do the pth_init. */
350   gcry_threads_pth.init = fixed_gcry_pth_init;
351   err = gcry_control (GCRYCTL_SET_THREAD_CBS, &gcry_threads_pth);
352   if (err)
353     {
354       log_fatal ("can't register GNU Pth with Libgcrypt: %s\n",
355                  gpg_strerror (err));
356     }
357
358   /* Check that the Libgcrypt is suitable.  */
359   if (!gcry_check_version (NEED_LIBGCRYPT_VERSION) )
360     log_fatal (_("%s is too old (need %s, have %s)\n"), "libgcrypt", 
361                NEED_LIBGCRYPT_VERSION, gcry_check_version (NULL) );
362
363   /* Take extra care of the random pool.  */
364   gcry_control (GCRYCTL_USE_SECURE_RNDPOOL);
365
366   may_coredump = disable_core_dumps ();
367   
368   gnupg_init_signals (0, emergency_cleanup);
369   
370   create_dotlock (NULL); /* Register locking cleanup.  */
371
372   opt.session_env = session_env_new ();
373   if (!opt.session_env)
374     log_fatal ("error allocating session environment block: %s\n",
375                strerror (errno));
376
377   opt.homedir = default_homedir ();
378
379   /* First check whether we have a config file on the commandline.  */
380   orig_argc = argc;
381   orig_argv = argv;
382   pargs.argc = &argc;
383   pargs.argv = &argv;
384   pargs.flags= 1|(1<<6);  /* Do not remove the args, ignore version.  */
385   while (arg_parse( &pargs, opts))
386     {
387       if (pargs.r_opt == oDebug || pargs.r_opt == oDebugAll)
388         parse_debug++;
389       else if (pargs.r_opt == oOptions)
390         { /* Yes, there is one, so we do not try the default one but
391              read the config file when it is encountered at the
392              commandline.  */
393           default_config = 0;
394         }
395       else if (pargs.r_opt == oNoOptions)
396         default_config = 0; /* --no-options */
397       else if (pargs.r_opt == oHomedir)
398         opt.homedir = pargs.r.ret_str;
399     }
400
401   /* Initialize the secure memory. */
402   gcry_control (GCRYCTL_INIT_SECMEM, 16384, 0);
403   maybe_setuid = 0;
404
405   /* 
406      Now we are now working under our real uid 
407   */
408
409   /* Setup malloc hooks. */
410   {
411     struct assuan_malloc_hooks malloc_hooks;
412
413     malloc_hooks.malloc = gcry_malloc;
414     malloc_hooks.realloc = gcry_realloc;
415     malloc_hooks.free = gcry_free;
416     assuan_set_malloc_hooks (&malloc_hooks);
417   }
418   
419   /* Prepare libassuan.  */
420   assuan_set_assuan_log_prefix (log_get_prefix (NULL));
421   assuan_set_gpg_err_source (GPG_ERR_SOURCE_DEFAULT);
422   assuan_set_system_hooks (ASSUAN_SYSTEM_PTH);
423
424
425   /* Setup a default control structure for command line mode.  */
426   memset (&ctrl, 0, sizeof ctrl);
427   g13_init_default_ctrl (&ctrl);
428   ctrl.no_server = 1;
429   ctrl.status_fd = -1; /* No status output. */
430
431   /* Set the default option file */
432   if (default_config )
433     configname = make_filename (opt.homedir, "g13.conf", NULL);
434   
435   argc        = orig_argc;
436   argv        = orig_argv;
437   pargs.argc  = &argc;
438   pargs.argv  = &argv;
439   pargs.flags =  1;  /* Do not remove the args.  */
440
441  next_pass:
442   if (configname)
443     {
444       configlineno = 0;
445       configfp = fopen (configname, "r");
446       if (!configfp)
447         {
448           if (default_config)
449             {
450               if (parse_debug)
451                 log_info (_("NOTE: no default option file `%s'\n"), configname);
452             }
453           else 
454             {
455               log_error (_("option file `%s': %s\n"), 
456                          configname, strerror(errno));
457               g13_exit(2);
458             }
459           xfree (configname);
460           configname = NULL;
461         }
462       if (parse_debug && configname)
463         log_info (_("reading options from `%s'\n"), configname);
464       default_config = 0;
465     }
466   
467   while (!no_more_options 
468          && optfile_parse (configfp, configname, &configlineno, &pargs, opts))
469     {
470       switch (pargs.r_opt)
471         {
472         case aGPGConfList: 
473         case aGPGConfTest: 
474           set_cmd (&cmd, pargs.r_opt);
475           nogreeting = 1;
476           nokeysetup = 1;
477           break;
478
479         case aServer:
480         case aMount:
481         case aUmount:
482           nokeysetup = 1;
483         case aCreate:
484           set_cmd (&cmd, pargs.r_opt);
485           break;
486
487         case oOutput: opt.outfile = pargs.r.ret_str; break;
488
489         case oQuiet: opt.quiet = 1; break;
490         case oNoGreeting: nogreeting = 1; break;
491         case oNoTTY:  break;
492
493         case oDryRun: opt.dry_run = 1; break;
494
495         case oVerbose:
496           opt.verbose++;
497           gcry_control (GCRYCTL_SET_VERBOSITY, (int)opt.verbose);
498           break;
499         case oNoVerbose:
500           opt.verbose = 0;
501           gcry_control (GCRYCTL_SET_VERBOSITY, (int)opt.verbose);
502           break;
503
504         case oLogFile: logfile = pargs.r.ret_str; break;
505         case oNoLogFile: logfile = NULL; break;          
506
507         case oNoDetach: nodetach = 1; break;
508
509         case oDebug: debug_value |= pargs.r.ret_ulong; break;
510         case oDebugAll: debug_value = ~0; break;
511         case oDebugNone: debug_value = 0; break;
512         case oDebugLevel: debug_level = pargs.r.ret_str; break;
513         case oDebugWait: debug_wait = pargs.r.ret_int; break;
514         case oDebugAllowCoreDump:
515           may_coredump = enable_core_dumps ();
516           break;
517
518         case oStatusFD: ctrl.status_fd = pargs.r.ret_int; break;
519         case oLoggerFD: log_set_fd (pargs.r.ret_int ); break;
520
521         case oNoOptions: break; /* no-options */
522         case oOptions:
523           /* Config files may not be nested (silently ignore them).  */
524           if (!configfp)
525             {
526               xfree(configname);
527               configname = xstrdup (pargs.r.ret_str);
528               goto next_pass;
529             }
530           break;
531
532         case oHomedir: opt.homedir = pargs.r.ret_str; break;
533
534         case oAgentProgram: opt.agent_program = pargs.r.ret_str;  break;
535         case oGpgProgram: opt.gpg_program = pargs.r.ret_str;  break;
536         case oDisplay: opt.display = xstrdup (pargs.r.ret_str); break;
537         case oTTYname: opt.ttyname = xstrdup (pargs.r.ret_str); break;
538         case oTTYtype: opt.ttytype = xstrdup (pargs.r.ret_str); break;
539         case oLCctype: opt.lc_ctype = xstrdup (pargs.r.ret_str); break;
540         case oLCmessages: opt.lc_messages = xstrdup (pargs.r.ret_str); break;
541         case oXauthority: opt.xauthority = xstrdup (pargs.r.ret_str); break;
542           
543         case oFakedSystemTime:
544           {
545             time_t faked_time = isotime2epoch (pargs.r.ret_str); 
546             if (faked_time == (time_t)(-1))
547               faked_time = (time_t)strtoul (pargs.r.ret_str, NULL, 10);
548             gnupg_set_time (faked_time, 0);
549           }
550           break;
551
552         case oNoSecmemWarn: gcry_control (GCRYCTL_DISABLE_SECMEM_WARN); break;
553
554         case oNoRandomSeedFile: use_random_seed = 0; break;
555
556         case oRecipient: /* Store the encryption key.  */
557           add_to_strlist (&recipients, pargs.r.ret_str);
558           break;
559
560
561         default: 
562           pargs.err = configfp? ARGPARSE_PRINT_WARNING:ARGPARSE_PRINT_ERROR; 
563           break;
564         }
565     }
566
567   if (configfp)
568     {
569       fclose (configfp);
570       configfp = NULL;
571       /* Keep a copy of the config filename. */
572       opt.config_filename = configname;
573       configname = NULL;
574       goto next_pass;
575     }
576   xfree (configname);
577   configname = NULL;
578
579   if (!opt.config_filename)
580     opt.config_filename = make_filename (opt.homedir, "g13.conf", NULL);
581
582   if (log_get_errorcount(0))
583     g13_exit(2);
584
585   /* Now that we have the options parsed we need to update the default
586      control structure.  */
587   g13_init_default_ctrl (&ctrl);
588
589   if (nogreeting)
590     greeting = 0;
591   
592   if (greeting)
593     {
594       fprintf (stderr, "%s %s; %s\n",
595                strusage(11), strusage(13), strusage(14) );
596       fprintf (stderr, "%s\n", strusage(15) );
597     }
598
599   if (may_coredump && !opt.quiet)
600     log_info (_("WARNING: program may create a core file!\n"));
601
602   if (logfile)
603     {
604       log_set_file (logfile);
605       log_set_prefix (NULL, 1|2|4);
606     }
607
608   if (gnupg_faked_time_p ())
609     {
610       gnupg_isotime_t tbuf;
611
612       log_info (_("WARNING: running with faked system time: "));
613       gnupg_get_isotime (tbuf);
614       dump_isotime (tbuf);
615       log_printf ("\n");
616     }
617
618   /* Print any pending secure memory warnings.  */
619   gcry_control (GCRYCTL_RESUME_SECMEM_WARN);
620
621   /* Setup the debug flags for all subsystems.  */
622   set_debug ();
623
624   /* Install a regular exit handler to make real sure that the secure
625      memory gets wiped out.  */
626   if (atexit (emergency_cleanup))
627     {
628       log_error ("atexit failed\n");
629       g13_exit (2);
630     }
631
632   /* Terminate if we found any error until now.  */
633   if (log_get_errorcount(0))
634     g13_exit (2);
635   
636   /* Set the standard GnuPG random seed file.  */
637   if (use_random_seed) 
638     {
639       char *p = make_filename (opt.homedir, "random_seed", NULL);
640       gcry_control (GCRYCTL_SET_RANDOM_SEED_FILE, p);
641       xfree(p);
642     }
643   
644   /* Store given filename into FNAME. */
645   fname = argc? *argv : NULL;
646
647   /* Parse all given encryption keys.  This does a lookup of the keys
648      and stops if any of the given keys was not found. */
649 #if 0 /* Currently not implemented.  */  
650   if (!nokeysetup)
651     {
652       strlist_t sl;
653       int failed = 0;
654       
655       for (sl = recipients; sl; sl = sl->next)
656         if (check_encryption_key ())
657           failed = 1;
658       if (failed)
659         g13_exit (1);
660     }
661 #endif /*0*/ 
662  
663   /* Dispatch command.  */
664   switch (cmd)
665     {
666     case aGPGConfList: 
667       { /* List options and default values in the GPG Conf format.  */
668         char *config_filename_esc = percent_escape (opt.config_filename, NULL);
669
670         printf ("gpgconf-g13.conf:%lu:\"%s\n",
671                 GC_OPT_FLAG_DEFAULT, config_filename_esc);
672         xfree (config_filename_esc);
673
674         printf ("verbose:%lu:\n", GC_OPT_FLAG_NONE);
675         printf ("quiet:%lu:\n", GC_OPT_FLAG_NONE);
676         printf ("debug-level:%lu:\"none:\n", GC_OPT_FLAG_DEFAULT);
677         printf ("log-file:%lu:\n", GC_OPT_FLAG_NONE);
678       }
679       break;
680     case aGPGConfTest:
681       /* This is merely a dummy command to test whether the
682          configuration file is valid.  */
683       break;
684
685     case aServer:
686       {
687         start_idle_task ();
688         ctrl.no_server = 0;
689         err = g13_server (&ctrl);
690         if (err)
691           log_error ("server exited with error: %s <%s>\n",
692                      gpg_strerror (err), gpg_strsource (err));
693         else
694           shutdown_pending++;
695       }
696       break;
697
698     case aCreate: /* Create a new container. */
699       {
700         if (argc != 1) 
701           wrong_args ("--create filename");
702         start_idle_task ();
703         err = g13_create_container (&ctrl, argv[0], recipients);
704         if (err)
705           log_error ("error creating a new container: %s <%s>\n",
706                      gpg_strerror (err), gpg_strsource (err));
707         else
708           shutdown_pending++;
709       }
710       break;
711
712     case aMount: /* Mount a container. */
713       {
714         if (argc != 1 && argc != 2 ) 
715           wrong_args ("--mount filename [mountpoint]");
716         start_idle_task ();
717         err = g13_mount_container (&ctrl, argv[0], argc == 2?argv[1]:NULL);
718         if (err)
719           log_error ("error mounting container `%s': %s <%s>\n",
720                      *argv, gpg_strerror (err), gpg_strsource (err));
721       }
722       break;
723
724     default:
725       log_error (_("invalid command (there is no implicit command)\n"));
726       break;
727     }
728
729   if (!err)
730     join_idle_task ();
731
732   /* Cleanup.  */
733   g13_exit (0);
734   return 8; /*NOTREACHED*/
735 }
736
737
738 /* Note: This function is used by signal handlers!. */
739 static void
740 emergency_cleanup (void)
741 {
742   gcry_control (GCRYCTL_TERM_SECMEM );
743 }
744
745
746 void
747 g13_exit (int rc)
748 {
749   gcry_control (GCRYCTL_UPDATE_RANDOM_SEED_FILE);
750   if (opt.debug & DBG_MEMSTAT_VALUE)
751     {
752       gcry_control( GCRYCTL_DUMP_MEMORY_STATS );
753       gcry_control( GCRYCTL_DUMP_RANDOM_STATS );
754     }
755   if (opt.debug)
756     gcry_control (GCRYCTL_DUMP_SECMEM_STATS );
757   emergency_cleanup ();
758   rc = rc? rc : log_get_errorcount(0)? 2 : g13_errors_seen? 1 : 0;
759   exit (rc);
760 }
761
762
763 /* Store defaults into the per-connection CTRL object.  */
764 void
765 g13_init_default_ctrl (struct server_control_s *ctrl)
766 {
767   ctrl->conttype = CONTTYPE_ENCFS;
768 }
769
770
771 /* This function is called for each signal we catch.  It is run in the
772    main context or the one of a Pth thread and thus it is not
773    restricted in what it may do.  */
774 static void
775 handle_signal (int signo)
776 {
777   switch (signo)
778     {
779 #ifndef HAVE_W32_SYSTEM
780     case SIGHUP:
781       log_info ("SIGHUP received - re-reading configuration\n");
782       /* Fixme:  Not yet implemented.  */
783       break;
784       
785     case SIGUSR1:
786       log_info ("SIGUSR1 received - printing internal information:\n");
787       pth_ctrl (PTH_CTRL_DUMPSTATE, log_get_stream ());
788       mountinfo_dump_all ();
789       break;
790
791     case SIGUSR2:
792       log_info ("SIGUSR2 received - no action defined\n");
793       break;
794
795     case SIGTERM:
796       if (!shutdown_pending)
797         log_info ("SIGTERM received - shutting down ...\n");
798       else
799         log_info ("SIGTERM received - still %u runners active\n",
800                   runner_get_threads ());
801       shutdown_pending++;
802       if (shutdown_pending > 2)
803         {
804           log_info ("shutdown forced\n");
805           log_info ("%s %s stopped\n", strusage(11), strusage(13) );
806           g13_exit (0);
807         }
808       break;
809       
810     case SIGINT:
811       log_info ("SIGINT received - immediate shutdown\n");
812       log_info( "%s %s stopped\n", strusage(11), strusage(13));
813       g13_exit (0);
814       break;
815 #endif /*!HAVE_W32_SYSTEM*/
816       
817     default:
818       log_info ("signal %d received - no action defined\n", signo);
819     }
820 }
821
822
823 /* This ticker function is called about every TIMERTICK_INTERVAL_SEC
824    seconds. */
825 static void
826 handle_tick (void)
827 {
828   /* log_debug ("TICK\n"); */
829 }
830
831
832 /* The idle task.  We use a separate thread to do idle stuff and to
833    catch signals.  */
834 static void *
835 idle_task (void *dummy_arg)
836 {
837   sigset_t sigs;       /* The set of signals we want to catch.  */
838   pth_event_t ev;      /* The main event to catch signals.  */
839   pth_event_t time_ev; /* The time event.  */
840   int signo;           /* The number of a raised signal is stored here.  */
841
842   (void)dummy_arg;
843
844   /* Create the event to catch the signals. */
845 #ifndef HAVE_W32_SYSTEM
846   sigemptyset (&sigs );
847   sigaddset (&sigs, SIGHUP);
848   sigaddset (&sigs, SIGUSR1);
849   sigaddset (&sigs, SIGUSR2);
850   sigaddset (&sigs, SIGINT);
851   sigaddset (&sigs, SIGTERM);
852   pth_sigmask (SIG_UNBLOCK, &sigs, NULL);
853 #else
854   sigs = 0;
855 #endif
856   ev = pth_event (PTH_EVENT_SIGS, &sigs, &signo);
857
858   /* The time event neds to computed n tghe fly.  */
859   time_ev = NULL;
860
861   for (;;)
862     {
863       /* The shutdown flag allows us to terminate the idle task.  */
864       if (shutdown_pending)
865         {
866           runner_cancel_all ();
867
868           if (!runner_get_threads ())
869             break; /* ready */
870         }
871
872       /* Create a timeout event if needed.  To help with power saving
873          we syncronize the ticks to the next full second.  */
874       if (!time_ev)
875         {
876           pth_time_t nexttick;
877
878           nexttick = pth_timeout (TIMERTICK_INTERVAL_SEC, 0);
879           if (nexttick.tv_usec > 10)  /* Use a 10 usec threshhold.  */
880             {
881               nexttick.tv_sec++;
882               nexttick.tv_usec = 0;
883             }
884           time_ev = pth_event (PTH_EVENT_TIME, nexttick);
885         }
886
887       pth_event_concat (ev, time_ev, NULL);
888       pth_wait (ev);
889       pth_event_isolate (time_ev);
890
891       if (pth_event_occurred (ev))
892         {
893           handle_signal (signo);
894         }
895
896       if (time_ev && pth_event_occurred (time_ev))
897         {
898           pth_event_free (time_ev, PTH_FREE_ALL);
899           time_ev = NULL;
900           handle_tick ();
901         }
902     }
903
904   pth_event_free (ev, PTH_FREE_ALL);
905   if (time_ev)
906     pth_event_free (time_ev, PTH_FREE_ALL);
907   log_info (_("%s %s stopped\n"), strusage(11), strusage(13));
908   return NULL;
909 }
910
911
912 /* Start the idle task.   */
913 static void
914 start_idle_task (void)
915 {
916   pth_attr_t tattr;
917   pth_t tid;
918   
919   tattr = pth_attr_new ();
920   pth_attr_set (tattr, PTH_ATTR_JOINABLE, 1);
921   pth_attr_set (tattr, PTH_ATTR_STACK_SIZE, 64*1024);
922   pth_attr_set (tattr, PTH_ATTR_NAME, "idle-task");
923   
924   tid = pth_spawn (tattr, idle_task, NULL);
925   if (!tid)
926     {
927       log_fatal ("error starting idle task: %s\n", 
928                  gpg_strerror (gpg_error_from_syserror ()));
929       return; /*NOTREACHED*/
930     }
931   idle_task_tid = tid;
932   pth_attr_destroy (tattr);
933 }
934
935
936 /* Wait for the idle task to finish.  */
937 static void
938 join_idle_task (void)
939 {
940   if (idle_task_tid)
941     {
942       if (!pth_join (idle_task_tid, NULL))
943         log_error ("waiting for idle task thread failed: %s\n",
944                    gpg_strerror (gpg_error_from_syserror ()));
945     }
946 }
947