trisulrp 3.2.13 → 3.2.27

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: d418f25fea2c8eaed993c659026c8e8217095bbb
-  data.tar.gz: 00601201b5c7878cf9fb719891ed71327100b797
+SHA256:
+  metadata.gz: 71c5b47d633207231c302542e8735d5a5a907569333dab8da436811cf451174a
+  data.tar.gz: 44c22ab4987836e91017194f01735909e80d5ec0665fec2e45daa0ba2f8beb32
 SHA512:
-  metadata.gz: 6604ebee90f6e960e9609e228f93abbabe94922aae71bf84782346f8c4c84e9c32c17a18f30952fb46ca167282684d30d6b957894b75decbaf7aa35a309c64ac
-  data.tar.gz: 3d9404aab2c1f12462c48bde1714022724ea62f4c225fe5a7106f11e92194827caf8a9b0aa1d60d9dd2b350253df6fea072a1ad5d7e4b24c70eeef476e69698b
+  metadata.gz: 5f521b245139593bf1339c3d59049c16162bc1df790f3d0790eba484d2501cd19018759c90c4323075886d8c35ef98ccd6d7118c215eb9c4cbc45f18322b0a22
+  data.tar.gz: 652d8c13e1d4ce1e8c4fd4e9bc632a961db575adb32267143b89c6aecebc2668c2287b5689efd3f5fe9d15b9039bfcd112d64915cdac9c77d464f06dd7ebcecb

data/README.rdoc

@@ -16,9 +16,12 @@ Key Features :
 
 * TRP Documentation and Tutorials  http://trisul.org/docs/trp/index.html
 * Getting started tutorial http://trisul.org/docs/trp/trpgemsteps.html
-* Github repo of sample scripts  https://github.com/vivekrajan/trisul-scripts
+* Github repo of sample scripts  https://github.com/trisulnsm/trisul-scripts/trp
 
 
+== Generating the ruby protobuf definitions 
+protoc --ruby_out=. trp.proto
+
 == Contributing to trisulrp
  
 * Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
@@ -31,5 +34,6 @@ Key Features :
 
 == Copyright
 
-Copyright (c) 2010-12 Unleash Networks. See LICENSE.txt for further details.
+License MIT 
+Copyright (c) 2010-2021 Unleash Networks. See LICENSE.txt for further details.
 

data/Rakefile

@@ -1,3 +1,4 @@
+$SAFE=0
 require 'rubygems'
 require 'bundler'
 begin

data/VERSION

@@ -1 +1 @@
-3.2.13
+3.2.27

data/lib/trisulrp/protocol.rb

@@ -335,6 +335,32 @@ module TrisulRP::Protocol
     return  tint
   end
 
+
+  # Helper iterate through each time interval in reverse order 
+  #
+  # [endpoint]  - the ZMQ endpoint
+  #
+  # ==== Returns
+  # ==== Yields
+  # [time_interval,  id, total_intervals] A TRP::TimeInterval object which can be attached to any :time_interval field of a TRP request
+  #
+  #
+  def each_time_interval(zmq_endpt)
+
+    req=mk_request(TRP::Message::Command::TIMESLICES_REQUEST )
+    get_response_zmq(zmq_endpt,req) do |resp|
+
+     slice_id = 0
+     total_slices = resp.slices.size 
+
+     resp.slices.reverse_each do | slc |
+        yield slc.time_interval, slice_id, total_slices
+        slice_id=slice_id+1 
+      end 
+    end
+  end
+
+
   # Helper to allow assinging string to KeyT field
   #
   # instead of  
@@ -520,6 +546,12 @@ module TrisulRP::Protocol
     when TRP::Message::Command::GRAPH_REQUEST
 	  fix_TRP_Fields( TRP::GraphRequest, params)
       req.graph_request = TRP::GraphRequest.new(params)
