Changeset 507

Show
Ignore:
Timestamp:
05/29/08 10:37:05 (7 months ago)
Author:
mgoldman
Message:

First draft writeup of functionality of manager.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved
  • branches/trunk-pmd-intproto/test/manager.tests

    r506 r507  
     1Manager Commands 
     2 
     3* add 
     4* update 
     5* status 
     6        - Requests the last known enforcing status of a node (or group 
     7          of nodes) from the master server. 
     8        - arguments: 
     9                - <none> 
     10                        - return all known nodes and the last enforcing status 
     11                          known on that node 
     12                - IP <list of ips> 
     13                        - For each node in the list, return the last known 
     14                          enforcing status. 
     15                - group <list of groups> 
     16                        - For each node in each listed group, return the last 
     17                          known enforcing status. 
     18* list 
     19        - lists one of several items of interest to a manager (human) 
     20        - arguments: 
     21                - <none> 
     22                        - TODO: should print useage? 
     23                - groups 
     24                        - lists all groups the master knows about. 
     25                - clients 
     26                        - reachable 
     27                                - CHECK: lists live clients 
     28                        - update 
     29                                - CHECK: lists clients needing update 
     30                        - in <group> 
     31                                - lists clients in <group> 
     32* log 
     33        - retrieves log messages 
     34        - arguments: 
     35                - all [(IP|group) <list>] 
     36                        - lists all logs directly from either all active clients 
     37                          or those clients from the optional IP or group list. 
     38                - delta [(IP|group) <list>] 
     39                        - lists the log deltas that do not yet exist on the 
     40                          server from either all clients or from the optional IP 
     41                          or group list 
     42                - query [(time <int low> <int high>  
     43                                | IP <ip>  
     44                                | group <group name>)] 
     45                        - looks up all messages on the server that match the 
     46                          specified query.  Multiple conditions may be used in a 
     47                          list. 
     48                                - time <int low> <int high> 
     49                                        - logs between low and high inclusive 
     50                                        - time in seconds since the epoch 
     51                                - IP <ip> 
     52                                        - multiple IP statements may be used 
     53                                        - IPs are added to the set of desired IPs 
     54                                - group <groupname> 
     55                                        - multiple group statements may be used 
     56                                        - groups are added to the set of desired groups 
     57                        - example query: 
     58                                * IP a IP b group foo group bar time 10 20 
     59                          log message has to come from (a|b) and (foo|bar) and 
     60                          10 <= timestamp <= 20 
     61* bools 
     62        - retrieves booleans from the server 
     63        - arguments 
     64                - <none> 
     65                        - retrieves all the booleans from all known clients 
     66                - IP <list> 
     67                        - retrieves booleans from all clients listed 
     68                - group <list> 
     69                        - retrieves all booleans from all clients in each group 
     70                          listed. 
     71 
     72# vim:tw=68 ts=4 foldmethod=indent