RBOW / Parse-Nessus-XML-1.14 / README 

            

              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

              
NAME
    Parse::Nessus::XML - Interface to Nessus XML result files
SYNOPSIS
      use Parse::Nessus::XML
      my $scan = Parse::Nessus::XML->new( $filename );
      my @results = $scan->results;
      my $plugin  = $scan->plugin(10964); # Parse::Nessus::XML::Plugin object
      my $name    = $plugin->name;
DESCRIPTION
    Provides an interface to the Nessus XML report file. This is primarily
    for my own use, so if it's missing stuff that you think should be in
    here, send me a patch.
    Please note that this API is just a suggestion, and is subject to change
    in the first few releases. Because of how deeply nested the data
    structure is, there's no particularly nice API to the whole thing - at
    least that I can think of. See the example script in the example/
    subdirectory to see how I use this in real life.
  new
      my $scan = Parse::Nessus::XML->new( $filename );
    Given the path to a file, returns a Parse::Nessus::XML object.
  results
        my $results = $scan->results; # listref
        my @results = $scan->results; # list
  plugin
    Returns a plugin object, given the ID. Then you can call for attributes
    off of that object.
      my $plugin = $scan->plugin(10964);
      $name = $plugin->name;
      $risk = $plugin->risk;
  package Parse::Nessus::XML::Plugin
    Supplementary package which facilitates figuring out what's in a
    particular plugin. Also allows location of a plugin by ID number, which
    speeds things up.
  Parse::Nessus::XML::Plugin->new
      my $plugin = Parse::Nessus::XML::Plugin->new( $scan, ID => 10964 );
      my $risk = $plugin->risk;
    Available attributes are: id, name, version, family, cve_id, bugtraq_id,
    category, risk, summary, copyright
AUTHOR
        Rich Bowen
        CPAN ID: RBOW
        rbowen@rcbowen.com
        http://rich.rcbowen.com/
COPYRIGHT
    This program is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.
    The full text of the license can be found in the LICENSE file included
    with this module.
SEE ALSO
    Parse::Nessus::NBE