+    when TRP::Message::Command::RUNTOOL_REQUEST
+	  fix_TRP_Fields( TRP::RunToolRequest, params)
+      req.run_tool_request = TRP::RunToolRequest.new(params)
+    when TRP::Message::Command::TOOL_INFO_REQUEST
+	  fix_TRP_Fields( TRP::ToolInfoRequest, params)
+      req.tool_info_request = TRP::ToolInfoRequest.new(params)
     else
       raise "Unknown TRP command ID"
     end
@@ -619,6 +651,10 @@ module TrisulRP::Protocol
         resp.file_response
     when TRP::Message::Command::GRAPH_RESPONSE
         resp.graph_response
+    when TRP::Message::Command::RUNTOOL_RESPONSE
+        resp.run_tool_response
+    when TRP::Message::Command::TOOL_INFO_RESPONSE
+        resp.tool_info_response
     else
       raise "#{resp.trp_command.to_i} Unknown TRP command ID"
     end

data/lib/trisulrp/trp.pb.rb

@@ -165,6 +165,13 @@ module TRP
       define :GRAPH_RESPONSE, 131
       define :AGGREGATE_SESSIONS_REQUEST, 132
       define :AGGREGATE_SESSIONS_RESPONSE, 133
+      define :RUNTOOL_REQUEST, 134
+      define :RUNTOOL_RESPONSE, 135
+      define :HA_CONTROL_REQUEST, 140
+      define :HA_CONTROL_RESPONSE, 141
+      define :DOMAIN_PING, 142
+      define :TOOL_INFO_REQUEST, 143
+      define :TOOL_INFO_RESPONSE, 144
     end
 
   end
@@ -186,6 +193,7 @@ module TRP
   class AggregateSessionsRequest < ::Protobuf::Message; end
   class AggregateSessionsResponse < ::Protobuf::Message
     class KeyTCount < ::Protobuf::Message; end
+    class TagGroup < ::Protobuf::Message; end
 
   end
 
@@ -245,6 +253,18 @@ module TRP
 
   end
 
+  class HAControlRequest < ::Protobuf::Message
+    class HAOperation < ::Protobuf::Enum
+      define :HA_TEST_REACHABILITY, 0
+      define :HA_SWITCH_BACKUP, 1
+      define :HA_SWITCH_PRIMARY, 2
+    end
+
+  end
+
+  class HAControlResponse < ::Protobuf::Message; end
+  class ToolInfoRequest < ::Protobuf::Message; end
+  class ToolInfoResponse < ::Protobuf::Message; end
   class NodeConfigRequest < ::Protobuf::Message
     class IntelFeed < ::Protobuf::Message; end
 
@@ -283,6 +303,18 @@ module TRP
   class FileResponse < ::Protobuf::Message; end
   class GraphRequest < ::Protobuf::Message; end
   class GraphResponse < ::Protobuf::Message; end
+  class RunToolRequest < ::Protobuf::Message
+    class NodeTool < ::Protobuf::Enum
+      define :PING, 1
+      define :DF, 2
+      define :GEOQUERY, 3
+      define :TOP, 4
+      define :BGPQUERY, 5
+    end
+
+  end
+
+  class RunToolResponse < ::Protobuf::Message; end
 
 
   ##
@@ -348,6 +380,9 @@ module TRP
     optional :string, :description, 4
     optional :int64, :metric, 5
     repeated ::TRP::KeyT::NameValueT, :attributes, 6
+    optional :int64, :metric_max, 7
+    optional :int64, :metric_min, 8
+    optional :int64, :metric_avg, 9
   end
 
   class CounterGroupT
@@ -520,6 +555,12 @@ module TRP
     optional ::TRP::AggregateSessionsResponse, :aggregate_sessions_response, 141
     optional ::TRP::AggregateResourcesRequest, :aggregate_resources_request, 142
     optional ::TRP::AggregateResourcesResponse, :aggregate_resources_response, 143
+    optional ::TRP::RunToolRequest, :run_tool_request, 144
+    optional ::TRP::RunToolResponse, :run_tool_response, 145
+    optional ::TRP::HAControlRequest, :ha_control_request, 150
+    optional ::TRP::HAControlResponse, :ha_control_response, 151
+    optional ::TRP::ToolInfoRequest, :tool_info_request, 152
+    optional ::TRP::ToolInfoResponse, :tool_info_response, 153
     optional :string, :destination_node, 200
     optional :string, :probe_id, 201
     optional :bool, :run_async, 202
