Fix more "make doc" warnings

This commit is contained in:
Daniel Thayer 2016-05-05 15:18:50 -05:00
parent 75e69d8c09
commit 28125e367e
5 changed files with 14 additions and 13 deletions

View file

@ -0,0 +1 @@
../../../../aux/plugins/kafka/README

View file

@ -120,7 +120,7 @@ export {
## Removes a rule. ## Removes a rule.
## ##
## id: The rule to remove, specified as the ID returned by :bro:id:`add_rule` . ## id: The rule to remove, specified as the ID returned by :bro:id:`NetControl::add_rule`.
## ##
## Returns: True if succesful, the relevant plugin indicated that it knew ## Returns: True if succesful, the relevant plugin indicated that it knew
## how to handle the removal. Note that again "success" means the ## how to handle the removal. Note that again "success" means the

View file

@ -14,7 +14,7 @@ export {
MAC, ##< Activity involving a MAC address. MAC, ##< Activity involving a MAC address.
}; };
## Type of a :bro:id:`Flow` for defining a flow. ## Type for defining a flow.
type Flow: record { type Flow: record {
src_h: subnet &optional; ##< The source IP address/subnet. src_h: subnet &optional; ##< The source IP address/subnet.
src_p: port &optional; ##< The source port number. src_p: port &optional; ##< The source port number.
@ -27,10 +27,10 @@ export {
## Type defining the enity an :bro:id:`Rule` is operating on. ## Type defining the enity an :bro:id:`Rule` is operating on.
type Entity: record { type Entity: record {
ty: EntityType; ##< Type of entity. ty: EntityType; ##< Type of entity.
conn: conn_id &optional; ##< Used with :bro:id:`CONNECTION` . conn: conn_id &optional; ##< Used with :bro:enum:`NetControl::CONNECTION`.
flow: Flow &optional; ##< Used with :bro:id:`FLOW` . flow: Flow &optional; ##< Used with :bro:enum:`NetControl::FLOW`.
ip: subnet &optional; ##< Used with bro:id:`ADDRESS`; can specifiy a CIDR subnet. ip: subnet &optional; ##< Used with :bro:enum:`NetControl::ADDRESS` to specifiy a CIDR subnet.
mac: string &optional; ##< Used with :bro:id:`MAC`. mac: string &optional; ##< Used with :bro:enum:`NetControl::MAC`.
}; };
## Target of :bro:id:`Rule` action. ## Target of :bro:id:`Rule` action.
@ -68,7 +68,7 @@ export {
WHITELIST, WHITELIST,
}; };
## Type of a :bro:id:`FlowMod` for defining a flow modification action. ## Type for defining a flow modification action.
type FlowMod: record { type FlowMod: record {
src_h: addr &optional; ##< The source IP address. src_h: addr &optional; ##< The source IP address.
src_p: count &optional; ##< The source port number. src_p: count &optional; ##< The source port number.
@ -90,8 +90,8 @@ export {
priority: int &default=default_priority; ##< Priority if multiple rules match an entity (larger value is higher priority). priority: int &default=default_priority; ##< Priority if multiple rules match an entity (larger value is higher priority).
location: string &optional; ##< Optional string describing where/what installed the rule. location: string &optional; ##< Optional string describing where/what installed the rule.
out_port: count &optional; ##< Argument for bro:id:`REDIRECT` rules. out_port: count &optional; ##< Argument for :bro:enum:`NetControl::REDIRECT` rules.
mod: FlowMod &optional; ##< Argument for :bro:id:`MODIFY` rules. mod: FlowMod &optional; ##< Argument for :bro:enum:`NetControl::MODIFY` rules.
id: string &default=""; ##< Internally determined unique ID for this rule. Will be set when added. id: string &default=""; ##< Internally determined unique ID for this rule. Will be set when added.
cid: count &default=0; ##< Internally determined unique numeric ID for this rule. Set when added. cid: count &default=0; ##< Internally determined unique numeric ID for this rule. Set when added.

View file

@ -120,7 +120,7 @@ event ssh1_server_host_key%(c: connection, p: string, e: string%);
## This event is generated when an :abbr:`SSH (Secure Shell)` ## This event is generated when an :abbr:`SSH (Secure Shell)`
## encrypted packet is seen. This event is not handled by default, but ## encrypted packet is seen. This event is not handled by default, but
## is provided for heuristic analysis scripts. Note that you have to set ## is provided for heuristic analysis scripts. Note that you have to set
## :bro:id:`SSH::skip_processing_after_detection` to false to use this ## :bro:id:`SSH::disable_analyzer_after_detection` to false to use this
## event. This carries a performance penalty. ## event. This carries a performance penalty.
## ##
## c: The connection over which the :abbr:`SSH (Secure Shell)` ## c: The connection over which the :abbr:`SSH (Secure Shell)`

View file

@ -2465,7 +2465,7 @@ function to_subnet%(sn: string%): subnet
## ##
## Returns: The *a* address as a :bro:type:`subnet`. ## Returns: The *a* address as a :bro:type:`subnet`.
## ##
## .. bro:see:: to_subset ## .. bro:see:: to_subnet
function addr_to_subnet%(a: addr%): subnet function addr_to_subnet%(a: addr%): subnet
%{ %{
int width = (a->AsAddr().GetFamily() == IPv4 ? 32 : 128); int width = (a->AsAddr().GetFamily() == IPv4 ? 32 : 128);
@ -2479,7 +2479,7 @@ function addr_to_subnet%(a: addr%): subnet
## ##
## Returns: The *s* subnet as a :bro:type:`addr`. ## Returns: The *s* subnet as a :bro:type:`addr`.
## ##
## .. bro:see:: to_subset ## .. bro:see:: to_subnet
function subnet_to_addr%(sn: subnet%): addr function subnet_to_addr%(sn: subnet%): addr
%{ %{
return new AddrVal(sn->Prefix()); return new AddrVal(sn->Prefix());
@ -2491,7 +2491,7 @@ function subnet_to_addr%(sn: subnet%): addr
## ##
## Returns: The width of the subnet. ## Returns: The width of the subnet.
## ##
## .. bro:see:: to_subset ## .. bro:see:: to_subnet
function subnet_width%(sn: subnet%): count function subnet_width%(sn: subnet%): count
%{ %{
return new Val(sn->Width(), TYPE_COUNT); return new Val(sn->Width(), TYPE_COUNT);