/mandos/trunk

To get this branch, use:
bzr branch http://bzr.recompile.se/loggerhead/mandos/trunk

« back to all changes in this revision

Viewing changes to mandos-ctl.xml

  • Committer: Teddy Hogeborn
  • Date: 2019-11-03 18:44:41 UTC
  • Revision ID: teddy@recompile.se-20191103184441-1vhjuf06hjqgfohh
mandos-monitor: Use Python's standard loggging module

* mandos-monitor: Use Python's standard loggging module, also for
                  warnings.  Suppress BytesWarning from urwid when
                  exiting.
  (log): New global logger object.  This replaces UserInterface
        log_message().
  (MandosClientWidget.__init__): Remove "logger" argument.
  (MandosClientWidget.using_timer): Wrap self.update_timer using new
                                    glib_safely() function.
  (glib_safely): New function to log any exceptions instead of letting
                 exceptions propagate up to GLib.
  (UserInterface.__init__): Remove "log_level" argument.  Set new
                            "loghandler" attribute, instance of new
                            "UILogHandler".
  (UserInterface.log_message): Removed.
  (UserInterface.log_message_raw): Renamed to "add_log_line"; all
                                   callers changed.  Also fix
                                   off-by-one error in max_log_length
                                   logic.
  (UserInterface.run): Add self.loghandler to logger "log". Wrap
                       self.process_input using new glib_safely()
                       function.
  (UserInterface.stop): Remove self.loghandler from logger "log".
  (UserInterface.process_input): Make verbosity toggle affect log
                                 level of logger "log".
  (UILogHandler): New.

Show diffs side-by-side

added added

removed removed

Lines of Context:
2
2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3
3
        "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4
4
<!ENTITY COMMANDNAME "mandos-ctl">
5
 
<!ENTITY TIMESTAMP "2019-03-09">
 
5
<!ENTITY TIMESTAMP "2019-07-29">
6
6
<!ENTITY % common SYSTEM "common.ent">
7
7
%common;
8
8
]>
557
557
  
558
558
  <refsect1 id="example">
559
559
    <title>EXAMPLE</title>
 
560
    <!-- Name of test methods in class Test_commands_from_options are
 
561
         written in comments below.  When adding an example, add a
 
562
         test too which tests the documented behavior. -->
560
563
    <informalexample>
 
564
      <!-- Test method: test_manual_page_example_1() -->
561
565
      <para>
562
566
        To list all clients:
563
567
      </para>
567
571
    </informalexample>
568
572
    
569
573
    <informalexample>
 
574
      <!-- Test method: test_manual_page_example_2() -->
570
575
      <para>
571
576
        To list <emphasis>all</emphasis> settings for the clients
572
577
        named <quote>foo1.example.org</quote> and <quote
581
586
    </informalexample>
582
587
    
583
588
    <informalexample>
 
589
      <!-- Test method: test_manual_page_example_3() -->
584
590
      <para>
585
591
        To enable all clients:
586
592
      </para>
590
596
    </informalexample>
591
597
    
592
598
    <informalexample>
 
599
      <!-- Test method: test_manual_page_example_4() -->
593
600
      <para>
594
601
        To change timeout and interval value for the clients
595
602
        named <quote>foo1.example.org</quote> and <quote
598
605
      <para>
599
606
 
600
607
<!-- do not wrap this line -->
601
 
<userinput>&COMMANDNAME; --timeout="PT5M" --interval="PT1M" foo1.example.org foo2.example.org</userinput>
 
608
<userinput>&COMMANDNAME; --timeout=PT5M --interval=PT1M foo1.example.org foo2.example.org</userinput>
602
609
 
603
610
      </para>
604
611
    </informalexample>
605
612
    
606
613
    <informalexample>
 
614
      <!-- Test method: test_manual_page_example_5() -->
607
615
      <para>
608
 
        To approve all clients currently waiting for it:
 
616
        To approve all clients currently waiting for approval:
609
617
      </para>
610
618
      <para>
611
619
        <userinput>&COMMANDNAME; --approve --all</userinput>