@@ -535,6 +576,8 @@ module TRP
     optional :string, :station_id_request, 2
     optional :string, :message, 3
     optional :int64, :local_timestamp, 4
+    optional :string, :local_timestamp_string, 5
+    optional :bool, :is_primary, 6
   end
 
   class ErrorResponse
@@ -554,6 +597,7 @@ module TRP
     required ::TRP::KeyT, :key, 4
     required ::TRP::TimeInterval, :time_interval, 5
     optional :int64, :volumes_only, 6, :default => 0
+    optional :bool, :get_key_attributes, 7, :default => false
   end
 
   class CounterItemResponse
@@ -561,6 +605,9 @@ module TRP
     required ::TRP::KeyT, :key, 2
     optional ::TRP::StatsArray, :totals, 3
     repeated ::TRP::StatsArray, :stats, 4
+    optional ::TRP::StatsArray, :maximums, 5
+    optional ::TRP::StatsArray, :minimums, 6
+    optional ::TRP::StatsArray, :samples, 8
   end
 
   class CounterGroupTopperRequest
@@ -571,6 +618,9 @@ module TRP
     optional ::TRP::Timestamp, :time_instant, 6
     optional :int64, :flags, 7
     optional :bool, :resolve_keys, 8, :default => true
+    optional :string, :key_filter, 9
+    optional :string, :inverse_key_filter, 10
+    optional :bool, :get_key_attributes, 11, :default => false
   end
 
   class CounterGroupTopperResponse
@@ -629,6 +679,7 @@ module TRP
     optional :bool, :resolve_keys, 21, :default => true
     optional :string, :outputpath, 22
     repeated :string, :idlist, 23
+    optional ::TRP::KeyT, :any_nf_ifindex, 24
   end
 
   class QuerySessionsResponse
@@ -655,7 +706,8 @@ module TRP
     optional :string, :subnet_24, 17
     optional :string, :subnet_16, 18
     optional :int64, :aggregate_topcount, 19, :default => 100
-    optional :string, :group_by_fields, 20
+    repeated :string, :group_by_fields, 20
+    optional ::TRP::KeyT, :any_nf_ifindex, 21
   end
 
   class AggregateSessionsResponse
@@ -665,6 +717,11 @@ module TRP
       required :int64, :metric, 3
     end
 
+    class TagGroup
+      required :string, :group_name, 1
+      repeated ::TRP::AggregateSessionsResponse::KeyTCount, :tag_metrics, 2
+    end
+
     required :string, :session_group, 2
     optional ::TRP::TimeInterval, :time_interval, 3
     repeated ::TRP::AggregateSessionsResponse::KeyTCount, :source_ip, 5
@@ -683,11 +740,14 @@ module TRP
     repeated ::TRP::AggregateSessionsResponse::KeyTCount, :internal_port, 18
     repeated ::TRP::AggregateSessionsResponse::KeyTCount, :internal_ip, 19
     repeated ::TRP::AggregateSessionsResponse::KeyTCount, :external_ip, 20
+    repeated ::TRP::AggregateSessionsResponse::TagGroup, :tag_group, 21
   end
 
   class UpdateKeyRequest
     required :string, :counter_group, 2
     repeated ::TRP::KeyT, :keys, 4
+    optional :bool, :remove_all_attributes, 5
+    repeated :string, :remove_attributes, 6
   end
 
   class SessionTrackerRequest
@@ -805,6 +865,8 @@ module TRP
     optional :int64, :meter, 3, :default => 0
     optional :int64, :maxitems, 4, :default => 100
     optional ::TRP::TimeInterval, :time_interval, 5
+    optional :string, :key_filter, 6
+    optional :string, :inverse_key_filter, 7
   end
 
   class TopperTrendResponse
