base/bif/broxygen.bif.bro

GLOBAL

Functions for querying script, package, or variable documentation.

Namespace:GLOBAL
Source File:/scripts/base/bif/broxygen.bif.bro

Summary

Functions

get_identifier_comments: function Retrieve the Broxygen-style comments (##) associated with an identifier (e.g.
get_package_readme: function Retrieve the contents of a Bro script package’s README file.
get_record_field_comments: function Retrieve the Broxygen-style comments (##) associated with a record field.
get_script_comments: function Retrieve the Broxygen-style summary comments (##!) associated with a Bro script.

Detailed Interface

Functions

get_identifier_comments
Type:function (name: string) : string

Retrieve the Broxygen-style comments (##) associated with an identifier (e.g. a variable or type).

Name:a script-level identifier for which to retrieve comments.
Returns:comments associated with name. If name is not a known identifier, an empty string is returned.
get_package_readme
Type:function (name: string) : string

Retrieve the contents of a Bro script package’s README file.

Name:the name of a Bro script package. It must be a relative path to where it is located within a particular component of BROPATH.
Returns:contents of the package’s README file. If name is not a known package, an empty string is returned.
get_record_field_comments
Type:function (name: string) : string

Retrieve the Broxygen-style comments (##) associated with a record field.

Name:the name of a record type and a field within it formatted like a typical record field access: “<record_type>$<field>”.
Returns:comments associated with the record field. If name does not point to a known record type or a known field within a record type, an empty string is returned.
get_script_comments
Type:function (name: string) : string

Retrieve the Broxygen-style summary comments (##!) associated with a Bro script.

Name:the name of a Bro script. It must be a relative path to where it is located within a particular component of BROPATH and use the same file name extension/suffix as the actual file (e.g. “.bro”).
Returns:summary comments associated with script with name. If name is not a known script, an empty string is returned.

Previous Page

base/bif/__load__.bro

Copyright 2016, The Bro Project. Last updated on January 10, 2019. Created using Sphinx 1.7.5.