@@ -920,6 +982,7 @@ module TRP
       optional :string, :extra_info, 4
       optional ::TRP::Timestamp, :register_time, 5
       optional ::TRP::Timestamp, :heartbeat_time, 6
+      optional :bool, :is_primary, 7, :default => true
     end
 
     required ::TRP::DomainOperation, :cmd, 1
@@ -929,12 +992,39 @@ module TRP
     optional :bool, :need_reconnect, 5, :default => false
   end
 
+  class HAControlRequest
+    required ::TRP::HAControlRequest::HAOperation, :cmd, 1
+    optional :string, :station_id, 2
+    optional :string, :params, 3
+  end
+
+  class HAControlResponse
+    optional :bool, :control_success, 1
+    optional :string, :station_id, 2
+    optional :string, :status_message, 3
+    optional :bool, :primary_reachable, 4
+    optional :bool, :backup_reachable, 5
+  end
+
+  class ToolInfoRequest
+    optional :string, :context_name, 1
+    optional :string, :tool_name, 2
+    repeated :string, :tool_info_requested, 3
+  end
+
+  class ToolInfoResponse
+    repeated ::TRP::NameValue, :tool_info, 1
+  end
+
   class NodeConfigRequest
     class IntelFeed
       required :string, :guid, 1
       optional :string, :name, 2
       optional :string, :download_rules, 3
       repeated :string, :uri, 4
+      repeated :string, :usernodes, 5
+      optional :int64, :sub_feed_id, 6, :default => -1
+      optional :bool, :restore_mode, 7, :default => false
     end
 
     optional :string, :message, 1
@@ -942,6 +1032,7 @@ module TRP
     optional ::TRP::NodeConfigRequest::IntelFeed, :process_new_feed, 3
     optional :bool, :get_all_nodes, 4, :default => true
     repeated ::TRP::NameValue, :query_config, 5
+    optional ::TRP::NodeConfigRequest::IntelFeed, :remove_feed, 6
   end
 
   class NodeConfigResponse
@@ -967,6 +1058,7 @@ module TRP
   class ContextInfoRequest
     optional :string, :context_name, 1
     optional :bool, :get_size_on_disk, 2, :default => false
+    optional :string, :tool_name, 3
   end
 
   class ContextInfoResponse
@@ -1144,5 +1236,17 @@ module TRP
     repeated ::TRP::EdgeGraphT, :graphs, 3
   end
 
+  class RunToolRequest
+    required :string, :context_name, 1
+    required ::TRP::RunToolRequest::NodeTool, :tool, 2
+    optional :string, :tool_input, 3
+    optional :string, :tool_input_file_data, 4
+  end
+
+  class RunToolResponse
+    required :string, :context_name, 1
+    optional :string, :tool_output, 2
+  end
+
 end
 

data/lib/trisulrp/trp.proto

@@ -107,6 +107,9 @@ message KeyT {
 		required string		attr_value=2;
 	}
 	repeated NameValueT		attributes=6;			/// New: Attributes are NVP for keys 
+    optional int64          metric_max=7;           /// optional : max observed value for metric  in context
+    optional int64          metric_min=8;           /// optional : max observed value for metric 
+    optional int64          metric_avg=9;           /// optional : max observed value for metric 
 }
 
 
@@ -350,6 +353,14 @@ message Message {
                     GRAPH_RESPONSE=131;
                     AGGREGATE_SESSIONS_REQUEST=132;                     
                     AGGREGATE_SESSIONS_RESPONSE=133;
+                    RUNTOOL_REQUEST=134;
+                    RUNTOOL_RESPONSE=135;
+                    HA_CONTROL_REQUEST=140;
+                    HA_CONTROL_RESPONSE=141;
+					DOMAIN_PING=142;
+					TOOL_INFO_REQUEST=143;
+					TOOL_INFO_RESPONSE=144;
+
     }
 
     required Command    trp_command=1;
@@ -417,6 +428,12 @@ message Message {
     optional AggregateSessionsResponse  aggregate_sessions_response=141;
     optional AggregateResourcesRequest  aggregate_resources_request=142;
     optional AggregateResourcesResponse  aggregate_resources_response=143;
+    optional RunToolRequest  run_tool_request=144;
+    optional RunToolResponse  run_tool_response=145;
+    optional HAControlRequest  ha_control_request=150;
+    optional HAControlResponse  ha_control_response=151;
+    optional ToolInfoRequest  tool_info_request=152;
+    optional ToolInfoResponse  tool_info_response=153;
     optional string     destination_node=200;   // todo move 2nd
     optional string     probe_id=201;           // todo move 3rd 
     optional bool       run_async=202;          /// if run_async = true, then you will immediately get a AsynResponse with a token you can poll 
@@ -443,6 +460,8 @@ message HelloResponse{
   optional string       station_id_request=2;   /// station id found in the request 
   optional string       message=3;              /// message found in the request 
   optional int64        local_timestamp=4;      /// local timestamp at server, used to detect drifts 
+  optional string       local_timestamp_string=5; /// on server with time zone, use this 
+  optional bool         is_primary=6;              /// is this a primary or HA node 
 }
 
 /// ErrorResponse
@@ -469,6 +488,7 @@ message CounterItemRequest{
     required KeyT           key=4;                          /// key (can specify key.key, key.label, etc too 
     required TimeInterval   time_interval=5;                /// Time interval for query
     optional int64          volumes_only=6 [default=0];     /// if '1' ; then only retrieves totals for each meter 
+	optional bool			get_key_attributes=7 [default=false]; /// if true, response keys get key_attributes as well 
 }
 
 /// CounterItemResponse  - 
@@ -477,6 +497,9 @@ message CounterItemResponse{
     required KeyT           key=2;                          /// key : filled up with readable,label automatically 
     optional StatsArray     totals=3;                       /// if volumes_only = 1 in request, this contains totals for each metric 
     repeated StatsArray     stats=4;                        /// time series stats - can use to draw charts etc 
+    optional StatsArray     maximums=5;                     /// if volumes_only = 1  this contains MAX(..) 
+    optional StatsArray     minimums=6;                     /// if volumes_only = 1  this contains MIN(..)
+    optional StatsArray     samples=8;                 		/// if volumes_only = 1  this contains SAMPLES(..) 
 }
 
 
@@ -489,6 +512,11 @@ message CounterGroupTopperRequest{
     optional Timestamp      time_instant=6;                 /// 
     optional int64          flags=7;                        
     optional bool           resolve_keys=8 [default=true];  /// retrieve labels as set in the response for each key 
+	optional string			key_filter=9;					/// only get keys with this pattern and SYS:GROUP
+	optional string			inverse_key_filter=10;			/// only get keys without this pattern  NOT
+	optional bool			get_key_attributes=11 [default=false]; 
+															/// if true, response keys get key_attributes as well 
+
 }
 
 /// CounterGroupTopperResponse  
@@ -543,7 +571,7 @@ message QuerySessionsRequest {
     optional KeyT           dest_ip=7;
     optional KeyT           dest_port=8;
     optional KeyT           any_ip=9;           /// source or dest match
-    optional KeyT           any_port=10;            /// source or dest match
+    optional KeyT           any_port=10;        /// source or dest match
     repeated KeyT           ip_pair=11;         /// array of 2 ips 
     optional KeyT           protocol=12;
     optional string         flowtag=13;         /// string flow tagger text 
@@ -557,6 +585,7 @@ message QuerySessionsRequest {
     optional bool           resolve_keys=21[default=true];  
     optional string         outputpath=22;      /// write results to a file (CSV) on trisul-hub (for very large dumps) 
     repeated string         idlist=23;          /// array of flow ids , usually from SessionTracker response 
+    optional KeyT           any_nf_ifindex=24;  /// composite query for both ifindex 
 }
 
 
@@ -590,7 +619,8 @@ message AggregateSessionsRequest {
     optional string         subnet_24=17;       /// ip /24 subnet  matching 
     optional string         subnet_16=18;       /// ip /16 subnet 
     optional int64          aggregate_topcount=19[default=100];   	/// number of count-star per field 
-	optional string         group_by_fields=20; /// list of field names 
+	repeated string         group_by_fields=20; /// list of field names 
+    optional KeyT           any_nf_ifindex=21;  /// matches either gen2 or gen3 
 }
 
 /// AggregateSessionsResponse 
@@ -603,6 +633,11 @@ message AggregateSessionsResponse {
 		required int64  metric=3;               ///  aggregated metrics, eg total bytes 
 	}
 
+	message TagGroup {
+		required string 	group_name=1;
+		repeated KeyTCount	tag_metrics=2;
+	}
+
     required string         session_group=2;
     optional TimeInterval   time_interval=3;
     repeated KeyTCount      source_ip=5;        /// top IPs 
@@ -621,13 +656,17 @@ message AggregateSessionsResponse {
     repeated KeyTCount      internal_port=18;   /// internal IP ports
     repeated KeyTCount      internal_ip=19;     /// internal IPs 
     repeated KeyTCount      external_ip=20;     /// external IPs
+	repeated TagGroup		tag_group=21;		/// tag groups 
 }
 
+
 /// UpdatekeysRequest
 /// Response = OKResponse or ErrorResponse
 message UpdateKeyRequest{
     required string         counter_group=2;
-    repeated KeyT           keys=4;  		/// key  : if you set both key and label, the DB label will be updated 
+    repeated KeyT           keys=4;  		         /// key  : if you set both key and label, the DB label will be updated 
+	optional bool           remove_all_attributes=5; /// remove all key attributes from keys 
+	repeated string         remove_attributes=6;     /// remove these attributes only from keys 
 }
 
 /// SessionTrackerRequest  - query session trackers 
@@ -775,6 +814,8 @@ message TopperTrendRequest {
     optional int64          meter=3 [default=0];
     optional int64          maxitems=4 [default=100];
     optional TimeInterval   time_interval=5;
+	optional string			key_filter=6;					/// only get keys with this pattern and SYS:GROUP
+	optional string			inverse_key_filter=7;			/// only get keys without this pattern  NOT
 }
 
 /// TopperTrendResponse   
@@ -841,9 +882,16 @@ message QueryFTSResponse {
 /// get the METERS METASLICE info 
 /// .. response = TimeSlicesResponse
 message TimeSlicesRequest  {
-    optional bool   get_disk_usage=1[default=false];
-    optional bool   get_all_engines=2[default=false];
-    optional bool   get_total_window=3[default=false];
+    optional bool   get_disk_usage=1[default=false];     /// get disk usage per SLICE 
+
+    optional bool   get_all_engines=2[default=false];    /// by default (set to false) we only get instance-0 
+	                                                     /// because are interested in iterating over 
+														 /// the time interval rather then each slice
+														 /// inside the time interval. set this to true
+														 /// if you want each slice to be reported 
+
+    optional bool   get_total_window=3[default=false];   /// just get the total time window in the 
+	                                                     /// trisul database 
 }
 
 /// .. response = TimeSlicesResponse
@@ -943,6 +991,7 @@ message DomainResponse {
         optional string             extra_info=4;
         optional Timestamp          register_time=5; 
         optional Timestamp          heartbeat_time=6; 
+		optional bool               is_primary=7[default=true]; /// primary or backup HA mode 
 
     }
 
@@ -953,22 +1002,62 @@ message DomainResponse {
     optional bool                   need_reconnect=5[default=false];
 }
 
+/// messages to HAControl
+message HAControlRequest {
+    enum HAOperation
+    {
+        HA_TEST_REACHABILITY=0;		///  test if primary or backup is reachable (test the other side)
+        HA_SWITCH_BACKUP=1;			///  switch all nodes to backup HA 
+        HA_SWITCH_PRIMARY=2;        ///  switch to primary HA 
+    }
+
+
+    required    HAOperation         cmd=1;
+    optional    string              station_id=2;
+    optional    string              params=3;
+}
+
+message HAControlResponse {
+    optional    bool                control_success=1;
+    optional    string              station_id=2;
+    optional    string              status_message=3;
+	optional    bool                primary_reachable=4;
+	optional    bool                backup_reachable=5;
+}
+
+/// tool info 
+/// general purpose probe information gathering tool 
+/// use cases :   get BGP route receiver peer status 
+message ToolInfoRequest {
+    optional    string              context_name=1;
+    optional    string              tool_name=2;
+    repeated    string              tool_info_requested=3; ///  array of information elements requested 
+}
+
+message ToolInfoResponse  {
+    repeated    NameValue           tool_info=1;	/// info elements Name=Value 
+}
+
 
 message NodeConfigRequest {
     optional string message=1;
 
     message IntelFeed {
-        required string     guid=1;             /// identifying feed group (eg Geo, Badfellas)
-        optional string     name=2;             /// name
-        optional string     download_rules=3;   /// xml file with feed update instructions
-        repeated string     uri=4;              /// individual files in config//.. for FileRequest download 
+        required string     guid=1;                   /// identifying feed group (eg Geo, Badfellas)
+        optional string     name=2;                   /// feed name (eg badfellas) 
+        optional string     download_rules=3;         /// xml file with feed update instructions
+        repeated string     uri=4;                    /// individual files in config//.. for FileRequest download 
+		repeated string     usernodes=5;              /// user requesting the feed, the probe0, probe1, etc 
+		optional int64		sub_feed_id=6[default=-1];/// sub feed ID, when a feed consists of several sub-feeds 
+		optional bool       restore_mode=7[default=false]; /// restore mode will backup and restore, used with add,remove
+
     }
 
     optional IntelFeed      add_feed=2;
     optional IntelFeed      process_new_feed=3;
     optional bool           get_all_nodes=4[default=true];
     repeated NameValue      query_config=5;
-
+    optional IntelFeed      remove_feed=6;            
 }
 
 message NodeConfigResponse {
@@ -999,8 +1088,9 @@ message ContextCreateRequest  {
 /// ContextInfo : one or all contexts
 ///  use is_init to prime with config 
 message ContextInfoRequest {
-     optional   string         context_name=1;     /// if not  set all context get in 
+     optional   string         context_name=1;      /// if not  set all context get in 
      optional   bool           get_size_on_disk=2[default=false]; ///  get size on disk (expensive) 
+	 optional   string         tool_name=3;         /// get status of this tool, freeform bgp, suricata, snort, udpsink etc..
 }
 
 message ContextInfoResponse {
@@ -1010,11 +1100,11 @@ message ContextInfoResponse {
     {
         required string         context_name=1;
         required bool           is_initialized=2;
-        required bool           is_running=3;
+        required bool           is_running=3;       /// trisul processes runs 
         optional int64          size_on_disk=4;
         optional TimeInterval   time_interval=5;
         optional bool           is_clean=6;
-        optional string         extrainfo=7;
+        optional string         extrainfo=7;        /// freeform text output when tool is specified , can be long string 
         repeated TimeInterval   run_history=8;
         optional string         profile=9;
         optional string         runmode=10;
@@ -1231,3 +1321,24 @@ message GraphResponse {
 											  /// repeated because returned in time chunks 
 }
 
+/// RunToolRequest  : run  set of named tools 
+message RunToolRequest   {
+     required   string         context_name=1;      /// if not  set all context get in 
+	 enum NodeTool {
+	 	PING=1;
+		DF=2;
+		GEOQUERY=3;
+		TOP=4;
+		BGPQUERY=5;
+	 }
+	 required  NodeTool 		tool=2;				/// which of these tools you want to run on node
+	 optional  string           tool_input=3;		/// input 
+	 optional  string           tool_input_file_data=4;/// data that goes into a tool input file 
+}
+
+/// RunToolResponse  : ouput 
+message RunToolResponse   {
+     required   string         context_name=1;      /// if not  set all context get in 
+     optional   string         tool_output=2;       /// cmd lines 
+}
+

data/trisulrp.gemspec

@@ -2,18 +2,18 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Juwelier::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: trisulrp 3.2.13 ruby lib
+# stub: trisulrp 3.2.27 ruby lib
 
 Gem::Specification.new do |s|
-  s.name = "trisulrp"
-  s.version = "3.2.13"
+  s.name = "trisulrp".freeze
+  s.version = "3.2.27"
 
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.require_paths = ["lib"]
-  s.authors = ["vivek"]
-  s.date = "2019-01-18"
-  s.description = "This gem deals about the trisul remote protocol"
-  s.email = "vivek_rajagopal@yahoo.com"
+  s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib".freeze]
+  s.authors = ["vivek".freeze]
+  s.date = "2021-04-20"
+  s.description = "This gem deals about the trisul remote protocol".freeze
+  s.email = "vivek_rajagopal@yahoo.com".freeze
   s.extra_rdoc_files = [
     "LICENSE.txt",
     "README.rdoc"
@@ -47,33 +47,33 @@ Gem::Specification.new do |s|
     "test/test_trisulrp.rb",
     "trisulrp.gemspec"
   ]
-  s.homepage = "http://github.com/vivekrajan/trisulrp"
-  s.licenses = ["MIT"]
-  s.rubygems_version = "2.5.1"
-  s.summary = "trisul trp"
+  s.homepage = "http://github.com/vivekrajan/trisulrp".freeze
+  s.licenses = ["MIT".freeze]
+  s.rubygems_version = "3.0.3".freeze
+  s.summary = "trisul trp".freeze
 
   if s.respond_to? :specification_version then
     s.specification_version = 4
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<protobuf>, [">= 0"])
-      s.add_development_dependency(%q<shoulda>, [">= 0"])
-      s.add_development_dependency(%q<bundler>, [">= 0"])
-      s.add_development_dependency(%q<juwelier>, [">= 0"])
-      s.add_development_dependency(%q<simplecov>, [">= 0"])
+      s.add_runtime_dependency(%q<protobuf>.freeze, [">= 0"])
+      s.add_development_dependency(%q<shoulda>.freeze, [">= 0"])
+      s.add_development_dependency(%q<bundler>.freeze, [">= 0"])
+      s.add_development_dependency(%q<juwelier>.freeze, [">= 0"])
+      s.add_development_dependency(%q<simplecov>.freeze, [">= 0"])
     else
-      s.add_dependency(%q<protobuf>, [">= 0"])
-      s.add_dependency(%q<shoulda>, [">= 0"])
-      s.add_dependency(%q<bundler>, [">= 0"])
-      s.add_dependency(%q<juwelier>, [">= 0"])
-      s.add_dependency(%q<simplecov>, [">= 0"])
+      s.add_dependency(%q<protobuf>.freeze, [">= 0"])
+      s.add_dependency(%q<shoulda>.freeze, [">= 0"])
+      s.add_dependency(%q<bundler>.freeze, [">= 0"])
+      s.add_dependency(%q<juwelier>.freeze, [">= 0"])
+      s.add_dependency(%q<simplecov>.freeze, [">= 0"])
     end
   else
-    s.add_dependency(%q<protobuf>, [">= 0"])
-    s.add_dependency(%q<shoulda>, [">= 0"])
-    s.add_dependency(%q<bundler>, [">= 0"])
-    s.add_dependency(%q<juwelier>, [">= 0"])
-    s.add_dependency(%q<simplecov>, [">= 0"])
+    s.add_dependency(%q<protobuf>.freeze, [">= 0"])
+    s.add_dependency(%q<shoulda>.freeze, [">= 0"])
+    s.add_dependency(%q<bundler>.freeze, [">= 0"])
+    s.add_dependency(%q<juwelier>.freeze, [">= 0"])
+    s.add_dependency(%q<simplecov>.freeze, [">= 0"])
   end
 end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trisulrp
 version: !ruby/object:Gem::Version
-  version: 3.2.13
+  version: 3.2.27
 platform: ruby
 authors:
 - vivek
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-01-18 00:00:00.000000000 Z
+date: 2021-04-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: protobuf
@@ -134,8 +134,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: trisul trp