OMP: OpenVAS Management Protocol

Version: 6.0

The "management" protocol of the Open Vulnerability Assessment System.

Summary of Data Types
Summary of Elements
Summary of Commands
RNC Preamble
Data Type Details
Element Details
Command Details
Compatibility Changes in Version 6.0

1 Summary of Data Types

alive_test	An alive test.
base64	Base64 encoded data.
boolean	A true or false value.
boolean_atoi	A true or false value, after conversion to an integer.
ctime	A date and time, in the C `ctime' format.
type_name	A name of a data type.
integer	An integer.
iso_time	A date and time, in ISO 8601 format.
levels	A string that may include the characters h, m, l, g and d.
name	A name.
port	A port.
user_list	A space separated list of users.
oid	An Object Identifier (OID).
severity	A severity score.
sort_order	A string describing an order for sorting.
status	The success or failure status of a command.
task_status	A task run status.
task_trend	The trend of results for a task.
threat	A threat level.
time_unit	A unit of time.
timezone	A timezone.
uuid	A Universally Unique Identifier (UUID).
uuid_or_empty	A Universally Unique Identifier (UUID), or the empty string.

2 Summary of Elements

c	A reference to a command.
e	A reference to an element.
r	A reference to a response.
o	An optional pattern item.
g	A group of pattern items.
any	Pattern item indicating "any number of".
pattern	The pattern element of a command or command descendant.
command_definition	Definition of a command in OMP describing HELP command.
note	A note.
override	An override.
result	A result.
report	Actually attributes and either base64 or a report.

3 Summary of Commands

authenticate	Authenticate with the manager.
commands	Run a list of commands.
create_agent	Create an agent.
create_config	Create a config.
create_alert	Create an alert.
create_filter	Create a filter.
create_group	Create a group.
create_lsc_credential	Create an LSC credential.
create_note	Create a note.
create_override	Create an override.
create_permission	Create a permission.
create_port_list	Create a port list.
create_port_range	Create a port range.
create_report	Create a report.
create_report_format	Create a report format.
create_role	Create a role.
create_scanner	Create a scanner.
create_schedule	Create a schedule.
create_slave	Create a slave.
create_tag	Create a tag.
create_target	Create a target.
create_task	Create a task.
create_user	Create a user.
delete_agent	Delete an agent.
delete_config	Delete a config.
delete_alert	Delete an alert.
delete_filter	Delete a filter.
delete_group	Delete a group.
delete_lsc_credential	Delete an LSC credential.
delete_note	Delete a note.
delete_override	Delete an override.
delete_report	Delete a report.
delete_permission	Delete a permission.
delete_port_list	Delete a port list.
delete_port_range	Delete a port range.
delete_report_format	Delete a report format.
delete_role	Delete a role.
delete_scanner	Delete a scanner.
delete_schedule	Delete a schedule.
delete_slave	Delete a slave.
delete_tag	Delete a tag.
delete_target	Delete a target.
delete_task	Delete a task.
delete_user	Delete a user.
describe_auth	Describe authentication methods.
describe_cert	Describe the CERT feed.
describe_feed	Describe the NVT feed.
describe_scap	Describe the SCAP feed.
empty_trashcan	Empty the trashcan.
get_agents	Get one or many agents.
get_configs	Get one or many configs.
get_aggregates	Get aggregates of various resources.
get_alerts	Get one or many alerts.
get_filters	Get one or many filters.
get_groups	Get one or many groups.
get_info	Get information for items of given type.
get_lsc_credentials	Get one or many LSC credentials.
get_notes	Get one or many notes.
get_nvts	Get one or many NVTs.
get_nvt_families	Get a list of all NVT families.
get_nvt_feed_version	Get NVT Feed version.
get_overrides	Get one or many overrides.
get_permissions	Get one or many permissions.
get_port_lists	Get one or many port lists.
get_preferences	Get one or many preferences.
get_reports	Get one or many reports.
get_report_formats	Get one or many report formats.
get_results	Get results.
get_roles	Get one or many roles.
get_scanners	Get one or many scanners.
get_schedules	Get one or many schedules.
get_settings	Get one or many settings.
get_slaves	Get one or many slaves.
get_system_reports	Get one or many system reports.
get_tags	Get one or many tags.
get_targets	Get one or many targets.
get_tasks	Get one or many tasks.
get_users	Get one or many users.
get_version	Get the OpenVAS Manager Protocol version.
help	Get the help text.
modify_agent	Modify an existing agent.
modify_alert	Modify an existing alert.
modify_auth	Modify the authentication methods.
modify_config	Modify an existing config.
modify_filter	Modify an existing filter.
modify_group	Modify an existing group.
modify_lsc_credential	Modify an existing LSC credential.
modify_note	Modify an existing note.
modify_override	Modify an existing override.
modify_permission	Modify a permission.
modify_port_list	Modify an existing port list.
modify_report	Modify an existing report.
modify_report_format	Update an existing report format.
modify_role	Modify an existing role.
modify_scanner	Modify an existing scanner.
modify_schedule	Modify an existing schedule.
modify_setting	Modify an existing setting.
modify_slave	Modify an existing slave.
modify_target	Modify an existing target.
modify_tag	Modify a tag.
modify_task	Modify an existing task.
modify_user	Modify a user.
restore	Restore a resource.
resume_task	Resume a task.
run_wizard	Run a wizard.
start_task	Manually start an existing task.
stop_task	Stop a running task.
sync_cert	Synchronize with a CERT feed.
sync_feed	Synchronize with an NVT feed.
sync_scap	Synchronize with a SCAP feed.
test_alert	Run an alert.
verify_agent	Verify an agent.
verify_report_format	Verify a report format.

4 RNC Preamble

### Preamble

start = command | response

command
  = authenticate
    | commands
    | create_agent
    | create_config
    | create_alert
    | create_filter
    | create_group
    | create_lsc_credential
    | create_note
    | create_override
    | create_permission
    | create_port_list
    | create_port_range
    | create_report
    | create_report_format
    | create_role
    | create_scanner
    | create_schedule
    | create_slave
    | create_tag
    | create_target
    | create_task
    | create_user
    | delete_agent
    | delete_config
    | delete_alert
    | delete_filter
    | delete_group
    | delete_lsc_credential
    | delete_note
    | delete_override
    | delete_report
    | delete_permission
    | delete_port_list
    | delete_port_range
    | delete_report_format
    | delete_role
    | delete_scanner
    | delete_schedule
    | delete_slave
    | delete_tag
    | delete_target
    | delete_task
    | delete_user
    | describe_auth
    | describe_cert
    | describe_feed
    | describe_scap
    | empty_trashcan
    | get_agents
    | get_configs
    | get_aggregates
    | get_alerts
    | get_filters
    | get_groups
    | get_info
    | get_lsc_credentials
    | get_notes
    | get_nvts
    | get_nvt_families
    | get_nvt_feed_version
    | get_overrides
    | get_permissions
    | get_port_lists
    | get_preferences
    | get_reports
    | get_report_formats
    | get_results
    | get_roles
    | get_scanners
    | get_schedules
    | get_settings
    | get_slaves
    | get_system_reports
    | get_tags
    | get_targets
    | get_tasks
    | get_users
    | get_version
    | help
    | modify_agent
    | modify_alert
    | modify_auth
    | modify_config
    | modify_filter
    | modify_group
    | modify_lsc_credential
    | modify_note
    | modify_override
    | modify_permission
    | modify_port_list
    | modify_report
    | modify_report_format
    | modify_role
    | modify_scanner
    | modify_schedule
    | modify_setting
    | modify_slave
    | modify_target
    | modify_tag
    | modify_task
    | modify_user
    | restore
    | resume_task
    | run_wizard
    | start_task
    | stop_task
    | sync_cert
    | sync_feed
    | sync_scap
    | test_alert
    | verify_agent
    | verify_report_format

response
  = authenticate_response
    | commands_response
    | create_agent_response
    | create_config_response
    | create_alert_response
    | create_filter_response
    | create_group_response
    | create_lsc_credential_response
    | create_note_response
    | create_override_response
    | create_permission_response
    | create_port_list_response
    | create_port_range_response
    | create_report_response
    | create_report_format_response
    | create_role_response
    | create_scanner_response
    | create_schedule_response
    | create_slave_response
    | create_tag_response
    | create_target_response
    | create_task_response
    | create_user_response
    | delete_agent_response
    | delete_config_response
    | delete_alert_response
    | delete_filter_response
    | delete_group_response
    | delete_lsc_credential_response
    | delete_note_response
    | delete_override_response
    | delete_report_response
    | delete_permission_response
    | delete_port_list_response
    | delete_port_range_response
    | delete_report_format_response
    | delete_role_response
    | delete_scanner_response
    | delete_schedule_response
    | delete_slave_response
    | delete_tag_response
    | delete_target_response
    | delete_task_response
    | delete_user_response
    | describe_auth_response
    | describe_cert_response
    | describe_feed_response
    | describe_scap_response
    | empty_trashcan_response
    | get_agents_response
    | get_configs_response
    | get_aggregates_response
    | get_alerts_response
    | get_filters_response
    | get_groups_response
    | get_info_response
    | get_lsc_credentials_response
    | get_notes_response
    | get_nvts_response
    | get_nvt_families_response
    | get_nvt_feed_version_response
    | get_overrides_response
    | get_permissions_response
    | get_port_lists_response
    | get_preferences_response
    | get_reports_response
    | get_report_formats_response
    | get_results_response
    | get_roles_response
    | get_scanners_response
    | get_schedules_response
    | get_settings_response
    | get_slaves_response
    | get_system_reports_response
    | get_tags_response
    | get_targets_response
    | get_tasks_response
    | get_users_response
    | get_version_response
    | help_response
    | modify_agent_response
    | modify_alert_response
    | modify_auth_response
    | modify_config_response
    | modify_filter_response
    | modify_group_response
    | modify_lsc_credential_response
    | modify_note_response
    | modify_override_response
    | modify_permission_response
    | modify_port_list_response
    | modify_report_response
    | modify_report_format_response
    | modify_role_response
    | modify_scanner_response
    | modify_schedule_response
    | modify_setting_response
    | modify_slave_response
    | modify_target_response
    | modify_tag_response
    | modify_task_response
    | modify_user_response
    | restore_response
    | resume_task_response
    | run_wizard_response
    | start_task_response
    | stop_task_response
    | sync_cert_response
    | sync_feed_response
    | sync_scap_response
    | test_alert_response
    | verify_agent_response
    | verify_report_format_response

5 Data Type Details

5.1 Data Type `alive_test`

In short: An alive test.

5.1.1 RNC

alive_test = xsd:token { pattern = "ICMP, TCP Service & ARP Ping|TCP Service & ARP Ping|I↵
CMP & ARP Ping|ICMP & TCP Service Ping|ARP Ping|TCP Service Ping|ICMP Ping|S↵
can Config Default" }

5.2 Data Type `base64`

In short: Base64 encoded data.

5.2.1 RNC

base64 = xsd:base64Binary

5.3 Data Type `boolean`

In short: A true or false value.

Zero is false, anything else is true. As a result, the empty string is considered true.

5.3.1 RNC

boolean = text

5.4 Data Type `boolean_atoi`

In short: A true or false value, after conversion to an integer.

Zero is false, anything else is true. The value is first converted to an integer, as by the C `atoi' routine. This means that an empty string is considered false.

5.4.1 RNC

boolean_atoi = text

5.5 Data Type `ctime`

In short: A date and time, in the C `ctime' format.

An example string in this format is "Wed Jun 30 21:49:08 1993\n".

5.5.1 RNC

ctime = text

5.6 Data Type `type_name`

In short: A name of a data type.

5.6.1 RNC

type_name = xsd:Name

5.7 Data Type `integer`

In short: An integer.

5.7.1 RNC

integer = xsd:integer

5.8 Data Type `iso_time`

In short: A date and time, in ISO 8601 format.

An example string in this format is "2011-11-08T19:57:06+02:00".

5.8.1 RNC

iso_time = text

5.9 Data Type `levels`

In short: A string that may include the characters h, m, l, g and d.

5.9.1 RNC

levels = xsd:token { pattern = "h?m?l?g?d?" }

5.10 Data Type `name`

In short: A name.

Typically this is the name of one of the manager resources, like a task or target.

5.10.1 RNC

name = xsd:string

5.11 Data Type `port`

In short: A port.

5.11.1 RNC

port = xsd:token { pattern = "[0-9]{1,5}" }

5.12 Data Type `user_list`

In short: A space separated list of users.

5.12.1 RNC

user_list = text

5.13 Data Type `oid`

In short: An Object Identifier (OID).

5.13.1 RNC

oid = xsd:token { pattern = "[0-9\.]{1,80}" }

5.14 Data Type `severity`

In short: A severity score.

A severity score is a decimal number between 0.0 and 10.0 (inclusive) with one digit after the decimal point or a special negative value (-1.0, -2.0 or -3.0). If a single severity score defines a constraint, e.g. on whether an override applies, for values 0.0 and lower the severity must be equal to match while for > 0.0 the compared value must be greater or equal.

5.14.1 RNC

severity = xsd:token { pattern = "-[1-3](\.0)?|[0-9](\.[0-9])?|10(\.0)?" }

5.15 Data Type `sort_order`

In short: A string describing an order for sorting.

The string "descending" denotes descending order, anything else means ascending.

5.15.1 RNC

sort_order = text

5.16 Data Type `status`

In short: The success or failure status of a command.

5.16.1 RNC

status = xsd:token { pattern = "200|201|202|400|401|403|404|409|500|503" }

5.17 Data Type `task_status`

In short: A task run status.

5.17.1 RNC

task_status = xsd:token { pattern = "Delete Requested|Done|New|Requested|Running|Stop Requ↵
ested|Stopped|Internal Error" }

5.18 Data Type `task_trend`

In short: The trend of results for a task.

5.18.1 RNC

task_trend = xsd:token { pattern = "up|down|more|less|same" }

5.19 Data Type `threat`

In short: A threat level.

Threat levels are a textual classification of severity scores only supported for importing reports from OpenVAS-6 and older. The use of these elements is deprecated as they are otherwise replaced by severity elements, which should be used instead.

5.19.1 RNC

threat = xsd:token { pattern = "High|Medium|Low|Alarm|Log|Debug" }

5.20 Data Type `time_unit`

In short: A unit of time.

5.20.1 RNC

time_unit = xsd:token { pattern = "second|minute|hour|day|week|month|year|decade" }

5.21 Data Type `timezone`

In short: A timezone.

The format of a timezone is the same as that of the TZ environment variable on GNU/Linux systems. That is, the same value accepted by the tzset C function. There are three versions of the format. Note the lack of spaces in the examples.

"std offset" defines a simple timezone. For example, "FOO+2" defines a timezone FOO which is 2 hours behind UTC.

"std offset dst [offset],start[/time],end[/time]" defines a timezone, including daylight savings time. For example, "NZST-12.00:00NZDT-13:00:00,M10.1.0,M3.3.0".

":[filespec]" refers to a predefined timezone. For example, ":Africa/Johannesburg". Note that the colon is optional. Certain acronyms are predefined, such as GB, NZ and CET.

5.21.1 RNC

timezone = text

5.22 Data Type `uuid`

In short: A Universally Unique Identifier (UUID).

5.22.1 RNC

uuid = xsd:token { pattern = "[0-9abcdefABCDEF\-]{1,40}" }

5.23 Data Type `uuid_or_empty`

In short: A Universally Unique Identifier (UUID), or the empty string.

5.23.1 RNC

uuid_or_empty = xsd:token { pattern = "[0-9abcdefABCDEF\-]{0,40}" }

6 Element Details

6.1 Element `c`

In short: A reference to a command.

6.1.1 Structure

6.1.2 RNC

c
 = element c
     {
       text
     }

6.2 Element `e`

In short: A reference to an element.

6.2.1 Structure

6.2.2 RNC

e
 = element e
     {
       text
     }

6.3 Element `r`

In short: A reference to a response.

6.3.1 Structure

6.3.2 RNC

r
 = element r
     {
       text
     }

6.4 Element `o`

In short: An optional pattern item.

6.4.1 Structure

- One of
  - <c>
    A reference to a command.
  - <e>
    A reference to an element.
  - <r>
    A reference to a response.
  - <g>
    A group of pattern items.

6.4.2 RNC

o
 = element o
     {
       ( c
           | e
           | r
           | g )
     }

6.5 Element `g`

In short: A group of pattern items.

6.5.1 Structure

- <c> *
  A reference to a command.
- <e> *
  A reference to an element.
- <r> *
  A reference to a response.
- <o> *
  An optional pattern item.
- <any> *
  Pattern item indicating "any number of".

6.5.2 RNC

g
 = element g
     {
       c*
       & e*
       & r*
       & o*
       & any*
     }

6.6 Element `any`

In short: Pattern item indicating "any number of".

6.6.1 Structure

- One of
  - <c>
    A reference to a command.
  - <e>
    A reference to an element.
  - <r>
    A reference to a response.
  - <g>
    A group of pattern items.

6.6.2 RNC

any
 = element any
     {
       ( c
           | e
           | r
           | g )
     }

6.7 Element `pattern`

In short: The pattern element of a command or command descendant.

It's actually either a 't' element, or the word "text", or "".

6.7.1 Structure

- <attrib> *
  An attribute.
  - <name>
  - <type>
  - <required>
- <c> *
  A reference to a command.
- <e> *
  A reference to an element.
- <r> *
  A reference to a response.
- <o> *
  An optional pattern item.
- <g> *
  A group of pattern items.
- <any> *
  Pattern item indicating "any number of".
- <t> ?
  The type of the text of the element.

6.7.2 RNC

pattern
 = element pattern
     {
       text
       & pattern_attrib*
       & c*
       & e*
       & r*
       & o*
       & g*
       & any*
       & pattern_t?
     }

pattern_attrib
 = element attrib
     {
       pattern_attrib_name
       & pattern_attrib_type
       & pattern_attrib_required
     }

pattern_attrib_name
 = element name
     {
       type_name
     }

pattern_attrib_type
 = element type
     {
       type_name
     }

pattern_attrib_required
 = element required
     {
       boolean
     }

pattern_t
 = element t
     {
       type_name
     }

6.8 Element `command_definition`

In short: Definition of a command in OMP describing HELP command.

6.8.1 Structure

- <name>
  The name of the command.
- <summary> ?
  A summary of the command.
- <description> ?
  A description of the command.
  - <p> *
    A paragraph.
- One of
  - The group
    - <pattern>
      (pattern)
    - <response>
      (pattern)
  - The group
    - <type>
      The type of the element.
    - <ele> *
      (command_definition)
      
      An element.
- <example> *
  - <summary> ?
  - <description> ?
  - <request>
    Example request.
  - <response>
    Response to example request.

6.8.2 RNC

command_definition
 = element command_definition
     {
       command_definition_name
       & command_definition_summary?
       & command_definition_description?
       & ( ( command_definition_pattern
           & command_definition_response )
           | ( command_definition_type
           & command_definition_ele* ) )
       & command_definition_example*
     }

command_definition_name
 = element name
     {
       type_name
     }

command_definition_summary
 = element summary
     {
       text
     }

command_definition_description
 = element description
     {
       text
       & command_definition_description_p*
     }

command_definition_description_p
 = element p
     {
       text
     }

command_definition_pattern
 = element pattern    # type pattern
     {
       text
       & pattern_attrib*
       & c*
       & e*
       & r*
       & o*
       & g*
       & any*
       & pattern_t?
     }

command_definition_response
 = element response    # type pattern
     {
       text
       & pattern_attrib*
       & c*
       & e*
       & r*
       & o*
       & g*
       & any*
       & pattern_t?
     }

command_definition_example
 = element example
     {
       command_definition_example_summary?
       & command_definition_example_description?
       & command_definition_example_request
       & command_definition_example_response
     }

command_definition_example_summary
 = element summary
     {
       text
     }

command_definition_example_description
 = element description
     {
       text
     }

command_definition_example_request
 = element request
     {
       text
     }

command_definition_example_response
 = element response
     {
       text
     }

command_definition_type
 = element type
     {
       text
     }

command_definition_ele
 = element ele    # type command_definition
     {
       command_definition_name
       & command_definition_summary?
       & command_definition_description?
       & ( ( command_definition_pattern
           & command_definition_response )
           | ( command_definition_type
           & command_definition_ele* ) )
       & command_definition_example*
     }

6.9 Element `note`

In short: A note.

6.9.1 Structure

- @id (uuid)
- <permissions>
  Permissions that the current user has on the note.
  - <permission> *
    - <name>
      The name of the permission.
- <owner>
  Owner of the note.
  - <name>
    The name of the owner.
- <nvt>
  - @oid (oid)
  - <name>
- <text>
  The text of the note.
  - @excerpt (boolean) Whether the content is an excerpt of the full text.
- <creation_time>
  Date and time the note was created.
- <modification_time>
  Date and time the note was last modified.
- <writable>
- <in_use>
- <active>
  Whether the note is active.
- <orphan>
  Whether the note is an orphan.
- <user_tags>
  Info on tags attached to the note.
  - <count>
    Number of attached tags.
  - <tag> *
    Short info on an individual tag (only if details were requested).
    - @id (uuid) UUID of the tag.
    - <name>
      Name of the tag (usually namespace:predicate).
    - <value>
      Value of the tag.
    - <comment>
      Comment for the tag.
- The group?
  - <hosts>
    A textual list of hosts.
  - <port>
    Port to which note applies.
  - <severity>
    Severity to which note applies.
  - <threat>
    Threat level to which note applies.
  - <task>
    Task to which note applies.
    - @id (uuid)
  - <end_time> ?
    End time of the note in case of limit, else empty.
  - <result> ?
    Result to which note applies.
    - @id (uuid)
    - <host>
    - <port>
    - <nvt>
      - @oid (oid)
      - <name>
      - <cvss_base>
      - <cve> ?
        CVE value associated with the NVT.
      - <bid> ?
        BID associated with the NVT.
    - <severity>
    - <threat>
    - <qod>
      The quality of detection (QoD) of the result.
      - <value>
        The numeric QoD value.
      - <type>
        The QoD type.
    - <description>

6.9.2 RNC

note
 = element note
     {
       attribute id { uuid }
       & note_permissions
       & note_owner
       & note_nvt
       & note_text
       & note_creation_time
       & note_modification_time
       & note_writable
       & note_in_use
       & note_active
       & note_orphan
       & note_user_tags
       & ( note_hosts
           & note_port
           & note_severity
           & note_threat
           & note_task
           & note_end_time?
           & note_result? )?
     }

note_permissions
 = element permissions
     {
       note_permissions_permission*
     }

note_permissions_permission
 = element permission
     {
       note_permissions_permission_name
     }

note_permissions_permission_name
 = element name
     {
       name
     }

note_owner
 = element owner
     {
       note_owner_name
     }

note_owner_name
 = element name
     {
       name
     }

note_nvt
 = element nvt
     {
       attribute oid { oid }
       & note_nvt_name
     }

note_nvt_name
 = element name
     {
       name
     }

note_creation_time
 = element creation_time
     {
       iso_time
     }

note_modification_time
 = element modification_time
     {
       iso_time
     }

note_writable
 = element writable
     {
       boolean
     }

note_in_use
 = element in_use
     {
       boolean
     }

note_active
 = element active
     {
       boolean
     }

note_text
 = element text
     {
       text
       & attribute excerpt { boolean }
     }

note_orphan
 = element orphan
     {
       boolean
     }

note_user_tags
 = element user_tags
     {
       note_user_tags_count
       & note_user_tags_tag*
     }

note_user_tags_count
 = element count
     {
       integer
     }

note_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & note_user_tags_tag_name
       & note_user_tags_tag_value
       & note_user_tags_tag_comment
     }

note_user_tags_tag_name
 = element name
     {
       text
     }

note_user_tags_tag_value
 = element value
     {
       text
     }

note_user_tags_tag_comment
 = element comment
     {
       text
     }

note_hosts
 = element hosts
     {
       text
     }

note_port
 = element port
     {
       text
     }

note_severity
 = element severity
     {
       severity
     }

note_threat
 = element threat
     {
       threat
     }

note_task
 = element task
     {
       attribute id { uuid }
     }

note_active
 = element active
     {
       integer
     }

note_end_time
 = element end_time
     {
       text
     }

note_result
 = element result
     {
       attribute id { uuid }
       & note_result_host
       & note_result_port
       & note_result_nvt
       & note_result_severity
       & note_result_threat
       & note_result_qod
       & note_result_description
     }

note_result_host
 = element host
     {
       text
     }

note_result_port
 = element port
     {
       text
     }

note_result_nvt
 = element nvt
     {
       attribute oid { oid }
       & note_result_nvt_name
       & note_result_nvt_cvss_base
       & note_result_nvt_cve?
       & note_result_nvt_bid?
     }

note_result_nvt_name
 = element name
     {
       name
     }

note_result_nvt_cvss_base
 = element cvss_base
     {
       text
     }

note_result_nvt_cve
 = element cve
     {
       text
     }

note_result_nvt_bid
 = element bid
     {
       integer
     }

note_result_severity
 = element severity
     {
       severity
     }

note_result_threat
 = element threat
     {
       threat
     }

note_result_qod
 = element qod
     {
       note_result_qod_value
       & note_result_qod_type
     }

note_result_qod_value
 = element value
     {
       integer
     }

note_result_qod_type
 = element type
     {
       text
     }

note_result_description
 = element description
     {
       text
     }

6.10 Element `override`

In short: An override.

6.10.1 Structure

- @id (uuid)
- <permissions>
  Permissions that the current user has on the note.
  - <permission> *
    - <name>
      The name of the permission.
- <owner>
  Owner of the override.
  - <name>
- <nvt>
  - @oid (oid)
  - <name>
- <creation_time>
  Date and time the override was created.
- <modification_time>
  Date and time the override was last modified.
- <writable>
- <in_use>
- <active>
  Whether the override is currently active.
- <text>
  The text of the override.
  - @excerpt (boolean) Whether the contents is an excerpt of the full text.
- <threat>
  Threat level to which override applies, derived from severity.
- <severity>
  Severity score to which override applies.
- <new_threat>
  New threat for result.
- <new_severity>
  New severity score for result.
- <orphan>
  Whether the override is an orphan.
- <permissions>
  Permissions that the current user has on the note.
  - <permission> *
    - <name>
      The name of the permission.
- <user_tags>
  Info on tags attached to the override.
  - <count>
    Number of attached tags.
  - <tag> *
    Short info on an individual tag (only if details were requested).
    - @id (uuid) UUID of the tag.
    - <name>
      Name of the tag (usually namespace:predicate).
    - <value>
      Value of the tag.
    - <comment>
      Comment for the tag.
- The group?
  - <hosts>
    A textual list of hosts.
  - <port>
    Port to which override applies.
  - <task>
    Task to which override applies.
    - @id (uuid)
  - <end_time> ?
    Override end time in case of limit, else empty.
  - <result> ?
    Result to which override applies.
    - @id (uuid)
    - <host>
    - <port>
    - <nvt>
      - @oid (oid)
      - <name>
      - <cvss_base>
      - <cve> ?
        CVE value associated with the NVT.
      - <bid> ?
        BID associated with the NVT.
    - <threat>
    - <severity>
    - <qod>
      The quality of detection (QoD) of the result.
      - <value>
        The numeric QoD value.
      - <type>
        The QoD type.
    - <description>

6.10.2 RNC

override
 = element override
     {
       attribute id { uuid }
       & override_permissions
       & override_owner
       & override_nvt
       & override_creation_time
       & override_modification_time
       & override_writable
       & override_in_use
       & override_active
       & override_text
       & override_threat
       & override_severity
       & override_new_threat
       & override_new_severity
       & override_orphan
       & override_permissions
       & override_user_tags
       & ( override_hosts
           & override_port
           & override_task
           & override_end_time?
           & override_result? )?
     }

override_permissions
 = element permissions
     {
       override_permissions_permission*
     }

override_permissions_permission
 = element permission
     {
       override_permissions_permission_name
     }

override_permissions_permission_name
 = element name
     {
       name
     }

override_owner
 = element owner
     {
       override_owner_name
     }

override_owner_name
 = element name
     {
       name
     }

override_nvt
 = element nvt
     {
       attribute oid { oid }
       & override_nvt_name
     }

override_nvt_name
 = element name
     {
       name
     }

override_creation_time
 = element creation_time
     {
       iso_time
     }

override_modification_time
 = element modification_time
     {
       iso_time
     }

override_writable
 = element writable
     {
       boolean
     }

override_in_use
 = element in_use
     {
       boolean
     }

override_active
 = element active
     {
       boolean
     }

override_text
 = element text
     {
       text
       & attribute excerpt { boolean }
     }

override_threat
 = element threat
     {
       threat
     }

override_severity
 = element severity
     {
       severity
     }

override_new_threat
 = element new_threat
     {
       threat
     }

override_new_severity
 = element new_severity
     {
       severity
     }

override_orphan
 = element orphan
     {
       boolean
     }

override_user_tags
 = element user_tags
     {
       override_user_tags_count
       & override_user_tags_tag*
     }

override_user_tags_count
 = element count
     {
       integer
     }

override_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & override_user_tags_tag_name
       & override_user_tags_tag_value
       & override_user_tags_tag_comment
     }

override_user_tags_tag_name
 = element name
     {
       text
     }

override_user_tags_tag_value
 = element value
     {
       text
     }

override_user_tags_tag_comment
 = element comment
     {
       text
     }

override_hosts
 = element hosts
     {
       text
     }

override_port
 = element port
     {
       text
     }

override_task
 = element task
     {
       attribute id { uuid }
     }

override_active
 = element active
     {
       integer
     }

override_end_time
 = element end_time
     {
       text
     }

override_result
 = element result
     {
       attribute id { uuid }
       & override_result_host
       & override_result_port
       & override_result_nvt
       & override_result_threat
       & override_result_severity
       & override_result_qod
       & override_result_description
     }

override_result_host
 = element host
     {
       text
     }

override_result_port
 = element port
     {
       text
     }

override_result_nvt
 = element nvt
     {
       attribute oid { oid }
       & override_result_nvt_name
       & override_result_nvt_cvss_base
       & override_result_nvt_cve?
       & override_result_nvt_bid?
     }

override_result_nvt_name
 = element name
     {
       name
     }

override_result_nvt_cvss_base
 = element cvss_base
     {
       text
     }

override_result_nvt_cve
 = element cve
     {
       text
     }

override_result_nvt_bid
 = element bid
     {
       integer
     }

override_result_threat
 = element threat
     {
       threat
     }

override_result_severity
 = element severity
     {
       severity
     }

override_result_qod
 = element qod
     {
       override_result_qod_value
       & override_result_qod_type
     }

override_result_qod_value
 = element value
     {
       integer
     }

override_result_qod_type
 = element type
     {
       text
     }

override_result_description
 = element description
     {
       text
     }

6.11 Element `result`

In short: A result.

6.11.1 Structure

- @id (uuid)
- <name>
  The name of the result.
- <owner>
  Owner of the result.
  - <name>
    The name of the owner.
- <comment>
  The comment on the result.
- <creation_time>
  Date and time the result was created.
- <modification_time>
  Date and time the result was last modified.
- <user_tags> ?
  Info on tags attached to the result (not in delta results).
  - <count>
    Number of attached tags.
  - <tag> *
    Short info on an individual tag (only if details were requested).
    - @id (uuid) UUID of the tag.
    - <name>
      Name of the tag (usually namespace:predicate).
    - <value>
      Value of the tag.
    - <comment>
      Comment for the tag.
- <report> ?
  Report the result belongs to (only when details were requested).
  - @id (uuid) UUID of the report the result belongs to.
- <task> ?
  Task the result applies to (only when details were requested).
  - @id (uuid) UUID of the task the result applies to.
  - <name>
    Name of the task the result applies to.
- <host>
- <port>
- <nvt>
  NVT to which result applies.
  - @oid (oid)
  - <name>
    The name of the NVT.
  - <family>
    The family the NVT is in.
  - <cvss_base>
    CVSS base value associated with the NVT.
  - <cve>
    CVE associated with the NVT.
  - <bid>
    BID associated with the NVT.
  - <tags>
    Tags associated with the NVT.
  - <cert>
    List of CERT advisories referencing this NVT via CVEs.
    - <cert_ref> *
      A CERT advisory reference.
      - @id (text) ID of the advisory.
      - @type (text) Type of the advisory (e.g. "DFN-CERT", "CERT-BUND").
  - <xref>
    XREFs associated with the NVT.
- <scan_nvt_version>
  Version of the NVT used in the scan.
- <threat>
- <severity>
- <qod>
  The quality of detection (QoD) of the result.
  - <value>
    The numeric QoD value.
  - <type>
    The QoD type.
- <original_threat> ?
  Original threat when overridden.
- <original_severity> ?
  Original severity when overridden.
- <description>
  Description of the result.
- <delta> ?
  Delta state.
  - <result> ?
    (result)
    
    Delta result.
  - <diff> ?
    (text)
    
    Comparison between descriptions.
  - <notes> ?
    List of notes on the result.
    - <note> *
      (note)
  - <overrides> ?
    List of overrides on the result.
    - <override> *
      (override)
- <details>
  Any details associated with the result.
  - <detail> *
    A detail associated with the result.
    - <name>
      The name of the detail.
    - <value>
      The value of the detail.
- <detection>
  Detection details.
  - <result>
    Detection result.
    - @id (uuid) UUID of the detection result.
    - <details>
      - <detail> *
        A detail associated with the detection result.
        
        <name>
        The name of the detail.
        
        <value>
        The value of the detail.
- <notes> ?
  List of notes on the result.
  - <note> *
    (note)
- <overrides> ?
  List of overrides on the result.
  - <override> *
    (override)

6.11.2 RNC

result
 = element result
     {
       attribute id { uuid }
       & result_name
       & result_owner
       & result_comment
       & result_creation_time
       & result_modification_time
       & result_user_tags?
       & result_report?
       & result_task?
       & result_host
       & result_port
       & result_nvt
       & result_scan_nvt_version
       & result_threat
       & result_severity
       & result_qod
       & result_original_threat?
       & result_original_severity?
       & result_description
       & result_delta?
       & result_details
       & result_detection
       & result_notes?
       & result_overrides?
     }

result_name
 = element name
     {
       text
     }

result_owner
 = element owner
     {
       result_owner_name
     }

result_owner_name
 = element name
     {
       name
     }

result_comment
 = element comment
     {
       text
     }

result_creation_time
 = element creation_time
     {
       iso_time
     }

result_modification_time
 = element modification_time
     {
       iso_time
     }

result_user_tags
 = element user_tags
     {
       result_user_tags_count
       & result_user_tags_tag*
     }

result_user_tags_count
 = element count
     {
       integer
     }

result_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & result_user_tags_tag_name
       & result_user_tags_tag_value
       & result_user_tags_tag_comment
     }

result_user_tags_tag_name
 = element name
     {
       text
     }

result_user_tags_tag_value
 = element value
     {
       text
     }

result_user_tags_tag_comment
 = element comment
     {
       text
     }

result_report
 = element report
     {
       attribute id { uuid }
     }

result_task
 = element task
     {
       attribute id { uuid }
       & result_task_name
     }

result_task_name
 = element name
     {
       text
     }

result_host
 = element host
     {
       text
     }

result_port
 = element port
     {
       text
     }

result_nvt
 = element nvt
     {
       attribute oid { oid }
       & result_nvt_name
       & result_nvt_family
       & result_nvt_cvss_base
       & result_nvt_cve
       & result_nvt_bid
       & result_nvt_tags
       & result_nvt_cert
       & result_nvt_xref
     }

result_nvt_name
 = element name
     {
       name
     }

result_nvt_family
 = element family
     {
       name
     }

result_nvt_cvss_base
 = element cvss_base
     {
       integer
     }

result_nvt_cve
 = element cve
     {
       text
     }

result_nvt_bid
 = element bid
     {
       text
     }

result_nvt_tags
 = element tags
     {
       text
     }

result_nvt_cert
 = element cert
     {
       result_nvt_cert_cert_ref*
     }

result_nvt_cert_cert_ref
 = element cert_ref
     {
       attribute id { text }?
       & attribute type { text }?
     }

result_nvt_xref
 = element xref
     {
       text
     }

result_scan_nvt_version
 = element scan_nvt_version
     {
       text
     }

result_threat
 = element threat
     {
       threat
     }

result_severity
 = element severity
     {
       severity
     }

result_qod
 = element qod
     {
       result_qod_value
       & result_qod_type
     }

result_qod_value
 = element value
     {
       integer
     }

result_qod_type
 = element type
     {
       text
     }

result_original_threat
 = element original_threat
     {
       threat
     }

result_original_severity
 = element original_severity
     {
       severity
     }

result_description
 = element description
     {
       text
     }

result_delta
 = element delta
     {
       text
       & result_delta_result?
       & result_delta_diff?
       & result_delta_notes?
       & result_delta_overrides?
     }

result_delta_result
 = element result    # type result
     {
       attribute id { uuid }
       & result_name
       & result_owner
       & result_comment
       & result_creation_time
       & result_modification_time
       & result_user_tags?
       & result_report?
       & result_task?
       & result_host
       & result_port
       & result_nvt
       & result_scan_nvt_version
       & result_threat
       & result_severity
       & result_qod
       & result_original_threat?
       & result_original_severity?
       & result_description
       & result_delta?
       & result_details
       & result_detection
       & result_notes?
       & result_overrides?
     }

result_delta_diff
 = element diff    # type text
     {
     }

result_delta_notes
 = element notes
     {
       result_delta_notes_note*
     }

result_delta_notes_note
 = element note    # type note
     {
       attribute id { uuid }
       & note_permissions
       & note_owner
       & note_nvt
       & note_text
       & note_creation_time
       & note_modification_time
       & note_writable
       & note_in_use
       & note_active
       & note_orphan
       & note_user_tags
       & ( note_hosts
           & note_port
           & note_severity
           & note_threat
           & note_task
           & note_end_time?
           & note_result? )?
     }

result_delta_overrides
 = element overrides
     {
       result_delta_overrides_override*
     }

result_delta_overrides_override
 = element override    # type override
     {
       attribute id { uuid }
       & override_permissions
       & override_owner
       & override_nvt
       & override_creation_time
       & override_modification_time
       & override_writable
       & override_in_use
       & override_active
       & override_text
       & override_threat
       & override_severity
       & override_new_threat
       & override_new_severity
       & override_orphan
       & override_permissions
       & override_user_tags
       & ( override_hosts
           & override_port
           & override_task
           & override_end_time?
           & override_result? )?
     }

result_details
 = element details
     {
       result_details_detail*
     }

result_details_detail
 = element detail
     {
       result_details_detail_name
       & result_details_detail_value
     }

result_details_detail_name
 = element name
     {
       text
     }

result_details_detail_value
 = element value
     {
       text
     }

result_detection
 = element detection
     {
       result_detection_result
     }

result_detection_result
 = element result
     {
       attribute id { uuid }
       & result_detection_result_details
     }

result_detection_result_details
 = element details
     {
       result_detection_result_details_detail*
     }

result_detection_result_details_detail
 = element detail
     {
       result_detection_result_details_detail_name
       & result_detection_result_details_detail_value
     }

result_detection_result_details_detail_name
 = element name
     {
       text
     }

result_detection_result_details_detail_value
 = element value
     {
       text
     }

result_notes
 = element notes
     {
       result_notes_note*
     }

result_notes_note
 = element note    # type note
     {
       attribute id { uuid }
       & note_permissions
       & note_owner
       & note_nvt
       & note_text
       & note_creation_time
       & note_modification_time
       & note_writable
       & note_in_use
       & note_active
       & note_orphan
       & note_user_tags
       & ( note_hosts
           & note_port
           & note_severity
           & note_threat
           & note_task
           & note_end_time?
           & note_result? )?
     }

result_overrides
 = element overrides
     {
       result_overrides_override*
     }

result_overrides_override
 = element override    # type override
     {
       attribute id { uuid }
       & override_permissions
       & override_owner
       & override_nvt
       & override_creation_time
       & override_modification_time
       & override_writable
       & override_in_use
       & override_active
       & override_text
       & override_threat
       & override_severity
       & override_new_threat
       & override_new_severity
       & override_orphan
       & override_permissions
       & override_user_tags
       & ( override_hosts
           & override_port
           & override_task
           & override_end_time?
           & override_result? )?
     }

6.12 Element `report`

In short: Actually attributes and either base64 or a report.

6.12.1 Structure

- @id (uuid)
- @format_id (uuid)
- @extension (text)
- @content_type (text)
- @type ("scan", "assets" or "prognostic")
- <owner>
  Owner of the report.
  - <name>
    The name of the owner.
- <name>
  Creation time as compatibility placeholder.
- <comment>
  The comment on the report.
- <creation_time>
  Date and time the report was created.
- <modification_time>
  Date and time the report was last modified.
- <writable>
  Whether the report is writable.
- <in_use>
  Whether the report is in use.
- <task>
  The task the report belongs to.
  - @id (uuid)
  - <name>
    The name of the task.
- <report_format>
  The report format used.
  - @id (uuid)
  - <name>
    The name of the report format.
- <report>
  - @id (uuid)
  - @type ("scan", "assets" or "prognostic")
  - <omp>
    Information of the OMP server.
    - <version>
      The OMP version.
  - <report_format>
    - <param>
      Report format parameter.
      - <name>
        Parameter name.
      - <value>
        Parameter value.
  - <sort>
    Result sorting information.
    - <field>
      Sort field.
      - <order>
        Sort order of field.
  - <filters>
    Result filtering information.
    - @id (uuid) Filter used if any, else 0.
    - <term>
      Filter term.
    - <phrase>
      Search phrase.
    - <notes>
      Whether notes are included.
    - <overrides>
      Whether overrides are included.
    - <apply_overrides>
      Whether overrides are applied.
    - <result_hosts_only>
      Whether only those hosts that have results are included.
    - <min_cvss_base>
      Minimum CVSS base if in effect, else empty string.
    - <min_qod>
      Minimum QoD if in effect, else empty string.
    - <autofp>
      Whether to trust vendor security updates. 1 full match, 2 partial.
    - <filter> *
      Level filter.
    - <host> ?
      - <ip>
        IP of single host in report (for "delta" and "prognostic").
    - <delta> ?
      Delta states.
      - <changed>
        Whether changed results are included.
      - <gone>
        Whether results that have vanished are included.
      - <new>
        Whether new results are included.
      - <same>
        Whether results that are equal are included.
  - <severity_class>
    - <name>
      Short severity class name.
    - <full_name>
      Full severity class name.
    - <severity_range> *
      Severity range.
      - <name>
        Name of severity range.
      - <min>
        Minimum CVSS value.
      - <max>
        Maximum CVSS value.
  - <delta> ?
    - <report>
      Second report, for delta reports.
      - @id (uuid)
      - <scan_run_status>
        Run status of task scan at time of report.
      - <timestamp>
        The time the scan was requested.
      - <scan_start>
        Start time of scan.
      - <scan_end>
        End time of scan.
  - The group?
    - <timezone>
      Name of timezone used for dates.
    - <timezone_abbrev>
      Abbreviation used for timezone.
    - <permissions>
      Permissions that the current user has on the report.
      - <permission> *
        <name>
        The name of the permission.
    - <user_tags>
      Info on tags attached to the report.
      - <count>
        Number of attached tags.
      - <tag> *
        Short info on an individual tag (only if details were requested).
        
        @id (uuid) UUID of the tag.
        
        <name>
        Name of the tag (usually namespace:predicate).
        
        <value>
        Value of the tag.
        
        <comment>
        Comment for the tag.
    - <scan_run_status>
      Run status of task scan at time of report.
    - <result_count>
      Counts of results produced by scan.
      - <full>
        Total number of results produced by scan.
      - <filtered>
        Number of results after filtering.
      - <debug>
        Number of "debug" results (threat level Debug).
        
        <full>
        Total number of results.
        
        <filtered>
        Number of results after filtering.
      - <hole>
        Number of "hole" results (threat level High).
        
        <full>
        Total number of results.
        
        <filtered>
        Number of results after filtering.
      - <info>
        Number of "info" results (threat level Low).
        
        <full>
        Total number of results.
        
        <filtered>
        Number of results after filtering.
      - <log>
        Number of "log" results (threat level Log).
        
        <full>
        Total number of results.
        
        <filtered>
        Number of results after filtering.
      - <warning>
        Number of "warning" results (threat level Medium).
        
        <full>
        Total number of results.
        
        <filtered>
        Number of results after filtering.
    - <severity>
      - <full>
        Maximum severity of the full report.
      - <filtered>
        Maximum severity of the report after filtering.
    - <host_count> ?
      Counts of hosts in the results.
      - <full>
        Total number of hosts.
      - <filtered>
        Number of hosts after filtering.
    - <task>
      - @id (uuid)
      - <name>
        The name of the task.
      - <comment>
        Comment for the task.
      - <target>
        The target of the task.
        
        @id (uuid) The UUID of the target.
        
        <trash>
        (boolean)
        
        Whether the target is in the trashcan.
      - <progress>
        The percentage of the task that is complete.
      - <user_tags>
        Info on tags attached to the task.
        
        <count>
        Number of attached tags.
        
        <tag> *
        Short info on an individual tag.
        
        @id (uuid) UUID of the tag.
        
        <name>
        Name of the tag (usually namespace:predicate).
        
        <value>
        Value of the tag.
        
        <comment>
        Comment for the tag.
    - <scan>
      Info from scan time.
      - <task>
        
        <slave>
        The task slave.
        
        @id (uuid)
        
        <name>
        
        <host>
        
        <port>
        
        <preferences>
        Currently only "source_iface".
        
        <preference> *
        
        <name>
        Full name of preference, suitable for end users.
        
        <scanner_name>
        Compact name of preference, from scanner.
        
        <value>
    - <ports>
      - @start (integer)
      - @max (integer)
      - <port> *
        
        <host>
        
        <severity>
        
        <threat>
    - <results>
      - @start (integer)
      - @max (integer)
      - <result> *
        (result)
        
        A result.
    - <hosts>
      - One of
        
        The group
        
        @start (integer)
        
        @max (integer)
        
        <count>
        Number of hosts.
    - <closed_cves>
      .
      - <count>
        The number of closed CVEs.
    - <vulns>
      .
      - <count>
        The number of Vulnerabilities.
    - <os>
      .
      - <count>
        The number of operating systems.
    - <apps>
      .
      - <count>
        The number of Applications.
    - <ssl_certs>
      .
      - <count>
        The number of SSL certificates.
    - <host> *
      - <ip>
        IP of the host.
      - <start>
        Scan start time for this host.
      - <end>
        Scan end time for this host.
      - <port_count>
        .
        
        <page>
        Number of ports of current host on current page.
      - <result_count>
        .
        
        <page>
        Total number of results for current host on current page.
        
        <hole>
        Number of "hole" results (level "High").
        
        <page>
        Number of results on current page.
        
        <warning>
        Number of "warning" results (level "Medium").
        
        <page>
        Number of results on current page.
        
        <info>
        Number of "info" results (level "Low").
        
        <page>
        Number of results on current page.
        
        <log>
        Number of "log" results.
        
        <page>
        Number of results on current page.
        
        <false_positive>
        Number of "false positive" results.
        
        <page>
        Number of results on current page.
      - <detail> *
        A detail associated with the host.
        
        <name>
        The name of the detail.
        
        <value>
        The value of the detail.
        
        <source>
        Where the detail comes from.
        
        <type>
        The type of the detail source.
        
        <name>
        The name of the detail source.
        
        <description>
        A description of the detail source.
    - <timestamp>
      The time the scan was requested.
    - <scan_start>
      Start time of scan.
    - <host_start> *
      Start time of a particular host.
      - <host>
    - <host_end> *
      End time of a particular host.
      - <host>
    - <scan_end>
      End time of scan.
    - <errors>
      - <count>
        The number of error messages.
      - <error> *
        An error message.
        
        <host>
        The host of the error message.
        
        <port>
        The port of the error message.
        
        <description>
        The description of the error message.
        
        <nvt>
        The NVT that generated the error message.
        
        @oid ()
        
        <name>
        The name of the NVT.
        
        <cvss_base>
        The base CVSS score of the NVT.
        
        <scan_nvt_version>
        The NVT version that generated the error.
        
        <severity>
        The severity score of the error message.

6.12.2 RNC

report
 = element report
     {
       text # RNC limitation: base64
       & attribute id { uuid }
       & attribute format_id { uuid }
       & attribute extension { text }
       & attribute content_type { text }
       & attribute type { xsd:token { pattern = "scan|assets|prognostic" } }?
       & report_owner
       & report_name
       & report_comment
       & report_creation_time
       & report_modification_time
       & report_writable
       & report_in_use
       & report_task
       & report_report_format
       & report_report
     }

report_owner
 = element owner
     {
       report_owner_name
     }

report_owner_name
 = element name
     {
       name
     }

report_name
 = element name
     {
       ""
     }

report_comment
 = element comment
     {
       text
     }

report_creation_time
 = element creation_time
     {
       iso_time
     }

report_modification_time
 = element modification_time
     {
       iso_time
     }

report_in_use
 = element in_use
     {
       boolean
     }

report_writable
 = element writable
     {
       boolean
     }

report_task
 = element task
     {
       attribute id { uuid }
       & report_task_name
     }

report_task_name
 = element name
     {
       name
     }

report_report_format
 = element report_format
     {
       attribute id { uuid }
       & report_report_format_name
     }

report_report_format_name
 = element name
     {
       name
     }

report_report
 = element report
     {
       attribute id { uuid }
       & attribute type { xsd:token { pattern = "scan|assets|prognostic" } }?
       & report_report_omp
       & report_report_report_format
       & report_report_sort
       & report_report_filters
       & report_report_severity_class
       & report_report_delta?
       & ( report_report_timezone
           & report_report_timezone_abbrev
           & report_report_permissions
           & report_report_user_tags
           & report_report_scan_run_status
           & report_report_result_count
           & report_report_severity
           & report_report_host_count?
           & report_report_task
           & report_report_scan
           & report_report_ports
           & report_report_results
           & report_report_hosts
           & report_report_closed_cves
           & report_report_vulns
           & report_report_os
           & report_report_apps
           & report_report_ssl_certs
           & report_report_host*
           & report_report_timestamp
           & report_report_scan_start
           & report_report_host_start*
           & report_report_host_end*
           & report_report_scan_end
           & report_report_errors )?
     }

report_report_omp
 = element omp
     {
       report_report_omp_version
     }

report_report_omp_version
 = element version
     {
       text
     }

report_report_report_format
 = element report_format
     {
       report_report_report_format_param
     }

report_report_report_format_param
 = element param
     {
       report_report_report_format_param_name
       & report_report_report_format_param_value
     }

report_report_report_format_param_name
 = element name
     {
       text
     }

report_report_report_format_param_value
 = element value
     {
       text
     }

report_report_delta
 = element delta
     {
       report_report_delta_report
     }

report_report_delta_report
 = element report
     {
       attribute id { uuid }
       & report_report_delta_report_scan_run_status
       & report_report_delta_report_timestamp
       & report_report_delta_report_scan_start
       & report_report_delta_report_scan_end
     }

report_report_delta_report_scan_run_status
 = element scan_run_status
     {
       task_status
     }

report_report_delta_report_timestamp
 = element timestamp
     {
       iso_time
     }

report_report_delta_report_scan_start
 = element scan_start
     {
       iso_time
     }

report_report_delta_report_scan_end
 = element scan_end
     {
       iso_time
     }

report_report_sort
 = element sort
     {
       report_report_sort_field
     }

report_report_sort_field
 = element field
     {
       text
       & report_report_sort_field_order
     }

report_report_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

report_report_filters
 = element filters
     {
       text # RNC limitation: levels
       & attribute id { uuid }?
       & report_report_filters_term
       & report_report_filters_phrase
       & report_report_filters_notes
       & report_report_filters_overrides
       & report_report_filters_apply_overrides
       & report_report_filters_result_hosts_only
       & report_report_filters_min_cvss_base
       & report_report_filters_min_qod
       & report_report_filters_autofp
       & report_report_filters_filter*
       & report_report_filters_host?
       & report_report_filters_delta?
     }

report_report_filters_term
 = element term
     {
       text
     }

report_report_filters_phrase
 = element phrase
     {
       text
     }

report_report_filters_notes
 = element notes
     {
       xsd:token { pattern = "0|1" }
     }

report_report_filters_overrides
 = element overrides
     {
       xsd:token { pattern = "0|1" }
     }

report_report_filters_apply_overrides
 = element apply_overrides
     {
       xsd:token { pattern = "0|1" }
     }

report_report_filters_result_hosts_only
 = element result_hosts_only
     {
       xsd:token { pattern = "0|1" }
     }

report_report_filters_min_cvss_base
 = element min_cvss_base
     {
       text
     }

report_report_filters_min_qod
 = element min_qod
     {
       text
     }

report_report_filters_autofp
 = element autofp
     {
       xsd:token { pattern = "0|1|2" }
     }

report_report_filters_filter
 = element filter
     {
       xsd:token { pattern = "High|Medium|Low|Log|Debug" }
     }

report_report_filters_host
 = element host
     {
       report_report_filters_host_ip
     }

report_report_filters_host_ip
 = element ip
     {
       text
     }

report_report_filters_delta
 = element delta
     {
       text
       & report_report_filters_delta_changed
       & report_report_filters_delta_gone
       & report_report_filters_delta_new
       & report_report_filters_delta_same
     }

report_report_filters_delta_changed
 = element changed
     {
       boolean
     }

report_report_filters_delta_gone
 = element gone
     {
       boolean
     }

report_report_filters_delta_new
 = element new
     {
       boolean
     }

report_report_filters_delta_same
 = element same
     {
       boolean
     }

report_report_timezone
 = element timezone
     {
       timezone
     }

report_report_timezone_abbrev
 = element timezone_abbrev
     {
       text
     }

report_report_permissions
 = element permissions
     {
       report_report_permissions_permission*
     }

report_report_permissions_permission
 = element permission
     {
       report_report_permissions_permission_name
     }

report_report_permissions_permission_name
 = element name
     {
       name
     }

report_report_user_tags
 = element user_tags
     {
       report_report_user_tags_count
       & report_report_user_tags_tag*
     }

report_report_user_tags_count
 = element count
     {
       integer
     }

report_report_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & report_report_user_tags_tag_name
       & report_report_user_tags_tag_value
       & report_report_user_tags_tag_comment
     }

report_report_user_tags_tag_name
 = element name
     {
       text
     }

report_report_user_tags_tag_value
 = element value
     {
       text
     }

report_report_user_tags_tag_comment
 = element comment
     {
       text
     }

report_report_scan_run_status
 = element scan_run_status
     {
       task_status
     }

report_report_result_count
 = element result_count
     {
       text
       & report_report_result_count_full
       & report_report_result_count_filtered
       & report_report_result_count_debug
       & report_report_result_count_hole
       & report_report_result_count_info
       & report_report_result_count_log
       & report_report_result_count_warning
     }

report_report_result_count_full
 = element full
     {
       integer
     }

report_report_result_count_filtered
 = element filtered
     {
       integer
     }

report_report_result_count_debug
 = element debug
     {
       report_report_result_count_debug_full
       & report_report_result_count_debug_filtered
     }

report_report_result_count_debug_full
 = element full
     {
       integer
     }

report_report_result_count_debug_filtered
 = element filtered
     {
       integer
     }

report_report_result_count_hole
 = element hole
     {
       report_report_result_count_hole_full
       & report_report_result_count_hole_filtered
     }

report_report_result_count_hole_full
 = element full
     {
       integer
     }

report_report_result_count_hole_filtered
 = element filtered
     {
       integer
     }

report_report_result_count_info
 = element info
     {
       report_report_result_count_info_full
       & report_report_result_count_info_filtered
     }

report_report_result_count_info_full
 = element full
     {
       integer
     }

report_report_result_count_info_filtered
 = element filtered
     {
       integer
     }

report_report_result_count_log
 = element log
     {
       report_report_result_count_log_full
       & report_report_result_count_log_filtered
     }

report_report_result_count_log_full
 = element full
     {
       integer
     }

report_report_result_count_log_filtered
 = element filtered
     {
       integer
     }

report_report_result_count_warning
 = element warning
     {
       report_report_result_count_warning_full
       & report_report_result_count_warning_filtered
     }

report_report_result_count_warning_full
 = element full
     {
       integer
     }

report_report_result_count_warning_filtered
 = element filtered
     {
       integer
     }

report_report_severity
 = element severity
     {
       report_report_severity_full
       & report_report_severity_filtered
     }

report_report_severity_full
 = element full
     {
       severity
     }

report_report_severity_filtered
 = element filtered
     {
       severity
     }

report_report_severity_class
 = element severity_class
     {
       report_report_severity_class_name
       & report_report_severity_class_full_name
       & report_report_severity_class_severity_range*
     }

report_report_severity_class_name
 = element name
     {
       
        ERROR
      
     }

report_report_severity_class_full_name
 = element full_name
     {
       text
     }

report_report_severity_class_severity_range
 = element severity_range
     {
       report_report_severity_class_severity_range_name
       & report_report_severity_class_severity_range_min
       & report_report_severity_class_severity_range_max
     }

report_report_severity_class_severity_range_name
 = element name
     {
       name
     }

report_report_severity_class_severity_range_min
 = element min
     {
       integer
     }

report_report_severity_class_severity_range_max
 = element max
     {
       integer
     }

report_report_host_count
 = element host_count
     {
       report_report_host_count_full
       & report_report_host_count_filtered
     }

report_report_host_count_full
 = element full
     {
       integer
     }

report_report_host_count_filtered
 = element filtered
     {
       integer
     }

report_report_task
 = element task
     {
       attribute id { uuid }
       & report_report_task_name
       & report_report_task_comment
       & report_report_task_target
       & report_report_task_progress
       & report_report_task_user_tags
     }

report_report_task_name
 = element name
     {
       name
     }

report_report_task_comment
 = element comment
     {
       text
     }

report_report_task_target
 = element target
     {
       attribute id { uuid }?
       & report_report_task_target_trash
     }

report_report_task_target_trash
 = element trash    # type boolean
     {
     }

report_report_task_progress
 = element progress
     {
       integer
     }

report_report_task_user_tags
 = element user_tags
     {
       report_report_task_user_tags_count
       & report_report_task_user_tags_tag*
     }

report_report_task_user_tags_count
 = element count
     {
       integer
     }

report_report_task_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & report_report_task_user_tags_tag_name
       & report_report_task_user_tags_tag_value
       & report_report_task_user_tags_tag_comment
     }

report_report_task_user_tags_tag_name
 = element name
     {
       text
     }

report_report_task_user_tags_tag_value
 = element value
     {
       text
     }

report_report_task_user_tags_tag_comment
 = element comment
     {
       text
     }

report_report_scan
 = element scan
     {
       report_report_scan_task
     }

report_report_scan_task
 = element task
     {
       report_report_scan_task_slave
       & report_report_scan_task_preferences
     }

report_report_scan_task_slave
 = element slave
     {
       attribute id { uuid }
       & report_report_scan_task_slave_name
       & report_report_scan_task_slave_host
       & report_report_scan_task_slave_port
     }

report_report_scan_task_slave_name
 = element name
     {
       name
     }

report_report_scan_task_slave_host
 = element host
     {
       text
     }

report_report_scan_task_slave_port
 = element port
     {
       text
     }

report_report_scan_task_preferences
 = element preferences
     {
       report_report_scan_task_preferences_preference*
     }

report_report_scan_task_preferences_preference
 = element preference
     {
       report_report_scan_task_preferences_preference_name
       & report_report_scan_task_preferences_preference_scanner_name
       & report_report_scan_task_preferences_preference_value
     }

report_report_scan_task_preferences_preference_name
 = element name
     {
       text
     }

report_report_scan_task_preferences_preference_scanner_name
 = element scanner_name
     {
       text
     }

report_report_scan_task_preferences_preference_value
 = element value
     {
       text
     }

report_report_ports
 = element ports
     {
       attribute start { integer }
       & attribute max { integer }
       & report_report_ports_port*
     }

report_report_ports_port
 = element port
     {
       text
       & report_report_ports_port_host
       & report_report_ports_port_severity
       & report_report_ports_port_threat
     }

report_report_ports_port_host
 = element host
     {
       text
     }

report_report_ports_port_severity
 = element severity
     {
       severity
     }

report_report_ports_port_threat
 = element threat
     {
       threat
     }

report_report_results
 = element results
     {
       attribute start { integer }
       & attribute max { integer }
       & report_report_results_result*
     }

report_report_results_result
 = element result    # type result
     {
       attribute id { uuid }
       & result_name
       & result_owner
       & result_comment
       & result_creation_time
       & result_modification_time
       & result_user_tags?
       & result_report?
       & result_task?
       & result_host
       & result_port
       & result_nvt
       & result_scan_nvt_version
       & result_threat
       & result_severity
       & result_qod
       & result_original_threat?
       & result_original_severity?
       & result_description
       & result_delta?
       & result_details
       & result_detection
       & result_notes?
       & result_overrides?
     }

report_report_hosts
 = element hosts
     {
       ( ( attribute start { integer }
           & attribute max { integer } )
           | report_report_hosts_count )
     }

report_report_hosts_count
 = element count
     {
     }

report_report_closed_cves
 = element closed_cves
     {
       report_report_closed_cves_count
     }

report_report_closed_cves_count
 = element count
     {
     }

report_report_vulns
 = element vulns
     {
       report_report_vulns_count
     }

report_report_vulns_count
 = element count
     {
     }

report_report_os
 = element os
     {
       report_report_os_count
     }

report_report_os_count
 = element count
     {
     }

report_report_apps
 = element apps
     {
       report_report_apps_count
     }

report_report_apps_count
 = element count
     {
     }

report_report_ssl_certs
 = element ssl_certs
     {
       report_report_ssl_certs_count
     }

report_report_ssl_certs_count
 = element count
     {
     }

report_report_host
 = element host
     {
       report_report_host_ip
       & report_report_host_start
       & report_report_host_end
       & report_report_host_port_count
       & report_report_host_result_count
       & report_report_host_detail*
     }

report_report_host_ip
 = element ip
     {
       text
     }

report_report_host_start
 = element start
     {
       text
     }

report_report_host_end
 = element end
     {
       text
     }

report_report_host_port_count
 = element port_count
     {
       report_report_host_port_count_page
     }

report_report_host_port_count_page
 = element page
     {
       integer
     }

report_report_host_result_count
 = element result_count
     {
       report_report_host_result_count_page
       & report_report_host_result_count_hole
       & report_report_host_result_count_warning
       & report_report_host_result_count_info
       & report_report_host_result_count_log
       & report_report_host_result_count_false_positive
     }

report_report_host_result_count_page
 = element page
     {
       integer
     }

report_report_host_result_count_hole
 = element hole
     {
       report_report_host_result_count_hole_page
     }

report_report_host_result_count_hole_page
 = element page
     {
       integer
     }

report_report_host_result_count_warning
 = element warning
     {
       report_report_host_result_count_warning_page
     }

report_report_host_result_count_warning_page
 = element page
     {
       integer
     }

report_report_host_result_count_info
 = element info
     {
       report_report_host_result_count_info_page
     }

report_report_host_result_count_info_page
 = element page
     {
       integer
     }

report_report_host_result_count_log
 = element log
     {
       report_report_host_result_count_log_page
     }

report_report_host_result_count_log_page
 = element page
     {
       integer
     }

report_report_host_result_count_false_positive
 = element false_positive
     {
       report_report_host_result_count_false_positive_page
     }

report_report_host_result_count_false_positive_page
 = element page
     {
       integer
     }

report_report_host_detail
 = element detail
     {
       report_report_host_detail_name
       & report_report_host_detail_value
       & report_report_host_detail_source
     }

report_report_host_detail_name
 = element name
     {
       text
     }

report_report_host_detail_value
 = element value
     {
       text
     }

report_report_host_detail_source
 = element source
     {
       report_report_host_detail_source_type
       & report_report_host_detail_source_name
       & report_report_host_detail_source_description
     }

report_report_host_detail_source_type
 = element type
     {
       text
     }

report_report_host_detail_source_name
 = element name
     {
       text
     }

report_report_host_detail_source_description
 = element description
     {
       text
     }

report_report_timestamp
 = element timestamp
     {
       iso_time
     }

report_report_scan_start
 = element scan_start
     {
       iso_time
     }

report_report_host_start
 = element host_start
     {
       text # RNC limitation: iso_time
       & report_report_host_start_host
     }

report_report_host_start_host
 = element host
     {
       text
     }

report_report_host_end
 = element host_end
     {
       text # RNC limitation: iso_time
       & report_report_host_end_host
     }

report_report_host_end_host
 = element host
     {
       text
     }

report_report_scan_end
 = element scan_end
     {
       iso_time
     }

report_report_errors
 = element errors
     {
       report_report_errors_count
       & report_report_errors_error*
     }

report_report_errors_count
 = element count
     {
     }

report_report_errors_error
 = element error
     {
       report_report_errors_error_host
       & report_report_errors_error_port
       & report_report_errors_error_description
       & report_report_errors_error_nvt
       & report_report_errors_error_scan_nvt_version
       & report_report_errors_error_severity
     }

report_report_errors_error_host
 = element host
     {
       text
     }

report_report_errors_error_port
 = element port
     {
       port
     }

report_report_errors_error_description
 = element description
     {
       text
     }

report_report_errors_error_nvt
 = element nvt
     {
       attribute oid {  }
       & report_report_errors_error_nvt_name
       & report_report_errors_error_nvt_cvss_base
     }

report_report_errors_error_nvt_name
 = element name
     {
       text
     }

report_report_errors_error_nvt_cvss_base
 = element cvss_base
     {
       severity
     }

report_report_errors_error_scan_nvt_version
 = element scan_nvt_version
     {
       text
     }

report_report_errors_error_severity
 = element severity
     {
       severity
     }

7 Command Details

7.1 Command `authenticate`

In short: Authenticate with the manager.

The client uses the authenticate command to authenticate with the Manager.

The client normally executes this command at the beginning of each connection. The only commands permitted before authentication are get_version and commands.

7.1.1 Structure

Command
- <credentials>
  - <username>
    The login name of the user.
  - <password>
    The user's password.
Response
- @status (status)
- @status_text (text)
- <role>
  ("User", "Admin", "Super Admin" or "Observer")
  
  The user's role.
- <timezone>
  The user's timezone.

7.1.2 RNC

Command

authenticate
 = element authenticate
     {
       authenticate_credentials
     }

authenticate_credentials
 = element credentials
     {
       authenticate_credentials_username
       & authenticate_credentials_password
     }

authenticate_credentials_username
 = element username
     {
       text
     }

authenticate_credentials_password
 = element password
     {
       text
     }

Response

authenticate_response
 = element authenticate_response
     {
       attribute status { status }
       & attribute status_text { text }
       & authenticate_response_role
       & authenticate_response_timezone
     }

authenticate_response_role
 = element role    # type UserAdminSuper AdminObserver
     {
     }

authenticate_response_timezone
 = element timezone
     {
       timezone
     }

7.1.3 Example: Authenticate with a good password

Client

 <authenticate>
   <credentials>
     <username>sally</username>
     <password>secret</password>
   </credentials>
 </authenticate>

Manager

 <authenticate_response status="200"
                        status_text="OK">
   <role>User</role>
   <timezone>UTC</timezone>
 </authenticate_response>

7.1.3 Example: Authenticate with a bad password

Client

 <authenticate>
   <credentials>
     <username>sally</username>
     <password>secrte</password>
   </credentials>
 </authenticate>

Manager

 <authenticate_response status="400"
                        status_text="Authentication failed"/>

7.2 Command `commands`

In short: Run a list of commands.

The client uses the commands command to run a list of commands. The elements are executed as OMP commands in the given sequence. The reply contains the result of each command, in the same order as the given commands.

7.2.1 Structure

Command
- One of*
  - <authenticate>
    authenticate command.
  - <commands>
    commands command.
  - <create_agent>
    create_agent command.
  - <create_alert>
    create_alert command.
  - <create_config>
    create_config command.
  - <create_filter>
    create_filter command.
  - <create_group>
    create_group command.
  - <create_lsc_credential>
    create_lsc_credential command.
  - <create_note>
    create_note command.
  - <create_override>
    create_override command.
  - <create_permission>
    create_permission command.
  - <create_port_list>
    create_port_list command.
  - <create_port_range>
    create_port_range command.
  - <create_report_format>
    create_report_format command.
  - <create_role>
    create_role command.
  - <create_scanner>
    create_scanner command.
  - <create_schedule>
    create_schedule command.
  - <create_slave>
    create_slave command.
  - <create_tag>
    create_tag command.
  - <create_target>
    create_target command.
  - <create_task>
    create_task command.
  - <create_user>
    create_user command.
  - <delete_agent>
    delete_agent command.
  - <delete_alert>
    delete_alert command.
  - <delete_config>
    delete_config command.
  - <delete_filter>
    delete_filter command.
  - <delete_group>
    delete_group command.
  - <delete_lsc_credential>
    delete_lsc_credential command.
  - <delete_note>
    delete_note command.
  - <delete_override>
    delete_override command.
  - <delete_permission>
    delete_permission command.
  - <delete_report>
    delete_report command.
  - <delete_report_format>
    delete_report_format command.
  - <delete_role>
    delete_role command.
  - <delete_port_list>
    delete_port_list command.
  - <delete_port_range>
    delete_port_range command.
  - <delete_scanner>
    delete_scanner command.
  - <delete_schedule>
    delete_schedule command.
  - <delete_slave>
    delete_slave command.
  - <delete_tag>
    delete_tag command.
  - <delete_target>
    delete_target command.
  - <delete_task>
    delete_task command.
  - <delete_user>
    delete_user command.
  - <describe_auth>
    describe_auth command.
  - <describe_cert>
    describe_cert command.
  - <describe_feed>
    describe_feed command.
  - <describe_scap>
    describe_scap command.
  - <empty_trashcan>
    empty_trashcan command.
  - <get_agents>
    get_agents command.
  - <get_alerts>
    get_alerts command.
  - <get_configs>
    get_configs command.
  - <get_filters>
    get_filters command.
  - <get_groups>
    get_groups command.
  - <get_info>
    get_info command.
  - <get_lsc_credentials>
    get_lsc_credentials command.
  - <get_notes>
    get_notes command.
  - <get_nvts>
    get_nvts command.
  - <get_nvt_families>
    get_nvt_families command.
  - <get_nvt_feed_version>
    get_nvt_feed_version command.
  - <get_overrides>
    get_overrides command.
  - <get_permissions>
    get_permissions command.
  - <get_port_lists>
    get_port_lists command.
  - <get_preferences>
    get_preferences command.
  - <get_reports>
    get_reports command.
  - <get_report_formats>
    get_report_formats command.
  - <get_results>
    get_results command.
  - <get_roles>
    get_roles command.
  - <get_scanners>
    get_scanners command.
  - <get_schedules>
    get_schedules command.
  - <get_settings>
    get_settings command.
  - <get_slaves>
    get_slaves command.
  - <get_system_reports>
    get_system_reports command.
  - <get_tags>
    get_tags command.
  - <get_targets>
    get_targets command.
  - <get_tasks>
    get_tasks command.
  - <get_users>
    get_users command.
  - <get_version>
    get_version command.
  - <help>
    help command.
  - <modify_agent>
    modify_agent command.
  - <modify_alert>
    modify_alert command.
  - <modify_auth>
    modify_auth command.
  - <modify_config>
    modify_config command.
  - <modify_filter>
    modify_filter command.
  - <modify_group>
    modify_group command.
  - <modify_lsc_credential>
    modify_lsc_credential command.
  - <modify_note>
    modify_note command.
  - <modify_override>
    modify_override command.
  - <modify_permission>
    modify_permission command.
  - <modify_port_list>
    modify_port_list command.
  - <modify_report>
    modify_report command.
  - <modify_report_format>
    modify_report_format command.
  - <modify_role>
    modify_role command.
  - <modify_scanner>
    modify_scanner command.
  - <modify_schedule>
    modify_schedule command.
  - <modify_setting>
    modify_setting command.
  - <modify_slave>
    modify_slave command.
  - <modify_tag>
    modify_tag command.
  - <modify_target>
    modify_target command.
  - <modify_task>
    modify_task command.
  - <modify_user>
    modify_user command.
  - <restore>
    restore command.
  - <resume_task>
    resume_task command.
  - <run_wizard>
    run_wizard command.
  - <start_task>
    start_task command.
  - <stop_task>
    stop_task command.
  - <sync_feed>
    sync_feed command.
  - <sync_scap>
    sync_scap command.
  - <sync_cert>
    sync_cert command.
  - <test_alert>
    test_alert command.
Response
- @status (status)
- @status_text (text)
- One of*
  - <authenticate_response>
    Response to authenticate command.
  - <commands_response>
    Response to commands command.
  - <create_agent_response>
    Response to create_agent command.
  - <create_alert_response>
    Response to create_alert command.
  - <create_config_response>
    Response to create_config command.
  - <create_filter_response>
    Response to create_filter command.
  - <create_group_response>
    Response to create_group command.
  - <create_lsc_credential_response>
    Response to create_lsc_credential command.
  - <create_note_response>
    Response to create_note command.
  - <create_override_response>
    Response to create_override command.
  - <create_permission_response>
    Response to create_permission command.
  - <create_port_list_response>
    Response to create_port_list command.
  - <create_port_range_response>
    Response to create_port_range command.
  - <create_role_response>
    Response to create_role command.
  - <create_scanner_response>
    Response to create_scanner command.
  - <create_schedule_response>
    Response to create_schedule command.
  - <create_slave_response>
    Response to create_slave command.
  - <create_tag_response>
    Response to create_tag command.
  - <create_target_response>
    Response to create_target command.
  - <create_task_response>
    Response to create_task command.
  - <create_user_response>
    Response to create_user command.
  - <delete_agent_response>
    Response to delete_agent command.
  - <delete_alert_response>
    Response to delete_alert command.
  - <delete_config_response>
    Response to delete_config command.
  - <delete_filter_response>
    Response to delete_filter command.
  - <delete_group_response>
    Response to delete_group command.
  - <delete_lsc_credential_response>
    Response to delete_lsc_credential command.
  - <delete_note_response>
    Response to delete_note command.
  - <delete_override_response>
    Response to delete_override command.
  - <delete_permission_response>
    Response to delete_permission command.
  - <delete_port_list_response>
    Response to delete_port_list command.
  - <delete_port_range_response>
    Response to delete_port_range command.
  - <delete_report_response>
    Response to delete_report command.
  - <delete_report_format_response>
    Response to delete_report_format command.
  - <delete_role_response>
    Response to delete_role command.
  - <delete_scanner_response>
    Response to delete_scanner command.
  - <delete_schedule_response>
    Response to delete_schedule command.
  - <delete_slave_response>
    Response to delete_slave command.
  - <delete_tag_response>
    Response to delete_tag command.
  - <delete_target_response>
    Response to delete_target command.
  - <delete_task_response>
    Response to delete_task command.
  - <delete_user_response>
    Response to delete_user command.
  - <describe_auth_response>
    Response to describe_auth command.
  - <describe_cert_response>
    Response to describe_cert command.
  - <describe_feed_response>
    Response to describe_feed command.
  - <describe_scap_response>
    Response to describe_scap command.
  - <empty_trashcan_response>
    Response to empty_trashcan command.
  - <get_agents_response>
    Response to get_agents command.
  - <get_alerts_response>
    Response to get_alerts command.
  - <get_configs_response>
    Response to get_configs command.
  - <get_groups_response>
    Response to get_groups command.
  - <get_info_response>
    Response to get_info command.
  - <get_lsc_credentials_response>
    Response to get_lsc_credentials command.
  - <get_filters_response>
    Response to get_filters command.
  - <get_notes_response>
    Response to get_notes command.
  - <get_nvts_response>
    Response to get_nvts command.
  - <get_nvt_families_response>
    Response to get_nvt_families command.
  - <get_nvt_feed_version_response>
    Response to get_nvt_feed_version command.
  - <get_overrides_response>
    Response to get_overrides command.
  - <get_permissions_response>
    Response to get_permissions command.
  - <get_port_lists_response>
    Response to get_port_lists command.
  - <get_preferences_response>
    Response to get_preferences command.
  - <get_reports_response>
    Response to get_reports command.
  - <get_report_formats_response>
    Response to get_report_formats command.
  - <get_results_response>
    Response to get_results command.
  - <get_roles_response>
    Response to get_roles command.
  - <get_slaves_response>
    Response to get_slaves command.
  - <get_scanners_response>
    Response to get_scanners command.
  - <get_schedules_response>
    Response to get_schedules command.
  - <get_settings_response>
    Response to get_settings command.
  - <get_system_reports_response>
    Response to get_system_reports command.
  - <get_tags_response>
    Response to get_tags command.
  - <get_targets_response>
    Response to get_targets command.
  - <get_tasks_response>
    Response to get_tasks command.
  - <get_users_response>
    Response to get_users command.
  - <get_version_response>
    Response to get_version command.
  - <help_response>
    Response to help command.
  - <modify_agent_response>
    Response to modify_agent command.
  - <modify_alert_response>
    Response to modify_alert command.
  - <modify_auth_response>
    Response to modify_auth command.
  - <modify_config_response>
    Response to modify_config command.
  - <modify_filter_response>
    Response to modify_filter command.
  - <modify_group_response>
    Response to modify_group command.
  - <modify_lsc_credential_response>
    Response to modify_lsc_credential command.
  - <modify_note_response>
    Response to modify_note command.
  - <modify_override_response>
    Response to modify_override command.
  - <modify_permission_response>
    Response to modify_permission command.
  - <modify_port_list_response>
    Response to modify_port_list command.
  - <modify_report_response>
    Response to modify_report command.
  - <modify_report_format_response>
    Response to modify_report_format command.
  - <modify_role_response>
    Response to modify_role command.
  - <modify_scanner_response>
    Response to modify_scanner command.
  - <modify_schedule_response>
    Response to modify_schedule command.
  - <modify_setting_response>
    Response to modify_setting command.
  - <modify_slave_response>
    Response to modify_slave command.
  - <modify_tag_response>
    Response to modify_tag command.
  - <modify_target_response>
    Response to modify_target command.
  - <modify_task_response>
    Response to modify_task command.
  - <modify_user_response>
    Response to modify_user command.
  - <restore_response>
    Response to restore command.
  - <resume_task_response>
    Response to resume_task command.
  - <run_wizard_response>
    Response to run_wizard command.
  - <start_task_response>
    Response to start_task command.
  - <stop_task_response>
    Response to stop_task command.
  - <sync_feed_response>
    Response to sync_feed command.
  - <sync_scap_response>
    Response to sync_scap command.
  - <sync_cert_response>
    Response to sync_cert command.
  - <test_alert_response>
    Response to test_alert command.

7.2.2 RNC

Command

commands
 = element commands
     {
       ( authenticate
           | commands
           | create_agent
           | create_alert
           | create_config
           | create_filter
           | create_group
           | create_lsc_credential
           | create_note
           | create_override
           | create_permission
           | create_port_list
           | create_port_range
           | create_report_format
           | create_role
           | create_scanner
           | create_schedule
           | create_slave
           | create_tag
           | create_target
           | create_task
           | create_user
           | delete_agent
           | delete_alert
           | delete_config
           | delete_filter
           | delete_group
           | delete_lsc_credential
           | delete_note
           | delete_override
           | delete_permission
           | delete_report
           | delete_report_format
           | delete_role
           | delete_port_list
           | delete_port_range
           | delete_scanner
           | delete_schedule
           | delete_slave
           | delete_tag
           | delete_target
           | delete_task
           | delete_user
           | describe_auth
           | describe_cert
           | describe_feed
           | describe_scap
           | empty_trashcan
           | get_agents
           | get_alerts
           | get_configs
           | get_filters
           | get_groups
           | get_info
           | get_lsc_credentials
           | get_notes
           | get_nvts
           | get_nvt_families
           | get_nvt_feed_version
           | get_overrides
           | get_permissions
           | get_port_lists
           | get_preferences
           | get_reports
           | get_report_formats
           | get_results
           | get_roles
           | get_scanners
           | get_schedules
           | get_settings
           | get_slaves
           | get_system_reports
           | get_tags
           | get_targets
           | get_tasks
           | get_users
           | get_version
           | help
           | modify_agent
           | modify_alert
           | modify_auth
           | modify_config
           | modify_filter
           | modify_group
           | modify_lsc_credential
           | modify_note
           | modify_override
           | modify_permission
           | modify_port_list
           | modify_report
           | modify_report_format
           | modify_role
           | modify_scanner
           | modify_schedule
           | modify_setting
           | modify_slave
           | modify_tag
           | modify_target
           | modify_task
           | modify_user
           | restore
           | resume_task
           | run_wizard
           | start_task
           | stop_task
           | sync_feed
           | sync_scap
           | sync_cert
           | test_alert )*
     }

Response

commands_response
 = element commands_response
     {
       attribute status { status }
       & attribute status_text { text }
       & ( authenticate_response
           | commands_response
           | create_agent_response
           | create_alert_response
           | create_config_response
           | create_filter_response
           | create_group_response
           | create_lsc_credential_response
           | create_note_response
           | create_override_response
           | create_permission_response
           | create_port_list_response
           | create_port_range_response
           | create_role_response
           | create_scanner_response
           | create_schedule_response
           | create_slave_response
           | create_tag_response
           | create_target_response
           | create_task_response
           | create_user_response
           | delete_agent_response
           | delete_alert_response
           | delete_config_response
           | delete_filter_response
           | delete_group_response
           | delete_lsc_credential_response
           | delete_note_response
           | delete_override_response
           | delete_permission_response
           | delete_port_list_response
           | delete_port_range_response
           | delete_report_response
           | delete_report_format_response
           | delete_role_response
           | delete_scanner_response
           | delete_schedule_response
           | delete_slave_response
           | delete_tag_response
           | delete_target_response
           | delete_task_response
           | delete_user_response
           | describe_auth_response
           | describe_cert_response
           | describe_feed_response
           | describe_scap_response
           | empty_trashcan_response
           | get_agents_response
           | get_alerts_response
           | get_configs_response
           | get_groups_response
           | get_info_response
           | get_lsc_credentials_response
           | get_filters_response
           | get_notes_response
           | get_nvts_response
           | get_nvt_families_response
           | get_nvt_feed_version_response
           | get_overrides_response
           | get_permissions_response
           | get_port_lists_response
           | get_preferences_response
           | get_reports_response
           | get_report_formats_response
           | get_results_response
           | get_roles_response
           | get_slaves_response
           | get_scanners_response
           | get_schedules_response
           | get_settings_response
           | get_system_reports_response
           | get_tags_response
           | get_targets_response
           | get_tasks_response
           | get_users_response
           | get_version_response
           | help_response
           | modify_agent_response
           | modify_alert_response
           | modify_auth_response
           | modify_config_response
           | modify_filter_response
           | modify_group_response
           | modify_lsc_credential_response
           | modify_note_response
           | modify_override_response
           | modify_permission_response
           | modify_port_list_response
           | modify_report_response
           | modify_report_format_response
           | modify_role_response
           | modify_scanner_response
           | modify_schedule_response
           | modify_setting_response
           | modify_slave_response
           | modify_tag_response
           | modify_target_response
           | modify_task_response
           | modify_user_response
           | restore_response
           | resume_task_response
           | run_wizard_response
           | start_task_response
           | stop_task_response
           | sync_feed_response
           | sync_scap_response
           | sync_cert_response
           | test_alert_response )*
     }

7.3 Command `create_agent`

In short: Create an agent.

The client uses the create_agent command to create a new agent.

7.3.1 Structure

Command
- <installer>
  A file that installs the agent on a target machine.
  - <signature>
    A detached OpenPGP signature of the installer.
- <name>
  A name for the installer.
- <comment> ?
  A comment on the agent.
- <copy> ?
  The UUID of an existing agent.
- <howto_install> ?
  A file that describes how to install the agent.
- <howto_use> ?
  A file that describes how to use the agent.
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.3.2 RNC

Command

create_agent
 = element create_agent
     {
       create_agent_installer
       & create_agent_name
       & create_agent_comment?
       & create_agent_copy?
       & create_agent_howto_install?
       & create_agent_howto_use?
     }

create_agent_installer
 = element installer
     {
       text # RNC limitation: base64
       & create_agent_installer_signature
     }

create_agent_installer_signature
 = element signature
     {
       base64
     }

create_agent_name
 = element name
     {
       name
     }

create_agent_comment
 = element comment
     {
       text
     }

create_agent_copy
 = element copy
     {
       uuid
     }

create_agent_howto_install
 = element howto_install
     {
       base64
     }

create_agent_howto_use
 = element howto_use
     {
       base64
     }

Response

create_agent_response
 = element create_agent_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.3.3 Example: Create an agent

Client

 <create_agent>
   <installer>
     asdf3235saf3kjBVF...
     <signature>iEYEABECAAYFA...</signature>
   </installer>
   <name>SLAD</name>
 </create_agent>

Manager

 <create_agent_response status="201"
                        status_text="OK, resource created"
                        id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6"/>

7.4 Command `create_config`

In short: Create a config.

The client uses the create_config command to create a new config.

This command can be called in three ways:

With a copy element. The new config is a copy of the existing config, with the given name.
With an embedded get_configs response element. The config is created as defined by the get_configs response element. Name is actually optional in this case. The config is given the name of the config in the get_configs response. If there is already a config with this name, then a number is attached to the name to make it unique.

7.4.1 Structure

Command
- <comment> ?
  A comment on the config.
- One of
  - <copy>
    The UUID of an existing config.
  - <get_configs_response>
    Response to get_configs command.
- <name>
  A name for the config.
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.4.2 RNC

Command

create_config
 = element create_config
     {
       create_config_comment?
       & ( create_config_copy
           | get_configs_response )
       & create_config_name
     }

create_config_comment
 = element comment
     {
       text
     }

create_config_copy
 = element copy
     {
       uuid
     }

create_config_name
 = element name
     {
       name
     }

Response

create_config_response
 = element create_config_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.4.3 Example: Copy a config

Client

 <create_config>
   <copy>daba56c8-73ec-11df-a475-002264764cea</copy>
   <name>Full</name>
 </create_config>

Manager

 <create_config_response status="201"
                         status_text="OK, resource created"
                         id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6"/>

7.4.3 Example: Create a config from a GET_CONFIGS response

Client

 <create_config>
   <get_configs_response>
     <config id="daba56c8-73ec-11df-a475-002264764cea">
       <name>Full and fast</name>
       ...
     </config>
   </get_configs_response>
 </create_config>

Manager

 <create_config_response status="201"
                         status_text="OK, resource created"
                         id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6"/>

7.5 Command `create_alert`

In short: Create an alert.

The client uses the create_alert command to create a new alert.

7.5.1 Structure

Command
- <name>
  A name for the alert.
- <comment> ?
  A comment on the alert.
- <copy> ?
  The UUID of an existing alert.
- <condition>
  The condition that must be satisfied for the alert to occur.
  - <data> *
    Some data that defines the condition.
    - <name>
      The name of the condition data.
- <event>
  The event that must happen for the alert to occur.
  - <data> *
    Some data that defines the event.
    - <name>
      The name of the event data.
- <method>
  The method by which the user is alerted.
  - <data> *
    Some data that defines the method.
    - <name>
      The name of the method data.
- <filter>
  Filter to apply when executing alert.
  - @id (uuid)
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.5.2 RNC

Command

create_alert
 = element create_alert
     {
       create_alert_name
       & create_alert_comment?
       & create_alert_copy?
       & create_alert_condition
       & create_alert_event
       & create_alert_method
       & create_alert_filter
     }

create_alert_name
 = element name
     {
       name
     }

create_alert_comment
 = element comment
     {
       text
     }

create_alert_copy
 = element copy
     {
       uuid
     }

create_alert_condition
 = element condition
     {
       text
       & create_alert_condition_data*
     }

create_alert_condition_data
 = element data
     {
       text
       & create_alert_condition_data_name
     }

create_alert_condition_data_name
 = element name
     {
       text
     }

create_alert_event
 = element event
     {
       text
       & create_alert_event_data*
     }

create_alert_event_data
 = element data
     {
       text
       & create_alert_event_data_name
     }

create_alert_event_data_name
 = element name
     {
       text
     }

create_alert_method
 = element method
     {
       text
       & create_alert_method_data*
     }

create_alert_method_data
 = element data
     {
       text
       & create_alert_method_data_name
     }

create_alert_method_data_name
 = element name
     {
       text
     }

create_alert_filter
 = element filter
     {
       attribute id { uuid }
     }

Response

create_alert_response
 = element create_alert_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.5.3 Example: Create an alert

Client

 <create_alert>
   <name>emergency</name>
   <condition>
     Severity at least
     <data>
       5.5
       <name>severity</name>
     </data>
   </condition>
   <event>
     Task run status changed
     <data>
       Done
       <name>status</name>
     </data>
   </event>
   <method>
     Email
     <data>
       sally@example.org
       <name>to_address</name>
     </data>
     <data>
       bob@example.org
       <name>from_address</name>
     </data>
   </method>
 </create_alert>

Manager

 <create_alert_response status="201"
                        status_text="OK, resource created"
                        id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6"/>

7.6 Command `create_filter`

In short: Create a filter.

The client uses the create_filter command to create a new filter.

7.6.1 Structure

Command
- <name>
  A name for the filter.
  - <make_unique>
    Whether to append a unique suffix if the name already exists.
- <comment> ?
  A comment on the filter.
- <copy> ?
  The UUID of an existing filter.
- <term> ?
  Filter term.
- <type> ?
  Resource type.
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.6.2 RNC

Command

create_filter
 = element create_filter
     {
       create_filter_name
       & create_filter_comment?
       & create_filter_copy?
       & create_filter_term?
       & create_filter_type?
     }

create_filter_name
 = element name
     {
       text # RNC limitation: name
       & create_filter_name_make_unique
     }

create_filter_name_make_unique
 = element make_unique
     {
       boolean
     }

create_filter_comment
 = element comment
     {
       text
     }

create_filter_copy
 = element copy
     {
       uuid
     }

create_filter_term
 = element term
     {
       text
     }

create_filter_type
 = element type
     {
       text
     }

Response

create_filter_response
 = element create_filter_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.6.3 Example: Create a filter

Client

 <create_filter>
   <name>Single Targets</name>
   <comment>Targets with only one host</comment>
   <term>ips=1 first=1 rows=-2</term>
   <type>target</type>
 </create_filter>

Manager

 <create_filter_response status="201"
                         status_text="OK, resource created"
                         id="254cd3ef-bbe1-4d58-859d-21b8d0c046c7"/>

7.7 Command `create_group`

In short: Create a group.

The client uses the create_group command to create a new group.

7.7.1 Structure

Command
- <name>
  A name for the group.
- <comment> ?
  A comment on the group.
- <copy> ?
  The UUID of an existing group.
- <users> ?
  Comma separated list of user names.
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.7.2 RNC

Command

create_group
 = element create_group
     {
       create_group_name
       & create_group_comment?
       & create_group_copy?
       & create_group_users?
     }

create_group_name
 = element name
     {
       name
     }

create_group_comment
 = element comment
     {
       text
     }

create_group_copy
 = element copy
     {
       uuid
     }

create_group_users
 = element users
     {
       text
     }

Response

create_group_response
 = element create_group_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.7.3 Example: Create a group

Client

 <create_group>
   <name>Managers</name>
   <users>sarah, bob</users>
 </create_group>

Manager

 <create_group_response status="201"
                        status_text="OK, resource created"
                        id="d94211b6-ba40-11e3-bcb1-406186ea4fc5"/>

7.8 Command `create_lsc_credential`

In short: Create an LSC credential.

The client uses the create_lsc_credential command to create a new LSC credential.

If the command includes a key, then the manager creates a key-based credential from the key. If the command includes a password, then the manager creates a password only credential. Otherwise the manager autogenerates a key-based credential.

7.8.1 Structure

Command
- <name>
  A name for the LSC credential.
- <comment> ?
  A comment on the LSC credential.
- <copy> ?
  The UUID of an existing LSC credential.
- <key> ?
  - <phrase>
    Key passphrase.
  - <private>
    Private key.
- <login>
  The user name of the credential.
- <password> ?
  The password for the credential login.
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.8.2 RNC

Command

create_lsc_credential
 = element create_lsc_credential
     {
       create_lsc_credential_name
       & create_lsc_credential_comment?
       & create_lsc_credential_copy?
       & create_lsc_credential_key?
       & create_lsc_credential_login
       & create_lsc_credential_password?
     }

create_lsc_credential_name
 = element name
     {
       name
     }

create_lsc_credential_comment
 = element comment
     {
       text
     }

create_lsc_credential_copy
 = element copy
     {
       uuid
     }

create_lsc_credential_key
 = element key
     {
       create_lsc_credential_key_phrase
       & create_lsc_credential_key_private
     }

create_lsc_credential_key_phrase
 = element phrase
     {
       text
     }

create_lsc_credential_key_private
 = element private
     {
       text
     }

create_lsc_credential_login
 = element login
     {
       text
     }

create_lsc_credential_password
 = element password
     {
       text
     }

Response

create_lsc_credential_response
 = element create_lsc_credential_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.8.3 Example: Create an LSC credential

Client

 <create_lsc_credential>
   <name>cluster sally</name>
   <login>sally</login>
   <password>secret</password>
   <comment>Sally's login to the cluster.</comment>
 </create_lsc_credential>

Manager

 <create_lsc_credential_response status="201"
                                 status_text="OK, resource created"
                                 id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6"/>

7.9 Command `create_note`

In short: Create a note.

The client uses the create_note command to create a new note.

7.9.1 Structure

Command
- <text>
  The text of the note.
- <nvt>
  NVT to which note applies.
  - @oid (oid)
- <active> ?
  Seconds note will be active. -1 on always, 0 off.
- <comment> ?
  A comment on the note.
- <copy> ?
  The UUID of an existing note.
- <hosts> ?
  A textual list of hosts.
- <port> ?
  Port to which note applies.
- <result> ?
  Result to which note applies.
  - @id (uuid)
- <severity> ?
  Severity to which note applies.
- <task> ?
  Task to which note applies.
  - @id (uuid)
- <threat> ?
  Threat level to which note applies. Will be converted to severity.
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.9.2 RNC

Command

create_note
 = element create_note
     {
       create_note_text
       & create_note_nvt
       & create_note_active?
       & create_note_comment?
       & create_note_copy?
       & create_note_hosts?
       & create_note_port?
       & create_note_result?
       & create_note_severity?
       & create_note_task?
       & create_note_threat?
     }

create_note_text
 = element text
     {
       text
     }

create_note_nvt
 = element nvt
     {
       attribute oid { oid }
     }

create_note_active
 = element active
     {
       integer
     }

create_note_comment
 = element comment
     {
       text
     }

create_note_copy
 = element copy
     {
       uuid
     }

create_note_hosts
 = element hosts
     {
       text
     }

create_note_port
 = element port
     {
       text
     }

create_note_result
 = element result
     {
       attribute id { uuid }
     }

create_note_severity
 = element severity
     {
       severity
     }

create_note_task
 = element task
     {
       attribute id { uuid }
     }

create_note_threat
 = element threat
     {
       threat
     }

Response

create_note_response
 = element create_note_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.9.3 Example: Create a note

Client

 <create_note>
   <text>This issue should be resolved after the upgrade.</text>
   <nvt>1.3.6.1.4.1.25623.1.0.10330</nvt>
   <result>254cd3ef-bbe1-4d58-859d-21b8d0c046c6</result>
 </create_note>

Manager

 <create_note_response status="202"
                       status_text="OK, resource created"
                       id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6"/>

7.10 Command `create_override`

In short: Create an override.

The client uses the create_override command to create a new override.

7.10.1 Structure

Command
- <text>
  The text of the override.
- <nvt>
  NVT to which override applies.
  - @oid (oid)
- <active> ?
  Seconds override will be active. -1 on always, 0 off.
- <comment> ?
  A comment on the override.
- <copy> ?
  The UUID of an existing override.
- <hosts> ?
  A textual list of hosts.
- <new_severity> ?
  New severity for result.
- <new_threat> ?
  New threat level for result, will be converted to a new_severity.
- <port> ?
  Port to which override applies.
- <result> ?
  Result to which override applies.
  - @id (uuid)
- <severity> ?
  Severity score to which override applies.
- <task> ?
  Task to which override applies.
  - @id (uuid)
- <threat> ?
  Threat level to which override applies, will be converted to severity.
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.10.2 RNC

Command

create_override
 = element create_override
     {
       create_override_text
       & create_override_nvt
       & create_override_active?
       & create_override_comment?
       & create_override_copy?
       & create_override_hosts?
       & create_override_new_severity?
       & create_override_new_threat?
       & create_override_port?
       & create_override_result?
       & create_override_severity?
       & create_override_task?
       & create_override_threat?
     }

create_override_text
 = element text
     {
       text
     }

create_override_active
 = element active
     {
       integer
     }

create_override_nvt
 = element nvt
     {
       attribute oid { oid }
     }

create_override_comment
 = element comment
     {
       text
     }

create_override_copy
 = element copy
     {
       uuid
     }

create_override_hosts
 = element hosts
     {
       text
     }

create_override_new_severity
 = element new_severity
     {
       severity
     }

create_override_new_threat
 = element new_threat
     {
       threat
     }

create_override_port
 = element port
     {
       text
     }

create_override_result
 = element result
     {
       attribute id { uuid }
     }

create_override_severity
 = element severity
     {
       severity
     }

create_override_task
 = element task
     {
       attribute id { uuid }
     }

create_override_threat
 = element threat
     {
       threat
     }

Response

create_override_response
 = element create_override_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.10.3 Example: Create an override

Client

 <create_override>
   <text>This is actually of little concern.</text>
   <nvt>1.3.6.1.4.1.25623.1.0.10330</nvt>
   <new_threat>Low</new_threat>
   <result>254cd3ef-bbe1-4d58-859d-21b8d0c046c6</result>
 </create_override>

Manager

 <create_override_response status="201"
                           status_text="OK, resource created"
                           id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6"/>

7.11 Command `create_permission`

In short: Create a permission.

The client uses the create_permission command to create a new permission.

7.11.1 Structure

Command
- <name>
  A permission name, currently the name of a command.
- <subject>
  A subject to whom the permission is granted.
  - @id (uuid)
  - <type>
    OMP type of the subject: user, group or role.
- <resource> ?
  A resource to which the permission applies.
  - @id (uuid)
  - <type>
    OMP type, for Super permissions: user, group or role.
- <copy> ?
  UUID of an existing permission to copy.
- <comment> ?
  Comment on the permission.
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.11.2 RNC

Command

create_permission
 = element create_permission
     {
       create_permission_name
       & create_permission_subject
       & create_permission_resource?
       & create_permission_copy?
       & create_permission_comment?
     }

create_permission_name
 = element name
     {
       text
     }

create_permission_subject
 = element subject
     {
       attribute id { uuid }?
       & create_permission_subject_type
     }

create_permission_subject_type
 = element type
     {
       text
     }

create_permission_resource
 = element resource
     {
       attribute id { uuid }?
       & create_permission_resource_type
     }

create_permission_resource_type
 = element type
     {
       text
     }

create_permission_copy
 = element copy
     {
       uuid
     }

create_permission_comment
 = element comment
     {
       text
     }

Response

create_permission_response
 = element create_permission_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.11.3 Example: Grant a user permission to view a target

Client

 <create_permission>
   <name>get_target</name>
   <resource id="b493b7a8-7489-11df-a3ec-002264764cea"/>
   <subject id="66abe5ce-c011-11e3-b96e-406186ea4fc5">
     <type>user</type>
   </subject>
 </create_permission>

Manager

 <create_permission_response status="201"
                             status_text="OK, resource created"
                             id="7ee79232-c011-11e3-b560-406186ea4fc5"/>

7.11.3 Example: Grant a role permission to create users

Client

 <create_permission>
   <name>create_user</name>
   <subject id="9b0cbd98-c011-11e3-a26e-406186ea4fc5">
     <type>role</type>
   </subject>
 </create_permission>

Manager

 <create_permission_response status="201"
                             status_text="OK, resource created"
                             id="b98ad69c-c011-11e3-b001-406186ea4fc5"/>

7.12 Command `create_port_list`

In short: Create a port list.

The client uses the create_port_list command to create a new port list.

The get_port_lists_response element overrides the port_range element.

7.12.1 Structure

Command
- <name>
  The name of the port list.
- <comment> ?
  A comment on the port list.
- <copy> ?
  The UUID of an existing agent.
- <port_range>
  Comma or newline separated list of ranges.
- <get_port_lists_response>
  Response to get_port_lists command.
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.12.2 RNC

Command

create_port_list
 = element create_port_list
     {
       create_port_list_name
       & create_port_list_comment?
       & create_port_list_copy?
       & create_port_list_port_range
       & get_port_lists_response
     }

create_port_list_name
 = element name
     {
       name
     }

create_port_list_comment
 = element comment
     {
       text
     }

create_port_list_copy
 = element copy
     {
       uuid
     }

create_port_list_port_range
 = element port_range
     {
       text
     }

Response

create_port_list_response
 = element create_port_list_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.12.3 Example: Create a port list

Client

 <create_port_list>
   <name>All TCP</name>
   <comment>All possible TCP ports</comment>
   <port_range>T:1-65535</port_range>
 </create_port_list>

Manager

 <create_port_list_response status="201"
                            status_text="OK, resource created"
                            id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6"/>

7.13 Command `create_port_range`

In short: Create a port range.

The client uses the create_port_range command to create a new port range.

7.13.1 Structure

Command
- <comment> ?
  A comment on the port range.
- <port_list>
  The port list to which to add the range.
  - @id (uuid)
- <start>
  The first port in the range.
- <end>
  The last port in the range.
- <type>
  The type of the ports: TCP, UDP, ....
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.13.2 RNC

Command

create_port_range
 = element create_port_range
     {
       create_port_range_comment?
       & create_port_range_port_list
       & create_port_range_start
       & create_port_range_end
       & create_port_range_type
     }

create_port_range_comment
 = element comment
     {
       text
     }

create_port_range_port_list
 = element port_list
     {
       attribute id { uuid }
     }

create_port_range_start
 = element start
     {
       port
     }

create_port_range_end
 = element end
     {
       port
     }

create_port_range_type
 = element type
     {
       text
     }

Response

create_port_range_response
 = element create_port_range_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.13.3 Example: Add a port range to a port list

Client

 <create_port_range>
   <port_list id="354cd3ef-bbe1-4d58-859d-21b8d0c046c4"/>
   <start>777</start>
   <end>779</end>
   <type>TCP</type>
 </create_port_range>

Manager

 <create_port_range_response status="201"
                             status_text="OK, resource created"
                             id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6"/>

7.14 Command `create_report`

In short: Create a report.

The client uses the create_report command to import a report.

7.14.1 Structure

Command
- <report>
  (report)
  
  A report wrapper, as in the GET_REPORTS response.
- <task>
  Task for report: id to use existing task, name to create new task.
  - @id (uuid)
  - <name> ?
    The name of the task.
  - <comment> ?
    Comment for the new task.
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.14.2 RNC

Command

create_report
 = element create_report
     {
       create_report_report
       & create_report_task
     }

create_report_report
 = element report    # type report
     {
       text # RNC limitation: base64
       & attribute id { uuid }
       & attribute format_id { uuid }
       & attribute extension { text }
       & attribute content_type { text }
       & attribute type { xsd:token { pattern = "scan|assets|prognostic" } }?
       & report_owner
       & report_name
       & report_comment
       & report_creation_time
       & report_modification_time
       & report_writable
       & report_in_use
       & report_task
       & report_report_format
       & report_report
     }

create_report_task
 = element task
     {
       attribute id { uuid }?
       & create_report_task_name?
       & create_report_task_comment?
     }

create_report_task_name
 = element name
     {
       name
     }

create_report_task_comment
 = element comment
     {
       text
     }

Response

create_report_response
 = element create_report_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.14.3 Example: Create a report in a new task

Client

 <create_report>
   <report id="a0704abb-2120-489f-959f-251c9f4ffebd">
     <name>CPE</name>
     <extension>csv</extension>
     <content_type>text/csv</content_type>
     <summary>Common Product Enumeration CSV table.</summary>
     <description>
       CPE stands for Common Product Enumeration. It is a
       ...
     </description>
     <global>1</global>
     <predefined>1</predefined>
     <trust>
       yes
       <time>Thu Dec 2 13:22:26 2010</time>
     </trust>
     <active>1</active>
   </report>
   <task>
     <name>Imported reports</name>
   </task>
 </create_report>

Manager

 <create_report_response status="201"
                         status_text="OK, resource created"
                         id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6"/>

7.15 Command `create_report_format`

In short: Create a report format.

The client uses the create_report_format command to create a new report format.

7.15.1 Structure

Command
- One of
  - <copy>
    The UUID of an existing report format.
  - <get_report_formats_response>
    Response to get_report_formats command.
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.15.2 RNC

Command

create_report_format
 = element create_report_format
     {
       ( create_report_format_copy
           | get_report_formats_response )
     }

create_report_format_copy
 = element copy
     {
       uuid
     }

Response

create_report_format_response
 = element create_report_format_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.15.3 Example: Create a report format

Client

 <create_report_format>
   <get_report_formats_response>
     <report_format id="a0704abb-2120-489f-959f-251c9f4ffebd">
       <name>CPE</name>
       <extension>csv</extension>
       <content_type>text/csv</content_type>
       <summary>Common Product Enumeration CSV table.</summary>
       <description>
         CPE stands for Common Product Enumeration. It is a
         ...
       </description>
       <global>1</global>
       <predefined>1</predefined>
       <trust>
         yes
         <time>Thu Dec 2 13:22:26 2010</time>
       </trust>
       <active>1</active>
     </report_format>
   </get_report_formats_response>
 </create_report_format>

Manager

 <create_report_format_response status="201"
                                status_text="OK, resource created"
                                id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6"/>

7.16 Command `create_role`

In short: Create a role.

The client uses the create_role command to create a new role.

7.16.1 Structure

Command
- <name>
  A name for the role.
- <comment> ?
  A comment on the role.
- <copy> ?
  The UUID of an existing role.
- <users> ?
  Comma separated list of user names.
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.16.2 RNC

Command

create_role
 = element create_role
     {
       create_role_name
       & create_role_comment?
       & create_role_copy?
       & create_role_users?
     }

create_role_name
 = element name
     {
       name
     }

create_role_comment
 = element comment
     {
       text
     }

create_role_copy
 = element copy
     {
       uuid
     }

create_role_users
 = element users
     {
       text
     }

Response

create_role_response
 = element create_role_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.16.3 Example: Create a role

Client

 <create_role>
   <name>SCAP Observer</name>
   <users>sarah, bob</users>
 </create_role>

Manager

 <create_role_response status="201"
                       status_text="OK, resource created"
                       id="b64c81b2-b9de-11e3-a2e9-406186ea4fc5"/>

7.17 Command `create_scanner`

In short: Create a scanner.

The client uses the create_scanner command to create a new scanner.

7.17.1 Structure

Command
- <name>
  A name for the scanner.
- <comment> ?
  A comment on the scanner.
- <copy> ?
  The UUID of an existing scanner.
- <host>
  The host of the scanner.
- <port>
  The port of the scanner.
- <type>
  The type of the scanner.
- <ca_pub>
  Certificate of CA to verify scanner certificate..
- <key_pub>
  Certificate to authenticate with to the Scanner..
- <key_priv>
  Private key to authenticate with to the Scanner.
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.17.2 RNC

Command

create_scanner
 = element create_scanner
     {
       create_scanner_name
       & create_scanner_comment?
       & create_scanner_copy?
       & create_scanner_host
       & create_scanner_port
       & create_scanner_type
       & create_scanner_ca_pub
       & create_scanner_key_pub
       & create_scanner_key_priv
     }

create_scanner_name
 = element name
     {
       name
     }

create_scanner_comment
 = element comment
     {
       text
     }

create_scanner_copy
 = element copy
     {
       uuid
     }

create_scanner_host
 = element host
     {
       text
     }

create_scanner_port
 = element port
     {
       text
     }

create_scanner_type
 = element type
     {
       text
     }

create_scanner_ca_pub
 = element ca_pub
     {
       text
     }

create_scanner_key_pub
 = element key_pub
     {
       text
     }

create_scanner_key_priv
 = element key_priv
     {
       text
     }

Response

create_scanner_response
 = element create_scanner_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.17.3 Example: Create a scanner

Client

 <create_scanner>
   <name>Default Scanner</name>
   <host>localhost</host>
   <port>9391</port>
   <type>2</type>
   <ca_pub>...</ca_pub>
   <key_pub>...</key_pub>
   <key_priv>...</key_priv>
 </create_scanner>

Manager

 <create_scanner_response status="201"
                          status_text="OK, resource created"
                          id="814cd30f-dee1-4d58-851d-21b8d0c048e3"/>

7.18 Command `create_schedule`

In short: Create a schedule.

The client uses the create_schedule command to create a new schedule.

7.18.1 Structure

Command
- <name>
  A name for the schedule.
- <comment> ?
  A comment on the schedule.
- <copy> ?
  The UUID of an existing schedule.
- <first_time> ?
  The first time the schedule will run.
  - <minute>
  - <hour>
  - <day_of_month>
  - <month>
  - <year>
- <duration> ?
  How long the Manager will run the scheduled task for.
  - <unit>
    Duration time unit.
- <period> ?
  How often the Manager will repeat the scheduled task.
  - <unit>
    Period time unit.
- <timezone> ?
  The timezone the schedule will follow.
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.18.2 RNC

Command

create_schedule
 = element create_schedule
     {
       create_schedule_name
       & create_schedule_comment?
       & create_schedule_copy?
       & create_schedule_first_time?
       & create_schedule_duration?
       & create_schedule_period?
       & create_schedule_timezone?
     }

create_schedule_name
 = element name
     {
       name
     }

create_schedule_comment
 = element comment
     {
       text
     }

create_schedule_copy
 = element copy
     {
       uuid
     }

create_schedule_first_time
 = element first_time
     {
       create_schedule_first_time_minute
       & create_schedule_first_time_hour
       & create_schedule_first_time_day_of_month
       & create_schedule_first_time_month
       & create_schedule_first_time_year
     }

create_schedule_first_time_minute
 = element minute
     {
       integer
     }

create_schedule_first_time_hour
 = element hour
     {
       integer
     }

create_schedule_first_time_day_of_month
 = element day_of_month
     {
       integer
     }

create_schedule_first_time_month
 = element month
     {
       integer
     }

create_schedule_first_time_year
 = element year
     {
       integer
     }

create_schedule_duration
 = element duration
     {
       create_schedule_duration_unit
     }

create_schedule_duration_unit
 = element unit
     {
       time_unit
     }

create_schedule_period
 = element period
     {
       create_schedule_period_unit
     }

create_schedule_period_unit
 = element unit
     {
       time_unit
     }

create_schedule_timezone
 = element timezone
     {
       timezone
     }

Response

create_schedule_response
 = element create_schedule_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.18.3 Example: Create a schedule

Client

 <create_schedule>
   <name>Every night</name>
   <first_time>
     <day_of_month>1</day_of_month>
     <hour>0</hour>
     <minute>0</minute>
     <month>1</month>
     <year>2011</year>
   </first_time>
   <duration>
     3
     <unit>hour</unit>
   </duration>
   <period>
     1
     <unit>day</unit>
   </period>
 </create_schedule>

Manager

 <create_schedule_response status="201"
                           status_text="OK, resource created"
                           id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6"/>

7.19 Command `create_slave`

In short: Create a slave.

The client uses the create_slave command to create a new slave.

7.19.1 Structure

Command
- <name>
  A name for the slave.
- <comment> ?
  A comment on the slave.
- <copy> ?
  The UUID of an existing slave.
- <host>
  The host that the slave Manager is running on.
- <port>
  The port that the slave Manager is serving on the host.
- <login>
  Login name on the slave Manager.
- <password> ?
  Password for login on the slave Manager.
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.19.2 RNC

Command

create_slave
 = element create_slave
     {
       create_slave_name
       & create_slave_comment?
       & create_slave_copy?
       & create_slave_host
       & create_slave_port
       & create_slave_login
       & create_slave_password?
     }

create_slave_name
 = element name
     {
       name
     }

create_slave_comment
 = element comment
     {
       text
     }

create_slave_copy
 = element copy
     {
       uuid
     }

create_slave_host
 = element host
     {
       text
     }

create_slave_port
 = element port
     {
       text
     }

create_slave_login
 = element login
     {
       text
     }

create_slave_password
 = element password
     {
       text
     }

Response

create_slave_response
 = element create_slave_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.19.3 Example: Create a slave

Client

 <create_slave>
   <name>Bangkok</name>
   <comment>Manager in Bangkok department.</comment>
   <host>192.0.32.10</host>
   <login>sally</login>
   <password>secret</password>
 </create_slave>

Manager

 <create_slave_response status="201"
                        status_text="OK, resource created"
                        id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6"/>

7.20 Command `create_tag`

In short: Create a tag.

The client uses the create_tag command to create a new tag. A name and the resource type must be provided. If a resource ID is also given, it must refer to an existing resource.

7.20.1 Structure

Command
- <name>
  A full tag name consisting of namespace and predicate.
- <resource>
  Identifies a resource the tag is to be attached to.
  - @id (uuid) ID of the resource the tag is to be attached to.
  - <type>
    OMP type of the resource the tag is to be attached to.
- <copy> ?
  UUID of an existing tag to copy.
- <value> ?
  Value associated with the tag.
- <comment> ?
  Comment to add to the tag.
- <active> ?
  Whether the tag is active.
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.20.2 RNC

Command

create_tag
 = element create_tag
     {
       create_tag_name
       & create_tag_resource
       & create_tag_copy?
       & create_tag_value?
       & create_tag_comment?
       & create_tag_active?
     }

create_tag_name
 = element name
     {
       text
     }

create_tag_resource
 = element resource
     {
       attribute id { uuid }?
       & create_tag_resource_type
     }

create_tag_resource_type
 = element type
     {
       text
     }

create_tag_copy
 = element copy
     {
       uuid
     }

create_tag_value
 = element value
     {
       text
     }

create_tag_comment
 = element comment
     {
       text
     }

create_tag_active
 = element active
     {
       boolean
     }

Response

create_tag_response
 = element create_tag_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.20.3 Example: Create a tag attached to a target

Client

 <create_tag>
   <name>geo:long</name>
   <resource id="b493b7a8-7489-11df-a3ec-002264764cea">
     <type>target</type>
   </resource>
   <value>52.2788</value>
 </create_tag>

Manager

 <create_tag_response status="201"
                      status_text="OK, resource created"
                      id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6"/>

7.21 Command `create_target`

In short: Create a target.

The client uses the create_target command to create a new target.

If the list of hosts is empty, the command must also include a target locator.

7.21.1 Structure

Command
- <name>
  A name for the target.
  - <make_unique>
    Whether to append a unique suffix if the name already exists.
- <comment> ?
  A comment on the target.
- <copy> ?
  The UUID of an existing target.
- <hosts>
  A textual list of hosts, which may be empty.
- <exclude_hosts> ?
  A list of hosts to exclude.
- <ssh_lsc_credential> ?
  SSH login credentials for target.
  - @id (uuid)
  - <port> ?
    The port the LSCs will use.
- <smb_lsc_credential> ?
  SMB login credentials for target.
  - @id (uuid)
- <esxi_lsc_credential> ?
  ESXi credential to use on target.
  - @id (uuid)
- <alive_tests> ?
  Which alive tests to use.
- <reverse_lookup_only> ?
  Whether to scan only hosts that have names.
- <reverse_lookup_unify> ?
  Whether to scan only one IP when multiple IPs have the same name.
- <port_range> ?
  Port range for the target.
- <port_list> ?
  Port list for the target.
  - @id (uuid)
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.21.2 RNC

Command

create_target
 = element create_target
     {
       create_target_name
       & create_target_comment?
       & create_target_copy?
       & create_target_hosts
       & create_target_exclude_hosts?
       & create_target_ssh_lsc_credential?
       & create_target_smb_lsc_credential?
       & create_target_esxi_lsc_credential?
       & create_target_alive_tests?
       & create_target_reverse_lookup_only?
       & create_target_reverse_lookup_unify?
       & create_target_port_range?
       & create_target_port_list?
     }

create_target_name
 = element name
     {
       text # RNC limitation: name
       & create_target_name_make_unique
     }

create_target_name_make_unique
 = element make_unique
     {
       boolean
     }

create_target_comment
 = element comment
     {
       text
     }

create_target_copy
 = element copy
     {
       uuid
     }

create_target_hosts
 = element hosts
     {
       text
     }

create_target_exclude_hosts
 = element exclude_hosts
     {
       text
     }

create_target_ssh_lsc_credential
 = element ssh_lsc_credential
     {
       attribute id { uuid }
       & create_target_ssh_lsc_credential_port?
     }

create_target_ssh_lsc_credential_port
 = element port
     {
       text
     }

create_target_smb_lsc_credential
 = element smb_lsc_credential
     {
       attribute id { uuid }
     }

create_target_esxi_lsc_credential
 = element esxi_lsc_credential
     {
       attribute id { uuid }
     }

create_target_alive_tests
 = element alive_tests
     {
       alive_test
     }

create_target_reverse_lookup_only
 = element reverse_lookup_only
     {
       boolean
     }

create_target_reverse_lookup_unify
 = element reverse_lookup_unify
     {
       boolean
     }

create_target_port_range
 = element port_range
     {
       text
     }

create_target_port_list
 = element port_list
     {
       attribute id { uuid }
     }

Response

create_target_response
 = element create_target_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.21.3 Example: Create a target, giving a host list

Client

 <create_target>
   <name>All GNU/Linux machines</name>
   <hosts>192.168.1.0/24</hosts>
 </create_target>

Manager

 <create_target_response status="201"
                         status_text="OK, resource created"
                         id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6"/>

7.22 Command `create_task`

In short: Create a task.

The client uses the create_task command to create a new task.

7.22.1 Structure

Command
- <name>
  A name for the task.
- <comment> ?
  A comment on the task.
- <copy> ?
  The UUID of an existing task.
- <alterable> ?
  Whether the task is alterable.
- <config>
  The scan configuration used by the task.
  - @id (uuid)
- <target>
  The hosts scanned by the task.
  - @id (uuid)
- <hosts_ordering> ?
  The order hosts are scanned in.
- <scanner>
  The scanner to use for scanning the target.
  - @id (uuid)
- <alert> *
  An alert that applies to the task.
  - @id (uuid)
- <schedule> ?
  When the task will run.
  - @id (uuid)
- <schedule_periods> ?
  A limit to the number of times the task will be scheduled, or 0 for no limit.
- <slave> ?
  Slave that the task will run on.
  - @id (uuid)
- <observers> ?
  Users allowed to observe this task.
- <preferences> ?
  - <preference> *
    - <scanner_name>
      Compact name of preference, from scanner.
    - <value>
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.22.2 RNC

Command

create_task
 = element create_task
     {
       create_task_name
       & create_task_comment?
       & create_task_copy?
       & create_task_alterable?
       & create_task_config
       & create_task_target
       & create_task_hosts_ordering?
       & create_task_scanner
       & create_task_alert*
       & create_task_schedule?
       & create_task_schedule_periods?
       & create_task_slave?
       & create_task_observers?
       & create_task_preferences?
     }

create_task_name
 = element name
     {
       name
     }

create_task_comment
 = element comment
     {
       text
     }

create_task_copy
 = element copy
     {
       uuid
     }

create_task_alterable
 = element alterable
     {
       boolean
     }

create_task_config
 = element config
     {
       attribute id { uuid }
     }

create_task_target
 = element target
     {
       attribute id { uuid }
     }

create_task_hosts_ordering
 = element hosts_ordering
     {
       text
     }

create_task_scanner
 = element scanner
     {
       attribute id { uuid }
     }

create_task_alert
 = element alert
     {
       attribute id { uuid }
     }

create_task_schedule
 = element schedule
     {
       attribute id { uuid }
     }

create_task_schedule_periods
 = element schedule_periods
     {
       integer
     }

create_task_slave
 = element slave
     {
       attribute id { uuid }
     }

create_task_observers
 = element observers
     {
       user_list
     }

create_task_preferences
 = element preferences
     {
       create_task_preferences_preference*
     }

create_task_preferences_preference
 = element preference
     {
       create_task_preferences_preference_scanner_name
       & create_task_preferences_preference_value
     }

create_task_preferences_preference_scanner_name
 = element scanner_name
     {
       text
     }

create_task_preferences_preference_value
 = element value
     {
       text
     }

Response

create_task_response
 = element create_task_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.22.3 Example: Create a task, giving a host list

Client

 <create_task>
   <name>Scan Webserver</name>
   <comment>Hourly scan of the webserver</comment>
   <config id="daba56c8-73ec-11df-a475-002264764cea"/>
   <target id="b493b7a8-7489-11df-a3ec-002264764cea"/>
   <scanner id="15348381-3180-213f-4eec-123591912388"/>
 </create_task>

Manager

 <create_task_response status="201"
                       status_text="OK, resource created"
                       id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6"/>

7.23 Command `create_user`

In short: Create a user.

The client uses the create_user command to create a new user.

7.23.1 Structure

Command
- <name>
  The name of the user to be created.
- <copy> ?
  The UUID of an existing user.
- <hosts> ?
  User access rules: a textual list of hosts.
  - @allow (boolean) If 1, allow only listed, otherwise forbid listed.
- <ifaces> ?
  User access rules: a textual list of ifaces.
  - @allow (boolean) If 1, allow only listed, otherwise forbid listed.
- <password> ?
  The password for the user.
- <role> *
  A role of the user.
  - @id (uuid)
Response
- @status (status)
- @status_text (text)
- @id (uuid)

7.23.2 RNC

Command

create_user
 = element create_user
     {
       create_user_name
       & create_user_copy?
       & create_user_hosts?
       & create_user_ifaces?
       & create_user_password?
       & create_user_role*
     }

create_user_name
 = element name
     {
       text
     }

create_user_copy
 = element copy
     {
       uuid
     }

create_user_hosts
 = element hosts
     {
       text
       & attribute allow { boolean }?
     }

create_user_ifaces
 = element ifaces
     {
       text
       & attribute allow { boolean }?
     }

create_user_password
 = element password
     {
       text
     }

create_user_role
 = element role
     {
       attribute id { uuid }
     }

Response

create_user_response
 = element create_user_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.23.3 Example: Create a user

Client

 <create_user>
   <name>foobar</name>
   <password>f00bar</password>
   <role id="8d453140-b74d-11e2-b0be-406186ea4fc5"/>
 </create_user>

Manager

 <create_user_response status="201"
                       status_text="OK, resource created"/>

7.24 Command `delete_agent`

In short: Delete an agent.

The client uses the delete_agent command to delete an existing agent.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Manager.

7.24.1 Structure

Command
- @agent_id (uuid)
- @ultimate (boolean) Whether to remove entirely, or to the trashcan.
Response
- @status (status)
- @status_text (text)

7.24.2 RNC

Command

delete_agent
 = element delete_agent
     {
       attribute agent_id { uuid }
       & attribute ultimate { boolean }
     }

Response

delete_agent_response
 = element delete_agent_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.24.3 Example: Delete an agent

Client

 <delete_agent agent_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <delete_agent_response status="200"
                        status_text="OK"/>

7.25 Command `delete_config`

In short: Delete a config.

The client uses the delete_config command to delete an existing config.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Manager.

7.25.1 Structure

Command
- @config_id (uuid)
- @ultimate (boolean) Whether to remove entirely, or to the trashcan.
Response
- @status (status)
- @status_text (text)

7.25.2 RNC

Command

delete_config
 = element delete_config
     {
       attribute config_id { uuid }
       & attribute ultimate { boolean }
     }

Response

delete_config_response
 = element delete_config_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.25.3 Example: Delete a config

Client

 <delete_config config_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <delete_config_response status="200"
                         status_text="OK"/>

7.26 Command `delete_alert`

In short: Delete an alert.

The client uses the delete_alert command to delete an existing alert.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Manager.

7.26.1 Structure

Command
- @alert_id (uuid)
- @ultimate (boolean) Whether to remove entirely, or to the trashcan.
Response
- @status (status)
- @status_text (text)

7.26.2 RNC

Command

delete_alert
 = element delete_alert
     {
       attribute alert_id { uuid }
       & attribute ultimate { boolean }
     }

Response

delete_alert_response
 = element delete_alert_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.26.3 Example: Delete an alert

Client

 <delete_alert alert_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <delete_alert_response status="200"
                        status_text="OK"/>

7.27 Command `delete_filter`

In short: Delete a filter.

The client uses the delete_filter command to delete an existing filter.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Manager.

7.27.1 Structure

Command
- @filter_id (uuid)
- @ultimate (boolean) Whether to remove entirely, or to the trashcan.
Response
- @status (status)
- @status_text (text)

7.27.2 RNC

Command

delete_filter
 = element delete_filter
     {
       attribute filter_id { uuid }
       & attribute ultimate { boolean }
     }

Response

delete_filter_response
 = element delete_filter_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.27.3 Example: Delete a filter

Client

 <delete_filter filter_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <delete_filter_response status="200"
                         status_text="OK"/>

7.28 Command `delete_group`

In short: Delete a group.

The client uses the delete_group command to delete an existing group.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Manager.

7.28.1 Structure

Command
- @group_id (uuid)
- @ultimate (boolean) Whether to remove entirely, or to the trashcan.
Response
- @status (status)
- @status_text (text)

7.28.2 RNC

Command

delete_group
 = element delete_group
     {
       attribute group_id { uuid }
       & attribute ultimate { boolean }
     }

Response

delete_group_response
 = element delete_group_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.28.3 Example: Delete a group

Client

 <delete_group group_id="d94211b6-ba40-11e3-bcb1-406186ea4fc5"/>

Manager

 <delete_group_response status="200"
                        status_text="OK"/>

7.29 Command `delete_lsc_credential`

In short: Delete an LSC credential.

The client uses the delete_lsc_credential command to delete an existing LSC credential.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Manager.

7.29.1 Structure

Command
- @lsc_credential_id (uuid)
- @ultimate (boolean) Whether to remove entirely, or to the trashcan.
Response
- @status (status)
- @status_text (text)

7.29.2 RNC

Command

delete_lsc_credential
 = element delete_lsc_credential
     {
       attribute lsc_credential_id { uuid }
       & attribute ultimate { boolean }
     }

Response

delete_lsc_credential_response
 = element delete_lsc_credential_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.29.3 Example: Delete an LSC credential

Client

 <delete_lsc_credential lsc_credential_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <delete_lsc_credential_response status="200"
                                 status_text="OK"/>

7.30 Command `delete_note`

In short: Delete a note.

The client uses the delete_note command to delete an existing note.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Manager.

7.30.1 Structure

Command
- @note_id (uuid)
- @ultimate (boolean) Whether to remove entirely, or to the trashcan.
Response
- @status (status)
- @status_text (text)

7.30.2 RNC

Command

delete_note
 = element delete_note
     {
       attribute note_id { uuid }
       & attribute ultimate { boolean }
     }

Response

delete_note_response
 = element delete_note_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.30.3 Example: Delete a note

Client

 <delete_note note_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <delete_note_response status="200"
                       status_text="OK"/>

7.31 Command `delete_override`

In short: Delete an override.

The client uses the delete_override command to delete an existing override.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Manager.

7.31.1 Structure

Command
- @override_id (uuid)
- @ultimate (boolean) Whether to remove entirely, or to the trashcan.
Response
- @status (status)
- @status_text (text)

7.31.2 RNC

Command

delete_override
 = element delete_override
     {
       attribute override_id { uuid }
       & attribute ultimate { boolean }
     }

Response

delete_override_response
 = element delete_override_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.31.3 Example: Delete an override

Client

 <delete_override override_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <delete_override_response status="200"
                           status_text="OK"/>

7.32 Command `delete_report`

In short: Delete a report.

The client uses the delete_report command to delete an existing report.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Manager.

7.32.1 Structure

Command
- @report_id (uuid)
Response
- @status (status)
- @status_text (text)

7.32.2 RNC

Command

delete_report
 = element delete_report
     {
       attribute report_id { uuid }
     }

Response

delete_report_response
 = element delete_report_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.32.3 Example: Delete a report

Client

 <delete_report report_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <delete_report_response status="200"
                         status_text="OK"/>

7.33 Command `delete_permission`

In short: Delete a permission.

The client uses the delete_permission command to delete an existing permission.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Manager.

7.33.1 Structure

Command
- @permission_id (uuid)
- @ultimate (boolean) Whether to remove entirely, or to the trashcan.
Response
- @status (status)
- @status_text (text)

7.33.2 RNC

Command

delete_permission
 = element delete_permission
     {
       attribute permission_id { uuid }
       & attribute ultimate { boolean }
     }

Response

delete_permission_response
 = element delete_permission_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.33.3 Example: Delete a permission

Client

 <delete_permission permission_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <delete_permission_response status="200"
                             status_text="OK"/>

7.34 Command `delete_port_list`

In short: Delete a port list.

The client uses the delete_port_list command to delete an existing port list.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Manager.

7.34.1 Structure

Command
- @port_list_id (uuid)
- @ultimate (boolean) Whether to remove entirely, or to the trashcan.
Response
- @status (status)
- @status_text (text)

7.34.2 RNC

Command

delete_port_list
 = element delete_port_list
     {
       attribute port_list_id { uuid }
       & attribute ultimate { boolean }
     }

Response

delete_port_list_response
 = element delete_port_list_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.34.3 Example: Delete a port list

Client

 <delete_port_list port_list_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <delete_port_list_response status="200"
                            status_text="OK"/>

7.35 Command `delete_port_range`

In short: Delete a port range.

The client uses the delete_port_range command to delete an existing port range.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Manager.

7.35.1 Structure

Command
- @port_range_id (uuid)
Response
- @status (status)
- @status_text (text)

7.35.2 RNC

Command

delete_port_range
 = element delete_port_range
     {
       attribute port_range_id { uuid }
     }

Response

delete_port_range_response
 = element delete_port_range_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.35.3 Example: Delete a port range

Client

 <delete_port_range port_range_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <delete_port_range_response status="200"
                             status_text="OK"/>

7.36 Command `delete_report_format`

In short: Delete a report format.

The client uses the delete_report_format command to delete an existing report format.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Manager.

7.36.1 Structure

Command
- @report_format_id (uuid)
- @ultimate (boolean) Whether to remove entirely, or to the trashcan.
Response
- @status (status)
- @status_text (text)

7.36.2 RNC

Command

delete_report_format
 = element delete_report_format
     {
       attribute report_format_id { uuid }
       & attribute ultimate { boolean }
     }

Response

delete_report_format_response
 = element delete_report_format_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.36.3 Example: Delete a report format

Client

 <delete_report_format report_format_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <delete_report_format_response status="200"
                                status_text="OK"/>

7.37 Command `delete_role`

In short: Delete a role.

The client uses the delete_role command to delete an existing role.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Manager.

7.37.1 Structure

Command
- @role_id (uuid)
- @ultimate (boolean) Whether to remove entirely, or to the trashcan.
Response
- @status (status)
- @status_text (text)

7.37.2 RNC

Command

delete_role
 = element delete_role
     {
       attribute role_id { uuid }
       & attribute ultimate { boolean }
     }

Response

delete_role_response
 = element delete_role_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.37.3 Example: Delete a role

Client

 <delete_role role_id="b64c81b2-b9de-11e3-a2e9-406186ea4fc5"/>

Manager

 <delete_role_response status="200"
                       status_text="OK"/>

7.38 Command `delete_scanner`

In short: Delete a scanner.

The client uses the delete_scanner command to delete an existing scanner.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Manager.

7.38.1 Structure

Command
- @scanner_id (uuid)
- @ultimate (boolean) Whether to remove entirely, or to the trashcan.
Response
- @status (status)
- @status_text (text)

7.38.2 RNC

Command

delete_scanner
 = element delete_scanner
     {
       attribute scanner_id { uuid }
       & attribute ultimate { boolean }
     }

Response

delete_scanner_response
 = element delete_scanner_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.38.3 Example: Delete a scanner

Client

 <delete_scanner scanner_id="817a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <delete_scanner_response status="200"
                          status_text="OK"/>

7.39 Command `delete_schedule`

In short: Delete a schedule.

The client uses the delete_schedule command to delete an existing schedule.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Manager.

7.39.1 Structure

Command
- @schedule_id (uuid)
- @ultimate (boolean) Whether to remove entirely, or to the trashcan.
Response
- @status (status)
- @status_text (text)

7.39.2 RNC

Command

delete_schedule
 = element delete_schedule
     {
       attribute schedule_id { uuid }
       & attribute ultimate { boolean }
     }

Response

delete_schedule_response
 = element delete_schedule_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.39.3 Example: Delete a schedule

Client

 <delete_schedule schedule_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <delete_schedule_response status="200"
                           status_text="OK"/>

7.40 Command `delete_slave`

In short: Delete a slave.

The client uses the delete_slave command to delete an existing slave.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Manager.

7.40.1 Structure

Command
- @slave_id (uuid)
- @ultimate (boolean) Whether to remove entirely, or to the trashcan.
Response
- @status (status)
- @status_text (text)

7.40.2 RNC

Command

delete_slave
 = element delete_slave
     {
       attribute slave_id { uuid }
       & attribute ultimate { boolean }
     }

Response

delete_slave_response
 = element delete_slave_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.40.3 Example: Delete a slave

Client

 <delete_slave slave_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <delete_slave_response status="200"
                        status_text="OK"/>

7.41 Command `delete_tag`

In short: Delete a tag.

The client uses the delete_tag command to delete an existing tag.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Manager.

7.41.1 Structure

Command
- @tag_id (uuid)
- @ultimate (boolean) Whether to remove entirely, or to the trashcan.
Response
- @status (status)
- @status_text (text)

7.41.2 RNC

Command

delete_tag
 = element delete_tag
     {
       attribute tag_id { uuid }
       & attribute ultimate { boolean }
     }

Response

delete_tag_response
 = element delete_tag_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.41.3 Example: Delete a tag

Client

 <delete_tag target_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <delete_tag_response status="200"
                      status_text="OK"/>

7.42 Command `delete_target`

In short: Delete a target.

The client uses the delete_target command to delete an existing target.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Manager.

7.42.1 Structure

Command
- @target_id (uuid)
- @ultimate (boolean) Whether to remove entirely, or to the trashcan.
Response
- @status (status)
- @status_text (text)

7.42.2 RNC

Command

delete_target
 = element delete_target
     {
       attribute target_id { uuid }
       & attribute ultimate { boolean }
     }

Response

delete_target_response
 = element delete_target_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.42.3 Example: Delete a target

Client

 <delete_target target_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <delete_target_response status="200"
                         status_text="OK"/>

7.43 Command `delete_task`

In short: Delete a task.

The client uses the delete_task command to delete an existing task, including all reports associated with the task.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Manager.

7.43.1 Structure

Command
- @task_id (uuid)
- @ultimate (boolean) Whether to remove entirely, or to the trashcan.
Response
- @status (status)
- @status_text (text)

7.43.2 RNC

Command

delete_task
 = element delete_task
     {
       attribute task_id { uuid }
       & attribute ultimate { boolean }
     }

Response

delete_task_response
 = element delete_task_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.43.3 Example: Delete a task

Client

 <delete_task task_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <delete_task_response status="200"
                       status_text="OK"/>

7.44 Command `delete_user`

In short: Delete a user.

The client uses the delete_user command to delete an existing user.

Since this is a destructive command, the client is advised to ask for confirmation from the user before sending this command to the Administrator.

7.44.1 Structure

Command
- @user_id (uuid) The ID of the user to be deleted. Overrides name.
- <name>
  The name of the user to be deleted.
Response
- @status (status)
- @status_text (text)

7.44.2 RNC

Command

delete_user
 = element delete_user
     {
       attribute user_id { uuid }
       & delete_user_name
     }

delete_user_name
 = element name
     {
       text
     }

Response

delete_user_response
 = element delete_user_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.44.3 Example: Delete a user

Client

 <delete_user name="foobar"/>

Manager

 <delete_user_response status="200"
                       status_text="OK"/>

7.45 Command `describe_auth`

In short: Describe authentication methods.

The client uses the "describe_auth" command to get details about the used authentication methods.

The Manager will reply with a list of all used authentication methods if such a list is available.

7.45.1 Structure

Command
Response
- @status (status)
- @status_text (text)
- <group>
  Config group.
  - @name (text)
  - <auth_conf_setting>
    - @key (text)
    - @value (text)

7.45.2 RNC

Command

describe_auth
 = element describe_auth
     {
       ""
     }

Response

describe_auth_response
 = element describe_auth_response
     {
       attribute status { status }
       & attribute status_text { text }
       & describe_auth_response_group
     }

describe_auth_response_group
 = element group
     {
       attribute name { text }
       & describe_auth_response_group_auth_conf_setting
     }

describe_auth_response_group_auth_conf_setting
 = element auth_conf_setting
     {
       attribute key { text }
       & attribute value { text }
     }

7.45.3 Example: Describe the authentication methods

Client

 <describe_auth/>

Manager

 <describe_auth_response status="200"
                         status_text="OK">
   <group name="Foo">
     <auth_conf_setting key="Bar"
                        value="Baz"/>
   </group>
 </describe_auth_response>

7.46 Command `describe_cert`

In short: Describe the CERT feed.

The client uses the "describe_cert" command to get details about the CERT feed used by the Manager.

The Manager will reply with a cert element containing information about the CERT feed.

7.46.1 Structure

Command
Response
- @status (status)
- @status_text (text)
- <cert>
  - <name>
    The name of the CERT feed.
  - <version>
    The version of the CERT feed.
  - <description>
    A description of the CERT feed.
  - <sync_not_available> ?
    Present if CERT syncing is not available.
    - <error>
      Description of why sync is not available.
  - <currently_syncing> ?
    Present if a CERT sync is underway.
    - <timestamp>
      Time sync started.
    - <user>
      Name of user who is performing sync.

7.46.2 RNC

Command

describe_cert
 = element describe_cert
     {
       ""
     }

Response

describe_cert_response
 = element describe_cert_response
     {
       attribute status { status }
       & attribute status_text { text }
       & describe_cert_response_cert
     }

describe_cert_response_cert
 = element cert
     {
       describe_cert_response_cert_name
       & describe_cert_response_cert_version
       & describe_cert_response_cert_description
       & describe_cert_response_cert_sync_not_available?
       & describe_cert_response_cert_currently_syncing?
     }

describe_cert_response_cert_name
 = element name
     {
       text
     }

describe_cert_response_cert_version
 = element version
     {
       text
     }

describe_cert_response_cert_description
 = element description
     {
       text
     }

describe_cert_response_cert_sync_not_available
 = element sync_not_available
     {
       describe_cert_response_cert_sync_not_available_error
     }

describe_cert_response_cert_sync_not_available_error
 = element error
     {
     }

describe_cert_response_cert_currently_syncing
 = element currently_syncing
     {
       describe_cert_response_cert_currently_syncing_timestamp
       & describe_cert_response_cert_currently_syncing_user
     }

describe_cert_response_cert_currently_syncing_timestamp
 = element timestamp
     {
       text
     }

describe_cert_response_cert_currently_syncing_user
 = element user
     {
       text
     }

7.46.3 Example: Describe the CERT feed

Client

 <describe_cert/>

Manager

 <describe_cert_response status="200"
                         status_text="OK">
   <cert>
     <name>OpenVAS CERT Feed</name>
     <version>201301040805</version>
     <description>
       The 'OpenVAS CERT Feed' is provided by 'The OpenVAS Project'.
       ...
     </description>
   </cert>
 </describe_cert_response>

7.47 Command `describe_feed`

In short: Describe the NVT feed.

The client uses the "describe_feed" command to get details about the NVT feed used by the Manager.

The Manager will reply with a feed element containing information about the NVT feed.

7.47.1 Structure

Command
Response
- @status (status)
- @status_text (text)
- <feed>
  - <name>
    The name of the feed.
  - <version>
    The version of the feed.
  - <description>
    A description of the feed.
  - <sync_not_available> ?
    Present if CERT syncing is not available.
    - <error>
      Description of why sync is not available.
  - <currently_syncing> ?
    Present if an NVT sync is underway.
    - <timestamp>
      Time sync started.
    - <user>
      Name of user who is performing sync.

7.47.2 RNC

Command

describe_feed
 = element describe_feed
     {
       ""
     }

Response

describe_feed_response
 = element describe_feed_response
     {
       attribute status { status }
       & attribute status_text { text }
       & describe_feed_response_feed
     }

describe_feed_response_feed
 = element feed
     {
       describe_feed_response_feed_name
       & describe_feed_response_feed_version
       & describe_feed_response_feed_description
       & describe_feed_response_feed_sync_not_available?
       & describe_feed_response_feed_currently_syncing?
     }

describe_feed_response_feed_name
 = element name
     {
       text
     }

describe_feed_response_feed_version
 = element version
     {
       text
     }

describe_feed_response_feed_description
 = element description
     {
       text
     }

describe_feed_response_feed_sync_not_available
 = element sync_not_available
     {
       describe_feed_response_feed_sync_not_available_error
     }

describe_feed_response_feed_sync_not_available_error
 = element error
     {
     }

describe_feed_response_feed_currently_syncing
 = element currently_syncing
     {
       describe_feed_response_feed_currently_syncing_timestamp
       & describe_feed_response_feed_currently_syncing_user
     }

describe_feed_response_feed_currently_syncing_timestamp
 = element timestamp
     {
       text
     }

describe_feed_response_feed_currently_syncing_user
 = element user
     {
       text
     }

7.47.3 Example: Describe the feed

Client

 <describe_feed/>

Manager

 <describe_feed_response status="200"
                         status_text="OK">
   <feed>
     <name>OpenVAS NVT Feed</name>
     <version>201011221324</version>
     <description>
       The 'OpenVAS NVT Feed' is provided by 'The OpenVAS Project'.
       ...
     </description>
   </feed>
 </describe_feed_response>

7.48 Command `describe_scap`

In short: Describe the SCAP feed.

The client uses the "describe_scap" command to get details about the SCAP feed used by the Manager.

The Manager will reply with a scap element containing information about the SCAP feed.

7.48.1 Structure

Command
Response
- @status (status)
- @status_text (text)
- <scap>
  - <name>
    The name of the scap feed.
  - <version>
    The version of the scap feed.
  - <description>
    A description of the scap feed.
  - <sync_not_available> ?
    Present if CERT syncing is not available.
    - <error>
      Description of why sync is not available.
  - <currently_syncing> ?
    Present if a CERT sync is underway.
    - <timestamp>
      Time sync started.
    - <user>
      Name of user who is performing sync.

7.48.2 RNC

Command

describe_scap
 = element describe_scap
     {
       ""
     }

Response

describe_scap_response
 = element describe_scap_response
     {
       attribute status { status }
       & attribute status_text { text }
       & describe_scap_response_scap
     }

describe_scap_response_scap
 = element scap
     {
       describe_scap_response_scap_name
       & describe_scap_response_scap_version
       & describe_scap_response_scap_description
       & describe_scap_response_scap_sync_not_available?
       & describe_scap_response_scap_currently_syncing?
     }

describe_scap_response_scap_name
 = element name
     {
       text
     }

describe_scap_response_scap_version
 = element version
     {
       text
     }

describe_scap_response_scap_description
 = element description
     {
       text
     }

describe_scap_response_scap_sync_not_available
 = element sync_not_available
     {
       describe_scap_response_scap_sync_not_available_error
     }

describe_scap_response_scap_sync_not_available_error
 = element error
     {
     }

describe_scap_response_scap_currently_syncing
 = element currently_syncing
     {
       describe_scap_response_scap_currently_syncing_timestamp
       & describe_scap_response_scap_currently_syncing_user
     }

describe_scap_response_scap_currently_syncing_timestamp
 = element timestamp
     {
       text
     }

describe_scap_response_scap_currently_syncing_user
 = element user
     {
       text
     }

7.48.3 Example: Describe the scap feed

Client

 <describe_scap/>

Manager

 <describe_scap_response status="200"
                         status_text="OK">
   <scap>
     <name>OpenVAS NVT SCAP</name>
     <version>201011221324</version>
     <description>
       The 'OpenVAS SCAP Feed' is provided by 'The OpenVAS Project'.
       ...
     </description>
   </scap>
 </describe_scap_response>

7.49 Command `empty_trashcan`

In short: Empty the trashcan.

The client uses the empty_trashcan command to empty the trashcan.

7.49.1 Structure

Command
Response
- @status (status)
- @status_text (text)

7.49.2 RNC

Command

empty_trashcan
 = element empty_trashcan
     {
       ""
     }

Response

empty_trashcan_response
 = element empty_trashcan_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.49.3 Example: Empty the trashcan

Client

 <empty_trashcan/>

Manager

 <empty_trashcan_response status="200"
                          status_text="OK"/>

7.50 Command `get_agents`

In short: Get one or many agents.

The client uses the get_agents command to get agent information. If the command sent by the client was valid, the manager will reply with a list of agents to the client.

If the request includes a format then the agents in the response include installer elements, otherwise they include trust state and time. If the details attribute is set, the response will include the installer.

7.50.1 Structure

Command
- @agent_id (uuid) ID of single agent to get.
- @filter (text) Filter term to use to filter query.
- @filt_id (uuid) ID of filter to use to filter query.
- @trash (boolean) Whether to get the trashcan agents instead.
- @details (boolean) Whether to include agents package information when no format was provided.
- @format ("installer", "howto_install" or "howto_use")
Response
- @status (status)
- @status_text (text)
- <agent> *
  - @id (uuid)
  - <owner>
    Owner of the agent.
    - <name>
      The name of the owner.
  - <name>
    The name of the agent.
  - <comment>
    The comment on the agent.
  - <creation_time>
    Date and time the agent was created.
  - <modification_time>
    Date and time the agent was last modified.
  - <in_use>
    Whether the agent is in use.
  - <writable>
    Whether the agent is writable.
  - <permissions>
    Permissions that the current user has on the agent.
    - <permission> *
      - <name>
        The name of the permission.
  - <user_tags>
    Info on tags attached to the agent.
    - <count>
      Number of attached tags.
    - <tag> *
      Short info on an individual tag (only if details were requested).
      - @id (uuid) UUID of the tag.
      - <name>
        Name of the tag (usually namespace:predicate).
      - <value>
        Value of the tag.
      - <comment>
        Comment for the tag.
  - One of
    - <installer>
      - <trust>
        Whether signature verification succeeded.
        
        <time>
        When the signature was verified.
    - <package>
      Either the installer or one of the HOWTOs.
      - <filename>
        The filename of the package.
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
- <sort>
  - <field>
    - <order>
- <agents>
  - @start (integer) First agent.
  - @max (integer) Maximum number of agents.
- <agent_count>
  - <filtered>
    Number of agents after filtering.
  - <page>
    Number of agents on current page.

7.50.2 RNC

Command

get_agents
 = element get_agents
     {
       attribute agent_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute trash { boolean }?
       & attribute details { boolean }?
       & attribute format { xsd:token { pattern = "installer|howto_install|howto_use" } }?
     }

Response

get_agents_response
 = element get_agents_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_agents_response_agent*
       & get_agents_response_filters
       & get_agents_response_sort
       & get_agents_response_agents
       & get_agents_response_agent_count
     }

get_agents_response_agent
 = element agent
     {
       attribute id { uuid }
       & get_agents_response_agent_owner
       & get_agents_response_agent_name
       & get_agents_response_agent_comment
       & get_agents_response_agent_creation_time
       & get_agents_response_agent_modification_time
       & get_agents_response_agent_in_use
       & get_agents_response_agent_writable
       & get_agents_response_agent_permissions
       & get_agents_response_agent_user_tags
       & ( get_agents_response_agent_installer
           | get_agents_response_agent_package )
     }

get_agents_response_agent_owner
 = element owner
     {
       get_agents_response_agent_owner_name
     }

get_agents_response_agent_owner_name
 = element name
     {
       name
     }

get_agents_response_agent_name
 = element name
     {
       name
     }

get_agents_response_agent_comment
 = element comment
     {
       text
     }

get_agents_response_agent_creation_time
 = element creation_time
     {
       iso_time
     }

get_agents_response_agent_modification_time
 = element modification_time
     {
       iso_time
     }

get_agents_response_agent_in_use
 = element in_use
     {
       boolean
     }

get_agents_response_agent_writable
 = element writable
     {
       boolean
     }

get_agents_response_agent_permissions
 = element permissions
     {
       get_agents_response_agent_permissions_permission*
     }

get_agents_response_agent_permissions_permission
 = element permission
     {
       get_agents_response_agent_permissions_permission_name
     }

get_agents_response_agent_permissions_permission_name
 = element name
     {
       name
     }

get_agents_response_agent_user_tags
 = element user_tags
     {
       get_agents_response_agent_user_tags_count
       & get_agents_response_agent_user_tags_tag*
     }

get_agents_response_agent_user_tags_count
 = element count
     {
       integer
     }

get_agents_response_agent_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_agents_response_agent_user_tags_tag_name
       & get_agents_response_agent_user_tags_tag_value
       & get_agents_response_agent_user_tags_tag_comment
     }

get_agents_response_agent_user_tags_tag_name
 = element name
     {
       text
     }

get_agents_response_agent_user_tags_tag_value
 = element value
     {
       text
     }

get_agents_response_agent_user_tags_tag_comment
 = element comment
     {
       text
     }

get_agents_response_agent_installer
 = element installer
     {
       get_agents_response_agent_installer_trust
     }

get_agents_response_agent_installer_trust
 = element trust
     {
       text # RNC limitation: xsd:token { pattern = "yes|no|unknown" }
       & get_agents_response_agent_installer_trust_time
     }

get_agents_response_agent_installer_trust_time
 = element time
     {
       iso_time
     }

get_agents_response_agent_package
 = element package
     {
       text # RNC limitation: base64
       & get_agents_response_agent_package_filename
     }

get_agents_response_agent_package_filename
 = element filename
     {
       text
     }

get_agents_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_agents_response_filters_term
       & get_agents_response_filters_name?
       & get_agents_response_filters_keywords
     }

get_agents_response_filters_term
 = element term
     {
       text
     }

get_agents_response_filters_name
 = element name
     {
       text
     }

get_agents_response_filters_keywords
 = element keywords
     {
       get_agents_response_filters_keywords_keyword*
     }

get_agents_response_filters_keywords_keyword
 = element keyword
     {
       get_agents_response_filters_keywords_keyword_column
       & get_agents_response_filters_keywords_keyword_relation
       & get_agents_response_filters_keywords_keyword_value
     }

get_agents_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_agents_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_agents_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_agents_response_sort
 = element sort
     {
       text
       & get_agents_response_sort_field
     }

get_agents_response_sort_field
 = element field
     {
       get_agents_response_sort_field_order
     }

get_agents_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_agents_response_agents
 = element agents
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_agents_response_agent_count
 = element agent_count
     {
       get_agents_response_agent_count_filtered
       & get_agents_response_agent_count_page
     }

get_agents_response_agent_count_filtered
 = element filtered
     {
       integer
     }

get_agents_response_agent_count_page
 = element page
     {
       integer
     }

7.50.3 Example: Get one or many agents

Client

 <get_agents/>

Manager

 <get_agents_response status="200"
                      status_text="OK">
   <agent id="c33864a9-d3fd-44b3-8717-972bfb01dfcf">
     <name>Custom Scan Agent</name>
     <comment>Custom agent for use on the Web servers.</comment>
     <creation_time>2012-01-23T10:44:00+01:00</creation_time>
     <modification_time>2013-01-23T10:44:00+01:00</modification_time>
     <writable>1</writable>
     <in_use>0</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <installer>
       <trust>
         yes
         <time>Wed Jun 30 21:49:08 2012</time>
       </trust>
     </installer>
   </agent>
   ...
 </get_agents_response>

7.50.3 Example: Get one agent

Client

 <get_agents agent_id="c33864a9-d3fd-44b3-8717-972bfb01dfcf"/>

Manager

 <get_agents_response status="200"
                      status_text="OK">
   <agent id="c33864a9-d3fd-44b3-8717-972bfb01dfcf">
     <name>Custom Scan Agent</name>
     <comment>Custom agent for use on the Web servers.</comment>
     <creation_time>2012-01-23T10:44:00+01:00</creation_time>
     <modification_time>2013-01-23T10:44:00+01:00</modification_time>
     <writable>1</writable>
     <in_use>0</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <installer>
       <trust>
         yes
         <time>Wed Jun 30 21:49:08 2012</time>
       </trust>
     </installer>
   </agent>
 </get_agents_response>

7.50.3 Example: Get one agent, including the installer package

Client

 <get_agents agent_id="c33864a9-d3fd-44b3-8717-972bfb01dfcf"
             format="installer"/>

Manager

 <get_agents_response status="200"
                      status_text="OK">
   <agent id="c33864a9-d3fd-44b3-8717-972bfb01dfcf">
     <name>Custom Scan Agent</name>
     <comment>Custom agent for use on the Web servers.</comment>
     <creation_time>2012-01-23T10:44:00+01:00</creation_time>
     <modification_time>2013-01-23T10:44:00+01:00</modification_time>
     <writable>1</writable>
     <in_use>0</in_use>
     <package format="installer">
       CgoKCgoKCgoKCgoKCSAgI...
       <filename>agent.deb</filename>
     </package>
   </agent>
 </get_agents_response>

7.51 Command `get_configs`

In short: Get one or many configs.

The client uses the get_configs command to get config information. If the command sent by the client was valid, the manager will reply with a list of configs to the client.

7.51.1 Structure

Command
- @config_id (uuid) ID of single config to get.
- @filter (text) Filter term to use to filter query.
- @filt_id (uuid) ID of filter to use to filter query.
- @trash (boolean) Whether to get the trashcan configs instead.
- @details (boolean) Whether to get config families, preferences, nvt selectors and tasks.
- @families (boolean) Whether to include the families if no details are requested.
- @preferences (boolean) Whether to include the preferences if no details are requested.
- @tasks (boolean) Whether to get tasks using this config.
Response
- @status (status)
- @status_text (text)
- <config> *
  - @id (uuid)
  - <owner>
    Owner of the config.
    - <name>
      The name of the owner.
  - <name>
    The name of the config.
  - <comment>
    The comment on the config.
  - <creation_time>
    Creation time of the config.
  - <modification_time>
    Last time the config was modified.
  - <family_count>
    The number of families selected by the config.
    - <growing>
      Whether new families are automatically added to the config.
  - <nvt_count>
    The number of NVTs selected by the config.
    - <growing>
      Whether new NVTs are automatically added to the config.
  - <type>
    The type the config..
  - <max_nvt_count>
    Total number of NVTs in the families selected by the config.
  - <known_nvt_count>
    Total number of known NVTs selected by the config.
  - <in_use>
    Whether any tasks are using the config.
  - <writable>
    Whether any tasks are using the config, including trashcan tasks.
  - <permissions>
    Permissions that the current user has on the target.
    - <permission> *
      - <name>
        The name of the permission.
  - <user_tags>
    Info on tags attached to the config.
    - <count>
      Number of attached tags.
    - <tag> *
      Short info on an individual tag (only if details were requested).
      - @id (uuid) UUID of the tag.
      - <name>
        Name of the tag (usually namespace:predicate).
      - <value>
        Value of the tag.
      - <comment>
        Comment for the tag.
  - <tasks>
    All tasks using the config.
    - <task> *
      - @id (uuid)
      - <name>
        The name of the task.
      - <permissions> ?
        Permissions the user has on the task.
  - <families> ?
    All families selected by the config.
    - <family> *
      - <name>
        The name of the family.
      - <nvt_count>
        The number of NVTs selected in the family.
      - <max_nvt_count>
        The total number of NVTs in the family.
      - <growing>
        Whether new NVTs in the family are automatically added to the selection.
  - <preferences> ?
    Preferences for all NVTs selected by the config.
    - <preference> *
      - <nvt>
        NVT to which preference applies.
        
        @oid (oid)
        
        <name>
        The name of the NVT.
      - <name>
        The name of the preference.
      - <type>
        The type of preference.
      - <value>
        The value of the preference.
      - <default>
        The default value of the preference.
      - <alt> *
        An alternate value for the preference.
  - <nvt_selectors> ?
    All NVT selectors of the config.
    - <nvt_selector> *
      An NVT selector.
      - <name>
        Name of the selector.
      - <include>
        Whether the selector is an include selector.
      - <type>
        Selector type: 0 = all, 1 = family, 2 = NVT.
      - <family_or_nvt>
        Name of the family or OID of the NVT.
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
- <sort>
  - <field>
    - <order>
- <configs>
  - @start (integer) First config.
  - @max (integer) Maximum number of configs.
- <config_count>
  - <filtered>
    Number of configs after filtering.
  - <page>
    Number of configs on current page.

7.51.2 RNC

Command

get_configs
 = element get_configs
     {
       attribute config_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute trash { boolean }?
       & attribute details { boolean }?
       & attribute families { boolean }?
       & attribute preferences { boolean }?
       & attribute tasks { boolean }?
     }

Response

get_configs_response
 = element get_configs_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_configs_response_config*
       & get_configs_response_filters
       & get_configs_response_sort
       & get_configs_response_configs
       & get_configs_response_config_count
     }

get_configs_response_config
 = element config
     {
       attribute id { uuid }
       & get_configs_response_config_owner
       & get_configs_response_config_name
       & get_configs_response_config_comment
       & get_configs_response_config_creation_time
       & get_configs_response_config_modification_time
       & get_configs_response_config_family_count
       & get_configs_response_config_nvt_count
       & get_configs_response_config_type
       & get_configs_response_config_max_nvt_count
       & get_configs_response_config_known_nvt_count
       & get_configs_response_config_in_use
       & get_configs_response_config_writable
       & get_configs_response_config_permissions
       & get_configs_response_config_user_tags
       & get_configs_response_config_tasks
       & get_configs_response_config_families?
       & get_configs_response_config_preferences?
       & get_configs_response_config_nvt_selectors?
     }

get_configs_response_config_owner
 = element owner
     {
       get_configs_response_config_owner_name
     }

get_configs_response_config_owner_name
 = element name
     {
       name
     }

get_configs_response_config_name
 = element name
     {
       name
     }

get_configs_response_config_comment
 = element comment
     {
       text
     }

get_configs_response_config_creation_time
 = element creation_time
     {
       iso_time
     }

get_configs_response_config_modification_time
 = element modification_time
     {
       iso_time
     }

get_configs_response_config_family_count
 = element family_count
     {
       text # RNC limitation: integer
       & get_configs_response_config_family_count_growing
     }

get_configs_response_config_family_count_growing
 = element growing
     {
       boolean
     }

get_configs_response_config_nvt_count
 = element nvt_count
     {
       text # RNC limitation: integer
       & get_configs_response_config_nvt_count_growing
     }

get_configs_response_config_nvt_count_growing
 = element growing
     {
       boolean
     }

get_configs_response_config_type
 = element type
     {
       text
     }

get_configs_response_config_max_nvt_count
 = element max_nvt_count
     {
       integer
     }

get_configs_response_config_known_nvt_count
 = element known_nvt_count
     {
       integer
     }

get_configs_response_config_in_use
 = element in_use
     {
       boolean
     }

get_configs_response_config_writable
 = element writable
     {
       boolean
     }

get_configs_response_config_permissions
 = element permissions
     {
       get_configs_response_config_permissions_permission*
     }

get_configs_response_config_permissions_permission
 = element permission
     {
       get_configs_response_config_permissions_permission_name
     }

get_configs_response_config_permissions_permission_name
 = element name
     {
       name
     }

get_configs_response_config_user_tags
 = element user_tags
     {
       get_configs_response_config_user_tags_count
       & get_configs_response_config_user_tags_tag*
     }

get_configs_response_config_user_tags_count
 = element count
     {
       integer
     }

get_configs_response_config_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_configs_response_config_user_tags_tag_name
       & get_configs_response_config_user_tags_tag_value
       & get_configs_response_config_user_tags_tag_comment
     }

get_configs_response_config_user_tags_tag_name
 = element name
     {
       text
     }

get_configs_response_config_user_tags_tag_value
 = element value
     {
       text
     }

get_configs_response_config_user_tags_tag_comment
 = element comment
     {
       text
     }

get_configs_response_config_tasks
 = element tasks
     {
       get_configs_response_config_tasks_task*
     }

get_configs_response_config_tasks_task
 = element task
     {
       attribute id { uuid }
       & get_configs_response_config_tasks_task_name
       & get_configs_response_config_tasks_task_permissions?
     }

get_configs_response_config_tasks_task_name
 = element name
     {
       name
     }

get_configs_response_config_tasks_task_permissions
 = element permissions
     {
       ""
     }

get_configs_response_config_families
 = element families
     {
       get_configs_response_config_families_family*
     }

get_configs_response_config_families_family
 = element family
     {
       get_configs_response_config_families_family_name
       & get_configs_response_config_families_family_nvt_count
       & get_configs_response_config_families_family_max_nvt_count
       & get_configs_response_config_families_family_growing
     }

get_configs_response_config_families_family_name
 = element name
     {
       name
     }

get_configs_response_config_families_family_type
 = element type
     {
       integer
     }

get_configs_response_config_families_family_nvt_count
 = element nvt_count
     {
       integer
     }

get_configs_response_config_families_family_max_nvt_count
 = element max_nvt_count
     {
       integer
     }

get_configs_response_config_families_family_growing
 = element growing
     {
       boolean
     }

get_configs_response_config_preferences
 = element preferences
     {
       get_configs_response_config_preferences_preference*
     }

get_configs_response_config_preferences_preference
 = element preference
     {
       get_configs_response_config_preferences_preference_nvt
       & get_configs_response_config_preferences_preference_name
       & get_configs_response_config_preferences_preference_type
       & get_configs_response_config_preferences_preference_value
       & get_configs_response_config_preferences_preference_default
       & get_configs_response_config_preferences_preference_alt*
     }

get_configs_response_config_preferences_preference_nvt
 = element nvt
     {
       attribute oid { oid }
       & get_configs_response_config_preferences_preference_nvt_name
     }

get_configs_response_config_preferences_preference_nvt_name
 = element name
     {
       name
     }

get_configs_response_config_preferences_preference_name
 = element name
     {
       name
     }

get_configs_response_config_preferences_preference_type
 = element type
     {
       text
     }

get_configs_response_config_preferences_preference_value
 = element value
     {
       text
     }

get_configs_response_config_preferences_preference_default
 = element default
     {
       text
     }

get_configs_response_config_preferences_preference_alt
 = element alt
     {
       text
     }

get_configs_response_config_nvt_selectors
 = element nvt_selectors
     {
       get_configs_response_config_nvt_selectors_nvt_selector*
     }

get_configs_response_config_nvt_selectors_nvt_selector
 = element nvt_selector
     {
       get_configs_response_config_nvt_selectors_nvt_selector_name
       & get_configs_response_config_nvt_selectors_nvt_selector_include
       & get_configs_response_config_nvt_selectors_nvt_selector_type
       & get_configs_response_config_nvt_selectors_nvt_selector_family_or_nvt
     }

get_configs_response_config_nvt_selectors_nvt_selector_name
 = element name
     {
       text
     }

get_configs_response_config_nvt_selectors_nvt_selector_include
 = element include
     {
       boolean
     }

get_configs_response_config_nvt_selectors_nvt_selector_type
 = element type
     {
       integer
     }

get_configs_response_config_nvt_selectors_nvt_selector_family_or_nvt
 = element family_or_nvt
     {
       text
     }

get_configs_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_configs_response_filters_term
       & get_configs_response_filters_name?
       & get_configs_response_filters_keywords
     }

get_configs_response_filters_term
 = element term
     {
       text
     }

get_configs_response_filters_name
 = element name
     {
       text
     }

get_configs_response_filters_keywords
 = element keywords
     {
       get_configs_response_filters_keywords_keyword*
     }

get_configs_response_filters_keywords_keyword
 = element keyword
     {
       get_configs_response_filters_keywords_keyword_column
       & get_configs_response_filters_keywords_keyword_relation
       & get_configs_response_filters_keywords_keyword_value
     }

get_configs_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_configs_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_configs_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_configs_response_sort
 = element sort
     {
       text
       & get_configs_response_sort_field
     }

get_configs_response_sort_field
 = element field
     {
       get_configs_response_sort_field_order
     }

get_configs_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_configs_response_configs
 = element configs
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_configs_response_config_count
 = element config_count
     {
       get_configs_response_config_count_filtered
       & get_configs_response_config_count_page
     }

get_configs_response_config_count_filtered
 = element filtered
     {
       integer
     }

get_configs_response_config_count_page
 = element page
     {
       integer
     }

7.51.3 Example: Get one or many configs

Client

 <get_configs/>

Manager

 <get_configs_response status="200"
                       status_text="OK">
   <config id="daba56c8-73ec-11df-a475-002264764cea">
     <name>Full and fast</name>
     <comment>
       All NVT's; optimized by using previously collected information.
     </comment>
     <creation_time>2012-11-23T10:44:00+01:00</creation_time>
     <modification_time>2013-01-23T10:44:00+01:00</modification_time>
     <family_count>
       4
       <growing>1</growing>
     </family_count>
     <nvt_count>
       12
       <growing>1</growing>
     </nvt_count>
     <in_use>1</in_use>
     <writable>0</writable>
     <user_tags>
       <count>0</count>
     </user_tags>
   </config>
   ...
 </get_configs_response>

7.51.3 Example: Get a single config, including preference, family lists and tasks using this config

Client

 <get_configs config_id="daba56c8-73ec-11df-a475-002264764cea"
              preferences="1"
              families="1"
              tasks="1"/>

Manager

 <get_configs_response status="200"
                       status_text="OK">
   <config id="daba56c8-73ec-11df-a475-002264764cea">
     <name>Full and fast</name>
     <comment>
       All NVT's; optimized by using previously collected information.
     </comment>
     <family_count>
       4
       <growing>1</growing>
     </family_count>
     <nvt_count>
       12
       <growing>1</growing>
     </nvt_count>
     <in_use>1</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <tasks>
       <task id="13bb418a-4220-4575-b35b-ec398bff7417">
         <name>Web Servers</name>
       </task>
       ...
     </tasks>
     <families>
       <family>
         <name>Credentials</name>
         <nvt_count>8</nvt_count>
         <max_nvt_count>8</max_nvt_count>
         <growing>1</growing>
       </family>
       ...
     </families>
     <preferences>
       <preference>
         <nvt oid="1.3.6.1.4.1.25623.1.0.10330">
           <name>Services</name>
         </nvt>
         <name>Network connection timeout :</name>
         <type>entry</type>
         <value>5</value>
       </preference>
       ...
     </preferences>
   </config>
   ...
 </get_configs_response>

7.52 Command `get_aggregates`

In short: Get aggregates of various resources.

The client uses the get_aggregate command to get aggregated data like counts or averages of various resources.

Unlike other get_... commands, get_aggregates ignores the filter keywords "first" and "rows". It also does not support selecting single items by id or getting items from the trashcan.

7.52.1 Structure

Command
- @filter (text) Filter term to use to filter query of the resources to aggregate.
- @filt_id (uuid) ID of filter to use to filter query of the resources to aggregate.
- @type (text) The OMP resource type to gather data from.
- @data_column (text) The column to get the data to aggregate from.
- @group_column (text) The field to group the resources by.
Response
- @status (status)
- @status_text (text)
- <aggregate> *
  A collection of aggregated data of the selected type.
  - <data_type>
    The resource type the data is aggregated from.
  - <data_column> ?
    The column the data is aggregated from.
  - <group_column> ?
    The column the data is grouped by.
  - One of
    - <group> *
      Aggregate data for a group of resources.
      - <value>
        Value of the group column.
      - <count>
        Number of resources in the group.
      - <c_count>
        Cumulative number of resources in all groups up to and including the current one.
      - The group?
        
        <min>
        Minimum value of the data column.
        
        <max>
        Maximum value of the data column.
        
        <mean>
        Arithmetic mean of the numeric values of the data.
        
        <sum>
        Sum of the numeric values of the data column.
        
        <c_sum>
        Cumulative sum of the numeric values of the data column for all groups up to and including the current one.
    - <overall>
      Aggregate data for all resources of the selected type.
      - <count>
        Overall number of resources.
      - <min>
        Overall minimum value of the data column.
      - <max>
        Overall maximum value of the data column.
      - <mean>
        Overall arithmetic mean of the numeric values of the data.
      - <sum>
        Overall sum of the numeric values of the data column.
  - <column_info>
    Info on the aggregate columns.
    - <aggregate_column> *
      Info on one column of the aggregate.
      - <name>
        Name of the column as it appears in the group or overall element.
      - <stat>
        The type of statistic in the column, e.g. min, max, mean.
      - <type>
        The resource type.
      - <column>
        Name of the column in the non-aggregated table.
      - <data_type>
        The data type of the column, e.g. integer, text, cvss.
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.

7.52.2 RNC

Command

get_aggregates
 = element get_aggregates
     {
       attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute type { text }
       & attribute data_column { text }?
       & attribute group_column { text }?
     }

Response

get_aggregates_response
 = element get_aggregates_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_aggregates_response_aggregate*
       & get_aggregates_response_filters
     }

get_aggregates_response_aggregate
 = element aggregate
     {
       get_aggregates_response_aggregate_data_type
       & get_aggregates_response_aggregate_data_column?
       & get_aggregates_response_aggregate_group_column?
       & ( get_aggregates_response_aggregate_group*
           | get_aggregates_response_aggregate_overall )
       & get_aggregates_response_aggregate_column_info
     }

get_aggregates_response_aggregate_data_type
 = element data_type
     {
       text
     }

get_aggregates_response_aggregate_data_column
 = element data_column
     {
       text
     }

get_aggregates_response_aggregate_group_column
 = element group_column
     {
       text
     }

get_aggregates_response_aggregate_group
 = element group
     {
       text
     }

get_aggregates_response_aggregate_group
 = element group
     {
       get_aggregates_response_aggregate_group_value
       & get_aggregates_response_aggregate_group_count
       & get_aggregates_response_aggregate_group_c_count
       & ( get_aggregates_response_aggregate_group_min
           & get_aggregates_response_aggregate_group_max
           & get_aggregates_response_aggregate_group_mean
           & get_aggregates_response_aggregate_group_sum
           & get_aggregates_response_aggregate_group_c_sum )?
     }

get_aggregates_response_aggregate_group_value
 = element value
     {
       text
     }

get_aggregates_response_aggregate_group_count
 = element count
     {
       integer
     }

get_aggregates_response_aggregate_group_c_count
 = element c_count
     {
       integer
     }

get_aggregates_response_aggregate_group_min
 = element min
     {
       text
     }

get_aggregates_response_aggregate_group_max
 = element max
     {
       text
     }

get_aggregates_response_aggregate_group_mean
 = element mean
     {
       text
     }

get_aggregates_response_aggregate_group_sum
 = element sum
     {
       text
     }

get_aggregates_response_aggregate_group_c_sum
 = element c_sum
     {
       text
     }

get_aggregates_response_aggregate_overall
 = element overall
     {
       get_aggregates_response_aggregate_overall_count
       & get_aggregates_response_aggregate_overall_min
       & get_aggregates_response_aggregate_overall_max
       & get_aggregates_response_aggregate_overall_mean
       & get_aggregates_response_aggregate_overall_sum
     }

get_aggregates_response_aggregate_overall_count
 = element count
     {
       integer
     }

get_aggregates_response_aggregate_overall_min
 = element min
     {
       text
     }

get_aggregates_response_aggregate_overall_max
 = element max
     {
       text
     }

get_aggregates_response_aggregate_overall_mean
 = element mean
     {
       text
     }

get_aggregates_response_aggregate_overall_sum
 = element sum
     {
       text
     }

get_aggregates_response_aggregate_column_info
 = element column_info
     {
       get_aggregates_response_aggregate_column_info_aggregate_column*
     }

get_aggregates_response_aggregate_column_info_aggregate_column
 = element aggregate_column
     {
       get_aggregates_response_aggregate_column_info_aggregate_column_name
       & get_aggregates_response_aggregate_column_info_aggregate_column_stat
       & get_aggregates_response_aggregate_column_info_aggregate_column_type
       & get_aggregates_response_aggregate_column_info_aggregate_column_column
       & get_aggregates_response_aggregate_column_info_aggregate_column_data_type
     }

get_aggregates_response_aggregate_column_info_aggregate_column_name
 = element name
     {
       text
     }

get_aggregates_response_aggregate_column_info_aggregate_column_stat
 = element stat
     {
       text
     }

get_aggregates_response_aggregate_column_info_aggregate_column_type
 = element type
     {
       text
     }

get_aggregates_response_aggregate_column_info_aggregate_column_column
 = element column
     {
       text
     }

get_aggregates_response_aggregate_column_info_aggregate_column_data_type
 = element data_type
     {
       text
     }

get_aggregates_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_aggregates_response_filters_term
       & get_aggregates_response_filters_name?
       & get_aggregates_response_filters_keywords
     }

get_aggregates_response_filters_term
 = element term
     {
       text
     }

get_aggregates_response_filters_name
 = element name
     {
       text
     }

get_aggregates_response_filters_keywords
 = element keywords
     {
       get_aggregates_response_filters_keywords_keyword*
     }

get_aggregates_response_filters_keywords_keyword
 = element keyword
     {
       get_aggregates_response_filters_keywords_keyword_column
       & get_aggregates_response_filters_keywords_keyword_relation
       & get_aggregates_response_filters_keywords_keyword_value
     }

get_aggregates_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_aggregates_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_aggregates_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

7.52.3 Example: Get severity statistics of NVTs by family

Client

 <get_aggregates type="nvt"
                 group_column="family"
                 data_column="severity"/>

Manager

 <get_aggregates_response status_text="OK"
                          status="200">
   <aggregate>
     <data_type>nvt</data_type>
     <data_column>severity</data_column>
     <group_column>family</group_column>
     <group>
       <value>AIX Local Security Checks</value>
       <count>1</count>
       <c_count>1</c_count>
       <min>3.3</min>
       <max>3.3</max>
       <mean>3.3</mean>
       <sum>3.3</sum>
       <c_sum>3.3</c_sum>
     </group>
     <group>
       <value>Brute force attacks</value>
       <count>8</count>
       <c_count>9</c_count>
       <min>0</min>
       <max>7.8</max>
       <mean>6.275</mean>
       <sum>50.2</sum>
       <c_sum>53.5</c_sum>
     </group>
     <group>
       <value>Buffer overflow</value>
       <count>519</count>
       <c_count>528</c_count>
       <min>10</min>
       <max>9.7</max>
       <mean>8.63083</mean>
       <sum>4479.4</sum>
       <c_sum>4532.9</c_sum>
     </group>
     ...
     <column_info>
       <aggregate_column>
         <name>value</name>
         <stat>value</stat>
         <type>nvt</type>
         <column>family</column>
         <data_type>text</data_type>
       </aggregate_column>
       <aggregate_column>
         <name>count</name>
         <stat>count</stat>
         <type>nvt</type>
         <column/>
         <data_type>integer</data_type>
       </aggregate_column>
       <aggregate_column>
         <name>c_count</name>
         <stat>c_count</stat>
         <type>nvt</type>
         <column/>
         <data_type>integer</data_type>
       </aggregate_column>
       <aggregate_column>
         <name>min</name>
         <stat>min</stat>
         <type>nvt</type>
         <column>severity</column>
         <data_type>cvss</data_type>
       </aggregate_column>
       ...
     </column_info>
   </aggregate>
   <filters id="">
     <term>first=1 rows=-1 sort=name</term>
     <keywords>
       <keyword>
         <column>first</column>
         <relation>=</relation>
         <value>1</value>
       </keyword>
       <keyword>
         <column>rows</column>
         <relation>=</relation>
         <value>-1</value>
       </keyword>
       <keyword>
         <column>sort</column>
         <relation>=</relation>
         <value>name</value>
       </keyword>
     </keywords>
   </filters>
 </get_aggregates_response>

7.53 Command `get_alerts`

In short: Get one or many alerts.

The client uses the get_alerts command to get alert information. If the command sent by the client was valid, the manager will reply with a list of alerts to the client.

7.53.1 Structure

Command
- @alert_id (uuid) ID of single alert to get.
- @filter (text) Filter term to use to filter query.
- @filt_id (uuid) ID of filter to use to filter query.
- @trash (boolean) Whether to get the trashcan alerts instead.
- @tasks (boolean) Whether to get the tasks using the alerts.
Response
- @status (status)
- @status_text (text)
- <alert> *
  - @id (uuid)
  - <owner>
    Owner of the alert.
    - <name>
      The name of the owner.
  - <name>
    The name of the alert.
  - <comment>
    The comment on the alert.
  - <creation_time>
    Creation time of the alert.
  - <modification_time>
    Last time the alert was modified.
  - <in_use>
    Whether any tasks are using the alert.
  - <writable>
    Whether the alert is writable or not.
  - <permissions>
    Permissions that the current user has on the alert.
    - <permission> *
      - <name>
        The name of the permission.
  - <user_tags>
    Info on tags attached to the alert.
    - <count>
      Number of attached tags.
    - <tag> *
      Short info on an individual tag (only if details were requested).
      - @id (uuid) UUID of the tag.
      - <name>
        Name of the tag (usually namespace:predicate).
      - <value>
        Value of the tag.
      - <comment>
        Comment for the tag.
  - <condition>
    The condition that must be satisfied for the alert to occur.
    - <data> *
      Some data that defines the condition.
      - <name>
        The name of the condition data.
  - <event>
    The event that must happen for the alert to occur.
    - <data> *
      Some data that defines the event.
      - <name>
        The name of the event data.
  - <method>
    The method by which he alert must occur.
    - <data> *
      Some data that defines the method.
      - <name>
        The name of the method data.
  - <filter>
    - @id (uuid)
    - <name>
      The name of the filter.
    - <permissions> ?
      Permissions the user has on the filter.
    - <trash>
      Whether the filter is in the trashcan.
  - <tasks> ?
    Tasks using the alert.
    - <task> *
      - @id (uuid)
      - <name>
        The name of the task.
      - <permissions> ?
        Permissions the user has on the task.
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
- <sort>
  - <field>
    - <order>
- <alerts>
  - @start (integer) First alert.
  - @max (integer) Maximum number of alerts.
- <alert_count>
  - <filtered>
    Number of alerts after filtering.
  - <page>
    Number of alerts on current page.

7.53.2 RNC

Command

get_alerts
 = element get_alerts
     {
       attribute alert_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute trash { boolean }?
       & attribute tasks { boolean }?
     }

Response

get_alerts_response
 = element get_alerts_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_alerts_response_alert*
       & get_alerts_response_filters
       & get_alerts_response_sort
       & get_alerts_response_alerts
       & get_alerts_response_alert_count
     }

get_alerts_response_alert
 = element alert
     {
       attribute id { uuid }
       & get_alerts_response_alert_owner
       & get_alerts_response_alert_name
       & get_alerts_response_alert_comment
       & get_alerts_response_alert_creation_time
       & get_alerts_response_alert_modification_time
       & get_alerts_response_alert_in_use
       & get_alerts_response_alert_writable
       & get_alerts_response_alert_permissions
       & get_alerts_response_alert_user_tags
       & get_alerts_response_alert_condition
       & get_alerts_response_alert_event
       & get_alerts_response_alert_method
       & get_alerts_response_alert_filter
       & get_alerts_response_alert_tasks?
     }

get_alerts_response_alert_owner
 = element owner
     {
       get_alerts_response_alert_owner_name
     }

get_alerts_response_alert_owner_name
 = element name
     {
       name
     }

get_alerts_response_alert_name
 = element name
     {
       name
     }

get_alerts_response_alert_comment
 = element comment
     {
       text
     }

get_alerts_response_alert_in_use
 = element in_use
     {
       boolean
     }

get_alerts_response_alert_writable
 = element writable
     {
       boolean
     }

get_alerts_response_alert_creation_time
 = element creation_time
     {
       iso_time
     }

get_alerts_response_alert_modification_time
 = element modification_time
     {
       iso_time
     }

get_alerts_response_alert_permissions
 = element permissions
     {
       get_alerts_response_alert_permissions_permission*
     }

get_alerts_response_alert_permissions_permission
 = element permission
     {
       get_alerts_response_alert_permissions_permission_name
     }

get_alerts_response_alert_permissions_permission_name
 = element name
     {
       name
     }

get_alerts_response_alert_user_tags
 = element user_tags
     {
       get_alerts_response_alert_user_tags_count
       & get_alerts_response_alert_user_tags_tag*
     }

get_alerts_response_alert_user_tags_count
 = element count
     {
       integer
     }

get_alerts_response_alert_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_alerts_response_alert_user_tags_tag_name
       & get_alerts_response_alert_user_tags_tag_value
       & get_alerts_response_alert_user_tags_tag_comment
     }

get_alerts_response_alert_user_tags_tag_name
 = element name
     {
       text
     }

get_alerts_response_alert_user_tags_tag_value
 = element value
     {
       text
     }

get_alerts_response_alert_user_tags_tag_comment
 = element comment
     {
       text
     }

get_alerts_response_alert_condition
 = element condition
     {
       text
       & get_alerts_response_alert_condition_data*
     }

get_alerts_response_alert_condition_data
 = element data
     {
       text
       & get_alerts_response_alert_condition_data_name
     }

get_alerts_response_alert_condition_data_name
 = element name
     {
       text
     }

get_alerts_response_alert_event
 = element event
     {
       text
       & get_alerts_response_alert_event_data*
     }

get_alerts_response_alert_event_data
 = element data
     {
       text
       & get_alerts_response_alert_event_data_name
     }

get_alerts_response_alert_event_data_name
 = element name
     {
       text
     }

get_alerts_response_alert_method
 = element method
     {
       text
       & get_alerts_response_alert_method_data*
     }

get_alerts_response_alert_method_data
 = element data
     {
       text
       & get_alerts_response_alert_method_data_name
     }

get_alerts_response_alert_method_data_name
 = element name
     {
       text
     }

get_alerts_response_alert_filter
 = element filter
     {
       attribute id { uuid }?
       & get_alerts_response_alert_filter_name
       & get_alerts_response_alert_filter_permissions?
       & get_alerts_response_alert_filter_trash
     }

get_alerts_response_alert_filter_name
 = element name
     {
       name
     }

get_alerts_response_alert_filter_permissions
 = element permissions
     {
       ""
     }

get_alerts_response_alert_filter_trash
 = element trash
     {
       boolean
     }

get_alerts_response_alert_tasks
 = element tasks
     {
       get_alerts_response_alert_tasks_task*
     }

get_alerts_response_alert_tasks_task
 = element task
     {
       attribute id { uuid }
       & get_alerts_response_alert_tasks_task_name
       & get_alerts_response_alert_tasks_task_permissions?
     }

get_alerts_response_alert_tasks_task_name
 = element name
     {
       name
     }

get_alerts_response_alert_tasks_task_permissions
 = element permissions
     {
       ""
     }

get_alerts_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_alerts_response_filters_term
       & get_alerts_response_filters_name?
       & get_alerts_response_filters_keywords
     }

get_alerts_response_filters_term
 = element term
     {
       text
     }

get_alerts_response_filters_name
 = element name
     {
       text
     }

get_alerts_response_filters_keywords
 = element keywords
     {
       get_alerts_response_filters_keywords_keyword*
     }

get_alerts_response_filters_keywords_keyword
 = element keyword
     {
       get_alerts_response_filters_keywords_keyword_column
       & get_alerts_response_filters_keywords_keyword_relation
       & get_alerts_response_filters_keywords_keyword_value
     }

get_alerts_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_alerts_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_alerts_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_alerts_response_sort
 = element sort
     {
       text
       & get_alerts_response_sort_field
     }

get_alerts_response_sort_field
 = element field
     {
       get_alerts_response_sort_field_order
     }

get_alerts_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_alerts_response_alerts
 = element alerts
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_alerts_response_alert_count
 = element alert_count
     {
       get_alerts_response_alert_count_filtered
       & get_alerts_response_alert_count_page
     }

get_alerts_response_alert_count_filtered
 = element filtered
     {
       integer
     }

get_alerts_response_alert_count_page
 = element page
     {
       integer
     }

7.53.3 Example: Get the alerts

Client

 <get_alerts/>

Manager

 <get_alerts_response status="200"
                      status_text="OK">
   <alert id="6181e65d-8ba0-4937-9c44-8f2b10b0def7">
     <name>Team alert</name>
     <comment/>
     <creation_time>2012-04-27T12:44:00+01:00</creation_time>
     <modification_time>2012-08-28T12:14:00+01:00</modification_time>
     <writable>1</writable>
     <in_use>1</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <condition>
       Threat level at least
       <data>
         High
         <name>level</name>
       </data>
     </condition>
     <event>
       Task run status changed
       <data>
         Done
         <name>status</name>
       </data>
     </event>
     <method>
       Email
       <data>
         team@example.org
         <name>to_address</name>
       </data>
       <data>
         admin@example.org
         <name>from_address</name>
       </data>
       <data>
         0
         <name>notice</name>
       </data>
     </method>
   </alert>
   ...
 </get_alerts_response>

7.54 Command `get_filters`

In short: Get one or many filters.

The client uses the get_filters command to get filter information.

7.54.1 Structure

Command
- @filter_id (uuid) ID of single filter to get.
- @filter (text) Filter term to use to filter query.
- @filt_id (uuid) ID of filter to use to filter query.
- @trash (boolean) Whether to get the trashcan filters instead.
- @alerts (boolean) Whether to include list of alerts that use the filter.
Response
- @status (status)
- @status_text (text)
- <filter> *
  - @id (uuid)
  - <owner>
    Owner of the filter.
    - <name>
      The name of the owner.
  - <name>
    The name of the filter.
  - <comment>
    The comment on the filter.
  - <term>
    The filter term.
  - <type>
    Resource type filter applies to. Blank for all.
  - <creation_time>
    Date and time the filter was created.
  - <modification_time>
    Date and time the filter was last modified.
  - <in_use>
    Whether any tasks are using the filter.
  - <writable>
    Whether the filter is writable.
  - <permissions>
    Permissions that the current user has on the filter.
    - <permission> *
      - <name>
        The name of the permission.
  - <user_tags>
    Info on tags attached to the filter.
    - <count>
      Number of attached tags.
    - <tag> *
      Short info on an individual tag (only if details were requested).
      - @id (uuid) UUID of the tag.
      - <name>
        Name of the tag (usually namespace:predicate).
      - <value>
        Value of the tag.
      - <comment>
        Comment for the tag.
  - <alerts> ?
    All alerts using the filter.
    - <alert> *
      - @id (uuid)
      - <name>
        The name of the alert.
      - <permissions> ?
        Permissions the user has on the alert.
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
  - @start (integer) First filter.
  - @max (integer) Maximum number of filters.
- <sort>
  - <field>
    - <order>
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
  - @start (integer) First filter.
  - @max (integer) Maximum number of filters.
- <filter_count>
  - <filtered>
    Number of filters after filtering.
  - <page>
    Number of filters on current page.

7.54.2 RNC

Command

get_filters
 = element get_filters
     {
       attribute filter_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute trash { boolean }?
       & attribute alerts { boolean }?
     }

Response

get_filters_response
 = element get_filters_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_filters_response_filter*
       & get_filters_response_filters
       & get_filters_response_sort
       & get_filters_response_filters
       & get_filters_response_filter_count
     }

get_filters_response_filter
 = element filter
     {
       attribute id { uuid }
       & get_filters_response_filter_owner
       & get_filters_response_filter_name
       & get_filters_response_filter_comment
       & get_filters_response_filter_term
       & get_filters_response_filter_type
       & get_filters_response_filter_creation_time
       & get_filters_response_filter_modification_time
       & get_filters_response_filter_in_use
       & get_filters_response_filter_writable
       & get_filters_response_filter_permissions
       & get_filters_response_filter_user_tags
       & get_filters_response_filter_alerts?
     }

get_filters_response_filter_owner
 = element owner
     {
       get_filters_response_filter_owner_name
     }

get_filters_response_filter_owner_name
 = element name
     {
       name
     }

get_filters_response_filter_name
 = element name
     {
       name
     }

get_filters_response_filter_comment
 = element comment
     {
       text
     }

get_filters_response_filter_term
 = element term
     {
       text
     }

get_filters_response_filter_type
 = element type
     {
       text
     }

get_filters_response_filter_creation_time
 = element creation_time
     {
       iso_time
     }

get_filters_response_filter_modification_time
 = element modification_time
     {
       iso_time
     }

get_filters_response_filter_in_use
 = element in_use
     {
       boolean
     }

get_filters_response_filter_writable
 = element writable
     {
       boolean
     }

get_filters_response_filter_permissions
 = element permissions
     {
       get_filters_response_filter_permissions_permission*
     }

get_filters_response_filter_permissions_permission
 = element permission
     {
       get_filters_response_filter_permissions_permission_name
     }

get_filters_response_filter_permissions_permission_name
 = element name
     {
       name
     }

get_filters_response_filter_user_tags
 = element user_tags
     {
       get_filters_response_filter_user_tags_count
       & get_filters_response_filter_user_tags_tag*
     }

get_filters_response_filter_user_tags_count
 = element count
     {
       integer
     }

get_filters_response_filter_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_filters_response_filter_user_tags_tag_name
       & get_filters_response_filter_user_tags_tag_value
       & get_filters_response_filter_user_tags_tag_comment
     }

get_filters_response_filter_user_tags_tag_name
 = element name
     {
       text
     }

get_filters_response_filter_user_tags_tag_value
 = element value
     {
       text
     }

get_filters_response_filter_user_tags_tag_comment
 = element comment
     {
       text
     }

get_filters_response_filter_alerts
 = element alerts
     {
       get_filters_response_filter_alerts_alert*
     }

get_filters_response_filter_alerts_alert
 = element alert
     {
       attribute id { uuid }
       & get_filters_response_filter_alerts_alert_name
       & get_filters_response_filter_alerts_alert_permissions?
     }

get_filters_response_filter_alerts_alert_name
 = element name
     {
       name
     }

get_filters_response_filter_alerts_alert_permissions
 = element permissions
     {
       ""
     }

get_filters_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_filters_response_filters_term
       & get_filters_response_filters_name?
       & get_filters_response_filters_keywords
     }

get_filters_response_filters_term
 = element term
     {
       text
     }

get_filters_response_filters_name
 = element name
     {
       text
     }

get_filters_response_filters_keywords
 = element keywords
     {
       get_filters_response_filters_keywords_keyword*
     }

get_filters_response_filters_keywords_keyword
 = element keyword
     {
       get_filters_response_filters_keywords_keyword_column
       & get_filters_response_filters_keywords_keyword_relation
       & get_filters_response_filters_keywords_keyword_value
     }

get_filters_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_filters_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_filters_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_filters_response_sort
 = element sort
     {
       text
       & get_filters_response_sort_field
     }

get_filters_response_sort_field
 = element field
     {
       get_filters_response_sort_field_order
     }

get_filters_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_filters_response_filters
 = element filters
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_filters_response_filter_count
 = element filter_count
     {
       get_filters_response_filter_count_filtered
       & get_filters_response_filter_count_page
     }

get_filters_response_filter_count_filtered
 = element filtered
     {
       integer
     }

get_filters_response_filter_count_page
 = element page
     {
       integer
     }

7.54.3 Example: Get one or many filters

Client

 <get_filters/>

Manager

 <get_filters_response status="200"
                       status_text="OK">
   <filter id="b493b7a8-7489-11df-a3ec-001164764cea">
     <name>Single Targets</name>
     <comment>Targets with only one host</comment>
     <term>ips=1 first=1 rows=-2</term>
     <type>target</type>
     <in_use>1</in_use>
     <writable>1</writable>
     <user_tags>
       <count>0</count>
     </user_tags>
     <creation_time>Sun Jun 27 08:49:46 2010</creation_time>
     <modification_time>Sun Jun 27 08:49:46 2010</modification_time>
   </filter>
   ...
 </get_filters_response>

7.54.3 Example: Get single filter, including alerts that use the filter

Client

 <get_filters filter_id="c33864a9-d3fd-44b3-8717-972bfb01dfc0"
              tasks="1"/>

Manager

 <get_filters_response status="200"
                       status_text="OK">
   <filter id="c33864a9-d3fd-44b3-8717-972bfb01dfc0">
     <name>Local</name>
     <comment>Any item with name containing 'local'.</comment>
     <term>name~local first=1 rows=-2</term>
     <type/>
     <in_use>1</in_use>
     <writable>1</writable>
     <user_tags>
       <count>0</count>
     </user_tags>
     <creation_time>Sun Jun 27 08:49:43 2010</creation_time>
     <modification_time>Sun Jun 27 08:49:43 2010</modification_time>
     <alerts>
       <alert id="13bb418a-4220-4575-b35b-ec398bff7418">
         <name>Local Mailer</name>
       </alert>
       ...
     </alerts>
   </filter>
 </get_filters_response>

7.55 Command `get_groups`

In short: Get one or many groups.

The client uses the get_groups command to get group information.

7.55.1 Structure

Command
- @group_id (uuid) ID of single group to get.
- @filter (text) Filter term to use to filter query.
- @filt_id (uuid) ID of filter to use to filter query.
- @trash (boolean) Whether to get the trashcan groups instead.
Response
- @status (status)
- @status_text (text)
- <group> *
  - @id (uuid)
  - <owner>
    Owner of the group.
    - <name>
      The name of the owner.
  - <name>
    The name of the group.
  - <comment>
    The comment on the group.
  - <creation_time>
    Date and time the group was created.
  - <modification_time>
    Date and time the group was last modified.
  - <writable>
    Whether the group is writable.
  - <in_use>
    Whether the group is in use.
  - <permissions>
    Permissions that the current user has on the group.
    - <permission> *
      - <name>
        The name of the permission.
  - <user_tags>
    Info on tags attached to the group.
    - <count>
      Number of attached tags.
    - <tag> *
      Short info on an individual tag (only if details were requested).
      - @id (uuid) UUID of the tag.
      - <name>
        Name of the tag (usually namespace:predicate).
      - <value>
        Value of the tag.
      - <comment>
        Comment for the tag.
  - <users>
    A comma-separated list of the users in the group.
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
- <sort>
  - <field>
    - <order>
- <groups>
  - @start (integer) First group.
  - @max (integer) Maximum number of groups.
- <group_count>
  - <filtered>
    Number of groups after filtering.
  - <page>
    Number of groups on current page.

7.55.2 RNC

Command

get_groups
 = element get_groups
     {
       attribute group_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute trash { boolean }?
     }

Response

get_groups_response
 = element get_groups_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_groups_response_group*
       & get_groups_response_filters
       & get_groups_response_sort
       & get_groups_response_groups
       & get_groups_response_group_count
     }

get_groups_response_group
 = element group
     {
       attribute id { uuid }
       & get_groups_response_group_owner
       & get_groups_response_group_name
       & get_groups_response_group_comment
       & get_groups_response_group_creation_time
       & get_groups_response_group_modification_time
       & get_groups_response_group_writable
       & get_groups_response_group_in_use
       & get_groups_response_group_permissions
       & get_groups_response_group_user_tags
       & get_groups_response_group_users
     }

get_groups_response_group_owner
 = element owner
     {
       get_groups_response_group_owner_name
     }

get_groups_response_group_owner_name
 = element name
     {
       name
     }

get_groups_response_group_name
 = element name
     {
       name
     }

get_groups_response_group_comment
 = element comment
     {
       text
     }

get_groups_response_group_creation_time
 = element creation_time
     {
       iso_time
     }

get_groups_response_group_modification_time
 = element modification_time
     {
       iso_time
     }

get_groups_response_group_users
 = element users
     {
       text
     }

get_groups_response_group_writable
 = element writable
     {
       boolean
     }

get_groups_response_group_in_use
 = element in_use
     {
       boolean
     }

get_groups_response_group_permissions
 = element permissions
     {
       get_groups_response_group_permissions_permission*
     }

get_groups_response_group_permissions_permission
 = element permission
     {
       get_groups_response_group_permissions_permission_name
     }

get_groups_response_group_permissions_permission_name
 = element name
     {
       name
     }

get_groups_response_group_user_tags
 = element user_tags
     {
       get_groups_response_group_user_tags_count
       & get_groups_response_group_user_tags_tag*
     }

get_groups_response_group_user_tags_count
 = element count
     {
       integer
     }

get_groups_response_group_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_groups_response_group_user_tags_tag_name
       & get_groups_response_group_user_tags_tag_value
       & get_groups_response_group_user_tags_tag_comment
     }

get_groups_response_group_user_tags_tag_name
 = element name
     {
       text
     }

get_groups_response_group_user_tags_tag_value
 = element value
     {
       text
     }

get_groups_response_group_user_tags_tag_comment
 = element comment
     {
       text
     }

get_groups_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_groups_response_filters_term
       & get_groups_response_filters_name?
       & get_groups_response_filters_keywords
     }

get_groups_response_filters_term
 = element term
     {
       text
     }

get_groups_response_filters_name
 = element name
     {
       text
     }

get_groups_response_filters_keywords
 = element keywords
     {
       get_groups_response_filters_keywords_keyword*
     }

get_groups_response_filters_keywords_keyword
 = element keyword
     {
       get_groups_response_filters_keywords_keyword_column
       & get_groups_response_filters_keywords_keyword_relation
       & get_groups_response_filters_keywords_keyword_value
     }

get_groups_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_groups_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_groups_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_groups_response_sort
 = element sort
     {
       text
       & get_groups_response_sort_field
     }

get_groups_response_sort_field
 = element field
     {
       get_groups_response_sort_field_order
     }

get_groups_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_groups_response_groups
 = element groups
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_groups_response_group_count
 = element group_count
     {
       get_groups_response_group_count_filtered
       & get_groups_response_group_count_page
     }

get_groups_response_group_count_filtered
 = element filtered
     {
       integer
     }

get_groups_response_group_count_page
 = element page
     {
       integer
     }

7.55.3 Example: Get one or many groups

Client

 <get_groups/>

Manager

 <get_groups_response status="200"
                      status_text="OK">
   <group id="b493b7a8-7489-11df-a3ec-002264764cea">
     <name>Management</name>
     <comment>Managers</comment>
     <creation_time>Sun Jun 27 08:49:43 2010</creation_time>
     <modification_time>Sun Jun 27 08:49:43 2010</modification_time>
     <writable>1</writable>
     <in_use>0</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <users>sarah, frank</users>
   </group>
   ...
   <filters id="">
     <term>first=1 rows=-1 sort=name</term>
     <keywords>
       <keyword>
         <column>first</column>
         <relation>=</relation>
         <value>1</value>
       </keyword>
       ...
     </keywords>
   </filters>
   <sort>
     <field>
       name
       <order>ascending</order>
     </field>
   </sort>
   <groups max="-1"
           start="1"/>
   <group_count>
     1
     <filtered>1</filtered>
     <page>1</page>
   </group_count>
 </get_groups_response>

7.56 Command `get_info`

In short: Get information for items of given type.

The client uses the get_info command to get information about static data from an external source, like CVE or CPE. If the command sent by the client was valid, the manager will reply with a list of info elements of a given type to the client.

7.56.1 Structure

Command
- @type (text) Type must be either CERT_BUND_ADV, CPE, CVE, DFN_CERT_ADV, OVALDEF, NVT or ALLINFO.
- @name (text) Name or identifier of the requested information.
- @info_id (text) ID of single info to get. Conflicts with name.
- @filter (text) Filter term to use to filter query.
- @filt_id (uuid) ID of filter to use to filter query.
- @details (boolean) Whether to include information about references to this information.
Response
- @status (status)
- @status_text (text)
- <info> *
  - @id (integer) A unique number identifying this info, if available.
  - <owner>
    Owner of the info.
    - <name>
      The name of the owner.
  - <name>
    The name of the info.
  - <comment>
    The comment on the info.
  - <creation_time>
    Date and time the info was created.
  - <modification_time>
    Date and time the info was last modified.
  - <permissions>
    Permissions that the current user has on the info.
    - <permission> *
      - <name>
        The name of the permission.
  - <user_tags>
    Info on tags attached to the info.
    - <count>
      Number of attached tags.
    - <tag> *
      Short info on an individual tag (only if details were requested).
      - @id (uuid) UUID of the tag.
      - <name>
        Name of the tag (usually namespace:predicate).
      - <value>
        Value of the tag.
      - <comment>
        Comment for the tag.
  - <update_time>
    Date and time the source of the info was read.
  - One of
    - <cert_bund_adv>
      An CERT-Bund advisory info element.
      - <title>
        Title of the advisory.
      - <summary>
        Summary text of the advisory.
      - <max_cvss>
        Highest CVSS score of CVEs referenced by the advisory.
      - <cve_refs>
        Number of CVEs referenced by this advisory.
      - <raw_data> ?
        Source representation of the information. Only when details were requested.
    - <cpe>
      A CPE info element.
      - <nvd_id>
        The NVD ID of the CPE.
      - <title> ?
        The title of the CPE.
      - <max_cvss>
        The highest CVSS recorder for this CPE.
      - <cve_refs>
        The number CVE of references to this CPE.
      - <status>
        The status of this CPE.
      - <cves> ?
        CVEs referring to this CPE. Only when details were requested.
        
        <cve> *
        CVE referring to this CPE.
      - <raw_data> ?
        Source representation of the information. Only when details were requested.
    - <cve>
      A CVE info element.
      - <cvss>
        CVSS Base Score.
      - <vector>
        CVSS Access Vector metric.
      - <complexity>
        CVSS Attack Complexity metric.
      - <authentication>
        CVSS Authentication metric.
      - <confidentiality_impact>
        CVSS Confidentiality impact metric.
      - <integrity_impact>
        CVSS Integrity impact metric.
      - <availability_impact>
        CVSS Availability impact metric.
      - <description>
        The CVE's description.
      - <products>
        Space separated list of CPEs affected by this.
      - <nvts> ?
        NVTs addressing this CVE. Only when details were requested.
        
        <nvt> *
        NVT referring to this CPE.
        
        @oid (oid)
        
        <name>
        Name of the NVT.
      - <cert> ?
        List of CERT advisories referencing this CVE.
        
        <cert_ref> *
        A CERT advisory reference.
        
        @type (text) Type of the advisory (e.g. "DFN-CERT", "CERT-BUND").
        
        <name>
        The name / ID of the advisory.
        
        <title>
        The title of the advisory.
        
        <warning> ?
        A warning message, e.g. when the database is unavailable.
      - <raw_data> ?
        Source representation of the information. Only when details were requested.
    - <dfn_cert_adv>
      An DFN-CERT advisory info element.
      - <title>
        Title of the advisory.
      - <summary>
        Summary text of the advisory.
      - <max_cvss>
        Highest CVSS score of CVEs referenced by the advisory.
      - <cve_refs>
        Number of CVEs referenced by this advisory.
      - <raw_data> ?
        Source representation of the information. Only when details were requested.
    - <ovaldef>
      An OVAL definition info element.
      - <version>
        Version number of the OVAL definition.
      - <deprecated>
        Whether the definition is deprecated.
      - <status>
        Lifecycle status text of the definition.
      - <class>
        Definition class of the definition.
      - <title>
        Title of the definition.
      - <max_cvss>
        Highest CVSS score of CVEs referenced by the definition.
      - <cve_refs>
        Number of CVEs referenced by the definition.
      - <file>
        Path to the source xml file, relative to the SCAP data directory.
      - <description> ?
        Longer description of the definition. Only when details were requested.
      - <raw_data> ?
        Source representation of the information. Only when details were requested.
    - <nvt>
      A NVT info element.
    - <allinfo>
      A SecInfo entry. Could be CPE, CVE, NVT, OVALDEF or DFN-CERT Advisory.
      - <type>
        Type of SecInfo entry.
      - <extra>
        Extra information from the entry like title or description.
      - <severity>
        Severity rating (CVSS score) of the entry.
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    (text)
    
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
- <sort>
  - <field>
    - <order>
- <details>
  (boolean)
  
  Are details included in this response.
- <info_count>
  - <filtered>
    Number of info elements after filtering.
  - <page>
    Number of info elements on current page.

7.56.2 RNC

Command

get_info
 = element get_info
     {
       attribute type { text }
       & attribute name { text }?
       & attribute info_id { text }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute details { boolean }?
     }

Response

get_info_response
 = element get_info_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_info_response_info*
       & get_info_response_filters
       & get_info_response_sort
       & get_info_response_details
       & get_info_response_info_count
     }

get_info_response_info
 = element info
     {
       attribute id { integer }?
       & get_info_response_info_owner
       & get_info_response_info_name
       & get_info_response_info_comment
       & get_info_response_info_creation_time
       & get_info_response_info_modification_time
       & get_info_response_info_permissions
       & get_info_response_info_user_tags
       & get_info_response_info_update_time
       & ( get_info_response_info_cert_bund_adv
           | get_info_response_info_cpe
           | get_info_response_info_cve
           | get_info_response_info_dfn_cert_adv
           | get_info_response_info_ovaldef
           | get_info_response_info_nvt
           | get_info_response_info_allinfo )
     }

get_info_response_info_owner
 = element owner
     {
       get_info_response_info_owner_name
     }

get_info_response_info_owner_name
 = element name
     {
       name
     }

get_info_response_info_name
 = element name
     {
       name
     }

get_info_response_info_comment
 = element comment
     {
       text
     }

get_info_response_info_creation_time
 = element creation_time
     {
       iso_time
     }

get_info_response_info_modification_time
 = element modification_time
     {
       iso_time
     }

get_info_response_info_update_time
 = element update_time
     {
       iso_time
     }

get_info_response_info_permissions
 = element permissions
     {
       get_info_response_info_permissions_permission*
     }

get_info_response_info_permissions_permission
 = element permission
     {
       get_info_response_info_permissions_permission_name
     }

get_info_response_info_permissions_permission_name
 = element name
     {
       name
     }

get_info_response_info_user_tags
 = element user_tags
     {
       get_info_response_info_user_tags_count
       & get_info_response_info_user_tags_tag*
     }

get_info_response_info_user_tags_count
 = element count
     {
       integer
     }

get_info_response_info_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_info_response_info_user_tags_tag_name
       & get_info_response_info_user_tags_tag_value
       & get_info_response_info_user_tags_tag_comment
     }

get_info_response_info_user_tags_tag_name
 = element name
     {
       text
     }

get_info_response_info_user_tags_tag_value
 = element value
     {
       text
     }

get_info_response_info_user_tags_tag_comment
 = element comment
     {
       text
     }

get_info_response_info_cert_bund_adv
 = element cert_bund_adv
     {
       get_info_response_info_cert_bund_adv_title
       & get_info_response_info_cert_bund_adv_summary
       & get_info_response_info_cert_bund_adv_max_cvss
       & get_info_response_info_cert_bund_adv_cve_refs
       & get_info_response_info_cert_bund_adv_raw_data?
     }

get_info_response_info_cert_bund_adv_title
 = element title
     {
       text
     }

get_info_response_info_cert_bund_adv_summary
 = element summary
     {
       text
     }

get_info_response_info_cert_bund_adv_max_cvss
 = element max_cvss
     {
       text
     }

get_info_response_info_cert_bund_adv_cve_refs
 = element cve_refs
     {
       integer
     }

get_info_response_info_cert_bund_adv_raw_data
 = element raw_data
     {
       text
     }

get_info_response_info_cpe
 = element cpe
     {
       get_info_response_info_cpe_nvd_id
       & get_info_response_info_cpe_title?
       & get_info_response_info_cpe_max_cvss
       & get_info_response_info_cpe_cve_refs
       & get_info_response_info_cpe_status
       & get_info_response_info_cpe_cves?
       & get_info_response_info_cpe_raw_data?
     }

get_info_response_info_cpe_nvd_id
 = element nvd_id
     {
       text
     }

get_info_response_info_cpe_title
 = element title
     {
       text
     }

get_info_response_info_cpe_max_cvss
 = element max_cvss
     {
       integer
     }

get_info_response_info_cpe_cve_refs
 = element cve_refs
     {
       integer
     }

get_info_response_info_cpe_status
 = element status
     {
       text
     }

get_info_response_info_cpe_cves
 = element cves
     {
       get_info_response_info_cpe_cves_cve*
     }

get_info_response_info_cpe_cves_cve
 = element cve
     {
       text
     }

get_info_response_info_cpe_raw_data
 = element raw_data
     {
       text
     }

get_info_response_info_nvt
 = element nvt
     {
       text
     }

get_info_response_info_cve
 = element cve
     {
       get_info_response_info_cve_cvss
       & get_info_response_info_cve_vector
       & get_info_response_info_cve_complexity
       & get_info_response_info_cve_authentication
       & get_info_response_info_cve_confidentiality_impact
       & get_info_response_info_cve_integrity_impact
       & get_info_response_info_cve_availability_impact
       & get_info_response_info_cve_description
       & get_info_response_info_cve_products
       & get_info_response_info_cve_nvts?
       & get_info_response_info_cve_cert?
       & get_info_response_info_cve_raw_data?
     }

get_info_response_info_cve_cvss
 = element cvss
     {
       text
     }

get_info_response_info_cve_vector
 = element vector
     {
       text
     }

get_info_response_info_cve_complexity
 = element complexity
     {
       text
     }

get_info_response_info_cve_authentication
 = element authentication
     {
       text
     }

get_info_response_info_cve_confidentiality_impact
 = element confidentiality_impact
     {
       text
     }

get_info_response_info_cve_integrity_impact
 = element integrity_impact
     {
       text
     }

get_info_response_info_cve_availability_impact
 = element availability_impact
     {
       text
     }

get_info_response_info_cve_description
 = element description
     {
       text
     }

get_info_response_info_cve_products
 = element products
     {
       text
     }

get_info_response_info_cve_nvts
 = element nvts
     {
       get_info_response_info_cve_nvts_nvt*
     }

get_info_response_info_cve_nvts_nvt
 = element nvt
     {
       attribute oid { oid }?
       & get_info_response_info_cve_nvts_nvt_name
     }

get_info_response_info_cve_nvts_nvt_name
 = element name
     {
       text
     }

get_info_response_info_cve_cert
 = element cert
     {
       get_info_response_info_cve_cert_cert_ref*
       & get_info_response_info_cve_cert_warning?
     }

get_info_response_info_cve_cert_cert_ref
 = element cert_ref
     {
       attribute type { text }?
       & get_info_response_info_cve_cert_cert_ref_name
       & get_info_response_info_cve_cert_cert_ref_title
     }

get_info_response_info_cve_cert_cert_ref_name
 = element name
     {
       text
     }

get_info_response_info_cve_cert_cert_ref_title
 = element title
     {
       text
     }

get_info_response_info_cve_cert_warning
 = element warning
     {
       text
     }

get_info_response_info_cve_raw_data
 = element raw_data
     {
       text
     }

get_info_response_info_dfn_cert_adv
 = element dfn_cert_adv
     {
       get_info_response_info_dfn_cert_adv_title
       & get_info_response_info_dfn_cert_adv_summary
       & get_info_response_info_dfn_cert_adv_max_cvss
       & get_info_response_info_dfn_cert_adv_cve_refs
       & get_info_response_info_dfn_cert_adv_raw_data?
     }

get_info_response_info_dfn_cert_adv_title
 = element title
     {
       text
     }

get_info_response_info_dfn_cert_adv_summary
 = element summary
     {
       text
     }

get_info_response_info_dfn_cert_adv_max_cvss
 = element max_cvss
     {
       text
     }

get_info_response_info_dfn_cert_adv_cve_refs
 = element cve_refs
     {
       integer
     }

get_info_response_info_dfn_cert_adv_raw_data
 = element raw_data
     {
       text
     }

get_info_response_info_ovaldef
 = element ovaldef
     {
       get_info_response_info_ovaldef_version
       & get_info_response_info_ovaldef_deprecated
       & get_info_response_info_ovaldef_status
       & get_info_response_info_ovaldef_class
       & get_info_response_info_ovaldef_title
       & get_info_response_info_ovaldef_max_cvss
       & get_info_response_info_ovaldef_cve_refs
       & get_info_response_info_ovaldef_file
       & get_info_response_info_ovaldef_description?
       & get_info_response_info_ovaldef_raw_data?
     }

get_info_response_info_ovaldef_version
 = element version
     {
       integer
     }

get_info_response_info_ovaldef_deprecated
 = element deprecated
     {
       boolean
     }

get_info_response_info_ovaldef_status
 = element status
     {
       text
     }

get_info_response_info_ovaldef_class
 = element class
     {
       text
     }

get_info_response_info_ovaldef_title
 = element title
     {
       text
     }

get_info_response_info_ovaldef_max_cvss
 = element max_cvss
     {
       text
     }

get_info_response_info_ovaldef_cve_refs
 = element cve_refs
     {
       integer
     }

get_info_response_info_ovaldef_file
 = element file
     {
       text
     }

get_info_response_info_ovaldef_description
 = element description
     {
       text
     }

get_info_response_info_ovaldef_raw_data
 = element raw_data
     {
       text
     }

get_info_response_info_allinfo
 = element allinfo
     {
       get_info_response_info_allinfo_type
       & get_info_response_info_allinfo_extra
       & get_info_response_info_allinfo_severity
     }

get_info_response_info_allinfo_type
 = element type
     {
       text
     }

get_info_response_info_allinfo_extra
 = element extra
     {
       text
     }

get_info_response_info_allinfo_severity
 = element severity
     {
       severity
     }

get_info_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_info_response_filters_term
       & get_info_response_filters_name?
       & get_info_response_filters_keywords
     }

get_info_response_filters_term
 = element term    # type text
     {
     }

get_info_response_filters_name
 = element name
     {
       text
     }

get_info_response_filters_keywords
 = element keywords
     {
       get_info_response_filters_keywords_keyword*
     }

get_info_response_filters_keywords_keyword
 = element keyword
     {
       get_info_response_filters_keywords_keyword_column
       & get_info_response_filters_keywords_keyword_relation
       & get_info_response_filters_keywords_keyword_value
     }

get_info_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_info_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_info_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_info_response_sort
 = element sort
     {
       text
       & get_info_response_sort_field
     }

get_info_response_sort_field
 = element field
     {
       get_info_response_sort_field_order
     }

get_info_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_info_response_info_count
 = element info_count
     {
       get_info_response_info_count_filtered
       & get_info_response_info_count_page
     }

get_info_response_info_count_filtered
 = element filtered
     {
       integer
     }

get_info_response_info_count_page
 = element page
     {
       integer
     }

get_info_response_details
 = element details    # type boolean
     {
     }

7.56.3 Example: Get a info about cpe:/a:gnu:gzip:1.3.3 with all details

Client

 <get_info type="CPE"
           name="cpe:/a:gnu:gzip:1.3.3"
           details="1"/>

Manager

 <get_info_response status_text="OK"
                    status="200">
   <info id="28139">
     <name>cpe:/a:gnu:gzip:1.3.3</name>
     <comment/>
     <creation_time>2007-09-14T17:36:49Z</creation_time>
     <modification_time>2007-09-14T17:36:49Z</modification_time>
     <writable>0</writable>
     <in_use>0</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <update_time>2012-10-26T13:18:00.000+0000</update_time>
     <cpe>
       <title>GNU Gzip 1.3.3</title>
       <max_cvss>10.0</max_cvss>
       <cve_refs>5</cve_refs>
       <status>DRAFT</status>
       <cves>
         <cve>
           <entry id="CVE-2004-0603">
             <vuln:cvss>
               <cvss:base_metrics>
                 <cvss:score>10.0</cvss:score>
               </cvss:base_metrics>
             </vuln:cvss>
           </entry>
         </cve>
         <cve>
           <entry id="CVE-2010-0001">
             <vuln:cvss>
               <cvss:base_metrics>
                 <cvss:score>6.8</cvss:score>
               </cvss:base_metrics>
             </vuln:cvss>
           </entry>
         </cve>
         <cve>
           <entry id="CVE-2009-2624">
             <vuln:cvss>
               <cvss:base_metrics>
                 <cvss:score>6.8</cvss:score>
               </cvss:base_metrics>
             </vuln:cvss>
           </entry>
         </cve>
         <cve>
           <entry id="CVE-2005-1228">
             <vuln:cvss>
               <cvss:base_metrics>
                 <cvss:score>5.0</cvss:score>
               </cvss:base_metrics>
             </vuln:cvss>
           </entry>
         </cve>
         <cve>
           <entry id="CVE-2005-0988">
             <vuln:cvss>
               <cvss:base_metrics>
                 <cvss:score>3.7</cvss:score>
               </cvss:base_metrics>
             </vuln:cvss>
           </entry>
         </cve>
       </cves>
       <raw_data>
         <cpe-item name="cpe:/a:gnu:gzip:1.3.3">
           <title xml:lang="en-US">GNU Gzip 1.3.3</title>
           <meta:item-metadata nvd-id="28139"
                               status="DRAFT"
                               modification-date="2007-09-14T17:36:49.090Z"/>
         </cpe-item>
       </raw_data>
     </cpe>
   </info>
   <details>1</details>
   <filters id="(null)">
     <term/>
   </filters>
   <sort>
     <field>
       name
       <order>ascending</order>
     </field>
   </sort>
   <info max="-1"
         start="1"/>
   <info_count>
     <filtered>1</filtered>
     <page>1</page>
   </info_count>
 </get_info_response>

7.56.3 Example: Get a info CVE-1999-0010 without details

Client

 <get_info name="CVE-2011-0018"
           type="cve"/>

Manager

 <get_info_response status_text="OK"
                    status="200">
   <info id="CVE-2011-0018">
     <name>CVE-2011-0018</name>
     <comment/>
     <creation_time>2011-01-28T16:00:02Z</creation_time>
     <modification_time>2011-02-05T07:01:22Z</modification_time>
     <writable>0</writable>
     <in_use>0</in_use>
     <update_time>2012-10-26T13:18:00.000+0000</update_time>
     <user_tags>
       <count>0</count>
     </user_tags>
     <cve>
       <cvss>9.0</cvss>
       <vector>NETWORK</vector>
       <complexity>LOW</complexity>
       <authentication>SINGLE_INSTANCE</authentication>
       <confidentiality_impact>COMPLETE</confidentiality_impact>
       <integrity_impact>COMPLETE</integrity_impact>
       <availability_impact>COMPLETE</availability_impact>
       <description>
         The email function in manage_sql.c in ...(truncated for example)
       </description>
       <products>
         cpe:/a:openvas:openvas_manager:1.0.1 ...(truncated for example)
       </products>
     </cve>
   </info>
   <filters id="(null)">
     <term/>
   </filters>
   <sort>
     <field>
       name
       <order>ascending</order>
     </field>
   </sort>
   <info max="-1"
         start="1"/>
   <info_count>
     <filtered>1</filtered>
     <page>1</page>
   </info_count>
 </get_info_response>

7.57 Command `get_lsc_credentials`

In short: Get one or many LSC credentials.

The client uses the get_lsc_credentials command to get LSC credentials information. If the command sent by the client was valid, the manager will reply with a list of LSC credentials to the client.

7.57.1 Structure

Command
- @lsc_credential_id (uuid) ID of single LSC credential to get.
- @filter (text) Filter term to use to filter query.
- @filt_id (uuid) ID of filter to use to filter query.
- @trash (boolean) Whether to get the trashcan LSC credentials instead.
- @targets (boolean) Whether to include a list of targets using the credentials.
- @format ("key", "rpm", "deb" or "exe")
Response
- @status (status)
- @status_text (text)
- <lsc_credential> *
  - @id (uuid)
  - <owner>
    Owner of the LSC credential.
    - <name>
      The name of the owner.
  - <name>
    The name of the LSC credential.
  - <login>
    The username of the LSC credential.
  - <comment>
    The comment on the LSC credential.
  - <creation_time>
    Date and time the info was created.
  - <modification_time>
    Date and time the info was last modified.
  - <writable>
    Whether this credential is writable.
  - <in_use>
    Whether any targets are using the LSC credential.
  - <permissions>
    Permissions that the current user has on the LSC credential.
    - <permission> *
      - <name>
        The name of the permission.
  - <user_tags>
    Info on tags attached to the credential.
    - <count>
      Number of attached tags.
    - <tag> *
      Short info on an individual tag (only if details were requested).
      - @id (uuid) UUID of the tag.
      - <name>
        Name of the tag (usually namespace:predicate).
      - <value>
        Value of the tag.
      - <comment>
        Comment for the tag.
  - <type>
    The type of the LSC credential.
  - <targets>
    All targets using this LSC credential.
    - <target> *
      - @id (uuid)
      - <name>
        The name of the target.
      - <permissions> ?
        Permissions the user has on the target.
  - One of
    - <public_key>
    - <package>
      - @format ("rpm", "deb" or "exe")
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
- <sort>
  - <field>
    - <order>
- <lsc_credentials>
  - @start (integer) First LSC credential.
  - @max (integer) Maximum number of LSC credentials.
- <lsc_credential_count>
  - <filtered>
    Number of LSC credentials after filtering.
  - <page>
    Number of LSC credentials on current page.

7.57.2 RNC

Command

get_lsc_credentials
 = element get_lsc_credentials
     {
       attribute lsc_credential_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute trash { boolean }?
       & attribute targets { boolean }?
       & attribute format { xsd:token { pattern = "key|rpm|deb|exe" } }?
     }

Response

get_lsc_credentials_response
 = element get_lsc_credentials_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_lsc_credentials_response_lsc_credential*
       & get_lsc_credentials_response_filters
       & get_lsc_credentials_response_sort
       & get_lsc_credentials_response_lsc_credentials
       & get_lsc_credentials_response_lsc_credential_count
     }

get_lsc_credentials_response_lsc_credential
 = element lsc_credential
     {
       attribute id { uuid }
       & get_lsc_credentials_response_lsc_credential_owner
       & get_lsc_credentials_response_lsc_credential_name
       & get_lsc_credentials_response_lsc_credential_login
       & get_lsc_credentials_response_lsc_credential_comment
       & get_lsc_credentials_response_lsc_credential_creation_time
       & get_lsc_credentials_response_lsc_credential_modification_time
       & get_lsc_credentials_response_lsc_credential_writable
       & get_lsc_credentials_response_lsc_credential_in_use
       & get_lsc_credentials_response_lsc_credential_permissions
       & get_lsc_credentials_response_lsc_credential_user_tags
       & get_lsc_credentials_response_lsc_credential_type
       & get_lsc_credentials_response_lsc_credential_targets
       & ( get_lsc_credentials_response_lsc_credential_public_key
           | get_lsc_credentials_response_lsc_credential_package )
     }

get_lsc_credentials_response_lsc_credential_owner
 = element owner
     {
       get_lsc_credentials_response_lsc_credential_owner_name
     }

get_lsc_credentials_response_lsc_credential_owner_name
 = element name
     {
       name
     }

get_lsc_credentials_response_lsc_credential_name
 = element name
     {
       name
     }

get_lsc_credentials_response_lsc_credential_login
 = element login
     {
       name
     }

get_lsc_credentials_response_lsc_credential_comment
 = element comment
     {
       text
     }

get_lsc_credentials_response_lsc_credential_creation_time
 = element creation_time
     {
       iso_time
     }

get_lsc_credentials_response_lsc_credential_modification_time
 = element modification_time
     {
       iso_time
     }

get_lsc_credentials_response_lsc_credential_writable
 = element writable
     {
       boolean
     }

get_lsc_credentials_response_lsc_credential_in_use
 = element in_use
     {
       boolean
     }

get_lsc_credentials_response_lsc_credential_permissions
 = element permissions
     {
       get_lsc_credentials_response_lsc_credential_permissions_permission*
     }

get_lsc_credentials_response_lsc_credential_permissions_permission
 = element permission
     {
       get_lsc_credentials_response_lsc_credential_permissions_permission_name
     }

get_lsc_credentials_response_lsc_credential_permissions_permission_name
 = element name
     {
       name
     }

get_lsc_credentials_response_lsc_credential_user_tags
 = element user_tags
     {
       get_lsc_credentials_response_lsc_credential_user_tags_count
       & get_lsc_credentials_response_lsc_credential_user_tags_tag*
     }

get_lsc_credentials_response_lsc_credential_user_tags_count
 = element count
     {
       integer
     }

get_lsc_credentials_response_lsc_credential_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_lsc_credentials_response_lsc_credential_user_tags_tag_name
       & get_lsc_credentials_response_lsc_credential_user_tags_tag_value
       & get_lsc_credentials_response_lsc_credential_user_tags_tag_comment
     }

get_lsc_credentials_response_lsc_credential_user_tags_tag_name
 = element name
     {
       text
     }

get_lsc_credentials_response_lsc_credential_user_tags_tag_value
 = element value
     {
       text
     }

get_lsc_credentials_response_lsc_credential_user_tags_tag_comment
 = element comment
     {
       text
     }

get_lsc_credentials_response_lsc_credential_type
 = element type
     {
       xsd:token { pattern = "gen|pass" }
     }

get_lsc_credentials_response_lsc_credential_targets
 = element targets
     {
       get_lsc_credentials_response_lsc_credential_targets_target*
     }

get_lsc_credentials_response_lsc_credential_targets_target
 = element target
     {
       attribute id { uuid }
       & get_lsc_credentials_response_lsc_credential_targets_target_name
       & get_lsc_credentials_response_lsc_credential_targets_target_permissions?
     }

get_lsc_credentials_response_lsc_credential_targets_target_name
 = element name
     {
       name
     }

get_lsc_credentials_response_lsc_credential_targets_target_permissions
 = element permissions
     {
       ""
     }

get_lsc_credentials_response_lsc_credential_public_key
 = element public_key
     {
       text
     }

get_lsc_credentials_response_lsc_credential_package
 = element package
     {
       base64
       & attribute format { xsd:token { pattern = "rpm|deb|exe" } }
     }

get_lsc_credentials_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_lsc_credentials_response_filters_term
       & get_lsc_credentials_response_filters_name?
       & get_lsc_credentials_response_filters_keywords
     }

get_lsc_credentials_response_filters_term
 = element term
     {
       text
     }

get_lsc_credentials_response_filters_name
 = element name
     {
       text
     }

get_lsc_credentials_response_filters_keywords
 = element keywords
     {
       get_lsc_credentials_response_filters_keywords_keyword*
     }

get_lsc_credentials_response_filters_keywords_keyword
 = element keyword
     {
       get_lsc_credentials_response_filters_keywords_keyword_column
       & get_lsc_credentials_response_filters_keywords_keyword_relation
       & get_lsc_credentials_response_filters_keywords_keyword_value
     }

get_lsc_credentials_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_lsc_credentials_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_lsc_credentials_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_lsc_credentials_response_sort
 = element sort
     {
       text
       & get_lsc_credentials_response_sort_field
     }

get_lsc_credentials_response_sort_field
 = element field
     {
       get_lsc_credentials_response_sort_field_order
     }

get_lsc_credentials_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_lsc_credentials_response_lsc_credentials
 = element lsc_credentials
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_lsc_credentials_response_lsc_credential_count
 = element lsc_credential_count
     {
       get_lsc_credentials_response_lsc_credential_count_filtered
       & get_lsc_credentials_response_lsc_credential_count_page
     }

get_lsc_credentials_response_lsc_credential_count_filtered
 = element filtered
     {
       integer
     }

get_lsc_credentials_response_lsc_credential_count_page
 = element page
     {
       integer
     }

7.57.3 Example: Get one or many the LSC credentials

Client

 <get_lsc_credentials/>

Manager

 <get_lsc_credentials_response status="200"
                               status_text="OK">
   <lsc_credential id="c33864a9-d3fd-44b3-8717-972bfb01dfcf">
     <name>sally</name>
     <login>sally</login>
     <comment/>
     <creation_time>2012-12-14T17:11:25+01:00</creation_time>
     <modification_time>2012-05-28T11:19:20+01:00</modification_time>
     <writable>1</writable>
     <in_use>0</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <type>gen</type>
   </lsc_credential>
   <lsc_credential id="8e305b0b-260d-450d-91a8-dadf0b144e15">
     <name>bob</name>
     <comment>Bob on the web server.</comment>
     <creation_time>2013-01-03T15:49:35+01:00</creation_time>
     <modification_time>2013-01-18T12:07:00+01:00</modification_time>
     <writable>1</writable>
     <in_use>1</in_use>
     <login>bob</login>
     <type>pass</type>
   </lsc_credential>
   ...
 </get_lsc_credentials_response>

7.57.3 Example: Get a single LSC credential, its public key and targets using it

Client

 <get_lsc_credentials lsc_credential_id="8e305b0b-260d-450d-91a8-dadf0b144e15"
                      format="key"
                      targets="1"/>

Manager

 <get_lsc_credentials_response status="200"
                               status_text="OK">
   <lsc_credential id="8e305b0b-260d-450d-91a8-dadf0b144e15">
     <name>bob</name>
     <comment>Bob on the web server.</comment>
     <creation_time>2012-11-03T15:41:35+01:00</creation_time>
     <modification_time>2012-11-18T13:17:00+01:00</modification_time>
     <writable>1</writable>
     <in_use>1</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <login>bob</login>
     <type>pass</type>
     <targets>
       <target id="1f28d970-17ef-4c69-ba8a-13827059f2b9">
         <name>Web server</name>
       </target>
     </targets>
     <public_key>
       ssh-rsa AAAAB3...Z64IcQ== Key generated by OpenVAS Manager
     </public_key>
   </lsc_credential>
 </get_lsc_credentials_response>

7.57.3 Example: Get the Debian package of a single LSC credential

Client

 <get_lsc_credentials lsc_credential_id="8e305b0b-260d-450d-91a8-dadf0b144e15"
                      format="deb"/>

Manager

 <get_lsc_credentials_response status="200"
                               status_text="OK">
   <lsc_credential id="8e305b0b-260d-450d-91a8-dadf0b144e15">
     <name>bob</name>
     <login>bob</login>
     <comment>Bob on the web server.</comment>
     <creation_time>2012-11-03T15:41:35+01:00</creation_time>
     <modification_time>2012-11-18T13:17:00+01:00</modification_time>
     <writable>1</writable>
     <in_use>1</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <type>pass</type>
     <targets>
       <target id="1f28d970-17ef-4c69-ba8a-13827059f2b9">
         <name>Web server</name>
       </target>
     </targets>
     <package format="deb">ITxhcmNoPgpk...DmvF0AKAAACg==</package>
   </lsc_credential>
 </get_lsc_credentials_response>

7.58 Command `get_notes`

In short: Get one or many notes.

The client uses the get_notes command to get note information. If the command sent by the client was valid, the manager will reply with a list of notes to the client.

7.58.1 Structure

Command
- @note_id (uuid) ID of single note to get.
- @filter (text) Filter term to use to filter query.
- @filt_id (uuid) ID of filter to use to filter query.
- @nvt_oid (oid)
- @task_id (uuid)
- @details (boolean)
- @result (boolean)
Response
- @status (status)
- @status_text (text)
- <note> *
  (note)
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
- <sort>
  - <field>
    - <order>
- <notes>
  - @start (integer) First note.
  - @max (integer) Maximum number of notes.
- <note_count>
  - <filtered>
    Number of notes after filtering.
  - <page>
    Number of notes on current page.

7.58.2 RNC

Command

get_notes
 = element get_notes
     {
       attribute note_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute nvt_oid { oid }?
       & attribute task_id { uuid }?
       & attribute details { boolean }?
       & attribute result { boolean }?
     }

Response

get_notes_response
 = element get_notes_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_notes_response_note*
       & get_notes_response_filters
       & get_notes_response_sort
       & get_notes_response_notes
       & get_notes_response_note_count
     }

get_notes_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_notes_response_filters_term
       & get_notes_response_filters_name?
       & get_notes_response_filters_keywords
     }

get_notes_response_filters_term
 = element term
     {
       text
     }

get_notes_response_filters_name
 = element name
     {
       text
     }

get_notes_response_filters_keywords
 = element keywords
     {
       get_notes_response_filters_keywords_keyword*
     }

get_notes_response_filters_keywords_keyword
 = element keyword
     {
       get_notes_response_filters_keywords_keyword_column
       & get_notes_response_filters_keywords_keyword_relation
       & get_notes_response_filters_keywords_keyword_value
     }

get_notes_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_notes_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_notes_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_notes_response_sort
 = element sort
     {
       text
       & get_notes_response_sort_field
     }

get_notes_response_sort_field
 = element field
     {
       get_notes_response_sort_field_order
     }

get_notes_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_notes_response_notes
 = element notes
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_notes_response_note_count
 = element note_count
     {
       get_notes_response_note_count_filtered
       & get_notes_response_note_count_page
     }

get_notes_response_note_count_filtered
 = element filtered
     {
       integer
     }

get_notes_response_note_count_page
 = element page
     {
       integer
     }

get_notes_response_note
 = element note    # type note
     {
       attribute id { uuid }
       & note_permissions
       & note_owner
       & note_nvt
       & note_text
       & note_creation_time
       & note_modification_time
       & note_writable
       & note_in_use
       & note_active
       & note_orphan
       & note_user_tags
       & ( note_hosts
           & note_port
           & note_severity
           & note_threat
           & note_task
           & note_end_time?
           & note_result? )?
     }

7.58.3 Example: Get one or many notes

Client

 <get_notes/>

Manager

 <get_notes_response status="200"
                     status_text="OK">
   <note id="b76b81a7-9df8-42df-afff-baa9d4620128">
     <nvt oid="1.3.6.1.4.1.25623.1.0.75">
       <name>Test NVT: long lines</name>
     </nvt>
     <creation_time>2013-01-09T09:47:41+01:00</creation_time>
     <modification_time>2013-01-09T09:47:41+01:00</modification_time>
     <writable>1</writable>
     <in_use>0</in_use>
     <active>1</active>
     <orphan>1</orphan>
     <user_tags>
       <count>0</count>
     </user_tags>
     <text excerpt="0">This is the full text of the note.</text>
   </note>
   ...
 </get_notes_response>

7.58.3 Example: Get details of a single note and result to which it applies

Client

 <get_notes note_id="7f618bbb-4664-419e-9bbf-367d93954cb0"
            details="1"
            result="1"/>

Manager

 <get_notes_response status="200"
                     status_text="OK">
   <note id="7f618bbb-4664-419e-9bbf-367d93954cb0">
     <nvt oid="1.3.6.1.4.1.25623.1.0.77">
       <name>Test NVT: control chars in report result</name>
     </nvt>
     <creation_time>Sun Jun 27 08:49:46 2010</creation_time>
     <modification_time>Sun Jun 27 08:49:46 2010</modification_time>
     <writable>1</writable>
     <in_use>0</in_use>
     <active>1</active>
     <end_time/>
     <text>note fixed to result</text>
     <hosts>127.0.0.1</hosts>
     <port>general/tcp</port>
     <threat>Medium</threat>
     <task id="40b236a9-2b0f-4813-b8c7-bc2b98d9d7e4">
       <name>test</name>
     </task>
     <orphan>0</orphan>
     <user_tags>
       <count>0</count>
     </user_tags>
     <result id="0c95e6b3-1100-4dfd-88f1-4bed1fad29de">
       <host>127.0.0.1</host>
       <port>general/tcp</port>
       <nvt oid="1.3.6.1.4.1.25623.1.0.77">
         <name>Test NVT: control chars in report result</name>
         <cvss_base/>
         <cve/>
         <bid/>
       </nvt>
       <threat>Medium</threat>
       <description>Warning with control char between fullstops: . .</description>
     </result>
   </note>
   ...
 </get_notes_response>

7.59 Command `get_nvts`

In short: Get one or many NVTs.

The client uses the get_nvts command to get NVT information.

This command may always include a details flag, a config, a sort order and a sort field. If the command includes a details flag, the manager also consults the timeout, preference_count and preferences flags.

The NVT OID, family name and config attributes limit the listing to a single NVT or all NVTs in a particular family and/or config.

If the details flag is present the manager will send full details of the NVT, otherwise it will send just the NVT name.

With the preferences flag the manager includes in the listing, the values of each listed NVT's preferences for the given config. The timeout flag does the same for the special timeout preference. If the config contains no values for a preference, the default value of the preference is returned. The same applies if no config is given.

If the manager possesses an NVT collection, it will reply with the NVT information. If the manager cannot access a list of available NVTs at that time, it will reply with the 503 response.

7.59.1 Structure

Command
- @nvt_oid (oid) Single NVT to get.
- @details (boolean) Whether to include full details.
- @preferences (boolean) Whether to include preference.
- @preference_count (boolean) Whether to include preference count.
- @timeout (boolean) Whether to include the special timeout preference.
- @config_id (uuid) ID of config to which to limit the NVT listing.
- @family (text) Family to which to limit NVT listing.
- @sort_order (sort_order)
- @sort_field (text)
Response
- @status (status)
- @status_text (text)
- <nvt>
  - @oid (oid)
  - <name>
    The name of the NVT.
  - <user_tags>
    Info on tags attached to the NVT.
    - <count>
      Number of attached tags.
    - <tag> *
      Short info on an individual tag (only if details were requested).
      - @id (uuid) UUID of the tag.
      - <name>
        Name of the tag (usually namespace:predicate).
      - <value>
        Value of the tag.
      - <comment>
        Comment for the tag.
  - The group?
    - <creation_time>
      The creation time of the NVT.
    - <modification_time>
      The modification time of the NVT.
    - <category>
      The category of the NVT.
    - <copyright>
      Copyright info of the NVT.
    - <summary>
      Short description of the NVT.
    - <family>
      Name of the family the NVT belongs to.
    - <version>
      Version of the NVT.
    - <cvss_base>
      CVSS base score of the NVT.
    - <qod>
      The quality of detection (QoD) of the NVT.
      - <value>
        The numeric QoD value.
      - <type>
        The QoD type.
    - <cve_id>
      IDs of the CVEs the NVT adresses.
    - <cert_refs>
      List of CERT advisories referencing this NVT via CVEs.
      - <cert_ref> *
        A CERT advisory reference.
        
        @id (text) ID of the advisory.
        
        @type (text) Type of the advisory (e.g. "DFN-CERT", "CERT-BUND").
      - <warning> ?
        A warning message, e.g. when the database is not.
    - <bugtraq_id>
      List of Bugtraq IDs of the NVT.
    - <xrefs>
      List of other references of the NVT.
    - <tags>
      The tags of the NVT, separated by vertical bars.
    - <preference_count> ?
      The number of preferences for the NVT.
    - <timeout> ?
      The timeout of the NVT.
    - <preferences> ?
      List of preferences of the NVT.
      - <timeout>
        The timeout of the NVT.
      - <preference> *
        
        <nvt>
        NVT to which preference applies.
        
        @oid (oid)
        
        <name>
        The name of the NVT.
        
        <name>
        The name of the preference.
        
        <type>
        The type of the preference.
        
        <value>
        The value of the preference.
        
        <alt> *
        An alternate value of the preference.
        
        <default>
        The default value of the preference.

7.59.2 RNC

Command

get_nvts
 = element get_nvts
     {
       attribute nvt_oid { oid }
       & attribute details { boolean }?
       & attribute preferences { boolean }?
       & attribute preference_count { boolean }?
       & attribute timeout { boolean }?
       & attribute config_id { uuid }?
       & attribute family { text }?
       & attribute sort_order { sort_order }?
       & attribute sort_field { text }?
     }

Response

get_nvts_response
 = element get_nvts_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_nvts_response_nvt
     }

get_nvts_response_nvt
 = element nvt
     {
       attribute oid { oid }
       & get_nvts_response_nvt_name
       & get_nvts_response_nvt_user_tags
       & ( get_nvts_response_nvt_creation_time
           & get_nvts_response_nvt_modification_time
           & get_nvts_response_nvt_category
           & get_nvts_response_nvt_copyright
           & get_nvts_response_nvt_summary
           & get_nvts_response_nvt_family
           & get_nvts_response_nvt_version
           & get_nvts_response_nvt_cvss_base
           & get_nvts_response_nvt_qod
           & get_nvts_response_nvt_cve_id
           & get_nvts_response_nvt_cert_refs
           & get_nvts_response_nvt_bugtraq_id
           & get_nvts_response_nvt_xrefs
           & get_nvts_response_nvt_tags
           & get_nvts_response_nvt_preference_count?
           & get_nvts_response_nvt_timeout?
           & get_nvts_response_nvt_preferences? )?
     }

get_nvts_response_nvt_name
 = element name
     {
       name
     }

get_nvts_response_nvt_category
 = element category
     {
       text
     }

get_nvts_response_nvt_creation_time
 = element creation_time
     {
       iso_time
     }

get_nvts_response_nvt_modification_time
 = element modification_time
     {
       iso_time
     }

get_nvts_response_nvt_user_tags
 = element user_tags
     {
       get_nvts_response_nvt_user_tags_count
       & get_nvts_response_nvt_user_tags_tag*
     }

get_nvts_response_nvt_user_tags_count
 = element count
     {
       integer
     }

get_nvts_response_nvt_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_nvts_response_nvt_user_tags_tag_name
       & get_nvts_response_nvt_user_tags_tag_value
       & get_nvts_response_nvt_user_tags_tag_comment
     }

get_nvts_response_nvt_user_tags_tag_name
 = element name
     {
       text
     }

get_nvts_response_nvt_user_tags_tag_value
 = element value
     {
       text
     }

get_nvts_response_nvt_user_tags_tag_comment
 = element comment
     {
       text
     }

get_nvts_response_nvt_copyright
 = element copyright
     {
       text
     }

get_nvts_response_nvt_summary
 = element summary
     {
       text
     }

get_nvts_response_nvt_family
 = element family
     {
       text
     }

get_nvts_response_nvt_version
 = element version
     {
       text
     }

get_nvts_response_nvt_cvss_base
 = element cvss_base
     {
       text
     }

get_nvts_response_nvt_qod
 = element qod
     {
       get_nvts_response_nvt_qod_value
       & get_nvts_response_nvt_qod_type
     }

get_nvts_response_nvt_qod_value
 = element value
     {
       integer
     }

get_nvts_response_nvt_qod_type
 = element type
     {
       text
     }

get_nvts_response_nvt_cve_id
 = element cve_id
     {
       text
     }

get_nvts_response_nvt_bugtraq_id
 = element bugtraq_id
     {
       text
     }

get_nvts_response_nvt_cert_refs
 = element cert_refs
     {
       get_nvts_response_nvt_cert_refs_cert_ref*
       & get_nvts_response_nvt_cert_refs_warning?
     }

get_nvts_response_nvt_cert_refs_cert_ref
 = element cert_ref
     {
       attribute id { text }?
       & attribute type { text }?
     }

get_nvts_response_nvt_cert_refs_warning
 = element warning
     {
       text
     }

get_nvts_response_nvt_xrefs
 = element xrefs
     {
       text
     }

get_nvts_response_nvt_tags
 = element tags
     {
       text
     }

get_nvts_response_nvt_preference_count
 = element preference_count
     {
       text
     }

get_nvts_response_nvt_timeout
 = element timeout
     {
       text
     }

get_nvts_response_nvt_preferences
 = element preferences
     {
       text
       & get_nvts_response_nvt_preferences_timeout
       & get_nvts_response_nvt_preferences_preference*
     }

get_nvts_response_nvt_preferences_timeout
 = element timeout
     {
       text
     }

get_nvts_response_nvt_preferences_preference
 = element preference
     {
       get_nvts_response_nvt_preferences_preference_nvt
       & get_nvts_response_nvt_preferences_preference_name
       & get_nvts_response_nvt_preferences_preference_type
       & get_nvts_response_nvt_preferences_preference_value
       & get_nvts_response_nvt_preferences_preference_alt*
       & get_nvts_response_nvt_preferences_preference_default
     }

get_nvts_response_nvt_preferences_preference_nvt
 = element nvt
     {
       attribute oid { oid }
       & get_nvts_response_nvt_preferences_preference_nvt_name
     }

get_nvts_response_nvt_preferences_preference_nvt_name
 = element name
     {
       name
     }

get_nvts_response_nvt_preferences_preference_name
 = element name
     {
       text
     }

get_nvts_response_nvt_preferences_preference_type
 = element type
     {
       text
     }

get_nvts_response_nvt_preferences_preference_value
 = element value
     {
       text
     }

get_nvts_response_nvt_preferences_preference_alt
 = element alt
     {
       text
     }

get_nvts_response_nvt_preferences_preference_default
 = element default
     {
       text
     }

7.59.3 Example: Get full NVT listing with details

Client

 <get_nvts details="1"/>

Manager

 <get_nvts_response status="200"
                    status_text="OK">
   <nvt oid="1.3.6.1.4.1.25623.1.7.13005">
     <name>Services</name>
     <creation_time>2011-01-14T10:12:23+01:00</creation_time>
     <modification_time>2012-09-19T20:56:15+02:00</modification_time>
     <user_tags>
       <count>0</count>
     </user_tags>
     <category>Services</category>
     <copyright>GNU GPL v2</copyright>
     <summary>Find what is listening on which port</summary>
     <family>Service detection</family>
     <version>$Revision: 1852 $</version>
     <cvss_base/>
     <cve_id>NOCVE</cve_id>
     <bugtraq_id>NOBID</bugtraq_id>
     <cert_refs/>
     <xrefs>NOXREF</xrefs>
     <tags>NOTAG</tags>
     <preference_count>-1</preference_count>
     <timeout/>
     <preferences>
       <timeout/>
       <preference>
         <nvt oid="1.3.6.1.4.1.25623.1.0.10330">
           <name>Services</name>
         </nvt>
         <name>Network connection timeout :</name>
         <type>entry</type>
         <value>5</value>
         <default>5</default>
       </preference>
       ...
     </preferences>
   </nvt>
   <nvt oid="1.3.6.1.4.1.25623.1.7.13006">
     <name>FooBar 21</name>
     <creation_time>2011-01-14T10:12:23+01:00</creation_time>
     <modification_time>2012-09-19T20:56:15+02:00</modification_time>
     <category>Services</category>
     <copyright>GNU GPL v2</copyright>
     <description>
       This script detects whether the FooBar 2.1 XSS vulnerability is present.
     </description>
     ...
   </nvt>
   ...
 </get_nvts_response>

7.59.3 Example: Get minimal information about one NVT

Client

 <get_nvts nvt_oid="1.3.6.1.4.1.25623.1.0.10330"/>

Manager

 <get_nvts_response status="200"
                    status_text="OK">
   <nvt oid="1.3.6.1.4.1.25623.1.0.10330">
     <name>Services</name>
     <user_tags>
       <count>0</count>
     </user_tags>
   </nvt>
 </get_nvts_response>

7.60 Command `get_nvt_families`

In short: Get a list of all NVT families.

The client uses the get_nvt_families command to get NVT family information. If the command sent by the client was valid, the manager will reply with a list of NVT families to the client.

7.60.1 Structure

Command
- @sort_order (sort_order)
Response
- @status (status)
- @status_text (text)
- <families>
  - <family> *
    - <name>
      The name of the family.
    - <max_nvt_count>
      The number of NVTs in the family.

7.60.2 RNC

Command

get_nvt_families
 = element get_nvt_families
     {
       attribute sort_order { sort_order }?
     }

Response

get_nvt_families_response
 = element get_nvt_families_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_nvt_families_response_families
     }

get_nvt_families_response_families
 = element families
     {
       get_nvt_families_response_families_family*
     }

get_nvt_families_response_families_family
 = element family
     {
       get_nvt_families_response_families_family_name
       & get_nvt_families_response_families_family_max_nvt_count
     }

get_nvt_families_response_families_family_name
 = element name
     {
       name
     }

get_nvt_families_response_families_family_max_nvt_count
 = element max_nvt_count
     {
       integer
     }

7.60.3 Example: Get the NVT families

Client

 <get_nvt_families/>

Manager

 <get_nvt_families_response status="200"
                            status_text="OK">
   <families>
     <family>
       <name>Credentials</name>
       <max_nvt_count>8</max_nvt_count>
     </family>
     <family>
       <name>Port scanners</name>
       <max_nvt_count>12</max_nvt_count>
     </family>
     ...
   </families>
 </get_nvt_families_response>

7.61 Command `get_nvt_feed_version`

In short: Get NVT Feed version.

The client uses the get_nvt_feed_version command to request a feed version for the complete NVT collection available through this manager.

If the manager possesses such a collection, it will reply with a response code indicating success, and the feed version files. If the manager cannot access a list of available NVTs at present, it will reply with the 503 response.

7.61.1 Structure

Command
Response
- @status (status)
- @status_text (text)
- <version>
  (integer)
  
  NVT Feed version.

7.61.2 RNC

Command

get_nvt_feed_version
 = element get_nvt_feed_version
     {
     }

Response

get_nvt_feed_version_response
 = element get_nvt_feed_version_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_nvt_feed_version_response_version
     }

get_nvt_feed_version_response_version
 = element version    # type integer
     {
     }

7.61.3 Example: Get the NVT feed version

Client

 <get_nvt_feed_version/>

Manager

 <get_nvt_feed_version_response status="200"
                                status_text="OK">
   <version>201303060811</version>
 </get_nvt_feed_version_response>

7.62 Command `get_overrides`

In short: Get one or many overrides.

The client uses the get_overrides command to get override information. If the command sent by the client was valid, the manager will reply with a list of overrides to the client.

7.62.1 Structure

Command
- @override_id (uuid) ID of single override to get.
- @filter (text) Filter term to use to filter query.
- @filt_id (uuid) ID of filter to use to filter query.
- @nvt_oid (oid)
- @task_id (uuid)
- @details (boolean)
- @result (boolean)
Response
- @status (status)
- @status_text (text)
- <override> *
  (override)
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
- <sort>
  - <field>
    - <order>
- <overrides>
  - @start (integer) First override.
  - @max (integer) Maximum number of overrides.
- <override_count>
  - <filtered>
    Number of overrides after filtering.
  - <page>
    Number of overrides on current page.

7.62.2 RNC

Command

get_overrides
 = element get_overrides
     {
       attribute override_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute nvt_oid { oid }?
       & attribute task_id { uuid }?
       & attribute details { boolean }?
       & attribute result { boolean }?
     }

Response

get_overrides_response
 = element get_overrides_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_overrides_response_override*
       & get_overrides_response_filters
       & get_overrides_response_sort
       & get_overrides_response_overrides
       & get_overrides_response_override_count
     }

get_overrides_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_overrides_response_filters_term
       & get_overrides_response_filters_name?
       & get_overrides_response_filters_keywords
     }

get_overrides_response_filters_term
 = element term
     {
       text
     }

get_overrides_response_filters_name
 = element name
     {
       text
     }

get_overrides_response_filters_keywords
 = element keywords
     {
       get_overrides_response_filters_keywords_keyword*
     }

get_overrides_response_filters_keywords_keyword
 = element keyword
     {
       get_overrides_response_filters_keywords_keyword_column
       & get_overrides_response_filters_keywords_keyword_relation
       & get_overrides_response_filters_keywords_keyword_value
     }

get_overrides_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_overrides_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_overrides_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_overrides_response_sort
 = element sort
     {
       text
       & get_overrides_response_sort_field
     }

get_overrides_response_sort_field
 = element field
     {
       get_overrides_response_sort_field_order
     }

get_overrides_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_overrides_response_overrides
 = element overrides
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_overrides_response_override_count
 = element override_count
     {
       get_overrides_response_override_count_filtered
       & get_overrides_response_override_count_page
     }

get_overrides_response_override_count_filtered
 = element filtered
     {
       integer
     }

get_overrides_response_override_count_page
 = element page
     {
       integer
     }

get_overrides_response_override
 = element override    # type override
     {
       attribute id { uuid }
       & override_permissions
       & override_owner
       & override_nvt
       & override_creation_time
       & override_modification_time
       & override_writable
       & override_in_use
       & override_active
       & override_text
       & override_threat
       & override_severity
       & override_new_threat
       & override_new_severity
       & override_orphan
       & override_permissions
       & override_user_tags
       & ( override_hosts
           & override_port
           & override_task
           & override_end_time?
           & override_result? )?
     }

7.62.3 Example: Get one or many overrides

Client

 <get_overrides/>

Manager

 <get_overrides_response status="200"
                         status_text="OK">
   <override id="b76b81a7-9df8-42df-afff-baa9d4620128">
     <nvt oid="1.3.6.1.4.1.25623.1.0.75">
       <name>Test NVT: long lines</name>
     </nvt>
     <creation_time>2013-01-09T09:50:10+01:00</creation_time>
     <modification_time>2013-01-09T09:50:10+01:00</modification_time>
     <writable>1</writable>
     <in_use>0</in_use>
     <active>1</active>
     <text excerpt="0">This is the full text of the override.</text>
     <new_threat>Log</new_threat>
     <new_severity>0.0</new_severity>
     <orphan>1</orphan>
     <user_tags>
       <count>0</count>
     </user_tags>
   </override>
   ...
 </get_overrides_response>

7.62.3 Example: Get details of a single override

Client

 <get_overrides override_id="7f618bbb-4664-419e-9bbf-367d93954cb0"
                details="1"/>

Manager

 <get_overrides_response status="200"
                         status_text="OK">
   <override id="7f618bbb-4664-419e-9bbf-367d93954cb0">
     <nvt oid="1.3.6.1.4.1.25623.1.0.77">
       <name>Test NVT: control chars in report result</name>
     </nvt>
     <creation_time>Sun Jun 27 08:49:46 2010</creation_time>
     <modification_time>Sun Jun 27 08:49:46 2010</modification_time>
     <writable>1</writable>
     <in_use>0</in_use>
     <active>1</active>
     <end_time/>
     <text>override fixed to result</text>
     <hosts>127.0.0.1</hosts>
     <port>general/tcp</port>
     <threat>Medium</threat>
     <new_threat>Low</new_threat>
     <new_severity>2.0</new_severity>
     <task id="40b236a9-2b0f-4813-b8c7-bc2b98d9d7e4">
       <name>test</name>
     </task>
     <orphan>0</orphan>
     <user_tags>
       <count>0</count>
     </user_tags>
     <result id="0c95e6b3-1100-4dfd-88f1-4bed1fad29de"/>
   </override>
   ...
 </get_overrides_response>

7.63 Command `get_permissions`

In short: Get one or many permissions.

The client uses the get_permissions command to get permission information.

7.63.1 Structure

Command
- @permission_id (uuid) ID of single permission to get.
- @filter (text) Filter term to use to filter query.
- @filt_id (uuid) ID of filter to use to filter query.
- @trash (boolean) Whether to get the trashcan permissions instead.
Response
- @status (status)
- @status_text (text)
- <permission> *
  - @id (uuid)
  - <owner>
    Owner of the permission.
    - <name>
      The name of the owner.
  - <name>
    The name of the permission.
  - <comment>
    The comment on the permission.
  - <creation_time>
    Date and time the permission was created.
  - <modification_time>
    Date and time the permission was last modified.
  - <writable>
    Whether the permission is writable.
  - <in_use>
    Whether the permission is in use.
  - <permissions>
    Permissions that the current user has on the permission.
    - <permission> *
      - <name>
        The name of the permission.
  - <user_tags>
    Info on tags attached to the permission.
    - <count>
      Number of attached tags.
    - <tag> *
      Short info on an individual tag (only if details were requested).
      - @id (uuid) UUID of the tag.
      - <name>
        Name of the tag (usually namespace:predicate).
      - <value>
        Value of the tag.
      - <comment>
        Comment for the tag.
  - <resource>
    The resource the permission applies to.
    - @id (uuid) UUID if permission applies to a resource, else 0.
    - <name>
    - <type>
      The OMP type of the resource.
    - <trash>
      Whether the resource is in the trash.
    - <deleted>
      Whether the resource has been deleted.
  - <subject>
    The subject the permission applies to.
    - @id (uuid) UUID of the subject.
    - <name>
    - <type>
      The OMP type of the subject: group, role or user.
    - <trash>
      Whether the subject is in the trash.
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
- <sort>
  - <field>
    - <order>
- <permissions>
  - @start (integer) First permission.
  - @max (integer) Maximum number of permissions.
- <permission_count>
  - <filtered>
    Number of permissions after filtering.
  - <page>
    Number of permissions on current page.

7.63.2 RNC

Command

get_permissions
 = element get_permissions
     {
       attribute permission_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute trash { boolean }?
     }

Response

get_permissions_response
 = element get_permissions_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_permissions_response_permission*
       & get_permissions_response_filters
       & get_permissions_response_sort
       & get_permissions_response_permissions
       & get_permissions_response_permission_count
     }

get_permissions_response_permission
 = element permission
     {
       attribute id { uuid }
       & get_permissions_response_permission_owner
       & get_permissions_response_permission_name
       & get_permissions_response_permission_comment
       & get_permissions_response_permission_creation_time
       & get_permissions_response_permission_modification_time
       & get_permissions_response_permission_writable
       & get_permissions_response_permission_in_use
       & get_permissions_response_permission_permissions
       & get_permissions_response_permission_user_tags
       & get_permissions_response_permission_resource
       & get_permissions_response_permission_subject
     }

get_permissions_response_permission_owner
 = element owner
     {
       get_permissions_response_permission_owner_name
     }

get_permissions_response_permission_owner_name
 = element name
     {
       name
     }

get_permissions_response_permission_name
 = element name
     {
       name
     }

get_permissions_response_permission_comment
 = element comment
     {
       text
     }

get_permissions_response_permission_creation_time
 = element creation_time
     {
       iso_time
     }

get_permissions_response_permission_modification_time
 = element modification_time
     {
       iso_time
     }

get_permissions_response_permission_resource
 = element resource
     {
       attribute id { uuid }?
       & get_permissions_response_permission_resource_name
       & get_permissions_response_permission_resource_type
       & get_permissions_response_permission_resource_trash
       & get_permissions_response_permission_resource_deleted
     }

get_permissions_response_permission_resource_name
 = element name
     {
       text
     }

get_permissions_response_permission_resource_type
 = element type
     {
       text
     }

get_permissions_response_permission_resource_trash
 = element trash
     {
       boolean
     }

get_permissions_response_permission_resource_deleted
 = element deleted
     {
       boolean
     }

get_permissions_response_permission_subject
 = element subject
     {
       attribute id { uuid }?
       & get_permissions_response_permission_subject_name
       & get_permissions_response_permission_subject_type
       & get_permissions_response_permission_subject_trash
     }

get_permissions_response_permission_subject_name
 = element name
     {
       text
     }

get_permissions_response_permission_subject_type
 = element type
     {
       text
     }

get_permissions_response_permission_subject_trash
 = element trash
     {
       boolean
     }

get_permissions_response_permission_subject_deleted
 = element deleted
     {
       boolean
     }

get_permissions_response_permission_writable
 = element writable
     {
       boolean
     }

get_permissions_response_permission_in_use
 = element in_use
     {
       boolean
     }

get_permissions_response_permission_permissions
 = element permissions
     {
       get_permissions_response_permission_permissions_permission*
     }

get_permissions_response_permission_permissions_permission
 = element permission
     {
       get_permissions_response_permission_permissions_permission_name
     }

get_permissions_response_permission_permissions_permission_name
 = element name
     {
       name
     }

get_permissions_response_permission_user_tags
 = element user_tags
     {
       get_permissions_response_permission_user_tags_count
       & get_permissions_response_permission_user_tags_tag*
     }

get_permissions_response_permission_user_tags_count
 = element count
     {
       integer
     }

get_permissions_response_permission_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_permissions_response_permission_user_tags_tag_name
       & get_permissions_response_permission_user_tags_tag_value
       & get_permissions_response_permission_user_tags_tag_comment
     }

get_permissions_response_permission_user_tags_tag_name
 = element name
     {
       text
     }

get_permissions_response_permission_user_tags_tag_value
 = element value
     {
       text
     }

get_permissions_response_permission_user_tags_tag_comment
 = element comment
     {
       text
     }

get_permissions_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_permissions_response_filters_term
       & get_permissions_response_filters_name?
       & get_permissions_response_filters_keywords
     }

get_permissions_response_filters_term
 = element term
     {
       text
     }

get_permissions_response_filters_name
 = element name
     {
       text
     }

get_permissions_response_filters_keywords
 = element keywords
     {
       get_permissions_response_filters_keywords_keyword*
     }

get_permissions_response_filters_keywords_keyword
 = element keyword
     {
       get_permissions_response_filters_keywords_keyword_column
       & get_permissions_response_filters_keywords_keyword_relation
       & get_permissions_response_filters_keywords_keyword_value
     }

get_permissions_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_permissions_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_permissions_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_permissions_response_sort
 = element sort
     {
       text
       & get_permissions_response_sort_field
     }

get_permissions_response_sort_field
 = element field
     {
       get_permissions_response_sort_field_order
     }

get_permissions_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_permissions_response_permissions
 = element permissions
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_permissions_response_permission_count
 = element permission_count
     {
       get_permissions_response_permission_count_filtered
       & get_permissions_response_permission_count_page
     }

get_permissions_response_permission_count_filtered
 = element filtered
     {
       integer
     }

get_permissions_response_permission_count_page
 = element page
     {
       integer
     }

7.63.3 Example: Get one or many permissions

Client

 <get_permissions/>

Manager

 <get_permissions_response status="200"
                           status_text="OK">
   <permission id="b493b7a8-7489-11df-a3ec-002264764cea">
     <name>Management</name>
     <comment>Managers</comment>
     <creation_time>Sun Jun 27 08:49:43 2010</creation_time>
     <modification_time>Sun Jun 27 08:49:43 2010</modification_time>
     <writable>1</writable>
     <in_use>0</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <users>sarah, frank</users>
   </permission>
   ...
   <filters id="">
     <term>first=1 rows=-1 sort=name</term>
     <keywords>
       <keyword>
         <column>first</column>
         <relation>=</relation>
         <value>1</value>
       </keyword>
       ...
     </keywords>
   </filters>
   <sort>
     <field>
       name
       <order>ascending</order>
     </field>
   </sort>
   <permissions max="-1"
                start="1"/>
   <permission_count>
     1
     <filtered>1</filtered>
     <page>1</page>
   </permission_count>
 </get_permissions_response>

7.64 Command `get_port_lists`

In short: Get one or many port lists.

The client uses the get_port_lists command to get port list information.

7.64.1 Structure

Command
- @port_list_id (uuid) ID of single port list to get.
- @filter (text) Filter term to use to filter query.
- @filt_id (uuid) ID of filter to use to filter query.
- @details (boolean) Whether to include full port list details.
- @targets (boolean) Whether to include targets using this port list.
- @trash (boolean) Whether to get the trashcan port lists instead.
Response
- @status (status)
- @status_text (text)
- <port_list> *
  - @id (uuid)
  - <owner>
    Owner of the port list.
    - <name>
      The name of the owner.
  - <name>
    The name of the port list.
  - <comment>
    The comment on the port list.
  - <creation_time>
  - <modification_time>
  - <writable>
    Whether the port list is writable.
  - <in_use>
    Whether any targets are using the port list.
  - <permissions>
    Permissions that the current user has on the port list.
    - <permission> *
      - <name>
        The name of the permission.
  - <user_tags>
    Info on tags attached to the port list.
    - <count>
      Number of attached tags.
    - <tag> *
      Short info on an individual tag (only if details were requested).
      - @id (uuid) UUID of the tag.
      - <name>
        Name of the tag (usually namespace:predicate).
      - <value>
        Value of the tag.
      - <comment>
        Comment for the tag.
  - <port_count>
    - <all>
      Total number of ports.
    - <tcp>
      Total number of TCP ports.
    - <udp>
      Total number of UDP ports.
  - <port_ranges> ?
    - <port_range> *
      - @id (uuid)
      - <start>
        First port in range.
      - <end>
        Last port in range.
      - <type>
        The type of port: TCP, UDP, ....
      - <comment>
        The comment on the port range.
  - <targets> ?
    The targets using the port list.
    - <target> *
      - @id (uuid)
      - <name>
        The name of the target.
      - <permissions> ?
        Permissions the user has on the target.
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
- <sort>
  - <field>
    - <order>
- <port_lists>
  - @start (integer) First port list.
  - @max (integer) Maximum number of port lists.
- <port_list_count>
  - <filtered>
    Number of port lists after filtering.
  - <page>
    Number of port lists on current page.

7.64.2 RNC

Command

get_port_lists
 = element get_port_lists
     {
       attribute port_list_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute details { boolean }?
       & attribute targets { boolean }?
       & attribute trash { boolean }?
     }

Response

get_port_lists_response
 = element get_port_lists_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_port_lists_response_port_list*
       & get_port_lists_response_filters
       & get_port_lists_response_sort
       & get_port_lists_response_port_lists
       & get_port_lists_response_port_list_count
     }

get_port_lists_response_port_list
 = element port_list
     {
       attribute id { uuid }
       & get_port_lists_response_port_list_owner
       & get_port_lists_response_port_list_name
       & get_port_lists_response_port_list_comment
       & get_port_lists_response_port_list_creation_time
       & get_port_lists_response_port_list_modification_time
       & get_port_lists_response_port_list_writable
       & get_port_lists_response_port_list_in_use
       & get_port_lists_response_port_list_permissions
       & get_port_lists_response_port_list_user_tags
       & get_port_lists_response_port_list_port_count
       & get_port_lists_response_port_list_port_ranges?
       & get_port_lists_response_port_list_targets?
     }

get_port_lists_response_port_list_owner
 = element owner
     {
       get_port_lists_response_port_list_owner_name
     }

get_port_lists_response_port_list_owner_name
 = element name
     {
       name
     }

get_port_lists_response_port_list_name
 = element name
     {
       name
     }

get_port_lists_response_port_list_comment
 = element comment
     {
       text
     }

get_port_lists_response_port_list_creation_time
 = element creation_time
     {
       iso_time
     }

get_port_lists_response_port_list_modification_time
 = element modification_time
     {
       iso_time
     }

get_port_lists_response_port_list_writable
 = element writable
     {
       boolean
     }

get_port_lists_response_port_list_in_use
 = element in_use
     {
       boolean
     }

get_port_lists_response_port_list_permissions
 = element permissions
     {
       get_port_lists_response_port_list_permissions_permission*
     }

get_port_lists_response_port_list_permissions_permission
 = element permission
     {
       get_port_lists_response_port_list_permissions_permission_name
     }

get_port_lists_response_port_list_permissions_permission_name
 = element name
     {
       name
     }

get_port_lists_response_port_list_user_tags
 = element user_tags
     {
       get_port_lists_response_port_list_user_tags_count
       & get_port_lists_response_port_list_user_tags_tag*
     }

get_port_lists_response_port_list_user_tags_count
 = element count
     {
       integer
     }

get_port_lists_response_port_list_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_port_lists_response_port_list_user_tags_tag_name
       & get_port_lists_response_port_list_user_tags_tag_value
       & get_port_lists_response_port_list_user_tags_tag_comment
     }

get_port_lists_response_port_list_user_tags_tag_name
 = element name
     {
       text
     }

get_port_lists_response_port_list_user_tags_tag_value
 = element value
     {
       text
     }

get_port_lists_response_port_list_user_tags_tag_comment
 = element comment
     {
       text
     }

get_port_lists_response_port_list_port_count
 = element port_count
     {
       get_port_lists_response_port_list_port_count_all
       & get_port_lists_response_port_list_port_count_tcp
       & get_port_lists_response_port_list_port_count_udp
     }

get_port_lists_response_port_list_port_count_all
 = element all
     {
       integer
     }

get_port_lists_response_port_list_port_count_tcp
 = element tcp
     {
       integer
     }

get_port_lists_response_port_list_port_count_udp
 = element udp
     {
       integer
     }

get_port_lists_response_port_list_port_ranges
 = element port_ranges
     {
       get_port_lists_response_port_list_port_ranges_port_range*
     }

get_port_lists_response_port_list_port_ranges_port_range
 = element port_range
     {
       attribute id { uuid }
       & get_port_lists_response_port_list_port_ranges_port_range_start
       & get_port_lists_response_port_list_port_ranges_port_range_end
       & get_port_lists_response_port_list_port_ranges_port_range_type
       & get_port_lists_response_port_list_port_ranges_port_range_comment
     }

get_port_lists_response_port_list_port_ranges_port_range_start
 = element start
     {
       integer
     }

get_port_lists_response_port_list_port_ranges_port_range_end
 = element end
     {
       integer
     }

get_port_lists_response_port_list_port_ranges_port_range_type
 = element type
     {
       text
     }

get_port_lists_response_port_list_port_ranges_port_range_comment
 = element comment
     {
       text
     }

get_port_lists_response_port_list_targets
 = element targets
     {
       get_port_lists_response_port_list_targets_target*
     }

get_port_lists_response_port_list_targets_target
 = element target
     {
       attribute id { uuid }
       & get_port_lists_response_port_list_targets_target_name
       & get_port_lists_response_port_list_targets_target_permissions?
     }

get_port_lists_response_port_list_targets_target_name
 = element name
     {
       name
     }

get_port_lists_response_port_list_targets_target_permissions
 = element permissions
     {
       ""
     }

get_port_lists_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_port_lists_response_filters_term
       & get_port_lists_response_filters_name?
       & get_port_lists_response_filters_keywords
     }

get_port_lists_response_filters_term
 = element term
     {
       text
     }

get_port_lists_response_filters_name
 = element name
     {
       text
     }

get_port_lists_response_filters_keywords
 = element keywords
     {
       get_port_lists_response_filters_keywords_keyword*
     }

get_port_lists_response_filters_keywords_keyword
 = element keyword
     {
       get_port_lists_response_filters_keywords_keyword_column
       & get_port_lists_response_filters_keywords_keyword_relation
       & get_port_lists_response_filters_keywords_keyword_value
     }

get_port_lists_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_port_lists_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_port_lists_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_port_lists_response_sort
 = element sort
     {
       text
       & get_port_lists_response_sort_field
     }

get_port_lists_response_sort_field
 = element field
     {
       get_port_lists_response_sort_field_order
     }

get_port_lists_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_port_lists_response_port_lists
 = element port_lists
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_port_lists_response_port_list_count
 = element port_list_count
     {
       get_port_lists_response_port_list_count_filtered
       & get_port_lists_response_port_list_count_page
     }

get_port_lists_response_port_list_count_filtered
 = element filtered
     {
       integer
     }

get_port_lists_response_port_list_count_page
 = element page
     {
       integer
     }

7.64.3 Example: Export a port list

Client

 <get_port_lists port_list_id="b993b6f5-f9fb-4e6e-9c94-dd46c00e058d"
                 details="1"
                 targets="1"/>

Manager

 <get_port_lists_response status="200"
                          status_text="OK">
   <port_list id="b993b6f5-f9fb-4e6e-9c94-dd46c00e058d">
     <name>All TCP</name>
     <comment>Every single TCP port.</comment>
     <creation_time>2012-12-31T16:38:45+01:00</creation_time>
     <modification_time>2012-12-31T16:38:45+01:00</modification_time>
     <writable>0</writable>
     <in_use>1</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <port_count>
       <all>65535</all>
       <tcp>65535</tcp>
       <udp>0</udp>
     </port_count>
     <port_ranges>
       <port_range>
         <type>TCP</type>
         <start>1</start>
         <end>65535</end>
       </port_range>
     </port_ranges>
     <targets>
       <target id="1f28d970-17ef-4c69-ba8a-13827059f2b9">
         <name>Web server</name>
       </target>
     </targets>
   </port_list>
 </get_port_lists_response>

7.65 Command `get_preferences`

In short: Get one or many preferences.

The client uses the get_preferences command to get preference information. If the command sent by the client was valid, the manager will reply with a list of preferences to the client. If the manager cannot access a list of available NVTs at present, it will reply with the 503 response.

When the command includes a config_id attribute, the preference element includes the preference name, type and value, and the NVT to which the preference applies. Otherwise, the preference element includes just the name and value, with the NVT and type built into the name.

7.65.1 Structure

Command
- @nvt_oid (oid)
- @config_id (uuid) ID of config of which to show preference values.
- @preference (text) The name of a particular preference to get.
Response
- @status (status)
- @status_text (text)
- <preference> *
  - <nvt>
    NVT to which preference applies.
    - @oid (oid)
    - <name>
      The name of the NVT.
  - <name>
    The name of the preference.
  - <type>
    The type of preference.
  - <value>
    The value of the preference.
  - <alt> *
    An alternate value of the preference.
  - <default>
    The default value of the preference.

7.65.2 RNC

Command

get_preferences
 = element get_preferences
     {
       attribute nvt_oid { oid }?
       & attribute config_id { uuid }?
       & attribute preference { text }?
     }

Response

get_preferences_response
 = element get_preferences_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_preferences_response_preference*
     }

get_preferences_response_preference
 = element preference
     {
       get_preferences_response_preference_nvt
       & get_preferences_response_preference_name
       & get_preferences_response_preference_type
       & get_preferences_response_preference_value
       & get_preferences_response_preference_alt*
       & get_preferences_response_preference_default
     }

get_preferences_response_preference_nvt
 = element nvt
     {
       attribute oid { oid }
       & get_preferences_response_preference_nvt_name
     }

get_preferences_response_preference_nvt_name
 = element name
     {
       name
     }

get_preferences_response_preference_name
 = element name
     {
       name
     }

get_preferences_response_preference_type
 = element type
     {
       text
     }

get_preferences_response_preference_value
 = element value
     {
       text
     }

get_preferences_response_preference_alt
 = element alt
     {
       text
     }

get_preferences_response_preference_default
 = element default
     {
       text
     }

7.65.3 Example: Get default preferences for all NVTs

Client

 <get_preferences/>

Manager

 <get_preferences_response status="200"
                           status_text="OK">
   <preference>
     <name>Services[entry]:Network connection timeout :</name>
     <value>5</value>
   </preference>
   ...
 </get_preferences_response>

7.65.3 Example: Get default preferences for a single NVT

Client

 <get_preferences nvt_oid="1.3.6.1.4.1.25623.1.0.10330"/>

Manager

 <get_preferences_response status="200"
                           status_text="OK">
   <preference>
     <name>Services[entry]:Network connection timeout :</name>
     <value>5</value>
     <default>5</default>
   </preference>
   ...
 </get_preferences_response>

7.65.3 Example: Get preferences from a config for all NVTs

Client

 <get_preferences config_id="daba56c8-73ec-11df-a475-002264764cea"/>

Manager

 <get_preferences_response status="200"
                           status_text="OK">
   <preference>
     <nvt oid="1.3.6.1.4.1.25623.1.0.10330">
       <name>Services</name>
     </nvt>
     <name>Network connection timeout :</name>
     <type>entry</type>
     <value>5</value>
   </preference>
   ...
 </get_preferences_response>

7.65.3 Example: Get preferences from a config for a single NVT

Client

 <get_preferences config_id="daba56c8-73ec-11df-a475-002264764cea"
                  nvt_oid="1.3.6.1.4.1.25623.1.0.10330"/>

Manager

 <get_preferences nvt_oid="1.3.6.1.4.1.25623.1.0.10330">
   <preference>
     <nvt oid="1.3.6.1.4.1.25623.1.0.10330">
       <name>Services</name>
     </nvt>
     <name>Network connection timeout :</name>
     <type>entry</type>
     <value>5</value>
     <default>5</default>
   </preference>
 </get_preferences>

7.66 Command `get_reports`

In short: Get one or many reports.

The client uses the get_reports command to get report information.

The XML report format is sent as XML. All other formats are sent in Base64 encoding.

7.66.1 Structure

Command
- @report_id (uuid) ID of single report to get.
- @filter (text) Filter term to use to filter results, when getting a single report.
- @filt_id (uuid) ID of filter to use to filter results, when getting a single report.
- @report_filter (uuid) Filter term to use to filter reports.
- @report_filt_id (uuid) ID of filter to use to filter reports.
- @type ("scan", "assets" or "prognostic") Type of report to get.
- @format_id (uuid) ID of required report format.
- @alert_id (uuid) ID of alert to pass generated report to.
- @first_result (integer) First result to get.
- @max_results (integer) Maximum number of results to get.
- @sort_order (sort_order)
- @sort_field (text)
- @apply_overrides (boolean) Whether to apply overrides to the results.
- @levels (levels) Which threat levels to include in the report.
- @search_phrase (text) A string that all results in the report must contain.
- @min_cvss_base (integer) Minimum CVSS base of results in report.
- @min_qod (integer) Minimum QoD of results in report.
- @notes (boolean) Whether to include notes in the report.
- @note_details (boolean) If notes are included, whether to include note details.
- @overrides (boolean) Whether to include overrides in the report.
- @override_details (boolean) If overrides are included, whether to include override details.
- @result_hosts_only (boolean) Whether to include only those hosts that have results.
- @host (text) For "assets" or "prognostic", single host to retrieve.
- @host_first_result (integer) For "assets" or "prognostic", first host to retrieve.
- @host_max_results (integer) For "assets" or "prognostic", maximum hosts to retrieve.
- @host_levels (levels) For "assets" or "prognostic", which threat levels to include in hosts.
- @host_search_phrase (text) For "assets" or "prognostic", the search phrase to limit hosts to.
- @pos (integer) For type "assets", position of report used, from end.
- @delta_report_id (uuid) ID of second report, for producing a delta report.
- @delta_states () Letters for results to include: c)hanged, g)one, n)ew, s)ame.
- @autofp ("0", "1" or "2") Whether to trust vendor security updates. 1 full match, 2 partial.
- @result_hosts_only (boolean) Whether to include only hosts with results.
- @ignore_pagination (boolean) Whether to ignore info used to split the report into pages like the filter terms "first" and "rows"..
- @timezone (timezone) The timezone to use for dates in the report.
Response
- @status (status)
- @status_text (text)
- <report> *
  (report)
  
  Actually attributes and either base64 or a report.
- The group?
  - <filters>
    - @id (uuid) UUID of filter if any, else 0.
    - <term>
      Filter term.
    - <name> ?
      Filter name, if applicable.
    - <keywords>
      Filter broken down into keywords.
      - <keyword> *
        
        <column>
        Column prefix.
        
        <relation>
        Relation operator.
        
        <value>
        The filter text.
  - <sort>
    - <field>
      - <order>
  - <reports>
    - @start (integer) First report.
    - @max (integer) Maximum number of reports.
  - <report_count>
    - <filtered>
      Number of reports after filtering.
    - <page>
      Number of reports on current page.

7.66.2 RNC

Command

get_reports
 = element get_reports
     {
       attribute report_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute report_filter { uuid }?
       & attribute report_filt_id { uuid }?
       & attribute type { xsd:token { pattern = "scan|assets|prognostic" } }?
       & attribute format_id { uuid }?
       & attribute alert_id { uuid }?
       & attribute first_result { integer }?
       & attribute max_results { integer }?
       & attribute sort_order { sort_order }?
       & attribute sort_field { text }?
       & attribute apply_overrides { boolean }?
       & attribute levels { levels }?
       & attribute search_phrase { text }?
       & attribute min_cvss_base { integer }?
       & attribute min_qod { integer }?
       & attribute notes { boolean }?
       & attribute note_details { boolean }?
       & attribute overrides { boolean }?
       & attribute override_details { boolean }?
       & attribute result_hosts_only { boolean }?
       & attribute host { text }?
       & attribute host_first_result { integer }?
       & attribute host_max_results { integer }?
       & attribute host_levels { levels }?
       & attribute host_search_phrase { text }?
       & attribute pos { integer }?
       & attribute delta_report_id { uuid }?
       & attribute delta_states {  }?
       & attribute autofp { xsd:token { pattern = "0|1|2" } }?
       & attribute result_hosts_only { boolean }?
       & attribute ignore_pagination { boolean }?
       & attribute timezone { timezone }?
     }

Response

get_reports_response
 = element get_reports_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_reports_response_report*
       & ( get_reports_response_filters
           & get_reports_response_sort
           & get_reports_response_reports
           & get_reports_response_report_count )?
     }

get_reports_response_report
 = element report    # type report
     {
       text # RNC limitation: base64
       & attribute id { uuid }
       & attribute format_id { uuid }
       & attribute extension { text }
       & attribute content_type { text }
       & attribute type { xsd:token { pattern = "scan|assets|prognostic" } }?
       & report_owner
       & report_name
       & report_comment
       & report_creation_time
       & report_modification_time
       & report_writable
       & report_in_use
       & report_task
       & report_report_format
       & report_report
     }

get_reports_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_reports_response_filters_term
       & get_reports_response_filters_name?
       & get_reports_response_filters_keywords
     }

get_reports_response_filters_term
 = element term
     {
       text
     }

get_reports_response_filters_name
 = element name
     {
       text
     }

get_reports_response_filters_keywords
 = element keywords
     {
       get_reports_response_filters_keywords_keyword*
     }

get_reports_response_filters_keywords_keyword
 = element keyword
     {
       get_reports_response_filters_keywords_keyword_column
       & get_reports_response_filters_keywords_keyword_relation
       & get_reports_response_filters_keywords_keyword_value
     }

get_reports_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_reports_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_reports_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_reports_response_sort
 = element sort
     {
       text
       & get_reports_response_sort_field
     }

get_reports_response_sort_field
 = element field
     {
       get_reports_response_sort_field_order
     }

get_reports_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_reports_response_reports
 = element reports
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_reports_response_report_count
 = element report_count
     {
       get_reports_response_report_count_filtered
       & get_reports_response_report_count_page
     }

get_reports_response_report_count_filtered
 = element filtered
     {
       integer
     }

get_reports_response_report_count_page
 = element page
     {
       integer
     }

7.66.3 Example: Get a report in PDF

Client

 <get_reports report_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"
              format_id="1a60a67e-97d0-4cbf-bc77-f71b08e7043d"/>

Manager

 <get_reports_response status="200"
                       status_text="OK">
   <report id="267a3405-e84a-47da-97b2-5fa0d2e8995e"
           format_id="1a60a67e-97d0-4cbf-bc77-f71b08e7043d"
           extension="pdf"
           content_type="application/pdf">hsisn3qaVFhkjFRG4...</report>
 </get_reports_response>

7.66.3 Example: Get a report in XML

Client

 <get_reports report_id="f0fdf522-276d-4893-9274-fb8699dc2270"/>

Manager

 <get_reports_response status="200"
                       status_text="OK">
   <report id="f0fdf522-276d-4893-9274-fb8699dc2270"
           format_id="d5da9f67-8551-4e51-807b-b6a873d70e34"
           extension="xml"
           content_type="text/xml">
     <report id="f0fdf522-276d-4893-9274-fb8699dc2270">
       <omp>
         <version>6.0</version>
       </omp>
       <sort>
         <field>
           type
           <order>descending</order>
         </field>
       </sort>
       <filters id="0">
         hmlgd
         <term/>
         <phrase/>
         <notes>0</notes>
         <overrides>0</overrides>
         <apply_overrides>0</apply_overrides>
         <result_hosts_only>1</result_hosts_only>
         <min_cvss_base/>
         <autofp>0</autofp>
         <result_hosts_only>1</result_hosts_only>
         <filter>High</filter>
         <filter>Medium</filter>
         <filter>Low</filter>
         <filter>Log</filter>
         <filter>Debug</filter>
       </filters>
       <user_tags>
         <count>0</count>
       </user_tags>
       <scan_run_status>Done</scan_run_status>
       <hosts>
         <count>1</count>
       </hosts>
       <closed_cves>
         <count>0</count>
       </closed_cves>
       <vulns>
         <count>3</count>
       </vulns>
       <os>
         <count>1</count>
       </os>
       <apps>
         <count>2</count>
       </apps>
       <ssl_certs>
         <count>0</count>
       </ssl_certs>
       <result_count>
         <full>10</full>
         <filtered>10</filtered>
         <debug>
           <full>0</full>
           <filtered>0</filtered>
         </debug>
         <hole>
           <full>0</full>
           <filtered>0</filtered>
         </hole>
         <info>
           <full>7</full>
           <filtered>7</filtered>
         </info>
         <log>
           <full>0</full>
           <filtered>0</filtered>
         </log>
         <warning>
           <full>3</full>
           <filtered>3</filtered>
         </warning>
       </result_count>
       <task id="13bb418a-4220-4575-b35b-ec398bff7417">
         <name>dik mm</name>
       </task>
       <scan>
         <task/>
       </scan>
       <timestamp>2010-02-02T19:11:21+00:00</timestamp>
       <scan_start>2010-02-02T19:11:21+00:00</scan_start>
       <timezone>UTC</timezone>
       <timezone_abbrev>UTC</timezone_abbrev>
       <ports start="1"
              max="-1">
         <port>
           general/tcp
           <host>127.0.1.1</host>
           <severity>5.0</severity>
           <threat>Medium</threat>
         </port>
         ...
       </ports>
       <results start="1"
                max="-1">
         <result id="634f7a2e-8ca1-43b7-b6d7-0d4841449508">
           <host>127.0.1.1</host>
           <port>general/tcp</port>
           <nvt oid="1.3.6.1.4.1.25623.1.0.74">
             <name>Test NVT: fields with ISO-8859-1 chars ()</name>
             <cvss_base>5.0</cvss_base>
             <cve>CVE-2013-1406</cve>
             <bid>51702</bid>
             <tags>NOTAGS</tags>
             <cert>
               <cert_ref id="DFN-CERT-2013-0246"
                         type="DFN-CERT"/>
             </cert>
             <xref>NOXREF</xref>
           </nvt>
           <threat>Medium</threat>
           <description>Test with umlaut Warning Port 0.</description>
         </result>
         ...
       </results>
       <host_start>
         2010-02-02T19:11:21+00:00
         <host>127.0.1.1</host>
       </host_start>
       <host_end>
         2010-02-02T19:11:52+00:00
         <host>127.0.1.1</host>
       </host_end>
       <scan_end>2010-02-02T19:11:52+00:00</scan_end>
       <errors>
         <count>0</count>
       </errors>
     </report>
   </report>
 </get_reports_response>

7.67 Command `get_report_formats`

In short: Get one or many report formats.

The client uses the get_report_formats command to get report format information.

7.67.1 Structure

Command
- @report_format_id (uuid) ID of single report format to get.
- @filter (text) Filter term to use to filter query.
- @filt_id (uuid) ID of filter to use to filter query.
- @trash (boolean) Whether to get the trashcan report formats instead.
- @alerts (boolean) Whether to include alerts that use the report format.
- @params (boolean) Whether to include report format parameters.
- @details (boolean) Include report format file, signature and parameters.
Response
- @status (status)
- @status_text (text)
- <report_format> *
  - @id (uuid)
  - <owner>
    Owner of the report format.
    - <name>
      The name of the owner.
  - <name>
    The name of the report format.
  - <creation_time>
  - <modification_time>
  - <writable>
    Whether the report format is global or in use.
  - <in_use>
    Whether any alerts are using the report format.
  - <permissions>
    Permissions that the current user has on the report format.
    - <permission> *
      - <name>
        The name of the permission.
  - <user_tags>
    Info on tags attached to the report format.
    - <count>
      Number of attached tags.
    - <tag> *
      Short info on an individual tag (only if details were requested).
      - @id (uuid) UUID of the tag.
      - <name>
        Name of the tag (usually namespace:predicate).
      - <value>
        Value of the tag.
      - <comment>
        Comment for the tag.
  - <extension>
  - <content_type>
  - <summary>
  - <description>
  - <global>
  - <predefined>
  - <alerts> ?
    Alerts using the report format.
    - <alert> *
      - @id (uuid) UUID of the alert.
      - <name>
        Name of the alert.
      - <permissions> ?
        Permissions the user has on the permission.
  - The group?
    - <file> *
      One of the files used to generate the report.
      - @name (text)
    - <signature>
      The report format signature.
  - <trust>
    Whether signature verification succeeded.
    - @name (text)
    - <time>
      The time the trust was checked.
  - <active>
    Whether the report format is active.
  - <param> *
    - <name>
      The name of the param.
    - <type>
      The type of the param.
      - <min> ?
        Minimum.
      - <max> ?
        Maximum.
      - <options> ?
        Selection options.
        
        <option> *
        Option value.
    - <value>
      The value of the param.
    - <default>
      The fallback value of the param.
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
- <sort>
  - <field>
    - <order>
- <report_formats>
  - @start (integer) First report format.
  - @max (integer) Maximum number of report formats.
- <report_format_count>
  - <filtered>
    Number of report formats after filtering.
  - <page>
    Number of report formats on current page.

7.67.2 RNC

Command

get_report_formats
 = element get_report_formats
     {
       attribute report_format_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute trash { boolean }?
       & attribute alerts { boolean }?
       & attribute params { boolean }?
       & attribute details { boolean }?
     }

Response

get_report_formats_response
 = element get_report_formats_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_report_formats_response_report_format*
       & get_report_formats_response_filters
       & get_report_formats_response_sort
       & get_report_formats_response_report_formats
       & get_report_formats_response_report_format_count
     }

get_report_formats_response_report_format
 = element report_format
     {
       attribute id { uuid }
       & get_report_formats_response_report_format_owner
       & get_report_formats_response_report_format_name
       & get_report_formats_response_report_format_creation_time
       & get_report_formats_response_report_format_modification_time
       & get_report_formats_response_report_format_writable
       & get_report_formats_response_report_format_in_use
       & get_report_formats_response_report_format_permissions
       & get_report_formats_response_report_format_user_tags
       & get_report_formats_response_report_format_extension
       & get_report_formats_response_report_format_content_type
       & get_report_formats_response_report_format_summary
       & get_report_formats_response_report_format_description
       & get_report_formats_response_report_format_global
       & get_report_formats_response_report_format_predefined
       & get_report_formats_response_report_format_alerts?
       & ( get_report_formats_response_report_format_file*
           & get_report_formats_response_report_format_signature )?
       & get_report_formats_response_report_format_trust
       & get_report_formats_response_report_format_active
       & get_report_formats_response_report_format_param*
     }

get_report_formats_response_report_format_owner
 = element owner
     {
       get_report_formats_response_report_format_owner_name
     }

get_report_formats_response_report_format_owner_name
 = element name
     {
       name
     }

get_report_formats_response_report_format_name
 = element name
     {
       name
     }

get_report_formats_response_report_format_creation_time
 = element creation_time
     {
       iso_time
     }

get_report_formats_response_report_format_modification_time
 = element modification_time
     {
       iso_time
     }

get_report_formats_response_report_format_writable
 = element writable
     {
       boolean
     }

get_report_formats_response_report_format_in_use
 = element in_use
     {
       boolean
     }

get_report_formats_response_report_format_permissions
 = element permissions
     {
       get_report_formats_response_report_format_permissions_permission*
     }

get_report_formats_response_report_format_permissions_permission
 = element permission
     {
       get_report_formats_response_report_format_permissions_permission_name
     }

get_report_formats_response_report_format_permissions_permission_name
 = element name
     {
       name
     }

get_report_formats_response_report_format_user_tags
 = element user_tags
     {
       get_report_formats_response_report_format_user_tags_count
       & get_report_formats_response_report_format_user_tags_tag*
     }

get_report_formats_response_report_format_user_tags_count
 = element count
     {
       integer
     }

get_report_formats_response_report_format_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_report_formats_response_report_format_user_tags_tag_name
       & get_report_formats_response_report_format_user_tags_tag_value
       & get_report_formats_response_report_format_user_tags_tag_comment
     }

get_report_formats_response_report_format_user_tags_tag_name
 = element name
     {
       text
     }

get_report_formats_response_report_format_user_tags_tag_value
 = element value
     {
       text
     }

get_report_formats_response_report_format_user_tags_tag_comment
 = element comment
     {
       text
     }

get_report_formats_response_report_format_summary
 = element summary
     {
       text
     }

get_report_formats_response_report_format_description
 = element description
     {
       text
     }

get_report_formats_response_report_format_extension
 = element extension
     {
       text
     }

get_report_formats_response_report_format_global
 = element global
     {
       boolean
     }

get_report_formats_response_report_format_content_type
 = element content_type
     {
       text
     }

get_report_formats_response_report_format_predefined
 = element predefined
     {
       boolean
     }

get_report_formats_response_report_format_alerts
 = element alerts
     {
       get_report_formats_response_report_format_alerts_alert*
     }

get_report_formats_response_report_format_alerts_alert
 = element alert
     {
       attribute id { uuid }
       & get_report_formats_response_report_format_alerts_alert_name
       & get_report_formats_response_report_format_alerts_alert_permissions?
     }

get_report_formats_response_report_format_alerts_alert_name
 = element name
     {
       name
     }

get_report_formats_response_report_format_alerts_alert_permissions
 = element permissions
     {
       ""
     }

get_report_formats_response_report_format_param
 = element param
     {
       get_report_formats_response_report_format_param_name
       & get_report_formats_response_report_format_param_type
       & get_report_formats_response_report_format_param_value
       & get_report_formats_response_report_format_param_default
     }

get_report_formats_response_report_format_param_name
 = element name
     {
       name
     }

get_report_formats_response_report_format_param_type
 = element type
     {
       text # RNC limitation: xsd:token { pattern = "boolean|integer|selection|string|text" }
       & get_report_formats_response_report_format_param_type_min?
       & get_report_formats_response_report_format_param_type_max?
       & get_report_formats_response_report_format_param_type_options?
     }

get_report_formats_response_report_format_param_type_min
 = element min
     {
       text
     }

get_report_formats_response_report_format_param_type_max
 = element max
     {
       text
     }

get_report_formats_response_report_format_param_type_options
 = element options
     {
       get_report_formats_response_report_format_param_type_options_option*
     }

get_report_formats_response_report_format_param_type_options_option
 = element option
     {
       text
     }

get_report_formats_response_report_format_param_value
 = element value
     {
       text
     }

get_report_formats_response_report_format_param_default
 = element default
     {
       text
     }

get_report_formats_response_report_format_file
 = element file
     {
       text # RNC limitation: base64
       & attribute name { text }
     }

get_report_formats_response_report_format_signature
 = element signature
     {
       text
     }

get_report_formats_response_report_format_trust
 = element trust
     {
       text # RNC limitation: xsd:token { pattern = "yes|no|unknown" }
       & attribute name { text }
       & get_report_formats_response_report_format_trust_time
     }

get_report_formats_response_report_format_trust_time
 = element time
     {
       iso_time
     }

get_report_formats_response_report_format_active
 = element active
     {
       boolean
     }

get_report_formats_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_report_formats_response_filters_term
       & get_report_formats_response_filters_name?
       & get_report_formats_response_filters_keywords
     }

get_report_formats_response_filters_term
 = element term
     {
       text
     }

get_report_formats_response_filters_name
 = element name
     {
       text
     }

get_report_formats_response_filters_keywords
 = element keywords
     {
       get_report_formats_response_filters_keywords_keyword*
     }

get_report_formats_response_filters_keywords_keyword
 = element keyword
     {
       get_report_formats_response_filters_keywords_keyword_column
       & get_report_formats_response_filters_keywords_keyword_relation
       & get_report_formats_response_filters_keywords_keyword_value
     }

get_report_formats_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_report_formats_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_report_formats_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_report_formats_response_sort
 = element sort
     {
       text
       & get_report_formats_response_sort_field
     }

get_report_formats_response_sort_field
 = element field
     {
       get_report_formats_response_sort_field_order
     }

get_report_formats_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_report_formats_response_report_formats
 = element report_formats
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_report_formats_response_report_format_count
 = element report_format_count
     {
       get_report_formats_response_report_format_count_filtered
       & get_report_formats_response_report_format_count_page
     }

get_report_formats_response_report_format_count_filtered
 = element filtered
     {
       integer
     }

get_report_formats_response_report_format_count_page
 = element page
     {
       integer
     }

7.67.3 Example: Get information about a report format

Client

 <get_report_formats report_format_id="b993b6f5-f9fb-4e6e-9c94-dd46c00e058d"/>

Manager

 <get_report_formats_response status="200"
                              status_text="OK">
   <report_format id="b993b6f5-f9fb-4e6e-9c94-dd46c00e058d">
     <name>HTML</name>
     <creation_time>2013-01-31T16:46:32+01:00</creation_time>
     <modification_time>2013-01-31T16:46:32+01:00</modification_time>
     <writable>1</writable>
     <in_use>0</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <extension>html</extension>
     <content_type>text/html</content_type>
     <summary>Single page HTML report.</summary>
     <description>
       A single HTML page listing results of a scan. Style information
       ...
     </description>
     <global>1</global>
     <predefined>1</predefined>
     <trust>
       no
       <time>Thu Dec 2 13:22:26 2010</time>
     </trust>
     <active>1</active>
   </report_format>
   ...
 </get_report_formats_response>

7.67.3 Example: Export a report format

Client

 <get_report_formats report_format_id="b993b6f5-f9fb-4e6e-9c94-dd46c00e058d"
                     details="1"/>

Manager

 <get_report_formats_response status="200"
                              status_text="OK">
   <report_format id="b993b6f5-f9fb-4e6e-9c94-dd46c00e058d">
     <name>HTML</name>
     <comment/>
     <creation_time>2013-01-18T18:23:53+01:00</creation_time>
     <modification_time>2013-01-18T18:24:10+01:00</modification_time>
     <writable>1</writable>
     <in_use>0</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <extension>html</extension>
     <content_type>text/html</content_type>
     <summary>Single page HTML report.</summary>
     <description>
       A single HTML page listing results of a scan. Style information
       ...
     </description>
     <global>1</global>
     <predefined>1</predefined>
     <file name="HTML.xsl">
       PD9ldD4K
       ...
     </file>
     <file name="generate">
       IyEvAk
       ...
     </file>
     <signature/>
   </report_format>
   ...
 </get_report_formats_response>

7.68 Command `get_results`

In short: Get results.

The client uses the get_results command to get result information.

If the request includes a notes flag, an overrides flag or an apply_overrides flag and any of these is true, then the request must also include a task ID.

7.68.1 Structure

Command
- @result_id (uuid) ID of single result to get.
- @filter (text) Filter term to use to filter query.
- @filt_id (uuid) ID of filter to use to filter query.
- @task_id (uuid) ID of task for note and override handling.
- @notes (boolean) Whether to include notes in the result.
- @note_details (boolean) If notes are included, whether to include note details.
- @overrides (boolean) Whether to include overrides in the result.
- @override_details (boolean) If overrides are included, whether to include override details.
- @apply_overrides (boolean) Whether to override result threat levels.
- @autofp ("0", "1" or "2") Whether to trust vendor security updates. 1 full match, 2 partial.
- @details (boolean) Whether to include additional details of the results.
Response
- @status (status)
- @status_text (text)
- <result> *
  (result)
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
- <sort>
  - <field>
    - <order>
- <results>
  - @start (integer) First result.
  - @max (integer) Maximum number of results.
- <result_count>
  - <filtered>
    Number of results after filtering.
  - <page>
    Number of results on current page.

7.68.2 RNC

Command

get_results
 = element get_results
     {
       attribute result_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute task_id { uuid }?
       & attribute notes { boolean }?
       & attribute note_details { boolean }?
       & attribute overrides { boolean }?
       & attribute override_details { boolean }?
       & attribute apply_overrides { boolean }?
       & attribute autofp { xsd:token { pattern = "0|1|2" } }?
       & attribute details { boolean }?
     }

Response

get_results_response
 = element get_results_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_results_response_result*
       & get_results_response_filters
       & get_results_response_sort
       & get_results_response_results
       & get_results_response_result_count
     }

get_results_response_result
 = element result    # type result
     {
       attribute id { uuid }
       & result_name
       & result_owner
       & result_comment
       & result_creation_time
       & result_modification_time
       & result_user_tags?
       & result_report?
       & result_task?
       & result_host
       & result_port
       & result_nvt
       & result_scan_nvt_version
       & result_threat
       & result_severity
       & result_qod
       & result_original_threat?
       & result_original_severity?
       & result_description
       & result_delta?
       & result_details
       & result_detection
       & result_notes?
       & result_overrides?
     }

get_results_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_results_response_filters_term
       & get_results_response_filters_name?
       & get_results_response_filters_keywords
     }

get_results_response_filters_term
 = element term
     {
       text
     }

get_results_response_filters_name
 = element name
     {
       text
     }

get_results_response_filters_keywords
 = element keywords
     {
       get_results_response_filters_keywords_keyword*
     }

get_results_response_filters_keywords_keyword
 = element keyword
     {
       get_results_response_filters_keywords_keyword_column
       & get_results_response_filters_keywords_keyword_relation
       & get_results_response_filters_keywords_keyword_value
     }

get_results_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_results_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_results_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_results_response_sort
 = element sort
     {
       text
       & get_results_response_sort_field
     }

get_results_response_sort_field
 = element field
     {
       get_results_response_sort_field_order
     }

get_results_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_results_response_results
 = element results
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_results_response_result_count
 = element result_count
     {
       get_results_response_result_count_filtered
       & get_results_response_result_count_page
     }

get_results_response_result_count_filtered
 = element filtered
     {
       integer
     }

get_results_response_result_count_page
 = element page
     {
       integer
     }

7.68.3 Example: Get one or many results

Client

 <get_results/>

Manager

 <get_results_response status="200"
                       status_text="OK">
   <result id="634f7a2e-8ca1-43b7-b6d7-0d4841449508">
     <owner>
       <name>admin</name>
     </owner>
     <comment/>
     <creation_time>2014-05-23T09:22:12Z</creation_time>
     <modification_time>2014-05-23T09:22:12Z</modification_time>
     <user_tags>
       <count>0</count>
     </user_tags>
     <host>127.0.1.1</host>
     <port>general/tcp</port>
     <nvt oid="1.3.6.1.4.1.25623.1.0.74">
       <name>Test NVT: fields with ISO-8859-1 chars</name>
       <cvss_base>5.0</cvss_base>
       <cve>CVE-2009-3095</cve>
       <bid>36254</bid>
       <tags>NOTAGS</tags>
       <cert/>
       <xref>NOXREF</xref>
     </nvt>
     <threat>Medium</threat>
     <description>Test with umlaut.</description>
   </result>
   ...
   <filters id="">
     <term>first=1 rows=-1 sort=name</term>
     <keywords>
       <keyword>
         <column>first</column>
         <relation>=</relation>
         <value>1</value>
       </keyword>
       ...
     </keywords>
   </filters>
   <sort>
     <field>
       name
       <order>ascending</order>
     </field>
   </sort>
   <results max="-1"
            start="1"/>
   <result_count>
     124
     <filtered>124</filtered>
     <page>124</page>
   </result_count>
 </get_results_response>

7.68.3 Example: Get a result, including notes and overrides

Client

 <get_results result_id="cac9e7c8-c726-49fd-a710-5f99079ab93e"
              task_id="40b236a9-2b0f-4813-b8c7-bc2b98d9d7e4"
              notes="1"
              overrides="1"/>

Manager

 <get_results_response status="200"
                       status_text="OK">
   <result id="cac9e7c8-c726-49fd-a710-5f99079ab93e">
     <owner>
       <name>admin</name>
     </owner>
     <comment/>
     <creation_time>2014-05-23T09:22:12Z</creation_time>
     <modification_time>2014-05-23T09:22:12Z</modification_time>
     <user_tags>
       <count>0</count>
     </user_tags>
     <host>127.0.0.1</host>
     <port>general/tcp</port>
     <nvt oid="1.3.6.1.4.1.25623.1.0.75">
       <name>Test NVT: long lines</name>
       <cvss_base>9</cvss_base>
       <cve>CVE-2009-3095</cve>
       <bid>36254</bid>
       <tags>NOTAGS</tags>
       <cert/>
       <xref>NOXREF</xref>
     </nvt>
     <threat>High</threat>
     <description>Test with very long warning.</description>
     <original_threat>Medium</original_threat>
     <notes/>
     <overrides>
       <override id="b0832812-75f1-45eb-b676-99c6e6bf2b24">
         <nvt oid="1.3.6.1.4.1.25623.1.0.75">
           <name>Test NVT: long lines</name>
         </nvt>
         <text excerpt="0">Test override</text>
         <new_threat>High</new_threat>
         <orphan>0</orphan>
       </override>
     </overrides>
   </result>
   <filters id="">
     <term>first=1 rows=-1 sort=name</term>
     <keywords>
       <keyword>
         <column>first</column>
         <relation>=</relation>
         <value>1</value>
       </keyword>
       ...
     </keywords>
   </filters>
   <sort>
     <field>
       name
       <order>ascending</order>
     </field>
   </sort>
   <results max="-1"
            start="1"/>
   <result_count>
     1
     <filtered>1</filtered>
     <page>1</page>
   </result_count>
 </get_results_response>

7.69 Command `get_roles`

In short: Get one or many roles.

The client uses the get_roles command to get role information.

7.69.1 Structure

Command
- @role_id (uuid) ID of single role to get.
- @filter (text) Filter term to use to filter query.
- @filt_id (uuid) ID of filter to use to filter query.
- @trash (boolean) Whether to get the trashcan roles instead.
Response
- @status (status)
- @status_text (text)
- <role> *
  - @id (uuid)
  - <owner>
    Owner of the role.
    - <name>
      The name of the owner.
  - <name>
    The name of the role.
  - <comment>
    The comment on the role.
  - <creation_time>
    Date and time the role was created.
  - <modification_time>
    Date and time the role was last modified.
  - <writable>
    Whether the role is writable.
  - <in_use>
    Whether the role is in use.
  - <permissions>
    Permissions that the current user has on the role.
    - <permission> *
      - <name>
        The name of the permission.
  - <user_tags>
    Info on tags attached to the role.
    - <count>
      Number of attached tags.
    - <tag> *
      Short info on an individual tag (only if details were requested).
      - @id (uuid) UUID of the tag.
      - <name>
        Name of the tag (usually namespace:predicate).
      - <value>
        Value of the tag.
      - <comment>
        Comment for the tag.
  - <users>
    A comma-separated list of the users who have this role.
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
- <sort>
  - <field>
    - <order>
- <roles>
  - @start (integer) First role.
  - @max (integer) Maximum number of roles.
- <role_count>
  - <filtered>
    Number of roles after filtering.
  - <page>
    Number of roles on current page.

7.69.2 RNC

Command

get_roles
 = element get_roles
     {
       attribute role_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute trash { boolean }?
     }

Response

get_roles_response
 = element get_roles_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_roles_response_role*
       & get_roles_response_filters
       & get_roles_response_sort
       & get_roles_response_roles
       & get_roles_response_role_count
     }

get_roles_response_role
 = element role
     {
       attribute id { uuid }
       & get_roles_response_role_owner
       & get_roles_response_role_name
       & get_roles_response_role_comment
       & get_roles_response_role_creation_time
       & get_roles_response_role_modification_time
       & get_roles_response_role_writable
       & get_roles_response_role_in_use
       & get_roles_response_role_permissions
       & get_roles_response_role_user_tags
       & get_roles_response_role_users
     }

get_roles_response_role_owner
 = element owner
     {
       get_roles_response_role_owner_name
     }

get_roles_response_role_owner_name
 = element name
     {
       name
     }

get_roles_response_role_name
 = element name
     {
       name
     }

get_roles_response_role_comment
 = element comment
     {
       text
     }

get_roles_response_role_creation_time
 = element creation_time
     {
       iso_time
     }

get_roles_response_role_modification_time
 = element modification_time
     {
       iso_time
     }

get_roles_response_role_users
 = element users
     {
       text
     }

get_roles_response_role_writable
 = element writable
     {
       boolean
     }

get_roles_response_role_in_use
 = element in_use
     {
       boolean
     }

get_roles_response_role_permissions
 = element permissions
     {
       get_roles_response_role_permissions_permission*
     }

get_roles_response_role_permissions_permission
 = element permission
     {
       get_roles_response_role_permissions_permission_name
     }

get_roles_response_role_permissions_permission_name
 = element name
     {
       name
     }

get_roles_response_role_user_tags
 = element user_tags
     {
       get_roles_response_role_user_tags_count
       & get_roles_response_role_user_tags_tag*
     }

get_roles_response_role_user_tags_count
 = element count
     {
       integer
     }

get_roles_response_role_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_roles_response_role_user_tags_tag_name
       & get_roles_response_role_user_tags_tag_value
       & get_roles_response_role_user_tags_tag_comment
     }

get_roles_response_role_user_tags_tag_name
 = element name
     {
       text
     }

get_roles_response_role_user_tags_tag_value
 = element value
     {
       text
     }

get_roles_response_role_user_tags_tag_comment
 = element comment
     {
       text
     }

get_roles_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_roles_response_filters_term
       & get_roles_response_filters_name?
       & get_roles_response_filters_keywords
     }

get_roles_response_filters_term
 = element term
     {
       text
     }

get_roles_response_filters_name
 = element name
     {
       text
     }

get_roles_response_filters_keywords
 = element keywords
     {
       get_roles_response_filters_keywords_keyword*
     }

get_roles_response_filters_keywords_keyword
 = element keyword
     {
       get_roles_response_filters_keywords_keyword_column
       & get_roles_response_filters_keywords_keyword_relation
       & get_roles_response_filters_keywords_keyword_value
     }

get_roles_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_roles_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_roles_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_roles_response_sort
 = element sort
     {
       text
       & get_roles_response_sort_field
     }

get_roles_response_sort_field
 = element field
     {
       get_roles_response_sort_field_order
     }

get_roles_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_roles_response_roles
 = element roles
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_roles_response_role_count
 = element role_count
     {
       get_roles_response_role_count_filtered
       & get_roles_response_role_count_page
     }

get_roles_response_role_count_filtered
 = element filtered
     {
       integer
     }

get_roles_response_role_count_page
 = element page
     {
       integer
     }

7.69.3 Example: Get one or many roles

Client

 <get_roles/>

Manager

 <get_roles_response status="200"
                     status_text="OK">
   <role id="b493b7a8-7489-11df-a3ec-002264764cea">
     <name>Management</name>
     <comment>Managers</comment>
     <creation_time>Sun Jun 27 08:49:43 2010</creation_time>
     <modification_time>Sun Jun 27 08:49:43 2010</modification_time>
     <writable>1</writable>
     <in_use>0</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <users>sarah, frank</users>
   </role>
   ...
   <filters id="">
     <term>first=1 rows=-1 sort=name</term>
     <keywords>
       <keyword>
         <column>first</column>
         <relation>=</relation>
         <value>1</value>
       </keyword>
       ...
     </keywords>
   </filters>
   <sort>
     <field>
       name
       <order>ascending</order>
     </field>
   </sort>
   <roles max="-1"
          start="1"/>
   <role_count>
     1
     <filtered>1</filtered>
     <page>1</page>
   </role_count>
 </get_roles_response>

7.70 Command `get_scanners`

In short: Get one or many scanners.

The client uses the get_scanners command to get scanner information.

7.70.1 Structure

Command
- @scanner_id (uuid) ID of single scanner to get.
- @filter (text) Filter term to use to filter query.
- @filt_id (uuid) ID of filter to use to filter query.
- @trash (boolean) Whether to get the trashcan scanners instead.
- @details (boolean) Whether to include extra details like tasks using this scanner.
Response
- @status (status)
- @status_text (text)
- <scanner> *
  - @id (uuid)
  - <owner>
    Owner of the scanner.
    - <name>
      The name of the owner.
  - <name>
    The name of the scanner.
  - <comment>
    The comment on the scanner.
  - <creation_time>
  - <modification_time>
  - <writable>
    Whether the scanner is writable.
  - <in_use>
    Whether any tasks are using the scanner.
  - <permissions>
    Permissions that the current user has on the scanner.
    - <permission> *
      - <name>
        The name of the permission.
  - <user_tags>
    Info on tags attached to the chedule.
    - <count>
      Number of attached tags.
    - <tag> *
      Short info on an individual tag (only if details were requested).
      - @id (uuid) UUID of the tag.
      - <name>
        Name of the tag (usually namespace:predicate).
      - <value>
        Value of the tag.
      - <comment>
        Comment for the tag.
  - <host>
    Host of the scanner.
  - <port>
    Port of the scanner.
  - <type>
    Type of the scanner.
  - <ca_pub>
    CA Certificate to verify the scanner's certificate.
  - <key_pub>
    Certificate of credentials to authenticate with.
  - <tasks> ?
    - <task> *
      - @id (uuid)
      - <name>
        The name of the task.
      - <permissions> ?
        Permissions the user has on the task.
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
- <sort>
  - <field>
    - <order>
- <scanners>
  - @start (integer) First scanner.
  - @max (integer) Maximum number of scanners.
- <scanner_count>
  - <filtered>
    Number of scanners after filtering.
  - <page>
    Number of scanners on current page.

7.70.2 RNC

Command

get_scanners
 = element get_scanners
     {
       attribute scanner_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute trash { boolean }?
       & attribute details { boolean }?
     }

Response

get_scanners_response
 = element get_scanners_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_scanners_response_scanner*
       & get_scanners_response_filters
       & get_scanners_response_sort
       & get_scanners_response_scanners
       & get_scanners_response_scanner_count
     }

get_scanners_response_scanner
 = element scanner
     {
       attribute id { uuid }
       & get_scanners_response_scanner_owner
       & get_scanners_response_scanner_name
       & get_scanners_response_scanner_comment
       & get_scanners_response_scanner_creation_time
       & get_scanners_response_scanner_modification_time
       & get_scanners_response_scanner_writable
       & get_scanners_response_scanner_in_use
       & get_scanners_response_scanner_permissions
       & get_scanners_response_scanner_user_tags
       & get_scanners_response_scanner_host
       & get_scanners_response_scanner_port
       & get_scanners_response_scanner_type
       & get_scanners_response_scanner_ca_pub
       & get_scanners_response_scanner_key_pub
       & get_scanners_response_scanner_tasks?
     }

get_scanners_response_scanner_owner
 = element owner
     {
       get_scanners_response_scanner_owner_name
     }

get_scanners_response_scanner_owner_name
 = element name
     {
       name
     }

get_scanners_response_scanner_name
 = element name
     {
       name
     }

get_scanners_response_scanner_comment
 = element comment
     {
       text
     }

get_scanners_response_scanner_creation_time
 = element creation_time
     {
       iso_time
     }

get_scanners_response_scanner_modification_time
 = element modification_time
     {
       iso_time
     }

get_scanners_response_scanner_writable
 = element writable
     {
       boolean
     }

get_scanners_response_scanner_in_use
 = element in_use
     {
       boolean
     }

get_scanners_response_scanner_permissions
 = element permissions
     {
       get_scanners_response_scanner_permissions_permission*
     }

get_scanners_response_scanner_permissions_permission
 = element permission
     {
       get_scanners_response_scanner_permissions_permission_name
     }

get_scanners_response_scanner_permissions_permission_name
 = element name
     {
       name
     }

get_scanners_response_scanner_user_tags
 = element user_tags
     {
       get_scanners_response_scanner_user_tags_count
       & get_scanners_response_scanner_user_tags_tag*
     }

get_scanners_response_scanner_user_tags_count
 = element count
     {
       integer
     }

get_scanners_response_scanner_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_scanners_response_scanner_user_tags_tag_name
       & get_scanners_response_scanner_user_tags_tag_value
       & get_scanners_response_scanner_user_tags_tag_comment
     }

get_scanners_response_scanner_user_tags_tag_name
 = element name
     {
       text
     }

get_scanners_response_scanner_user_tags_tag_value
 = element value
     {
       text
     }

get_scanners_response_scanner_user_tags_tag_comment
 = element comment
     {
       text
     }

get_scanners_response_scanner_host
 = element host
     {
       text
     }

get_scanners_response_scanner_port
 = element port
     {
       text
     }

get_scanners_response_scanner_type
 = element type
     {
       text
     }

get_scanners_response_scanner_ca_pub
 = element ca_pub
     {
       text
     }

get_scanners_response_scanner_key_pub
 = element key_pub
     {
       text
     }

get_scanners_response_scanner_tasks
 = element tasks
     {
       get_scanners_response_scanner_tasks_task*
     }

get_scanners_response_scanner_tasks_task
 = element task
     {
       attribute id { uuid }
       & get_scanners_response_scanner_tasks_task_name
       & get_scanners_response_scanner_tasks_task_permissions?
     }

get_scanners_response_scanner_tasks_task_name
 = element name
     {
       name
     }

get_scanners_response_scanner_tasks_task_permissions
 = element permissions
     {
       ""
     }

get_scanners_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_scanners_response_filters_term
       & get_scanners_response_filters_name?
       & get_scanners_response_filters_keywords
     }

get_scanners_response_filters_term
 = element term
     {
       text
     }

get_scanners_response_filters_name
 = element name
     {
       text
     }

get_scanners_response_filters_keywords
 = element keywords
     {
       get_scanners_response_filters_keywords_keyword*
     }

get_scanners_response_filters_keywords_keyword
 = element keyword
     {
       get_scanners_response_filters_keywords_keyword_column
       & get_scanners_response_filters_keywords_keyword_relation
       & get_scanners_response_filters_keywords_keyword_value
     }

get_scanners_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_scanners_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_scanners_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_scanners_response_sort
 = element sort
     {
       text
       & get_scanners_response_sort_field
     }

get_scanners_response_sort_field
 = element field
     {
       get_scanners_response_sort_field_order
     }

get_scanners_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_scanners_response_scanners
 = element scanners
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_scanners_response_scanner_count
 = element scanner_count
     {
       get_scanners_response_scanner_count_filtered
       & get_scanners_response_scanner_count_page
     }

get_scanners_response_scanner_count_filtered
 = element filtered
     {
       integer
     }

get_scanners_response_scanner_count_page
 = element page
     {
       integer
     }

7.70.3 Example: Get full details of a single scanner

Client

 <get_scanners details="1"
               scanner_id="c33864a9-d3fd-44b3-8717-972bfb01dfcf"/>

Manager

 <get_scanners_response status="200"
                        status_text="OK">
   <scanner id="c33864a9-d3fd-44b3-8717-972bfb01dfcf">
     <name>Default Scanner</name>
     <comment/>
     <creation_time>2014-01-01T13:57:25+01:00</creation_time>
     <modification_time>2014-01-18T12:07:36+01:00</modification_time>
     <writable>0</writable>
     <in_use>1</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <host>localhost</host>
     <port>9391</port>
     <type>2</type>
     <ca_pub>...</ca_pub>
     <key_pub>...</key_pub>
     <tasks>
       <task id="813864a9-d3fd-44b3-8717-972bfb01dfc0">
         <name>Debian desktops</name>
       </task>
       ...
     </tasks>
   </scanner>
   <truncate>...</truncate>
 </get_scanners_response>

7.71 Command `get_schedules`

In short: Get one or many schedules.

The client uses the get_schedules command to get schedule information.

7.71.1 Structure

Command
- @schedule_id (uuid) ID of single schedule to get.
- @filter (text) Filter term to use to filter query.
- @filt_id (uuid) ID of filter to use to filter query.
- @trash (boolean) Whether to get the trashcan schedules instead.
- @tasks (boolean) Whether to include tasks using the schedules.
Response
- @status (status)
- @status_text (text)
- <schedule> *
  - @id (uuid)
  - <owner>
    Owner of the schedule.
    - <name>
      The name of the owner.
  - <name>
    The name of the schedule.
  - <comment>
    The comment on the schedule.
  - <creation_time>
  - <modification_time>
  - <writable>
    Whether the schedule is writable.
  - <in_use>
    Whether any tasks are using the schedule.
  - <permissions>
    Permissions that the current user has on the schedule.
    - <permission> *
      - <name>
        The name of the permission.
  - <user_tags>
    Info on tags attached to the schedule.
    - <count>
      Number of attached tags.
    - <tag> *
      Short info on an individual tag (only if details were requested).
      - @id (uuid) UUID of the tag.
      - <name>
        Name of the tag (usually namespace:predicate).
      - <value>
        Value of the tag.
      - <comment>
        Comment for the tag.
  - <first_time>
    First time the task ran or will run.
  - <next_time>
    The next time the task will run.
  - <timezone>
    The timezone that the schedule follows.
  - <timezone_abbrev>
    The abbreviated name of the timezone.
  - <period>
    How often the task will run, in seconds.
  - <period_months>
    How often the task will run, months portion.
  - <simple_period>
    Simple representation of period, if available.
    - <unit> ?
  - <duration>
    How long the task will run for (0 for entire task).
  - <simple_duration>
    Simple representation of duration, if available.
    - <unit> ?
  - <tasks> ?
    - <task> *
      - @id (uuid)
      - <name>
        The name of the task.
      - <permissions> ?
        Permissions the user has on the task.
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
- <sort>
  - <field>
    - <order>
- <schedules>
  - @start (integer) First schedule.
  - @max (integer) Maximum number of schedules.
- <schedule_count>
  - <filtered>
    Number of schedules after filtering.
  - <page>
    Number of schedules on current page.

7.71.2 RNC

Command

get_schedules
 = element get_schedules
     {
       attribute schedule_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute trash { boolean }?
       & attribute tasks { boolean }?
     }

Response

get_schedules_response
 = element get_schedules_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_schedules_response_schedule*
       & get_schedules_response_filters
       & get_schedules_response_sort
       & get_schedules_response_schedules
       & get_schedules_response_schedule_count
     }

get_schedules_response_schedule
 = element schedule
     {
       attribute id { uuid }
       & get_schedules_response_schedule_owner
       & get_schedules_response_schedule_name
       & get_schedules_response_schedule_comment
       & get_schedules_response_schedule_creation_time
       & get_schedules_response_schedule_modification_time
       & get_schedules_response_schedule_writable
       & get_schedules_response_schedule_in_use
       & get_schedules_response_schedule_permissions
       & get_schedules_response_schedule_user_tags
       & get_schedules_response_schedule_first_time
       & get_schedules_response_schedule_next_time
       & get_schedules_response_schedule_timezone
       & get_schedules_response_schedule_timezone_abbrev
       & get_schedules_response_schedule_period
       & get_schedules_response_schedule_period_months
       & get_schedules_response_schedule_simple_period
       & get_schedules_response_schedule_duration
       & get_schedules_response_schedule_simple_duration
       & get_schedules_response_schedule_tasks?
     }

get_schedules_response_schedule_owner
 = element owner
     {
       get_schedules_response_schedule_owner_name
     }

get_schedules_response_schedule_owner_name
 = element name
     {
       name
     }

get_schedules_response_schedule_name
 = element name
     {
       name
     }

get_schedules_response_schedule_comment
 = element comment
     {
       text
     }

get_schedules_response_schedule_creation_time
 = element creation_time
     {
       iso_time
     }

get_schedules_response_schedule_modification_time
 = element modification_time
     {
       iso_time
     }

get_schedules_response_schedule_writable
 = element writable
     {
       boolean
     }

get_schedules_response_schedule_in_use
 = element in_use
     {
       boolean
     }

get_schedules_response_schedule_permissions
 = element permissions
     {
       get_schedules_response_schedule_permissions_permission*
     }

get_schedules_response_schedule_permissions_permission
 = element permission
     {
       get_schedules_response_schedule_permissions_permission_name
     }

get_schedules_response_schedule_permissions_permission_name
 = element name
     {
       name
     }

get_schedules_response_schedule_user_tags
 = element user_tags
     {
       get_schedules_response_schedule_user_tags_count
       & get_schedules_response_schedule_user_tags_tag*
     }

get_schedules_response_schedule_user_tags_count
 = element count
     {
       integer
     }

get_schedules_response_schedule_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_schedules_response_schedule_user_tags_tag_name
       & get_schedules_response_schedule_user_tags_tag_value
       & get_schedules_response_schedule_user_tags_tag_comment
     }

get_schedules_response_schedule_user_tags_tag_name
 = element name
     {
       text
     }

get_schedules_response_schedule_user_tags_tag_value
 = element value
     {
       text
     }

get_schedules_response_schedule_user_tags_tag_comment
 = element comment
     {
       text
     }

get_schedules_response_schedule_first_time
 = element first_time
     {
       iso_time
     }

get_schedules_response_schedule_next_time
 = element next_time
     {
       iso_time
     }

get_schedules_response_schedule_timezone
 = element timezone
     {
       timezone
     }

get_schedules_response_schedule_timezone_abbrev
 = element timezone_abbrev
     {
       text
     }

get_schedules_response_schedule_period
 = element period
     {
       integer
     }

get_schedules_response_schedule_period_months
 = element period_months
     {
       integer
     }

get_schedules_response_schedule_simple_period
 = element simple_period
     {
       text
       & get_schedules_response_schedule_simple_period_unit?
     }

get_schedules_response_schedule_simple_period_unit
 = element unit
     {
       time_unit
     }

get_schedules_response_schedule_duration
 = element duration
     {
       integer
     }

get_schedules_response_schedule_simple_duration
 = element simple_duration
     {
       text
       & get_schedules_response_schedule_simple_duration_unit?
     }

get_schedules_response_schedule_simple_duration_unit
 = element unit
     {
       time_unit
     }

get_schedules_response_schedule_tasks
 = element tasks
     {
       get_schedules_response_schedule_tasks_task*
     }

get_schedules_response_schedule_tasks_task
 = element task
     {
       attribute id { uuid }
       & get_schedules_response_schedule_tasks_task_name
       & get_schedules_response_schedule_tasks_task_permissions?
     }

get_schedules_response_schedule_tasks_task_name
 = element name
     {
       name
     }

get_schedules_response_schedule_tasks_task_permissions
 = element permissions
     {
       ""
     }

get_schedules_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_schedules_response_filters_term
       & get_schedules_response_filters_name?
       & get_schedules_response_filters_keywords
     }

get_schedules_response_filters_term
 = element term
     {
       text
     }

get_schedules_response_filters_name
 = element name
     {
       text
     }

get_schedules_response_filters_keywords
 = element keywords
     {
       get_schedules_response_filters_keywords_keyword*
     }

get_schedules_response_filters_keywords_keyword
 = element keyword
     {
       get_schedules_response_filters_keywords_keyword_column
       & get_schedules_response_filters_keywords_keyword_relation
       & get_schedules_response_filters_keywords_keyword_value
     }

get_schedules_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_schedules_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_schedules_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_schedules_response_sort
 = element sort
     {
       text
       & get_schedules_response_sort_field
     }

get_schedules_response_sort_field
 = element field
     {
       get_schedules_response_sort_field_order
     }

get_schedules_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_schedules_response_schedules
 = element schedules
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_schedules_response_schedule_count
 = element schedule_count
     {
       get_schedules_response_schedule_count_filtered
       & get_schedules_response_schedule_count_page
     }

get_schedules_response_schedule_count_filtered
 = element filtered
     {
       integer
     }

get_schedules_response_schedule_count_page
 = element page
     {
       integer
     }

7.71.3 Example: Get full details of a single schedule

Client

 <get_schedules schedule_id="c33864a9-d3fd-44b3-8717-972bfb01dfcf"/>

Manager

 <get_schedules_response status="200"
                         status_text="OK">
   <schedule id="c33864a9-d3fd-44b3-8717-972bfb01dfcf">
     <name>Overnight</name>
     <comment>3 hours, starting at 12h00.</comment>
     <creation_time>2013-01-01T13:57:25+01:00</creation_time>
     <modification_time>2013-01-18T12:07:36+01:00</modification_time>
     <writable>0</writable>
     <in_use>1</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <first_time>Tue Jun 29 00:00:00 2010</first_time>
     <next_time>Tue Jun 29 00:00:00 2010</next_time>
     <period>86400</period>
     <period_months>0</period_months>
     <simple_period>
       1
       <unit>day</unit>
     </simple_period>
     <duration>10800</duration>
     <simple_duration>
       3
       <unit>hour</unit>
     </simple_duration>
     <timezone>Europe/Berlin</timezone>
     <timezone_abbrev>CEST</timezone_abbrev>
     <tasks>
       <task id="d4daf4c4-25c7-40ac-87d3-38e489f34330">
         <name>Task 1</name>
       </task>
     </tasks>
   </schedule>
   <truncate>...</truncate>
 </get_schedules_response>

7.72 Command `get_settings`

In short: Get one or many settings.

The client uses the get_settings command to get the settings.

7.72.1 Structure

Command
- @setting_id (uuid) ID of single setting to get.
- @filter (text) Filter term.
- @first (integer) First result.
- @max (integer) Maximum number of results in response.
- @sort_order (sort_order)
- @sort_field (text)
Response
- @status (status)
- @status_text (text)
- <filters>
  - <term>
    Filter term.
- <settings>
  - @start (integer) First setting.
  - @max (integer) Maximum number of settings.
- <setting> *
  - <name>
  - <comment>
  - <value>
- <setting_count>
  - <filtered>
    Number of settings after filtering.
  - <page>
    Number of settings on current page.

7.72.2 RNC

Command

get_settings
 = element get_settings
     {
       attribute setting_id { uuid }?
       & attribute filter { text }?
       & attribute first { integer }?
       & attribute max { integer }?
       & attribute sort_order { sort_order }?
       & attribute sort_field { text }?
     }

Response

get_settings_response
 = element get_settings_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_settings_response_filters
       & get_settings_response_settings
       & get_settings_response_setting*
       & get_settings_response_setting_count
     }

get_settings_response_filters
 = element filters
     {
       get_settings_response_filters_term
     }

get_settings_response_filters_term
 = element term
     {
       text
     }

get_settings_response_settings
 = element settings
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_settings_response_setting
 = element setting
     {
       get_settings_response_setting_name
       & get_settings_response_setting_comment
       & get_settings_response_setting_value
     }

get_settings_response_setting_name
 = element name
     {
       text
     }

get_settings_response_setting_comment
 = element comment
     {
       text
     }

get_settings_response_setting_value
 = element value
     {
       text
     }

get_settings_response_setting_count
 = element setting_count
     {
       get_settings_response_setting_count_filtered
       & get_settings_response_setting_count_page
     }

get_settings_response_setting_count_filtered
 = element filtered
     {
       integer
     }

get_settings_response_setting_count_page
 = element page
     {
       integer
     }

7.72.3 Example: Get one or many settings

Client

 <get_settings/>

Manager

 <get_settings_response status="200"
                        status_text="OK">
   <settings>
     <setting id="5f5a8712-8017-11e1-8556-406186ea4fc5">
       <name>Rows Per Page</name>
       <value>15</value>
     </setting>
   </settings>
 </get_settings_response>

7.73 Command `get_slaves`

In short: Get one or many slaves.

The client uses the get_slaves command to get slave information.

7.73.1 Structure

Command
- @slave_id (uuid) ID of single slave to get.
- @filter (text) Filter term to use to filter query.
- @filt_id (uuid) ID of filter to use to filter query.
- @trash (boolean) Whether to get the trashcan slaves instead.
- @tasks (boolean) Whether to include a list of tasks using the slave.
Response
- @status (status)
- @status_text (text)
- <slave> *
  - @id (uuid)
  - <owner>
    Owner of the slave.
    - <name>
      The name of the owner.
  - <name>
    The name of the slave.
  - <comment>
    The comment on the slave.
  - <creation_time>
  - <modification_time>
  - <writable>
    Whether the slave is writable.
  - <in_use>
    Whether any slaves are using the slave.
  - <permissions>
    Permissions that the current user has on the slave.
    - <permission> *
      - <name>
        The name of the permission.
  - <user_tags>
    Info on tags attached to the slave.
    - <count>
      Number of attached tags.
    - <tag> *
      Short info on an individual tag (only if details were requested).
      - @id (uuid) UUID of the tag.
      - <name>
        Name of the tag (usually namespace:predicate).
      - <value>
        Value of the tag.
      - <comment>
        Comment for the tag.
  - <host>
    The host that the slave Manager is running on.
  - <port>
    The port that the slave Manager is serving on the host.
  - <login>
    Login name on the slave Manager.
  - <tasks> ?
    - <task> *
      - @id (uuid)
      - <name>
        The name of the task.
      - <permissions> ?
        Permissions the user has on the task.
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
- <sort>
  - <field>
    - <order>
- <slaves>
  - @start (integer) First slave.
  - @max (integer) Maximum number of slaves.
- <slave_count>
  - <filtered>
    Number of slaves after filtering.
  - <page>
    Number of slaves on current page.

7.73.2 RNC

Command

get_slaves
 = element get_slaves
     {
       attribute slave_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute trash { boolean }?
       & attribute tasks { boolean }?
     }

Response

get_slaves_response
 = element get_slaves_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_slaves_response_slave*
       & get_slaves_response_filters
       & get_slaves_response_sort
       & get_slaves_response_slaves
       & get_slaves_response_slave_count
     }

get_slaves_response_slave
 = element slave
     {
       attribute id { uuid }
       & get_slaves_response_slave_owner
       & get_slaves_response_slave_name
       & get_slaves_response_slave_comment
       & get_slaves_response_slave_creation_time
       & get_slaves_response_slave_modification_time
       & get_slaves_response_slave_writable
       & get_slaves_response_slave_in_use
       & get_slaves_response_slave_permissions
       & get_slaves_response_slave_user_tags
       & get_slaves_response_slave_host
       & get_slaves_response_slave_port
       & get_slaves_response_slave_login
       & get_slaves_response_slave_tasks?
     }

get_slaves_response_slave_owner
 = element owner
     {
       get_slaves_response_slave_owner_name
     }

get_slaves_response_slave_owner_name
 = element name
     {
       name
     }

get_slaves_response_slave_name
 = element name
     {
       name
     }

get_slaves_response_slave_comment
 = element comment
     {
       text
     }

get_slaves_response_slave_creation_time
 = element creation_time
     {
       iso_time
     }

get_slaves_response_slave_modification_time
 = element modification_time
     {
       iso_time
     }

get_slaves_response_slave_writable
 = element writable
     {
       boolean
     }

get_slaves_response_slave_in_use
 = element in_use
     {
       boolean
     }

get_slaves_response_slave_permissions
 = element permissions
     {
       get_slaves_response_slave_permissions_permission*
     }

get_slaves_response_slave_permissions_permission
 = element permission
     {
       get_slaves_response_slave_permissions_permission_name
     }

get_slaves_response_slave_permissions_permission_name
 = element name
     {
       name
     }

get_slaves_response_slave_user_tags
 = element user_tags
     {
       get_slaves_response_slave_user_tags_count
       & get_slaves_response_slave_user_tags_tag*
     }

get_slaves_response_slave_user_tags_count
 = element count
     {
       integer
     }

get_slaves_response_slave_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_slaves_response_slave_user_tags_tag_name
       & get_slaves_response_slave_user_tags_tag_value
       & get_slaves_response_slave_user_tags_tag_comment
     }

get_slaves_response_slave_user_tags_tag_name
 = element name
     {
       text
     }

get_slaves_response_slave_user_tags_tag_value
 = element value
     {
       text
     }

get_slaves_response_slave_user_tags_tag_comment
 = element comment
     {
       text
     }

get_slaves_response_slave_host
 = element host
     {
       text
     }

get_slaves_response_slave_port
 = element port
     {
       text
     }

get_slaves_response_slave_login
 = element login
     {
       text
     }

get_slaves_response_slave_tasks
 = element tasks
     {
       get_slaves_response_slave_tasks_task*
     }

get_slaves_response_slave_tasks_task
 = element task
     {
       attribute id { uuid }
       & get_slaves_response_slave_tasks_task_name
       & get_slaves_response_slave_tasks_task_permissions?
     }

get_slaves_response_slave_tasks_task_name
 = element name
     {
       name
     }

get_slaves_response_slave_tasks_task_permissions
 = element permissions
     {
       ""
     }

get_slaves_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_slaves_response_filters_term
       & get_slaves_response_filters_name?
       & get_slaves_response_filters_keywords
     }

get_slaves_response_filters_term
 = element term
     {
       text
     }

get_slaves_response_filters_name
 = element name
     {
       text
     }

get_slaves_response_filters_keywords
 = element keywords
     {
       get_slaves_response_filters_keywords_keyword*
     }

get_slaves_response_filters_keywords_keyword
 = element keyword
     {
       get_slaves_response_filters_keywords_keyword_column
       & get_slaves_response_filters_keywords_keyword_relation
       & get_slaves_response_filters_keywords_keyword_value
     }

get_slaves_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_slaves_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_slaves_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_slaves_response_sort
 = element sort
     {
       text
       & get_slaves_response_sort_field
     }

get_slaves_response_sort_field
 = element field
     {
       get_slaves_response_sort_field_order
     }

get_slaves_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_slaves_response_slaves
 = element slaves
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_slaves_response_slave_count
 = element slave_count
     {
       get_slaves_response_slave_count_filtered
       & get_slaves_response_slave_count_page
     }

get_slaves_response_slave_count_filtered
 = element filtered
     {
       integer
     }

get_slaves_response_slave_count_page
 = element page
     {
       integer
     }

7.73.3 Example: Get one or many slaves, including task lists

Client

 <get_slaves tasks="1"/>

Manager

 <get_slaves_response status="200"
                      status_text="OK">
   <slave id="c33864a9-d3fd-44b3-8717-972bfb01dfcf">
     <name>Bangkok</name>
     <comment>Manager in Bangkok department.</comment>
     <creation_time>2012-11-09T13:57:25+01:00</creation_time>
     <modification_time>2012-12-28T12:07:36+01:00</modification_time>
     <writable>1</writable>
     <in_use>0</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <host>192.0.32.10</host>
     <login>sally</login>
     <tasks>
       <task id="c33864a9-d3fd-44b3-8717-972bfb01dfc0">
         <name>Debian desktops</name>
       </task>
       ...
     </tasks>
   </slave>
   ...
 </get_slaves_response>

7.74 Command `get_system_reports`

In short: Get one or many system reports.

The client uses the get_system_reports command to get system reports.

7.74.1 Structure

Command
- @name (text) A string describing the required report.
- @duration (integer) The number of seconds into the past that the report should include.
- @brief (boolean) Whether to include the actual reports.
- @slave_id (uuid) Slave from which to get report.
Response
- @status (status)
- @status_text (text)
- <system_report> *
  - <name>
    The name of the system report.
  - <title>
    The title of the system report.
  - <report> ?
    - @format ("png" or "txt")
    - @duration (integer)

7.74.2 RNC

Command

get_system_reports
 = element get_system_reports
     {
       attribute name { text }?
       & attribute duration { integer }?
       & attribute brief { boolean }?
       & attribute slave_id { uuid }?
     }

Response

get_system_reports_response
 = element get_system_reports_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_system_reports_response_system_report*
     }

get_system_reports_response_system_report
 = element system_report
     {
       get_system_reports_response_system_report_name
       & get_system_reports_response_system_report_title
       & get_system_reports_response_system_report_report?
     }

get_system_reports_response_system_report_name
 = element name
     {
       name
     }

get_system_reports_response_system_report_title
 = element title
     {
       text
     }

get_system_reports_response_system_report_report
 = element report
     {
       text # RNC limitation: base64
       & attribute format { xsd:token { pattern = "png|txt" } }
       & attribute duration { integer }
     }

7.74.3 Example: Get listing of available system reports

Client

 <get_system_reports brief="1"/>

Manager

 <get_system_reports_response status="200"
                              status_text="OK">
   <system_report>
     <name>proc</name>
     <title>Processes</title>
   </system_report>
   <system_report>
     <name>load</name>
     <title>System Load</title>
   </system_report>
   <system_report>
     <name>cpu_0</name>
     <title>CPU Usage: CPU 0</title>
   </system_report>
   ...
 </get_system_reports_response>

7.74.3 Example: Get a system report

Client

 <get_system_reports name="proc"/>

Manager

 <get_system_reports_response status="200"
                              status_text="OK">
   <system_report>
     <name>proc</name>
     <title>Processes</title>
     <report format="png"
             duration="86400">
       iVBORw0KGgoAAAANSUhEUgAAArkAAAE...2bEdAAAAAElFTkSuQmCC
     </report>
   </system_report>
 </get_system_reports_response>

7.75 Command `get_tags`

In short: Get one or many tags.

The client uses the get_tags command to get tag information.

7.75.1 Structure

Command
- @tag_id (uuid) ID of single tag to get.
- @filter (text) Filter term to use to filter query.
- @filt_id (text) ID of filter to use to filter query.
- @trash (boolean) Whether to get tags from the trashcan instead.
- @names_only (boolean) Whether to get only distinct tag names.
Response
- @status (status)
- @status_text (text)
- <tag> *
  Information on a single tag.
  - @id (uuid) uuid of the tag (omitted when using names_only).
  - <name>
    Name of the tag (usually namespace:predicate).
  - The group?
    - <permissions>
      Permissions that the current user has on the tag.
      - <permission> *
        <name>
        The name of the permission.
    - <owner>
      Owner of the tag.
      - <name>
        The name of the owner.
    - <comment>
      Comment for the tag.
    - <creation_time>
      Date and time the tag was created.
    - <modification_time>
      Date and time the tag was last modified.
    - <writable>
      Whether the tag is writable.
    - <in_use>
      Whether any tasks are using the tag.
    - <resource>
      Identifies a resource the tag is attached to.
      - @id (uuid) ID of the resource the tag is attached to.
      - <type>
        OMP type of the resource the tag is attached to.
      - <name>
        Name of the attach resource if available, empty otherwise.
      - <trash>
        Whether the resource is in the trashcan.
      - <permissions> ?
        Permissions the user has on the resource.
    - <value>
      Value associated with the tag.
    - <active>
      Whether the tag is active.
    - <orphan>
      Whether the tag is attached to a nonexistent resource.
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
- <sort>
  - <field>
    - <order>
- <tags>
  - @start (integer) First tag.
  - @max (integer) Maximum number of tags.
- <tag_count>
  - <filtered>
    Number of tags after filtering.
  - <page>
    Number of tags on current page.

7.75.2 RNC

Command

get_tags
 = element get_tags
     {
       attribute tag_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { text }?
       & attribute trash { boolean }?
       & attribute names_only { boolean }?
     }

Response

get_tags_response
 = element get_tags_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_tags_response_tag*
       & get_tags_response_filters
       & get_tags_response_sort
       & get_tags_response_tags
       & get_tags_response_tag_count
     }

get_tags_response_tag
 = element tag
     {
       attribute id { uuid }?
       & get_tags_response_tag_name
       & ( get_tags_response_tag_permissions
           & get_tags_response_tag_owner
           & get_tags_response_tag_comment
           & get_tags_response_tag_creation_time
           & get_tags_response_tag_modification_time
           & get_tags_response_tag_writable
           & get_tags_response_tag_in_use
           & get_tags_response_tag_resource
           & get_tags_response_tag_value
           & get_tags_response_tag_active
           & get_tags_response_tag_orphan )?
     }

get_tags_response_tag_permissions
 = element permissions
     {
       get_tags_response_tag_permissions_permission*
     }

get_tags_response_tag_permissions_permission
 = element permission
     {
       get_tags_response_tag_permissions_permission_name
     }

get_tags_response_tag_permissions_permission_name
 = element name
     {
       name
     }

get_tags_response_tag_owner
 = element owner
     {
       get_tags_response_tag_owner_name
     }

get_tags_response_tag_owner_name
 = element name
     {
       name
     }

get_tags_response_tag_name
 = element name
     {
       text
     }

get_tags_response_tag_comment
 = element comment
     {
       text
     }

get_tags_response_tag_creation_time
 = element creation_time
     {
       iso_time
     }

get_tags_response_tag_modification_time
 = element modification_time
     {
       iso_time
     }

get_tags_response_tag_writable
 = element writable
     {
       boolean
     }

get_tags_response_tag_in_use
 = element in_use
     {
       boolean
     }

get_tags_response_tag_resource
 = element resource
     {
       attribute id { uuid }
       & get_tags_response_tag_resource_type
       & get_tags_response_tag_resource_name
       & get_tags_response_tag_resource_trash
       & get_tags_response_tag_resource_permissions?
     }

get_tags_response_tag_resource_type
 = element type
     {
       text
     }

get_tags_response_tag_resource_name
 = element name
     {
       text
     }

get_tags_response_tag_resource_trash
 = element trash
     {
       boolean
     }

get_tags_response_tag_resource_permissions
 = element permissions
     {
       ""
     }

get_tags_response_tag_value
 = element value
     {
       text
     }

get_tags_response_tag_active
 = element active
     {
       boolean
     }

get_tags_response_tag_orphan
 = element orphan
     {
       boolean
     }

get_tags_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_tags_response_filters_term
       & get_tags_response_filters_name?
       & get_tags_response_filters_keywords
     }

get_tags_response_filters_term
 = element term
     {
       text
     }

get_tags_response_filters_name
 = element name
     {
       text
     }

get_tags_response_filters_keywords
 = element keywords
     {
       get_tags_response_filters_keywords_keyword*
     }

get_tags_response_filters_keywords_keyword
 = element keyword
     {
       get_tags_response_filters_keywords_keyword_column
       & get_tags_response_filters_keywords_keyword_relation
       & get_tags_response_filters_keywords_keyword_value
     }

get_tags_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_tags_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_tags_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_tags_response_sort
 = element sort
     {
       text
       & get_tags_response_sort_field
     }

get_tags_response_sort_field
 = element field
     {
       get_tags_response_sort_field_order
     }

get_tags_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_tags_response_tags
 = element tags
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_tags_response_tag_count
 = element tag_count
     {
       get_tags_response_tag_count_filtered
       & get_tags_response_tag_count_page
     }

get_tags_response_tag_count_filtered
 = element filtered
     {
       integer
     }

get_tags_response_tag_count_page
 = element page
     {
       integer
     }

7.75.3 Example: Get one or many tags

Client

 <get_tags/>

Manager

 <get_tags_response status="200"
                    status_text="OK">
   <tag id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6">
     <name>geo:long</name>
     <comment/>
     <creation_time>Fri Apr 12 08:49:43 2013</creation_time>
     <modification_time>Fri Apr 12 08:49:43 2013</modification_time>
     <writable>1</writable>
     <in_use>0</in_use>
     <resource id="b493b7a8-7489-11df-a3ec-002264764cea">
       <type>target</type>
       <name>Server 1</name>
       <trash>0</trash>
     </resource>
     <value>52.2788</value>
     <active>1</active>
     <orphaned>0</orphaned>
   </tag>
   ...
 </get_tags_response>

7.76 Command `get_targets`

In short: Get one or many targets.

The client uses the get_targets command to get target information.

7.76.1 Structure

Command
- @target_id (uuid) ID of single target to get.
- @filter (text) Filter term to use to filter query.
- @filt_id (uuid) ID of filter to use to filter query.
- @trash (boolean) Whether to get the trashcan targets instead.
- @tasks (boolean) Whether to include list of tasks that use the target.
Response
- @status (status)
- @status_text (text)
- <target> *
  - @id (uuid)
  - <owner>
    Owner of the target.
    - <name>
      The name of the owner.
  - <name>
    The name of the target.
  - <comment>
    The comment on the target.
  - <creation_time>
    Date and time the target was created.
  - <modification_time>
    Date and time the target was last modified.
  - <writable>
    Whether the target is writable.
  - <in_use>
    Whether any tasks are using the target.
  - <permissions>
    Permissions that the current user has on the target.
    - <permission> *
      - <name>
        The name of the permission.
  - <user_tags>
    Info on tags attached to the target.
    - <count>
      Number of attached tags.
    - <tag> *
      Short info on an individual tag (only if details were requested).
      - @id (uuid) UUID of the tag.
      - <name>
        Name of the tag (usually namespace:predicate).
      - <value>
        Value of the tag.
      - <comment>
        Comment for the tag.
  - <hosts>
    A list of hosts.
  - <exclude_hosts>
    A list of hosts to exclude.
  - <max_hosts>
    The maximum number of hosts defined by the target.
  - <ssh_lsc_credential>
    - @id (uuid_or_empty)
    - <name>
      The name of the SSH LSC credential.
    - <permissions> ?
      Permissions the user has on the task.
    - <port>
      The port the LSCs will use.
    - <trash>
      Whether the LSC credential is in the trashcan.
  - <smb_lsc_credential>
    - @id (uuid_or_empty)
    - <name>
      The name of the SMB LSC credential.
    - <permissions> ?
      Permissions the user has on the task.
    - <trash>
      Whether the LSC credential is in the trashcan.
  - <esxi_lsc_credential>
    - @id (uuid_or_empty)
    - <name>
      The name of the ESXi LSC credential.
    - <permissions> ?
      Permissions the user has on the task.
    - <trash>
      Whether the LSC credential is in the trashcan.
  - <permissions>
    Permissions that the current user has on the target.
    - <permission> *
      - <name>
        The name of the permission.
  - <port_range>
    Port range of the target.
  - <port_list>
    - @id (uuid)
    - <name>
      The name of the port_list.
    - <permissions> ?
      Permissions the user has on the task.
    - <trash>
      Whether the port_list is in the trashcan.
  - <alive_tests>
    Which alive tests to use.
  - <reverse_lookup_only>
    Whether to scan only hosts that have names.
  - <reverse_lookup_unify>
    Whether to scan only one IP when multiple IPs have the same name.
  - <tasks> ?
    All tasks using the target.
    - <task> *
      - @id (uuid)
      - <name>
        The name of the task.
      - <permissions> ?
        Permissions the user has on the task.
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
- <sort>
  - <field>
    - <order>
- <targets>
  - @start (integer) First target.
  - @max (integer) Maximum number of targets.
- <target_count>
  - <filtered>
    Number of targets after filtering.
  - <page>
    Number of targets on current page.

7.76.2 RNC

Command

get_targets
 = element get_targets
     {
       attribute target_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute trash { boolean }?
       & attribute tasks { boolean }?
     }

Response

get_targets_response
 = element get_targets_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_targets_response_target*
       & get_targets_response_filters
       & get_targets_response_sort
       & get_targets_response_targets
       & get_targets_response_target_count
     }

get_targets_response_target
 = element target
     {
       attribute id { uuid }
       & get_targets_response_target_owner
       & get_targets_response_target_name
       & get_targets_response_target_comment
       & get_targets_response_target_creation_time
       & get_targets_response_target_modification_time
       & get_targets_response_target_writable
       & get_targets_response_target_in_use
       & get_targets_response_target_permissions
       & get_targets_response_target_user_tags
       & get_targets_response_target_hosts
       & get_targets_response_target_exclude_hosts
       & get_targets_response_target_max_hosts
       & get_targets_response_target_ssh_lsc_credential
       & get_targets_response_target_smb_lsc_credential
       & get_targets_response_target_esxi_lsc_credential
       & get_targets_response_target_permissions
       & get_targets_response_target_port_range
       & get_targets_response_target_port_list
       & get_targets_response_target_alive_tests
       & get_targets_response_target_reverse_lookup_only
       & get_targets_response_target_reverse_lookup_unify
       & get_targets_response_target_tasks?
     }

get_targets_response_target_owner
 = element owner
     {
       get_targets_response_target_owner_name
     }

get_targets_response_target_owner_name
 = element name
     {
       name
     }

get_targets_response_target_name
 = element name
     {
       name
     }

get_targets_response_target_comment
 = element comment
     {
       text
     }

get_targets_response_target_creation_time
 = element creation_time
     {
       iso_time
     }

get_targets_response_target_modification_time
 = element modification_time
     {
       iso_time
     }

get_targets_response_target_hosts
 = element hosts
     {
       text
     }

get_targets_response_target_exclude_hosts
 = element exclude_hosts
     {
       text
     }

get_targets_response_target_max_hosts
 = element max_hosts
     {
       integer
     }

get_targets_response_target_writable
 = element writable
     {
       boolean
     }

get_targets_response_target_in_use
 = element in_use
     {
       boolean
     }

get_targets_response_target_permissions
 = element permissions
     {
       get_targets_response_target_permissions_permission*
     }

get_targets_response_target_permissions_permission
 = element permission
     {
       get_targets_response_target_permissions_permission_name
     }

get_targets_response_target_permissions_permission_name
 = element name
     {
       name
     }

get_targets_response_target_user_tags
 = element user_tags
     {
       get_targets_response_target_user_tags_count
       & get_targets_response_target_user_tags_tag*
     }

get_targets_response_target_user_tags_count
 = element count
     {
       integer
     }

get_targets_response_target_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_targets_response_target_user_tags_tag_name
       & get_targets_response_target_user_tags_tag_value
       & get_targets_response_target_user_tags_tag_comment
     }

get_targets_response_target_user_tags_tag_name
 = element name
     {
       text
     }

get_targets_response_target_user_tags_tag_value
 = element value
     {
       text
     }

get_targets_response_target_user_tags_tag_comment
 = element comment
     {
       text
     }

get_targets_response_target_ssh_lsc_credential
 = element ssh_lsc_credential
     {
       attribute id { uuid_or_empty }
       & get_targets_response_target_ssh_lsc_credential_name
       & get_targets_response_target_ssh_lsc_credential_permissions?
       & get_targets_response_target_ssh_lsc_credential_port
       & get_targets_response_target_ssh_lsc_credential_trash
     }

get_targets_response_target_ssh_lsc_credential_name
 = element name
     {
       name
     }

get_targets_response_target_ssh_lsc_credential_permissions
 = element permissions
     {
       ""
     }

get_targets_response_target_ssh_lsc_credential_port
 = element port
     {
       text
     }

get_targets_response_target_ssh_lsc_credential_trash
 = element trash
     {
       boolean
     }

get_targets_response_target_smb_lsc_credential
 = element smb_lsc_credential
     {
       attribute id { uuid_or_empty }
       & get_targets_response_target_smb_lsc_credential_name
       & get_targets_response_target_smb_lsc_credential_permissions?
       & get_targets_response_target_smb_lsc_credential_trash
     }

get_targets_response_target_smb_lsc_credential_name
 = element name
     {
       name
     }

get_targets_response_target_smb_lsc_credential_permissions
 = element permissions
     {
       ""
     }

get_targets_response_target_smb_lsc_credential_trash
 = element trash
     {
       boolean
     }

get_targets_response_target_esxi_lsc_credential
 = element esxi_lsc_credential
     {
       attribute id { uuid_or_empty }
       & get_targets_response_target_esxi_lsc_credential_name
       & get_targets_response_target_esxi_lsc_credential_permissions?
       & get_targets_response_target_esxi_lsc_credential_trash
     }

get_targets_response_target_esxi_lsc_credential_name
 = element name
     {
       name
     }

get_targets_response_target_esxi_lsc_credential_permissions
 = element permissions
     {
       ""
     }

get_targets_response_target_esxi_lsc_credential_trash
 = element trash
     {
       boolean
     }

get_targets_response_target_port_range
 = element port_range
     {
       name
     }

get_targets_response_target_port_list
 = element port_list
     {
       attribute id { uuid }
       & get_targets_response_target_port_list_name
       & get_targets_response_target_port_list_permissions?
       & get_targets_response_target_port_list_trash
     }

get_targets_response_target_port_list_name
 = element name
     {
       name
     }

get_targets_response_target_port_list_permissions
 = element permissions
     {
       ""
     }

get_targets_response_target_port_list_trash
 = element trash
     {
       boolean
     }

get_targets_response_target_alive_tests
 = element alive_tests
     {
       alive_test
     }

get_targets_response_target_reverse_lookup_only
 = element reverse_lookup_only
     {
       boolean
     }

get_targets_response_target_reverse_lookup_unify
 = element reverse_lookup_unify
     {
       boolean
     }

get_targets_response_target_tasks
 = element tasks
     {
       get_targets_response_target_tasks_task*
     }

get_targets_response_target_tasks_task
 = element task
     {
       attribute id { uuid }
       & get_targets_response_target_tasks_task_name
       & get_targets_response_target_tasks_task_permissions?
     }

get_targets_response_target_tasks_task_name
 = element name
     {
       name
     }

get_targets_response_target_tasks_task_permissions
 = element permissions
     {
       ""
     }

get_targets_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_targets_response_filters_term
       & get_targets_response_filters_name?
       & get_targets_response_filters_keywords
     }

get_targets_response_filters_term
 = element term
     {
       text
     }

get_targets_response_filters_name
 = element name
     {
       text
     }

get_targets_response_filters_keywords
 = element keywords
     {
       get_targets_response_filters_keywords_keyword*
     }

get_targets_response_filters_keywords_keyword
 = element keyword
     {
       get_targets_response_filters_keywords_keyword_column
       & get_targets_response_filters_keywords_keyword_relation
       & get_targets_response_filters_keywords_keyword_value
     }

get_targets_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_targets_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_targets_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_targets_response_sort
 = element sort
     {
       text
       & get_targets_response_sort_field
     }

get_targets_response_sort_field
 = element field
     {
       get_targets_response_sort_field_order
     }

get_targets_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_targets_response_targets
 = element targets
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_targets_response_target_count
 = element target_count
     {
       get_targets_response_target_count_filtered
       & get_targets_response_target_count_page
     }

get_targets_response_target_count_filtered
 = element filtered
     {
       integer
     }

get_targets_response_target_count_page
 = element page
     {
       integer
     }

7.76.3 Example: Get one or many targets

Client

 <get_targets/>

Manager

 <get_targets_response status="200"
                       status_text="OK">
   <target id="b493b7a8-7489-11df-a3ec-002264764cea">
     <name>Localhost</name>
     <comment/>
     <creation_time>Sun Jun 27 08:49:43 2010</creation_time>
     <modification_time>Sun Jun 27 08:49:43 2010</modification_time>
     <writable>0</writable>
     <in_use>7</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <hosts>localhost</hosts>
     <max_hosts>1</max_hosts>
     <ssh_lsc_credential id="">
       <name/>
     </ssh_lsc_credential>
     <smb_lsc_credential id="">
       <name/>
     </smb_lsc_credential>
     <esxi_lsc_credential id="">
       <name/>
     </esxi_lsc_credential>
   </target>
   ...
 </get_targets_response>

7.76.3 Example: Get a single target, including tasks using the target

Client

 <get_targets target_id="1f28d970-17ef-4c69-ba8a-13827059f2b9"
              tasks="1"/>

Manager

 <get_targets_response status="200"
                       status_text="OK">
   <target id="1f28d970-17ef-4c69-ba8a-13827059f2b9">
     <name>dik</name>
     <comment>dik mm</comment>
     <creation_time>Sun Jun 27 08:49:43 2010</creation_time>
     <modification_time>Sun Jun 27 08:49:43 2010</modification_time>
     <writable>0</writable>
     <in_use>4</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <hosts>dik.example.org</hosts>
     <max_hosts>1</max_hosts>
     <ssh_lsc_credential id="58ff2793-2dc7-43fe-85f9-20bfac5a87e4">
       <name>mm</name>
     </ssh_lsc_credential>
     <smb_lsc_credential id="">
       <name/>
     </smb_lsc_credential>
     <esxi_lsc_credential id="">
       <name/>
     </esxi_lsc_credential>
     <tasks>
       <task id="13bb418a-4220-4575-b35b-ec398bff7417">
         <name>dik mm</name>
       </task>
       ...
     </tasks>
   </target>
 </get_targets_response>

7.77 Command `get_tasks`

In short: Get one or many tasks.

The client uses the get_tasks command to get task information.

As a convenience for clients the response includes a task count and the values of the sort order, sort field and apply overrides flag that the manager applied when selecting the tasks.

7.77.1 Structure

Command
- @task_id (uuid) ID of single task to get.
- @filter (text) Filter term to use to filter query.
- @filt_id (uuid) ID of filter to use to filter query.
- @trash (boolean) Whether to get the trashcan tasks instead.
- @details (boolean) Whether to include full task details.
Response
- @status (status)
- @status_text (text)
- <apply_overrides>
- <task> *
  - @id (uuid)
  - <owner>
    Owner of the task.
    - <name>
      The name of the owner.
  - <name>
    The name of the task.
  - <comment>
    The comment on the task.
  - <creation_time>
    Creation time of the task.
  - <modification_time>
    Last time the task was modified.
  - <writable>
    Whether the task is writable.
  - <in_use>
    Whether this task is currently in use.
  - <permissions>
    Permissions that the current user has on the task.
    - <permission> *
      - <name>
        The name of the permission.
  - <user_tags>
    Info on tags attached to the task.
    - <count>
      Number of attached tags.
    - <tag> *
      Short info on an individual tag (only if details were requested).
      - @id (uuid) UUID of the tag.
      - <name>
        Name of the tag (usually namespace:predicate).
      - <value>
        Value of the tag.
      - <comment>
        Comment for the tag.
  - <status>
    The run status of the task.
  - <progress>
    The percentage of the task that is complete.
    - <host_progress> *
      Percentage complete for a particular host.
      - <host>
  - <alterable>
    Whether the task is an Alterable Task.
  - <config>
    The scan configuration used by the task.
    - @id (uuid)
    - <name>
      The name of the config.
    - <permissions> ?
      Permissions the user has on the config.
    - <trash>
      Whether the config is in the trashcan.
  - <target>
    The hosts scanned by the task.
    - @id (uuid)
    - <name>
      The name of the target.
    - <permissions> ?
      Permissions the user has on the target.
    - <trash>
      Whether the target is in the trashcan.
  - <hosts_ordering>
    The order hosts are scanned in.
  - <scanner>
    The scanner used to scan the target.
    - @id (uuid)
    - <name>
      The name of the scanner.
    - <permissions> ?
      Permissions the user has on the task.
    - <type>
      Type of the scanner.
  - <alert>
    An alert that applies to the task.
    - @id (uuid_or_empty)
    - <name>
      The name of the alert.
    - <permissions> ?
      Permissions the user has on the alert.
    - <trash>
      Whether the alert is in the trashcan.
  - <observers>
    Users allowed to observe this task.
    - <group> *
      Group allowed to observe this task.
      - @id (uuid)
      - <name>
        The name of the group.
    - <role> *
      Role allowed to observe this task.
      - @id (uuid)
      - <name>
        The name of the role.
  - <schedule>
    When the task will run.
    - @id (uuid_or_empty)
    - <name>
      The name of the schedule.
    - <permissions> ?
      Permissions the user has on the schedule.
    - <trash>
      Whether the schedule is in the trashcan.
  - <schedule_periods>
    A limit to the number of times the task will be scheduled, or 0 for no limit.
  - <slave>
    The slave that the task will run on.
    - @id (uuid)
    - <name>
      The name of the slave.
    - <permissions> ?
      Permissions the user has on the slave.
    - <trash>
      Whether the slave is in the trashcan.
  - <report_count>
    Number of reports.
    - <finished>
      Number of reports where the scan completed.
  - <trend>
  - <current_report> ?
    - <report>
      - @id (uuid)
      - <timestamp>
  - <first_report> ?
    - <report>
      - @id (uuid)
      - <timestamp>
      - <scan_end>
      - <result_count>
        Result counts for this report.
        
        <debug>
        
        <false_positive>
        
        <log>
        
        <info>
        
        <warning>
        
        <hole>
      - <severity>
        Maximum severity of the report.
  - <last_report> ?
    - <report>
      - @id (uuid)
      - <timestamp>
      - <scan_end>
      - <result_count>
        Result counts for this report.
        
        <debug>
        
        <false_positive>
        
        <log>
        
        <info>
        
        <warning>
        
        <hole>
      - <severity>
        Maximum severity of the report.
  - <second_last_report> ?
    - <report>
      - @id (uuid)
      - <timestamp>
      - <scan_end>
      - <result_count>
        Result counts for this report.
        
        <debug>
        
        <false_positive>
        
        <log>
        
        <info>
        
        <warning>
        
        <hole>
      - <severity>
        Maximum severity of the report.
  - <reports> *
    - <report> *
      - @id (uuid)
      - <timestamp>
      - <scan_end>
      - <scan_run_status>
        Run status of task scan.
      - <result_count>
        Result counts for this report.
        
        <debug>
        
        <false_positive>
        
        <log>
        
        <info>
        
        <warning>
        
        <hole>
      - <severity>
        Maximum severity of the report.
  - <result_count>
    Result count for the entire task.
  - <preferences>
    - <preference> *
      - <name>
        Full name of preference, suitable for end users.
      - <scanner_name>
        Compact name of preference, from scanner.
      - <value>
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
- <sort>
  - <field>
    - <order>
- <tasks>
  - @start (integer) First task.
  - @max (integer) Maximum number of tasks.
- <task_count>
  - <filtered>
    Number of tasks after filtering.
  - <page>
    Number of tasks on current page.

7.77.2 RNC

Command

get_tasks
 = element get_tasks
     {
       attribute task_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
       & attribute trash { boolean }?
       & attribute details { boolean }?
     }

Response

get_tasks_response
 = element get_tasks_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_tasks_response_apply_overrides
       & get_tasks_response_task*
       & get_tasks_response_filters
       & get_tasks_response_sort
       & get_tasks_response_tasks
       & get_tasks_response_task_count
     }

get_tasks_response_apply_overrides
 = element apply_overrides
     {
       xsd:token { pattern = "0|1" }
     }

get_tasks_response_task
 = element task
     {
       attribute id { uuid }
       & get_tasks_response_task_owner
       & get_tasks_response_task_name
       & get_tasks_response_task_comment
       & get_tasks_response_task_creation_time
       & get_tasks_response_task_modification_time
       & get_tasks_response_task_writable
       & get_tasks_response_task_in_use
       & get_tasks_response_task_permissions
       & get_tasks_response_task_user_tags
       & get_tasks_response_task_status
       & get_tasks_response_task_progress
       & get_tasks_response_task_alterable
       & get_tasks_response_task_config
       & get_tasks_response_task_target
       & get_tasks_response_task_hosts_ordering
       & get_tasks_response_task_scanner
       & get_tasks_response_task_alert
       & get_tasks_response_task_observers
       & get_tasks_response_task_schedule
       & get_tasks_response_task_schedule_periods
       & get_tasks_response_task_slave
       & get_tasks_response_task_report_count
       & get_tasks_response_task_trend
       & get_tasks_response_task_current_report?
       & get_tasks_response_task_first_report?
       & get_tasks_response_task_last_report?
       & get_tasks_response_task_second_last_report?
       & get_tasks_response_task_reports*
       & get_tasks_response_task_result_count
       & get_tasks_response_task_preferences
     }

get_tasks_response_task_owner
 = element owner
     {
       get_tasks_response_task_owner_name
     }

get_tasks_response_task_owner_name
 = element name
     {
       name
     }

get_tasks_response_task_name
 = element name
     {
       name
     }

get_tasks_response_task_comment
 = element comment
     {
       text
     }

get_tasks_response_task_creation_time
 = element creation_time
     {
       iso_time
     }

get_tasks_response_task_modification_time
 = element modification_time
     {
       iso_time
     }

get_tasks_response_task_writable
 = element writable
     {
       boolean
     }

get_tasks_response_task_in_use
 = element in_use
     {
       boolean
     }

get_tasks_response_task_permissions
 = element permissions
     {
       get_tasks_response_task_permissions_permission*
     }

get_tasks_response_task_permissions_permission
 = element permission
     {
       get_tasks_response_task_permissions_permission_name
     }

get_tasks_response_task_permissions_permission_name
 = element name
     {
       name
     }

get_tasks_response_task_user_tags
 = element user_tags
     {
       get_tasks_response_task_user_tags_count
       & get_tasks_response_task_user_tags_tag*
     }

get_tasks_response_task_user_tags_count
 = element count
     {
       integer
     }

get_tasks_response_task_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_tasks_response_task_user_tags_tag_name
       & get_tasks_response_task_user_tags_tag_value
       & get_tasks_response_task_user_tags_tag_comment
     }

get_tasks_response_task_user_tags_tag_name
 = element name
     {
       text
     }

get_tasks_response_task_user_tags_tag_value
 = element value
     {
       text
     }

get_tasks_response_task_user_tags_tag_comment
 = element comment
     {
       text
     }

get_tasks_response_task_status
 = element status
     {
       task_status
     }

get_tasks_response_task_progress
 = element progress
     {
       text # RNC limitation: integer
       & get_tasks_response_task_progress_host_progress*
     }

get_tasks_response_task_progress_host_progress
 = element host_progress
     {
       text # RNC limitation: integer
       & get_tasks_response_task_progress_host_progress_host
     }

get_tasks_response_task_progress_host_progress_host
 = element host
     {
       text
     }

get_tasks_response_task_alterable
 = element alterable
     {
       boolean
     }

get_tasks_response_task_config
 = element config
     {
       attribute id { uuid }
       & get_tasks_response_task_config_name
       & get_tasks_response_task_config_permissions?
       & get_tasks_response_task_config_trash
     }

get_tasks_response_task_config_name
 = element name
     {
       name
     }

get_tasks_response_task_config_permissions
 = element permissions
     {
       ""
     }

get_tasks_response_task_config_trash
 = element trash
     {
       boolean
     }

get_tasks_response_task_target
 = element target
     {
       attribute id { uuid }
       & get_tasks_response_task_target_name
       & get_tasks_response_task_target_permissions?
       & get_tasks_response_task_target_trash
     }

get_tasks_response_task_target_name
 = element name
     {
       name
     }

get_tasks_response_task_target_permissions
 = element permissions
     {
       ""
     }

get_tasks_response_task_target_trash
 = element trash
     {
       boolean
     }

get_tasks_response_task_hosts_ordering
 = element hosts_ordering
     {
       text
     }

get_tasks_response_task_scanner
 = element scanner
     {
       attribute id { uuid }
       & get_tasks_response_task_scanner_name
       & get_tasks_response_task_scanner_permissions?
       & get_tasks_response_task_scanner_type
     }

get_tasks_response_task_scanner_name
 = element name
     {
       name
     }

get_tasks_response_task_scanner_type
 = element type
     {
       integer
     }

get_tasks_response_task_scanner_permissions
 = element permissions
     {
       ""
     }

get_tasks_response_task_alert
 = element alert
     {
       attribute id { uuid_or_empty }
       & get_tasks_response_task_alert_name
       & get_tasks_response_task_alert_permissions?
       & get_tasks_response_task_alert_trash
     }

get_tasks_response_task_alert_name
 = element name
     {
       name
     }

get_tasks_response_task_alert_permissions
 = element permissions
     {
       ""
     }

get_tasks_response_task_alert_trash
 = element trash
     {
       boolean
     }

get_tasks_response_task_observers
 = element observers
     {
       text # RNC limitation: user_list
       & get_tasks_response_task_observers_group*
       & get_tasks_response_task_observers_role*
     }

get_tasks_response_task_observers_group
 = element group
     {
       attribute id { uuid }
       & get_tasks_response_task_observers_group_name
     }

get_tasks_response_task_observers_group_name
 = element name
     {
       name
     }

get_tasks_response_task_observers_role
 = element role
     {
       attribute id { uuid }
       & get_tasks_response_task_observers_role_name
     }

get_tasks_response_task_observers_role_name
 = element name
     {
       name
     }

get_tasks_response_task_schedule
 = element schedule
     {
       attribute id { uuid_or_empty }
       & get_tasks_response_task_schedule_name
       & get_tasks_response_task_schedule_permissions?
       & get_tasks_response_task_schedule_trash
     }

get_tasks_response_task_schedule_name
 = element name
     {
       name
     }

get_tasks_response_task_schedule_permissions
 = element permissions
     {
       ""
     }

get_tasks_response_task_schedule_trash
 = element trash
     {
       boolean
     }

get_tasks_response_task_schedule_periods
 = element schedule_periods
     {
       integer
     }

get_tasks_response_task_slave
 = element slave
     {
       attribute id { uuid }
       & get_tasks_response_task_slave_name
       & get_tasks_response_task_slave_permissions?
       & get_tasks_response_task_slave_trash
     }

get_tasks_response_task_slave_name
 = element name
     {
       name
     }

get_tasks_response_task_slave_permissions
 = element permissions
     {
       ""
     }

get_tasks_response_task_slave_trash
 = element trash
     {
       boolean
     }

get_tasks_response_task_report_count
 = element report_count
     {
       text # RNC limitation: integer
       & get_tasks_response_task_report_count_finished
     }

get_tasks_response_task_report_count_finished
 = element finished
     {
       integer
     }

get_tasks_response_task_trend
 = element trend
     {
       task_trend
     }

get_tasks_response_task_current_report
 = element current_report
     {
       get_tasks_response_task_current_report_report
     }

get_tasks_response_task_current_report_report
 = element report
     {
       attribute id { uuid }
       & get_tasks_response_task_current_report_report_timestamp
     }

get_tasks_response_task_current_report_report_timestamp
 = element timestamp
     {
       iso_time
     }

get_tasks_response_task_first_report
 = element first_report
     {
       get_tasks_response_task_first_report_report
     }

get_tasks_response_task_first_report_report
 = element report
     {
       attribute id { uuid }
       & get_tasks_response_task_first_report_report_timestamp
       & get_tasks_response_task_first_report_report_scan_end
       & get_tasks_response_task_first_report_report_result_count
       & get_tasks_response_task_first_report_report_severity
     }

get_tasks_response_task_first_report_report_timestamp
 = element timestamp
     {
       iso_time
     }

get_tasks_response_task_first_report_report_scan_end
 = element scan_end
     {
       iso_time
     }

get_tasks_response_task_first_report_report_result_count
 = element result_count
     {
       get_tasks_response_task_first_report_report_result_count_debug
       & get_tasks_response_task_first_report_report_result_count_false_positive
       & get_tasks_response_task_first_report_report_result_count_log
       & get_tasks_response_task_first_report_report_result_count_info
       & get_tasks_response_task_first_report_report_result_count_warning
       & get_tasks_response_task_first_report_report_result_count_hole
     }

get_tasks_response_task_first_report_report_result_count_debug
 = element debug
     {
       integer
     }

get_tasks_response_task_first_report_report_result_count_false_positive
 = element false_positive
     {
       integer
     }

get_tasks_response_task_first_report_report_result_count_log
 = element log
     {
       integer
     }

get_tasks_response_task_first_report_report_result_count_info
 = element info
     {
       integer
     }

get_tasks_response_task_first_report_report_result_count_warning
 = element warning
     {
       integer
     }

get_tasks_response_task_first_report_report_result_count_hole
 = element hole
     {
       integer
     }

get_tasks_response_task_first_report_report_severity
 = element severity
     {
       severity
     }

get_tasks_response_task_last_report
 = element last_report
     {
       get_tasks_response_task_last_report_report
     }

get_tasks_response_task_last_report_report
 = element report
     {
       attribute id { uuid }
       & get_tasks_response_task_last_report_report_timestamp
       & get_tasks_response_task_last_report_report_scan_end
       & get_tasks_response_task_last_report_report_result_count
       & get_tasks_response_task_last_report_report_severity
     }

get_tasks_response_task_last_report_report_timestamp
 = element timestamp
     {
       iso_time
     }

get_tasks_response_task_last_report_report_scan_end
 = element scan_end
     {
       iso_time
     }

get_tasks_response_task_last_report_report_result_count
 = element result_count
     {
       get_tasks_response_task_last_report_report_result_count_debug
       & get_tasks_response_task_last_report_report_result_count_false_positive
       & get_tasks_response_task_last_report_report_result_count_log
       & get_tasks_response_task_last_report_report_result_count_info
       & get_tasks_response_task_last_report_report_result_count_warning
       & get_tasks_response_task_last_report_report_result_count_hole
     }

get_tasks_response_task_last_report_report_result_count_debug
 = element debug
     {
       integer
     }

get_tasks_response_task_last_report_report_result_count_false_positive
 = element false_positive
     {
       integer
     }

get_tasks_response_task_last_report_report_result_count_log
 = element log
     {
       integer
     }

get_tasks_response_task_last_report_report_result_count_info
 = element info
     {
       integer
     }

get_tasks_response_task_last_report_report_result_count_warning
 = element warning
     {
       integer
     }

get_tasks_response_task_last_report_report_result_count_hole
 = element hole
     {
       integer
     }

get_tasks_response_task_last_report_report_severity
 = element severity
     {
       severity
     }

get_tasks_response_task_second_last_report
 = element second_last_report
     {
       get_tasks_response_task_second_last_report_report
     }

get_tasks_response_task_second_last_report_report
 = element report
     {
       attribute id { uuid }
       & get_tasks_response_task_second_last_report_report_timestamp
       & get_tasks_response_task_second_last_report_report_scan_end
       & get_tasks_response_task_second_last_report_report_result_count
       & get_tasks_response_task_second_last_report_report_severity
     }

get_tasks_response_task_second_last_report_report_timestamp
 = element timestamp
     {
       iso_time
     }

get_tasks_response_task_second_last_report_report_scan_end
 = element scan_end
     {
       iso_time
     }

get_tasks_response_task_second_last_report_report_result_count
 = element result_count
     {
       get_tasks_response_task_second_last_report_report_result_count_debug
       & get_tasks_response_task_second_last_report_report_result_count_false_positive
       & get_tasks_response_task_second_last_report_report_result_count_log
       & get_tasks_response_task_second_last_report_report_result_count_info
       & get_tasks_response_task_second_last_report_report_result_count_warning
       & get_tasks_response_task_second_last_report_report_result_count_hole
     }

get_tasks_response_task_second_last_report_report_result_count_debug
 = element debug
     {
       integer
     }

get_tasks_response_task_second_last_report_report_result_count_false_positive
 = element false_positive
     {
       integer
     }

get_tasks_response_task_second_last_report_report_result_count_log
 = element log
     {
       integer
     }

get_tasks_response_task_second_last_report_report_result_count_info
 = element info
     {
       integer
     }

get_tasks_response_task_second_last_report_report_result_count_warning
 = element warning
     {
       integer
     }

get_tasks_response_task_second_last_report_report_result_count_hole
 = element hole
     {
       integer
     }

get_tasks_response_task_second_last_report_report_severity
 = element severity
     {
       severity
     }

get_tasks_response_task_reports
 = element reports
     {
       get_tasks_response_task_reports_report*
     }

get_tasks_response_task_reports_report
 = element report
     {
       attribute id { uuid }
       & get_tasks_response_task_reports_report_timestamp
       & get_tasks_response_task_reports_report_scan_end
       & get_tasks_response_task_reports_report_scan_run_status
       & get_tasks_response_task_reports_report_result_count
       & get_tasks_response_task_reports_report_severity
     }

get_tasks_response_task_reports_report_timestamp
 = element timestamp
     {
       iso_time
     }

get_tasks_response_task_reports_report_scan_end
 = element scan_end
     {
       iso_time
     }

get_tasks_response_task_reports_report_scan_run_status
 = element scan_run_status
     {
       task_status
     }

get_tasks_response_task_reports_report_result_count
 = element result_count
     {
       get_tasks_response_task_reports_report_result_count_debug
       & get_tasks_response_task_reports_report_result_count_false_positive
       & get_tasks_response_task_reports_report_result_count_log
       & get_tasks_response_task_reports_report_result_count_info
       & get_tasks_response_task_reports_report_result_count_warning
       & get_tasks_response_task_reports_report_result_count_hole
     }

get_tasks_response_task_reports_report_result_count_debug
 = element debug
     {
       integer
     }

get_tasks_response_task_reports_report_result_count_false_positive
 = element false_positive
     {
       integer
     }

get_tasks_response_task_reports_report_result_count_log
 = element log
     {
       integer
     }

get_tasks_response_task_reports_report_result_count_info
 = element info
     {
       integer
     }

get_tasks_response_task_reports_report_result_count_warning
 = element warning
     {
       integer
     }

get_tasks_response_task_reports_report_result_count_hole
 = element hole
     {
       integer
     }

get_tasks_response_task_reports_report_severity
 = element severity
     {
       severity
     }

get_tasks_response_task_result_count
 = element result_count
     {
       text
     }

get_tasks_response_task_preferences
 = element preferences
     {
       get_tasks_response_task_preferences_preference*
     }

get_tasks_response_task_preferences_preference
 = element preference
     {
       get_tasks_response_task_preferences_preference_name
       & get_tasks_response_task_preferences_preference_scanner_name
       & get_tasks_response_task_preferences_preference_value
     }

get_tasks_response_task_preferences_preference_name
 = element name
     {
       text
     }

get_tasks_response_task_preferences_preference_scanner_name
 = element scanner_name
     {
       text
     }

get_tasks_response_task_preferences_preference_value
 = element value
     {
       text
     }

get_tasks_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_tasks_response_filters_term
       & get_tasks_response_filters_name?
       & get_tasks_response_filters_keywords
     }

get_tasks_response_filters_term
 = element term
     {
       text
     }

get_tasks_response_filters_name
 = element name
     {
       text
     }

get_tasks_response_filters_keywords
 = element keywords
     {
       get_tasks_response_filters_keywords_keyword*
     }

get_tasks_response_filters_keywords_keyword
 = element keyword
     {
       get_tasks_response_filters_keywords_keyword_column
       & get_tasks_response_filters_keywords_keyword_relation
       & get_tasks_response_filters_keywords_keyword_value
     }

get_tasks_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_tasks_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_tasks_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_tasks_response_sort
 = element sort
     {
       text
       & get_tasks_response_sort_field
     }

get_tasks_response_sort_field
 = element field
     {
       get_tasks_response_sort_field_order
     }

get_tasks_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_tasks_response_tasks
 = element tasks
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_tasks_response_task_count
 = element task_count
     {
       get_tasks_response_task_count_filtered
       & get_tasks_response_task_count_page
     }

get_tasks_response_task_count_filtered
 = element filtered
     {
       integer
     }

get_tasks_response_task_count_page
 = element page
     {
       integer
     }

7.77.3 Example: Get one or many tasks

Client

 <get_tasks/>

Manager

 <get_tasks_response status="200"
                     status_text="OK">
   <apply_overrides>0</apply_overrides>
   <task id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6">
     <name>Scan Webserver</name>
     <comment>Scan of the web server.</comment>
     <creation_time>2013-01-03T13:50:03+01:00</creation_time>
     <modification_time>2013-01-11T16:03:24+01:00</modification_time>
     <writable>1</writable>
     <in_use>0</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <owner>
       <name>admin</name>
     </owner>
     <observers/>
     <alterable>0</alterable>
     <config id="daba56c8-73ec-11df-a475-002264764cea">
       <name>Full and fast</name>
     </config>
     <target id="1f28d970-17ef-4c69-ba8a-13827059f2b9">
       <name>dik</name>
     </target>
     <scanner id="34891919-37ff-5c69-1a2a-089e9018308a">
       <name>foo scanner</name>
       <type>2</type>
     </scanner>
     <slave id="">
       <name/>
     </slave>
     <status>Done</status>
     <progress>-1</progress>
     <report_count>
       2
       <finished>2</finished>
     </report_count>
     <trend/>
     <schedule id="">
       <name/>
       <next_time>over</next_time>
     </schedule>
     <first_report>
       <report id="f0fdf522-276d-4893-9274-fb8699dc2270">
         <timestamp>Mon Feb 1 19:11:20 2010</timestamp>
         <result_count>
           <debug>0</debug>
           <hole>0</hole>
           <info>7</info>
           <log>0</log>
           <warning>3</warning>
         </result_count>
         <severity>5.0</severity>
       </report>
     </first_report>
     <last_report>
       <report id="f0fdf522-276d-4893-9274-fb8699dc2270">
         <timestamp>Mon Feb 1 19:11:20 2010</timestamp>
         <result_count>
           <debug>0</debug>
           <hole>0</hole>
           <info>7</info>
           <log>0</log>
           <warning>3</warning>
         </result_count>
         <severity>5.0</severity>
       </report>
     </last_report>
     <second_last_report>
       <report id="f0fdf522-276d-4893-9274-fb8699dc2270">
         <timestamp>Mon Feb 1 19:11:20 2010</timestamp>
         <result_count>
           <debug>0</debug>
           <hole>0</hole>
           <info>7</info>
           <log>0</log>
           <warning>3</warning>
         </result_count>
         <severity>5.0</severity>
       </report>
     </second_last_report>
     <alert id="">
       <name/>
     </alert>
     <preferences>
       <preference>
         <name>Maximum concurrently executed NVTs per host</name>
         <scanner_name>max_checks</scanner_name>
         <value>4</value>
       </preference>
       <preference>
         <name>Maximum concurrently scanned hosts</name>
         <scanner_name>max_hosts</scanner_name>
         <value>20</value>
       </preference>
       <preference>
         <name>Add results to Asset Management</name>
         <scanner_name>in_assets</scanner_name>
         <value>yes</value>
       </preference>
     </preferences>
   </task>
   <task id="f14747d3-a4d7-4e79-99bb-a0a1276cb78c">
     <name>Scan Mailserver</name>
     ...
   </task>
 </get_tasks_response>

7.77.3 Example: Get a single task, including all reports

Client

 <get_tasks task_id="f14747d3-a4d7-4e79-99bb-a0a1276cb78c"
            details="1"/>

Manager

 <get_tasks_response status="200"
                     status_text="OK">
   <apply_overrides>0</apply_overrides>
   <task id="13bb418a-4220-4575-b35b-ec398bff7417">
     <name>Scan Mailserver</name>
     <comment>Scan of the web server.</comment>
     <creation_time>2013-01-03T13:50:03+01:00</creation_time>
     <modification_time>2013-01-11T16:03:24+01:00</modification_time>
     <writable>1</writable>
     <in_use>0</in_use>
     <user_tags>
       <count>0</count>
     </user_tags>
     <owner>
       <name>admin</name>
     </owner>
     <observers/>
     <alterable>1</alterable>
     <config id="daba56c8-73ec-11df-a475-002264764cea">
       <name>Full and fast</name>
     </config>
     <target id="1f28d970-17ef-4c69-ba8a-13827059f2b9">
       <name>dik</name>
     </target>
     <slave id="">
       <name/>
     </slave>
     <status>Done</status>
     <progress>-1</progress>
     <report_count>
       2
       <finished>2</finished>
     </report_count>
     <trend/>
     <schedule id="">
       <name/>
       <next_time>over</next_time>
     </schedule>
     <first_report>
       <report id="f0fdf522-276d-4893-9274-fb8699dc2270">
         <timestamp>Mon Feb 1 19:11:20 2010</timestamp>
         <result_count>
           <debug>0</debug>
           <hole>0</hole>
           <info>7</info>
           <log>0</log>
           <warning>3</warning>
         </result_count>
         <severity>5.0</severity>
       </report>
     </first_report>
     <last_report>
       <report id="2688e6c7-db29-4505-80f1-0fd4a09e1011">
         <timestamp>Mon Feb 1 19:11:20 2010</timestamp>
         <result_count>
           <debug>0</debug>
           <hole>0</hole>
           <info>7</info>
           <log>0</log>
           <warning>3</warning>
         </result_count>
         <severity>5.0</severity>
       </report>
     </last_report>
     <second_last_report>
       <report id="f0fdf522-276d-4893-9274-fb8699dc2270">
         <timestamp>Mon Feb 1 19:11:20 2010</timestamp>
         <result_count>
           <debug>0</debug>
           <hole>0</hole>
           <info>7</info>
           <log>0</log>
           <warning>3</warning>
         </result_count>
         <severity>5.0</severity>
       </report>
     </second_last_report>
     <alert id="">
       <name/>
     </alert>
     <reports>
       <report id="f0fdf522-276d-4893-9274-fb8699dc2270">
         <timestamp>Mon Feb 1 18:51:38 2010</timestamp>
         <scan_run_status>Done</scan_run_status>
         <result_count>
           <debug>0</debug>
           <hole>0</hole>
           <info>7</info>
           <log>0</log>
           <warning>3</warning>
         </result_count>
       </report>
       <report id="2688e6c7-db29-4505-80f1-0fd4a09e1011">
         <timestamp>Mon Feb 1 19:11:20 2010</timestamp>
         <scan_run_status>Done</scan_run_status>
         <result_count>
           <debug>0</debug>
           <hole>0</hole>
           <info>7</info>
           <log>0</log>
           <warning>3</warning>
         </result_count>
         <severity>5.0</severity>
       </report>
       <preferences>
         <preference>
           <name>Maximum concurrently executed NVTs per host</name>
           <scanner_name>max_checks</scanner_name>
           <value>4</value>
         </preference>
         <preference>
           <name>Maximum concurrently scanned hosts</name>
           <scanner_name>max_hosts</scanner_name>
           <value>20</value>
         </preference>
         <preference>
           <name>Add results to Asset Management</name>
           <scanner_name>in_assets</scanner_name>
           <value>yes</value>
         </preference>
       </preferences>
     </reports>
   </task>
   <filters id="0">
     <term/>
   </filters>
   <sort>
     <field>
       name
       <order>ascending</order>
     </field>
   </sort>
   <tasks max="-1"
          start="1"/>
   <task_count>
     3
     <filtered>1</filtered>
     <page>1</page>
   </task_count>
 </get_tasks_response>

7.78 Command `get_users`

In short: Get one or many users.

The client uses the "get_users" command to retrieve the list of user accounts on the Scanner.

7.78.1 Structure

Command
- @user_id (uuid) ID of single user to get.
- @filter (text) Filter term to use to filter query.
- @filt_id (uuid) ID of filter to use to filter query.
Response
- @status (status)
- @status_text (text)
- <user> *
  - @id (uuid) ID of user.
  - <owner>
    Owner of the user.
    - <name>
      The name of the owner.
  - <name>
    The name of the user.
  - <comment>
    The comment on the user.
  - <creation_time>
    Creation time of the user.
  - <modification_time>
    Last time the user was modified.
  - <writable>
    Whether the user is writable.
  - <in_use>
    Whether this user is currently in use.
  - <role> *
    The role of the user.
    - @id (uuid)
    - <name>
      Name of role.
    - <permissions> ?
      Permissions the user has on the role.
  - <groups>
    The groups the user belongs to.
    - <group>
      - @id (uuid)
      - <name>
        Name of group.
      - <permissions> ?
        Permissions the user has on the group.
  - <hosts>
    Host access rule for the user.
    - @allow ("0", "1", "2" or "3") 0 forbidden, 1 allowed, 2 all allowed, 3 custom.
  - <ifaces>
    Iface access rule for the user.
    - @allow ("0", "1", "2" or "3") 0 forbidden, 1 allowed, 2 all allowed, 3 custom.
  - <permissions>
    Permissions that the current user has on the user.
    - <permission> *
      - <name>
        The name of the permission.
  - <user_tags>
    Info on tags attached to the user.
    - <count>
      Number of attached tags.
    - <tag> *
      Short info on an individual tag (only if details were requested).
      - @id (uuid) UUID of the tag.
      - <name>
        Name of the tag (usually namespace:predicate).
      - <value>
        Value of the tag.
      - <comment>
        Comment for the tag.
  - <sources>
    (sources)
    
    Sources allowed for authentication for this user.
- <filters>
  - @id (uuid) UUID of filter if any, else 0.
  - <term>
    Filter term.
  - <name> ?
    Filter name, if applicable.
  - <keywords>
    Filter broken down into keywords.
    - <keyword> *
      - <column>
        Column prefix.
      - <relation>
        Relation operator.
      - <value>
        The filter text.
- <sort>
  - <field>
    - <order>
- <users>
  - @start (integer) First user.
  - @max (integer) Maximum number of users.
- <user_count>
  - <filtered>
    Number of users after filtering.
  - <page>
    Number of users on current page.

7.78.2 RNC

Command

get_users
 = element get_users
     {
       attribute user_id { uuid }?
       & attribute filter { text }?
       & attribute filt_id { uuid }?
     }

Response

get_users_response
 = element get_users_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_users_response_user*
       & get_users_response_filters
       & get_users_response_sort
       & get_users_response_users
       & get_users_response_user_count
     }

get_users_response_user
 = element user
     {
       attribute id { uuid }
       & get_users_response_user_owner
       & get_users_response_user_name
       & get_users_response_user_comment
       & get_users_response_user_creation_time
       & get_users_response_user_modification_time
       & get_users_response_user_writable
       & get_users_response_user_in_use
       & get_users_response_user_role*
       & get_users_response_user_groups
       & get_users_response_user_hosts
       & get_users_response_user_ifaces
       & get_users_response_user_permissions
       & get_users_response_user_user_tags
       & get_users_response_user_sources
     }

get_users_response_user_owner
 = element owner
     {
       get_users_response_user_owner_name
     }

get_users_response_user_owner_name
 = element name
     {
       name
     }

get_users_response_user_name
 = element name
     {
       text
     }

get_users_response_user_comment
 = element comment
     {
       text
     }

get_users_response_user_creation_time
 = element creation_time
     {
       iso_time
     }

get_users_response_user_modification_time
 = element modification_time
     {
       iso_time
     }

get_users_response_user_writable
 = element writable
     {
       boolean
     }

get_users_response_user_in_use
 = element in_use
     {
       boolean
     }

get_users_response_user_role
 = element role
     {
       attribute id { uuid }
       & get_users_response_user_role_name
       & get_users_response_user_role_permissions?
     }

get_users_response_user_role_name
 = element name
     {
       name
     }

get_users_response_user_role_permissions
 = element permissions
     {
       ""
     }

get_users_response_user_groups
 = element groups
     {
       get_users_response_user_groups_group
     }

get_users_response_user_groups_group
 = element group
     {
       attribute id { uuid }
       & get_users_response_user_groups_group_name
       & get_users_response_user_groups_group_permissions?
     }

get_users_response_user_groups_group_name
 = element name
     {
       name
     }

get_users_response_user_groups_group_permissions
 = element permissions
     {
       ""
     }

get_users_response_user_hosts
 = element hosts
     {
       text
       & attribute allow { xsd:token { pattern = "0|1|2|3" } }
     }

get_users_response_user_ifaces
 = element ifaces
     {
       text
       & attribute allow { xsd:token { pattern = "0|1|2|3" } }
     }

get_users_response_user_permissions
 = element permissions
     {
       get_users_response_user_permissions_permission*
     }

get_users_response_user_permissions_permission
 = element permission
     {
       get_users_response_user_permissions_permission_name
     }

get_users_response_user_permissions_permission_name
 = element name
     {
       name
     }

get_users_response_user_user_tags
 = element user_tags
     {
       get_users_response_user_user_tags_count
       & get_users_response_user_user_tags_tag*
     }

get_users_response_user_user_tags_count
 = element count
     {
       integer
     }

get_users_response_user_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_users_response_user_user_tags_tag_name
       & get_users_response_user_user_tags_tag_value
       & get_users_response_user_user_tags_tag_comment
     }

get_users_response_user_user_tags_tag_name
 = element name
     {
       text
     }

get_users_response_user_user_tags_tag_value
 = element value
     {
       text
     }

get_users_response_user_user_tags_tag_comment
 = element comment
     {
       text
     }

get_users_response_user_sources
 = element sources    # type sources
     {
     }

get_users_response_filters
 = element filters
     {
       attribute id { uuid }
       & get_users_response_filters_term
       & get_users_response_filters_name?
       & get_users_response_filters_keywords
     }

get_users_response_filters_term
 = element term
     {
       text
     }

get_users_response_filters_name
 = element name
     {
       text
     }

get_users_response_filters_keywords
 = element keywords
     {
       get_users_response_filters_keywords_keyword*
     }

get_users_response_filters_keywords_keyword
 = element keyword
     {
       get_users_response_filters_keywords_keyword_column
       & get_users_response_filters_keywords_keyword_relation
       & get_users_response_filters_keywords_keyword_value
     }

get_users_response_filters_keywords_keyword_column
 = element column
     {
       text
     }

get_users_response_filters_keywords_keyword_relation
 = element relation
     {
       
        ERROR
      
     }

get_users_response_filters_keywords_keyword_value
 = element value
     {
       text
     }

get_users_response_sort
 = element sort
     {
       text
       & get_users_response_sort_field
     }

get_users_response_sort_field
 = element field
     {
       get_users_response_sort_field_order
     }

get_users_response_sort_field_order
 = element order
     {
       xsd:token { pattern = "ascending|descending" }
     }

get_users_response_users
 = element users
     {
       attribute start { integer }
       & attribute max { integer }
     }

get_users_response_user_count
 = element user_count
     {
       get_users_response_user_count_filtered
       & get_users_response_user_count_page
     }

get_users_response_user_count_filtered
 = element filtered
     {
       integer
     }

get_users_response_user_count_page
 = element page
     {
       integer
     }

7.78.3 Example: Get the users

Client

 <get_users/>

Manager

 <get_users_response status="200"
                     status_text="OK">
   <user>
     <name>foobar</name>
     <role id="8d453140-b74d-11e2-b0be-406186ea4fc5">
       <name>User</name>
     </role>
     <hosts allow="2"/>
     <user_tags>
       <count>0</count>
     </user_tags>
     <sources>
       <source>file</source>
     </sources>
   </user>
 </get_users_response>

7.79 Command `get_version`

In short: Get the OpenVAS Manager Protocol version.

7.79.1 Structure

Command
Response
- @status (status)
- @status_text (text)
- <version>

7.79.2 RNC

Command

get_version
 = element get_version
     {
       ""
     }

Response

get_version_response
 = element get_version_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_version_response_version
     }

get_version_response_version
 = element version
     {
       text
     }

7.79.3 Example: Get the version

Client

 <get_version/>

Manager

 <get_version_response status="200"
                       status_text="OK">
   <version>1.0</version>
 </get_version_response>

7.80 Command `help`

In short: Get the help text.

7.80.1 Structure

Command
- @format ("html", "HTML", "rnc", "RNC", "text", "TEXT", "xml" or "XML") Required help format.
- @type ("brief" or "") Help type, currently only blank or "brief" for XML format.
Response
- @status (status)
- @status_text (text)
- <schema> ?
  - <protocol>
    - @format (text) The help format.
    - @extension (text) The suggested file extension for the help.
    - @content_type (text) The MIME content-type of the help.
    - <name>
      The full name of the protocol.
    - <abbreviation> ?
      The abbreviated name of the protocol.
    - <summary> ?
      A summary of the protocol.
    - <version> ?
      The version number of the protocol.
    - <type> *
      A data type.
      - <name>
        The name of the data type.
      - <summary> ?
        A summary of the data type.
      - <description> ?
        A description of the data type.
        
        <p> *
        A paragraph.
      - <pattern>
        The RNC pattern for the data type.
    - <command> *
      (command_definition)
      
      A command.

7.80.2 RNC

Command

help
 = element help
     {
       attribute format { xsd:token { pattern = "html|HTML|rnc|RNC|text|TEXT|xml|XML" } }?
       & attribute type { xsd:token { pattern = "brief|" } }?
     }

Response

help_response
 = element help_response
     {
       text
       & attribute status { status }
       & attribute status_text { text }
       & help_response_schema?
     }

help_response_schema
 = element schema
     {
       help_response_schema_protocol
     }

help_response_schema_protocol
 = element protocol
     {
       attribute format { text }?
       & attribute extension { text }?
       & attribute content_type { text }?
       & help_response_schema_protocol_name
       & help_response_schema_protocol_abbreviation?
       & help_response_schema_protocol_summary?
       & help_response_schema_protocol_version?
       & help_response_schema_protocol_type*
       & help_response_schema_protocol_command*
     }

help_response_schema_protocol_name
 = element name
     {
       text
     }

help_response_schema_protocol_abbreviation
 = element abbreviation
     {
       text
     }

help_response_schema_protocol_summary
 = element summary
     {
       text
     }

help_response_schema_protocol_version
 = element version
     {
       text
     }

help_response_schema_protocol_type
 = element type
     {
       help_response_schema_protocol_type_name
       & help_response_schema_protocol_type_summary?
       & help_response_schema_protocol_type_description?
       & help_response_schema_protocol_type_pattern
     }

help_response_schema_protocol_type_name
 = element name
     {
       type_name
     }

help_response_schema_protocol_type_summary
 = element summary
     {
       text
     }

help_response_schema_protocol_type_description
 = element description
     {
       text
       & help_response_schema_protocol_type_description_p*
     }

help_response_schema_protocol_type_description_p
 = element p
     {
       text
     }

help_response_schema_protocol_type_pattern
 = element pattern
     {
       text
     }

help_response_schema_protocol_command
 = element command    # type command_definition
     {
       command_definition_name
       & command_definition_summary?
       & command_definition_description?
       & ( ( command_definition_pattern
           & command_definition_response )
           | ( command_definition_type
           & command_definition_ele* ) )
       & command_definition_example*
     }

7.80.3 Example: Get the help text

Client

 <help/>

Manager

 <help_response status="200"
                status_text="OK">
            AUTHENTICATE           Authenticate with the manager.
            COMMANDS               Run a list of commands.
            CREATE_AGENT           Create an agent.
            CREATE_ALERT           Create an alert.
            CREATE_CONFIG          Create a config.
            CREATE_FILTER          Create a filter.
            CREATE_GROUP           Create a group.
            CREATE_LSC_CREDENTIAL  Create a local security check credential.
            CREATE_NOTE            Create a note.
            CREATE_OVERRIDE        Create an override.
            CREATE_PERMISSION      Create a permission.
            CREATE_PORT_LIST       Create a port list.
            CREATE_PORT_RANGE      Create a port range in a port list.
            CREATE_REPORT          Create a report.
            CREATE_REPORT_FORMAT   Create a report format.
            CREATE_ROLE            Create a role.
            CREATE_SCANNER         Create a scanner.
            CREATE_SCHEDULE        Create a schedule.
            CREATE_SLAVE           Create a slave.
            CREATE_TAG             Create a tag.
            CREATE_TARGET          Create a target.
            CREATE_TASK            Create a task.
            CREATE_USER            Create a new user.
            DELETE_AGENT           Delete an agent.
            DELETE_ALERT           Delete an alert.
            DELETE_CONFIG          Delete a config.
            DELETE_FILTER          Delete a filter.
            DELETE_GROUP           Delete a group.
            DELETE_LSC_CREDENTIAL  Delete a local security check credential.
            DELETE_NOTE            Delete a note.
            DELETE_OVERRIDE        Delete an override.
            DELETE_PERMISSION      Delete a permission.
            DELETE_PORT_LIST       Delete a port list.
            DELETE_PORT_RANGE      Delete a port range.
            DELETE_REPORT          Delete a report.
            DELETE_REPORT_FORMAT   Delete a report format.
            DELETE_ROLE            Delete a role.
            DELETE_SCANNER         Delete a scanner.
            DELETE_SCHEDULE        Delete a schedule.
            DELETE_SLAVE           Delete a slave.
            DELETE_TAG             Delete a tag.
            DELETE_TARGET          Delete a target.
            DELETE_TASK            Delete a task.
            DELETE_USER            Delete an existing user.
            DESCRIBE_AUTH          Get details about the used authentication methods.
            DESCRIBE_CERT          Get details of the CERT feed this Manager uses.
            DESCRIBE_FEED          Get details of the NVT feed this Manager uses.
            DESCRIBE_SCAP          Get details of the SCAP feed this Manager uses.
            EMPTY_TRASHCAN         Empty the trashcan.
            GET_AGENTS             Get one or many agents.
            GET_ALERTS             Get one or many alerts.
            GET_CONFIGS            Get one or many configs.
            GET_FILTERS            Get one or many filters.
            GET_GROUPS             Get one or many groups.
            GET_INFO               Get raw information for a given item.
            GET_LSC_CREDENTIALS    Get one or many local security check credentials.
            GET_NOTES              Get one or many notes.
            GET_NVTS               Get one or all available NVTs.
            GET_NVT_FAMILIES       Get a list of all NVT families.
            GET_NVT_FEED_VERSION   Get NVT feed version.
            GET_OVERRIDES          Get one or many overrides.
            GET_PERMISSIONS        Get one or many permissions.
            GET_PORT_LISTS         Get one or many port lists.
            GET_PREFERENCES        Get preferences for all available NVTs.
            GET_REPORTS            Get one or many reports.
            GET_REPORT_FORMATS     Get one or many report formats.
            GET_RESULTS            Get results.
            GET_ROLES              Get one or many roles.
            GET_SCANNERS           Get one or many scanners.
            GET_SCHEDULES          Get one or many schedules.
            GET_SETTINGS           Get one or many settings.
            GET_SLAVES             Get one or many slaves.
            GET_SYSTEM_REPORTS     Get one or many system reports.
            GET_TAGS               Get one or many tags.
            GET_TARGETS            Get one or many targets.
            GET_TASKS              Get one or many tasks.
            GET_USERS              Get one or many users.
            GET_VERSION            Get the OpenVAS Manager Protocol version.
            HELP                   Get this help text.
            MODIFY_AGENT           Modify an existing agent.
            MODIFY_ALERT           Modify an existing alert.
            MODIFY_AUTH            Modify the authentication methods.
            MODIFY_CONFIG          Update an existing config.
            MODIFY_FILTER          Modify an existing filter.
            MODIFY_GROUP           Modify an existing group.
            MODIFY_LSC_CREDENTIAL  Modify an existing LSC credential.
            MODIFY_NOTE            Modify an existing note.
            MODIFY_OVERRIDE        Modify an existing override.
            MODIFY_PERMISSION      Modify an existing permission.
            MODIFY_PORT_LIST       Modify an existing port list.
            MODIFY_REPORT          Modify an existing report.
            MODIFY_REPORT_FORMAT   Modify an existing report format.
            MODIFY_ROLE            Modify an existing role.
            MODIFY_SCANNER         Modify an existing scanner.
            MODIFY_SCHEDULE        Modify an existing schedule.
            MODIFY_SETTING         Modify an existing setting.
            MODIFY_SLAVE           Modify an existing slave.
            MODIFY_TAG             Modify an existing tag.
            MODIFY_TARGET          Modify an existing target.
            MODIFY_TASK            Update an existing task.
            MODIFY_USER            Modify a user.
            RESTORE                Restore a resource.
            RESUME_TASK            Resume a task.
            RUN_WIZARD             Run a wizard.
            START_TASK             Manually start an existing task.
            STOP_TASK              Stop a running task.
            SYNC_CERT              Synchronize with a CERT feed.
            SYNC_FEED              Synchronize with an NVT feed.
            SYNC_SCAP              Synchronize with a SCAP feed.
            TEST_ALERT             Run an alert.
            VERIFY_AGENT           Verify an agent.
            VERIFY_REPORT_FORMAT   Verify a report format.
 </help_response>

7.80.3 Example: Get the OMP schema

Client

 <help format="XML"/>

Manager

 <help_response status="200"
                status_text="OK">
   <schema format="XML"
           extension="xml"
           content_type="text/xml">
     <protocol>
       <name>OpenVAS Management Protocol</name>
       <abbreviation>OMP</abbreviation>
       <summary>
         The "management" protocol of the Open Vulnerability Assessment System
       </summary>
       <version>1.0</version>
       <type>
         <name>base64</name>
         <summary>Base64 encoded data</summary>
         <pattern>xsd:base64Binary</pattern>
       </type>
       ...
       <command>
         <name>authenticate</name>
         <summary>Authenticate with the manager</summary>
         <description>
           <p>
                    The client uses the authenticate command to authenticate with the
                    Manager.
           </p>
           <p>
                    The client normally executes this command at the beginning of each
                    connection.  The only commands permitted before authentication are
                    get_version and commands.
           </p>
         </description>
         <pattern>
           <e>credentials</e>
         </pattern>
         <ele>
           <name>credentials</name>
           <pattern>
             <e>username</e>
             <e>password</e>
           </pattern>
           <ele>
             <name>username</name>
             <summary>The login name of the user</summary>
             <pattern>text</pattern>
           </ele>
           <ele>
             <name>password</name>
             <summary>The user's password</summary>
             <pattern>text</pattern>
           </ele>
         </ele>
         <response>
           <pattern>
             <attrib>
               <name>status</name>
               <type>status</type>
               <required>1</required>
             </attrib>
             <attrib>
               <name>status_text</name>
               <type>text</type>
               <required>1</required>
             </attrib>
           </pattern>
         </response>
         <example>
           <summary>Authenticate with a good password</summary>
           <request>
             <authenticate>
               <credentials>
                 <username>sally</username>
                 <password>secret</password>
               </credentials>
             </authenticate>
           </request>
           <response>
             <authenticate_response status="200"
                                    status_text="OK">
               <role>User</role>
               <timezone>UTC</timezone>
             </authenticate_response>
           </response>
         </example>
         ...
       </command>
       ...
     </protocol>
   </schema>
 </help_response>

7.81 Command `modify_agent`

In short: Modify an existing agent.

The client uses the modify_agent command to change an existing agent.

7.81.1 Structure

Command
- @agent_id (uuid) ID of agent to modify.
- <name> ?
  Name of agent.
- <comment> ?
  Comment on agent.
Response
- @status (status)
- @status_text (text)

7.81.2 RNC

Command

modify_agent
 = element modify_agent
     {
       attribute agent_id { uuid }
       & modify_agent_name?
       & modify_agent_comment?
     }

modify_agent_comment
 = element comment
     {
       text
     }

modify_agent_name
 = element name
     {
       name
     }

Response

modify_agent_response
 = element modify_agent_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.81.3 Example: Modify the comment on an agent

Client

 <modify_agent agent_id="c737f787-9473-410d-8956-9d7b57bdd11f">
   <comment>Old Agent 1</comment>
 </modify_agent>

Manager

 <modify_agent_response status="200"
                        status_text="OK"/>

7.82 Command `modify_alert`

In short: Modify an existing alert.

The client uses the modify_alert command to change an existing alert.

7.82.1 Structure

Command
- @alert_id (uuid) ID of alert to modify.
- <name> ?
  Name of alert.
- <comment> ?
  Comment on alert.
- <filter> ?
  Filter to apply when executing alert.
  - @id (uuid)
- <event> ?
  The event that must happen for the alert to occur.
  - <data> *
    Some data that defines the event.
    - <name>
      The name of the event data.
- <condition> ?
  The condition that must be satisfied for the alert to occur.
  - <data> *
    Some data that defines the condition.
    - <name>
      The name of the condition data.
- <method> ?
  The method by which the user is alerted.
  - <data> *
    Some data that defines the method.
    - <name>
      The name of the method data.
Response
- @status (status)
- @status_text (text)

7.82.2 RNC

Command

modify_alert
 = element modify_alert
     {
       attribute alert_id { uuid }
       & modify_alert_name?
       & modify_alert_comment?
       & modify_alert_filter?
       & modify_alert_event?
       & modify_alert_condition?
       & modify_alert_method?
     }

modify_alert_name
 = element name
     {
       name
     }

modify_alert_comment
 = element comment
     {
       text
     }

modify_alert_condition
 = element condition
     {
       text
       & modify_alert_condition_data*
     }

modify_alert_condition_data
 = element data
     {
       text
       & modify_alert_condition_data_name
     }

modify_alert_condition_data_name
 = element name
     {
       text
     }

modify_alert_event
 = element event
     {
       text
       & modify_alert_event_data*
     }

modify_alert_event_data
 = element data
     {
       text
       & modify_alert_event_data_name
     }

modify_alert_event_data_name
 = element name
     {
       text
     }

modify_alert_method
 = element method
     {
       text
       & modify_alert_method_data*
     }

modify_alert_method_data
 = element data
     {
       text
       & modify_alert_method_data_name
     }

modify_alert_method_data_name
 = element name
     {
       text
     }

modify_alert_filter
 = element filter
     {
       attribute id { uuid }
     }

Response

modify_alert_response
 = element modify_alert_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.82.3 Example: Modify the name and report filter of an alert and the condition that triggers it

Client

 <modify_alert alert_id="914b59f8-25f5-4c8f-832c-2379cd625236">
   <name>Low Level Alert 2</name>
   <condition>
     Threat level at least
     <data>
       Low
       <name>level</name>
     </data>
   </condition>
   <filter id="7a06bd00-7e4a-4669-b7d7-8fe65ec64a41"/>
 </modify_alert>

Manager

 <modify_alert_response status="200"
                        status_text="OK"/>

7.83 Command `modify_auth`

In short: Modify the authentication methods.

The client uses the "modify_auth" command to modify the authentication methods.

7.83.1 Structure

Command
- <group>
  - <auth_conf_setting> *
    A setting to modify.
    - @key (text)
    - @value (text)
Response
- @status (status)
- @status_text (text)

7.83.2 RNC

Command

modify_auth
 = element modify_auth
     {
       modify_auth_group
     }

modify_auth_group
 = element group
     {
       modify_auth_group_auth_conf_setting*
     }

modify_auth_group_auth_conf_setting
 = element auth_conf_setting
     {
       attribute key { text }
       & attribute value { text }
     }

Response

modify_auth_response
 = element modify_auth_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.83.3 Example: Modify a single setting for an authentication method

Client

 <modify_auth>
   <group name="Foo">
     <auth_conf_setting key="Bar"
                        value="Baz"/>
   </group>
 </modify_auth>

Manager

 <modify_auth_response status="200"
                       status_text="OK"/>

7.84 Command `modify_config`

In short: Modify an existing config.

This command can take five forms: with a preference, with a family selection, with an NVT selection, or with a name or comment.

The first form modifies a preference on the config. If the preference includes an NVT, then the preference is an NVT preference, otherwise the preference is a scanner preference. If the preference includes a value then the manager updates the value of the preference, otherwise the manager removes the preference. The value must be base64 encoded.

The second form, with a family selection, lets the client modify the NVTs selected by the config at a family level. The idea is that the client modifies the entire family selection at once, so a client will often need to include many families in a family selection.

The family_selection may include a growing element to indicate whether new families should be added to the selection. It may also include any number of family elements.

A family element must always include a name and may include a growing element and an all element. The all element indicates whether all NVTs in the family should be selected. The growing element indicates whether new NVTs in the family should be added to the selection as they arrive. Leaving a family out of the family_selection is equivalent to including the family with all 0 and growing 0.

The effect of the all 0 and growing 0 case is subtle: if all NVTs were selected then all are removed (effectively removing the family from the config). However if some NVTs were selected then they remain selected. As a result the client must include in the family_selection all families that must have all NVTs selected.

The third option, an NVT selection, must include a family and may include any number of NVTs. The manager updates the given family in the config to include only the given NVTs.

If there was no error with the command sent by the client, the manager will apply the changes to the config and will reply with a response code indicating success.

7.84.1 Structure

Command
- @config_id (uuid) ID of config to modify.
- One of
  - <name>
    New name for the config.
  - <comment>
    New comment for the config.
  - <preference>
    - <name>
      The name of the preference to modify.
    - <nvt> ?
      NVT associated with preference to modify.
      - @oid (oid)
    - <value> ?
      New value for preference.
  - <family_selection>
    - <growing> ?
      Whether new families should be added to the config.
    - <family> *
      - <all> ?
        Whether to select all NVTs initially.
      - <growing> ?
        Whether to add newly arrived nvts to the selection.
      - <name>
  - <nvt_selection>
    - <family>
      Name of family to modify.
    - <nvt> *
      - @oid (oid)
Response
- @status (status)
- @status_text (text)

7.84.2 RNC

Command

modify_config
 = element modify_config
     {
       attribute config_id { uuid }
       & ( modify_config_name
           | modify_config_comment
           | modify_config_preference
           | modify_config_family_selection
           | modify_config_nvt_selection )
     }

modify_config_name
 = element name
     {
       name
     }

modify_config_comment
 = element comment
     {
       text
     }

modify_config_preference
 = element preference
     {
       modify_config_preference_name
       & modify_config_preference_nvt?
       & modify_config_preference_value?
     }

modify_config_preference_name
 = element name
     {
       name
     }

modify_config_preference_nvt
 = element nvt
     {
       attribute oid { oid }
     }

modify_config_preference_value
 = element value
     {
       base64
     }

modify_config_family_selection
 = element family_selection
     {
       modify_config_family_selection_growing?
       & modify_config_family_selection_family*
     }

modify_config_family_selection_growing
 = element growing
     {
       boolean_atoi
     }

modify_config_family_selection_family
 = element family
     {
       modify_config_family_selection_family_all?
       & modify_config_family_selection_family_growing?
       & modify_config_family_selection_family_name
     }

modify_config_family_selection_family_all
 = element all
     {
       boolean_atoi
     }

modify_config_family_selection_family_growing
 = element growing
     {
       boolean_atoi
     }

modify_config_family_selection_family_name
 = element name
     {
       name
     }

modify_config_nvt_selection
 = element nvt_selection
     {
       modify_config_nvt_selection_family
       & modify_config_nvt_selection_nvt*
     }

modify_config_nvt_selection_family
 = element family
     {
       name
     }

modify_config_nvt_selection_nvt
 = element nvt
     {
       attribute oid { oid }
     }

Response

modify_config_response
 = element modify_config_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.84.3 Example: Modify a config NVT preference

Client

 <modify_config config_id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6">
   <preference>
     <nvt oid="1.3.6.1.4.1.25623.1.0.14259"/>
     <name>Nmap (NASL wrapper)[checkbox]:UDP port scan</name>
     <value>eWVz</value>
   </preference>
 </modify_config>

Manager

 <modify_config_response status="200"
                         status_text="OK"/>

7.84.3 Example: Modify a config Scanner preference

Client

 <modify_config config_id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6">
   <preference>
     <name>scanner[scanner]:vhosts</name>
     <value>ZXhhbXBsZQ==</value>
   </preference>
 </modify_config>

Manager

 <modify_config_response status="200"
                         status_text="OK"/>

7.84.3 Example: Modify the families that a config selects

The outer "growing" element sets the config to add any new families that arrive.

The client requests the Manager to keep a single selected family (Debian Local Security Checks), to select all NVTs in this family, and to automatically add any new NVTs in this family to the config.

Client

 <modify_config config_id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6">
   <family_selection>
     <growing>1</growing>
     <family>
       <name>Debian Local Security Checks</name>
       <all>1</all>
       <growing>1</growing>
     </family>
   </family_selection>
 </modify_config>

Manager

 <modify_config_response status="200"
                         status_text="OK"/>

7.84.3 Example: Modify the NVTs that a config selects in a particular family

Client

 <modify_config config_id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6">
   <nvt_selection>
     <family>Debian Local Security Checks</family>
     <nvt oid="1.3.6.1.4.1.25623.1.0.53797"/>
     <nvt oid="1.3.6.1.4.1.25623.1.0.63272"/>
     <nvt oid="1.3.6.1.4.1.25623.1.0.55615"/>
     <nvt oid="1.3.6.1.4.1.25623.1.0.53546"/>
   </nvt_selection>
 </modify_config>

Manager

 <modify_config_response status="200"
                         status_text="OK"/>

7.85 Command `modify_filter`

In short: Modify an existing filter.

The client uses the modify_filter command to change an existing filter.

7.85.1 Structure

Command
- @filter_id (uuid) ID of filter to modify.
- <comment> ?
  Comment on filter.
- <name> ?
  Name of filter.
- <term> ?
  Filter term.
- <type> ?
  Resource type filter applies to.
Response
- @status (status)
- @status_text (text)

7.85.2 RNC

Command

modify_filter
 = element modify_filter
     {
       attribute filter_id { uuid }
       & modify_filter_comment?
       & modify_filter_name?
       & modify_filter_term?
       & modify_filter_type?
     }

modify_filter_comment
 = element comment
     {
       text
     }

modify_filter_name
 = element name
     {
       name
     }

modify_filter_term
 = element term
     {
       text
     }

modify_filter_type
 = element type
     {
       text
     }

Response

modify_filter_response
 = element modify_filter_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.85.3 Example: Modify the term of a filter

Client

 <modify_filter filter_id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6">
   <term>name=local</term>
 </modify_filter>

Manager

 <modify_filter_response status="200"
                         status_text="OK"/>

7.86 Command `modify_group`

In short: Modify an existing group.

The client uses the modify_group command to change an existing group.

7.86.1 Structure

Command
- @group_id (uuid) ID of group to modify.
- <name> ?
  Name of group.
- <comment> ?
  Comment on group.
- <users> ?
  Comma separated list of user names.
Response
- @status (status)
- @status_text (text)

7.86.2 RNC

Command

modify_group
 = element modify_group
     {
       attribute group_id { uuid }
       & modify_group_name?
       & modify_group_comment?
       & modify_group_users?
     }

modify_group_name
 = element name
     {
       name
     }

modify_group_comment
 = element comment
     {
       text
     }

modify_group_users
 = element users
     {
       text
     }

Response

modify_group_response
 = element modify_group_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.86.3 Example: Modify the name of a group

Client

 <modify_group group_id="d94211b6-ba40-11e3-bcb1-406186ea4fc5">
   <name>Line Managers</name>
 </modify_group>

Manager

 <modify_group_response status="200"
                        status_text="OK"/>

7.87 Command `modify_lsc_credential`

In short: Modify an existing LSC credential.

The client uses the modify_lsc_credential command to change an existing LSC credential.

The login and password can only be changed for password LSC credentials. Modification of login or password on package credentials is forbidden.

7.87.1 Structure

Command
- @lsc_credential_id (uuid) ID of LSC credential to modify.
- <comment> ?
  A comment on the LSC credential.
- <name> ?
  A name for the LSC credential.
- <password> ?
  The password for the credential login.
- <login> ?
  The user name of the credential.
Response
- @status (status)
- @status_text (text)

7.87.2 RNC

Command

modify_lsc_credential
 = element modify_lsc_credential
     {
       attribute lsc_credential_id { uuid }
       & modify_lsc_credential_comment?
       & modify_lsc_credential_name?
       & modify_lsc_credential_password?
       & modify_lsc_credential_login?
     }

modify_lsc_credential_name
 = element name
     {
       name
     }

modify_lsc_credential_comment
 = element comment
     {
       text
     }

modify_lsc_credential_login
 = element login
     {
       text
     }

modify_lsc_credential_password
 = element password
     {
       text
     }

Response

modify_lsc_credential_response
 = element modify_lsc_credential_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.87.3 Example: Modify the comment of an LSC credential

Client

 <modify_lsc_credential lsc_credential_id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6">
   <comment>Credential for all machines in lab 4.</comment>
 </modify_lsc_credential>

Manager

 <modify_lsc_credential_response status="200"
                                 status_text="OK"/>

7.88 Command `modify_note`

In short: Modify an existing note.

The client uses the modify_note command to change an existing note.

If an optional element is left out, the existing value will be cleared, generalising that constraint.

7.88.1 Structure

Command
- @note_id (uuid) ID of note to modify.
- <active> ?
  Seconds note will be active. -1 on always, 0 off.
- <hosts> ?
  A textual list of hosts.
- <port> ?
  Port to which note applies.
- <result> ?
  Result to which note applies.
  - @id (uuid)
- <severity> ?
  Severity to which note applies.
- <task> ?
  Task to which note applies.
  - @id (uuid)
- <text>
  The text of the note.
- <threat> ?
  Threat level to which note applies.
Response
- @status (status)
- @status_text (text)

7.88.2 RNC

Command

modify_note
 = element modify_note
     {
       attribute note_id { uuid }
       & modify_note_active?
       & modify_note_hosts?
       & modify_note_port?
       & modify_note_result?
       & modify_note_severity?
       & modify_note_task?
       & modify_note_text
       & modify_note_threat?
     }

modify_note_active
 = element active
     {
       integer
     }

modify_note_hosts
 = element hosts
     {
       text
     }

modify_note_port
 = element port
     {
       text
     }

modify_note_severity
 = element severity
     {
       severity
     }

modify_note_text
 = element text
     {
       text
     }

modify_note_threat
 = element threat
     {
       threat
     }

modify_note_task
 = element task
     {
       attribute id { uuid }
     }

modify_note_result
 = element result
     {
       attribute id { uuid }
     }

Response

modify_note_response
 = element modify_note_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.88.3 Example: Modify the text and result of a note

Client

 <modify_note note_id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6">
   <text>This issue should be resolved after the upgrade.</text>
   <result result_id="254cd3ef-bbe1-4d58-859d-21b8d0c046c"/>
 </modify_note>

Manager

 <modify_note_response status="200"
                       status_text="OK"/>

7.89 Command `modify_override`

In short: Modify an existing override.

The client uses the modify_override command to change an existing override.

If an optional element is left out, the existing value will be cleared, generalising that constraint.

7.89.1 Structure

Command
- @override_id (uuid) ID of override to modify.
- <active> ?
  Seconds override will be active. -1 on always, 0 off.
- <hosts> ?
  A textual list of hosts.
- <new_severity> ?
  New severity score for result.
- <new_threat> ?
  New threat level for result.
- <port> ?
  Port to which override applies.
- <result> ?
  Result to which override applies.
  - @id (uuid)
- <task> ?
  Task to which override applies.
  - @id (uuid)
- <text>
  Text describing the override.
- <severity> ?
  Severity score to which override applies.
- <threat> ?
  Threat level to which override applies.
Response
- @status (status)
- @status_text (text)

7.89.2 RNC

Command

modify_override
 = element modify_override
     {
       attribute override_id { uuid }
       & modify_override_active?
       & modify_override_hosts?
       & modify_override_new_severity?
       & modify_override_new_threat?
       & modify_override_port?
       & modify_override_result?
       & modify_override_task?
       & modify_override_text
       & modify_override_severity?
       & modify_override_threat?
     }

modify_override_active
 = element active
     {
       integer
     }

modify_override_hosts
 = element hosts
     {
       text
     }

modify_override_new_severity
 = element new_severity
     {
       severity
     }

modify_override_new_threat
 = element new_threat
     {
       threat
     }

modify_override_port
 = element port
     {
       text
     }

modify_override_text
 = element text
     {
       text
     }

modify_override_severity
 = element severity
     {
       severity
     }

modify_override_threat
 = element threat
     {
       threat
     }

modify_override_task
 = element task
     {
       attribute id { uuid }
     }

modify_override_result
 = element result
     {
       attribute id { uuid }
     }

Response

modify_override_response
 = element modify_override_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.89.3 Example: Set the override threat to Low

Client

 <modify_override override_id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6">
   <text>This issue is less important in our setup.</text>
   <new_threat>Low</new_threat>
 </modify_override>

Manager

 <modify_override_response status="200"
                           status_text="OK"/>

7.90 Command `modify_permission`

In short: Modify a permission.

The client uses the modify_permission command to change an existing permission.

7.90.1 Structure

Command
- @permission_id (uuid)
- <name> ?
  Permission name, currently the name of a command.
- <comment> ?
  The comment on the permission.
- <resource> ?
  A resource to which the permission applies.
  - @id (uuid) UUID if permission applies to resource, else 0.
  - <type>
    OMP type, for Super permissions: user, group or role.
- <subject> ?
  A subject to whom the permission is granted.
  - @id (uuid)
  - <type>
    OMP type of the subject: user, group or role.
Response
- @status (status)
- @status_text (text)

7.90.2 RNC

Command

modify_permission
 = element modify_permission
     {
       attribute permission_id { uuid }
       & modify_permission_name?
       & modify_permission_comment?
       & modify_permission_resource?
       & modify_permission_subject?
     }

modify_permission_name
 = element name
     {
       text
     }

modify_permission_comment
 = element comment
     {
       text
     }

modify_permission_resource
 = element resource
     {
       attribute id { uuid }?
       & modify_permission_resource_type
     }

modify_permission_resource_type
 = element type
     {
       text
     }

modify_permission_subject
 = element subject
     {
       attribute id { uuid }?
       & modify_permission_subject_type
     }

modify_permission_subject_type
 = element type
     {
       text
     }

Response

modify_permission_response
 = element modify_permission_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.90.3 Example: Change user of a permission

Client

 <modify_permission permission_id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6">
   <subject id="76e47468-c095-11e3-9285-406186ea4fc5">
     <type>user</type>
   </subject>
 </modify_permission>

Manager

 <modify_permission_response status="200"
                             status_text="OK"/>

7.91 Command `modify_port_list`

In short: Modify an existing port list.

The client uses the modify_port_list command to change an existing port list.

7.91.1 Structure

Command
- @port_list_id (uuid) ID of port list to modify.
- <name> ?
  Name of port list.
- <comment> ?
  Comment on port list.
Response
- @status (status)
- @status_text (text)

7.91.2 RNC

Command

modify_port_list
 = element modify_port_list
     {
       attribute port_list_id { uuid }
       & modify_port_list_name?
       & modify_port_list_comment?
     }

modify_port_list_name
 = element name
     {
       name
     }

modify_port_list_comment
 = element comment
     {
       text
     }

Response

modify_port_list_response
 = element modify_port_list_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.91.3 Example: Modify the name of a port list

Client

 <modify_port_list port_list_id="27140836-05ae-4e8b-9abf-f725ddc2888f">
   <name>PL-WS1</name>
   <comment>Port List for Web Server 1</comment>
 </modify_port_list>

Manager

 <modify_port_list_response status="200"
                            status_text="OK"/>

7.92 Command `modify_report`

In short: Modify an existing report.

The client uses the modify_report command to change an existing report.

7.92.1 Structure

Command
- @report_id (uuid) ID of report to modify.
- <comment>
  The comment on the report.
Response
- @status (status)
- @status_text (text)

7.92.2 RNC

Command

modify_report
 = element modify_report
     {
       attribute report_id { uuid }
       & modify_report_comment
     }

modify_report_comment
 = element comment
     {
       text
     }

Response

modify_report_response
 = element modify_report_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.92.3 Example: Modify a report comment

Client

 <modify_report report_id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6">
   <comment>Monthly scan of the webserver.</comment>
 </modify_report>

Manager

 <modify_report_response status="200"
                         status_text="OK"/>

7.93 Command `modify_report_format`

In short: Update an existing report format.

The client uses the modify_report_format command to change an existing report format.

7.93.1 Structure

Command
- @report_format_id (uuid) ID of report format to modify.
- One of
  - <active>
    Whether the report format is active.
  - <name>
    The name of the report format.
  - <summary>
    A summary of the report format.
  - <param>
    - <name>
      The name of the param.
    - <value> ?
      New value for the param.
Response
- @status (status)
- @status_text (text)

7.93.2 RNC

Command

modify_report_format
 = element modify_report_format
     {
       attribute report_format_id { uuid }
       & ( modify_report_format_active
           | modify_report_format_name
           | modify_report_format_summary
           | modify_report_format_param )
     }

modify_report_format_active
 = element active
     {
       boolean
     }

modify_report_format_name
 = element name
     {
       name
     }

modify_report_format_summary
 = element summary
     {
       text
     }

modify_report_format_param
 = element param
     {
       modify_report_format_param_name
       & modify_report_format_param_value?
     }

modify_report_format_param_name
 = element name
     {
       name
     }

modify_report_format_param_value
 = element value
     {
       base64
     }

Response

modify_report_format_response
 = element modify_report_format_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.93.3 Example: Modify a report format param

Client

 <modify_report_format report_format_id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6">
   <param>
     <name>Background Colour</name>
     <value>cmVk</value>
   </param>
 </modify_report_format>

Manager

 <modify_report_format_response status="200"
                                status_text="OK"/>

7.93.3 Example: Modify the name of a report format

Client

 <modify_report_format report_format_id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6">
   <name>New name</name>
 </modify_report_format>

Manager

 <modify_report_format_response status="200"
                                status_text="OK"/>

7.94 Command `modify_role`

In short: Modify an existing role.

The client uses the modify_role command to change an existing role.

7.94.1 Structure

Command
- @role_id (uuid) ID of role to modify.
- <name> ?
  Name of role.
- <comment> ?
  Comment on role.
- <users> ?
  Comma separated list of user names.
Response
- @status (status)
- @status_text (text)

7.94.2 RNC

Command

modify_role
 = element modify_role
     {
       attribute role_id { uuid }
       & modify_role_name?
       & modify_role_comment?
       & modify_role_users?
     }

modify_role_name
 = element name
     {
       name
     }

modify_role_comment
 = element comment
     {
       text
     }

modify_role_users
 = element users
     {
       text
     }

Response

modify_role_response
 = element modify_role_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.94.3 Example: Modify the name of a role

Client

 <modify_role role_id="914b59f8-25f5-4c8f-832c-2379cd625236">
   <name>SCAP User</name>
 </modify_role>

Manager

 <modify_role_response status="200"
                       status_text="OK"/>

7.95 Command `modify_scanner`

In short: Modify an existing scanner.

The client uses the modify_scanner command to change an existing scanner.

7.95.1 Structure

Command
- @scanner_id (uuid) ID of scanner to modify.
- <comment> ?
  Comment on scanner.
- <name> ?
  Name of scanner.
- <host>
  Host of the scanner.
- <port>
  Port of the scanner.
- <type>
  Type of the scanner. '1' for OSP, '2' for OpenVAS (classic) Scanner.
- <ca_pub> ?
  Certificate of CA to verify scanner's certificate.
- <key_pub> ?
  Certificate of credentials to authenticate with to scanner.
- <key_priv> ?
  Private key of credentials to authenticate with to scanner.
Response
- @status (status)
- @status_text (text)

7.95.2 RNC

Command

modify_scanner
 = element modify_scanner
     {
       attribute scanner_id { uuid }
       & modify_scanner_comment?
       & modify_scanner_name?
       & modify_scanner_host
       & modify_scanner_port
       & modify_scanner_type
       & modify_scanner_ca_pub?
       & modify_scanner_key_pub?
       & modify_scanner_key_priv?
     }

modify_scanner_comment
 = element comment
     {
       text
     }

modify_scanner_name
 = element name
     {
       name
     }

modify_scanner_host
 = element host
     {
       text
     }

modify_scanner_port
 = element port
     {
       text
     }

modify_scanner_type
 = element type
     {
       text
     }

modify_scanner_ca_pub
 = element ca_pub
     {
       text
     }

modify_scanner_key_pub
 = element key_pub
     {
       text
     }

modify_scanner_key_priv
 = element key_priv
     {
       text
     }

Response

modify_scanner_response
 = element modify_scanner_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.95.3 Example: Modify the name of a scanner

Client

 <modify_scanner scanner_id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6">
   <name>Weekly Scan</name>
 </modify_scanner>

Manager

 <modify_scanner_response status="200"
                          status_text="OK"/>

7.96 Command `modify_schedule`

In short: Modify an existing schedule.

The client uses the modify_schedule command to change an existing schedule.

7.96.1 Structure

Command
- @schedule_id (uuid) ID of schedule to modify.
- <comment> ?
  Comment on schedule.
- <name> ?
  Name of schedule.
- <first_time> ?
  First time the task will run. Missing subelements default to current system time.
  - <day_of_month> ?
  - <hour> ?
  - <minute> ?
  - <month> ?
  - <year> ?
- <duration> ?
  How long the task will run for.
  - <unit> ?
- <period> ?
  How often the task will run.
  - <unit> ?
- <timezone> ?
  The timezone the schedule will follow. User's timezone is used if omitted.
Response
- @status (status)
- @status_text (text)

7.96.2 RNC

Command

modify_schedule
 = element modify_schedule
     {
       attribute schedule_id { uuid }
       & modify_schedule_comment?
       & modify_schedule_name?
       & modify_schedule_first_time?
       & modify_schedule_duration?
       & modify_schedule_period?
       & modify_schedule_timezone?
     }

modify_schedule_comment
 = element comment
     {
       text
     }

modify_schedule_name
 = element name
     {
       name
     }

modify_schedule_first_time
 = element first_time
     {
       modify_schedule_first_time_day_of_month?
       & modify_schedule_first_time_hour?
       & modify_schedule_first_time_minute?
       & modify_schedule_first_time_month?
       & modify_schedule_first_time_year?
     }

modify_schedule_first_time_day_of_month
 = element day_of_month
     {
       text
     }

modify_schedule_first_time_hour
 = element hour
     {
       text
     }

modify_schedule_first_time_minute
 = element minute
     {
       text
     }

modify_schedule_first_time_month
 = element month
     {
       text
     }

modify_schedule_first_time_year
 = element year
     {
       text
     }

modify_schedule_timezone
 = element timezone
     {
       timezone
     }

modify_schedule_duration
 = element duration
     {
       text
       & modify_schedule_duration_unit?
     }

modify_schedule_duration_unit
 = element unit
     {
       time_unit
     }

modify_schedule_period
 = element period
     {
       text
       & modify_schedule_period_unit?
     }

modify_schedule_period_unit
 = element unit
     {
       time_unit
     }

Response

modify_schedule_response
 = element modify_schedule_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.96.3 Example: Modify the name of a schedule

Client

 <modify_schedule schedule_id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6">
   <name>Weekly Scan</name>
 </modify_schedule>

Manager

 <modify_schedule_response status="200"
                           status_text="OK"/>

7.97 Command `modify_setting`

In short: Modify an existing setting.

The client uses the modify_setting command to change an existing setting. These are user settings that can be controlled via OMP. The settings "Password" and "Timezone" can be modified by name, the rest by UUID.

7.97.1 Structure

Command
- @setting_id (uuid)
- <name>
  The name of the setting.
- <value>
  The value of the setting.
Response
- @status (status)
- @status_text (text)

7.97.2 RNC

Command

modify_setting
 = element modify_setting
     {
       attribute setting_id { uuid }?
       & modify_setting_name
       & modify_setting_value
     }

modify_setting_name
 = element name
     {
       text
     }

modify_setting_value
 = element value
     {
       text
     }

Response

modify_setting_response
 = element modify_setting_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.97.3 Example: Modify the timezone

Client

 <modify_setting>
   <name>Timezone</name>
   <value>Africa/Johannesburg</value>
 </modify_setting>

Manager

 <modify_setting_response status="200"
                          status_text="OK"/>

7.98 Command `modify_slave`

In short: Modify an existing slave.

The client uses the modify_slave command to change an existing slave.

7.98.1 Structure

Command
- @slave_id (uuid) ID of slave to modify.
- <name>
  A name for the slave.
- <comment> ?
  A comment on the slave.
- <host>
  The host that the slave Manager is running on.
- <port>
  The port that the slave Manager is serving on the host.
- <login>
  Login name on the slave Manager.
- <password>
  Password for login on the slave Manager.
Response
- @status (status)
- @status_text (text)

7.98.2 RNC

Command

modify_slave
 = element modify_slave
     {
       attribute slave_id { uuid }
       & modify_slave_name
       & modify_slave_comment?
       & modify_slave_host
       & modify_slave_port
       & modify_slave_login
       & modify_slave_password
     }

modify_slave_name
 = element name
     {
       name
     }

modify_slave_comment
 = element comment
     {
       text
     }

modify_slave_host
 = element host
     {
       text
     }

modify_slave_port
 = element port
     {
       text
     }

modify_slave_login
 = element login
     {
       text
     }

modify_slave_password
 = element password
     {
       text
     }

Response

modify_slave_response
 = element modify_slave_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.98.3 Example: Update slave information

Client

 <modify_slave slave_id="f1e4dd0c-155c-4ac1-b43b-8d40a1b99dd0">
   <name>BK-1</name>
   <comment>Bangkok Manager 1</comment>
   <host>bk1.example.com</host>
   <port>9390</port>
   <login>user1</login>
   <password>pass</password>
 </modify_slave>

Manager

 <modify_slave_response status="200"
                        status_text="OK"/>

7.99 Command `modify_target`

In short: Modify an existing target.

The client uses the modify_target command to change an existing target.

7.99.1 Structure

Command
- @target_id (uuid) ID of target to modify.
- <comment> ?
  Comment on target.
- <name> ?
  Name of target.
- <hosts> ?
  Target hosts.
- <hosts_ordering> ?
  The order hosts are scanned in.
- <exclude_hosts> ?
  A list of hosts to exclude.
- <ssh_lsc_credential> ?
  SSH credential to use on target.
  - @id (uuid)
- <smb_lsc_credential> ?
  SMB credential to use on target.
  - @id (uuid)
- <esxi_lsc_credential> ?
  ESXi credential to use on target.
  - @id (uuid)
- <port_list> ?
  Port List describing ports to scan.
  - @id (uuid)
- <alive_tests> ?
  Which alive tests to use.
- <reverse_lookup_only> ?
  Whether to scan only hosts that have names.
- <reverse_lookup_unify> ?
  Whether to scan only one IP when multiple IPs have the same name.
Response
- @status (status)
- @status_text (text)

7.99.2 RNC

Command

modify_target
 = element modify_target
     {
       attribute target_id { uuid }
       & modify_target_comment?
       & modify_target_name?
       & modify_target_hosts?
       & modify_target_hosts_ordering?
       & modify_target_exclude_hosts?
       & modify_target_ssh_lsc_credential?
       & modify_target_smb_lsc_credential?
       & modify_target_esxi_lsc_credential?
       & modify_target_port_list?
       & modify_target_alive_tests?
       & modify_target_reverse_lookup_only?
       & modify_target_reverse_lookup_unify?
     }

modify_target_comment
 = element comment
     {
       text
     }

modify_target_name
 = element name
     {
       name
     }

modify_target_hosts
 = element hosts
     {
       text
     }

modify_target_hosts_ordering
 = element hosts_ordering
     {
       text
     }

modify_target_exclude_hosts
 = element exclude_hosts
     {
       text
     }

modify_target_ssh_lsc_credential
 = element ssh_lsc_credential
     {
       attribute id { uuid }
     }

modify_target_smb_lsc_credential
 = element smb_lsc_credential
     {
       attribute id { uuid }
     }

modify_target_esxi_lsc_credential
 = element esxi_lsc_credential
     {
       attribute id { uuid }
     }

modify_target_port_list
 = element port_list
     {
       attribute id { uuid }
     }

modify_target_alive_tests
 = element alive_tests
     {
       alive_test
     }

modify_target_reverse_lookup_only
 = element reverse_lookup_only
     {
       boolean
     }

modify_target_reverse_lookup_unify
 = element reverse_lookup_unify
     {
       boolean
     }

Response

modify_target_response
 = element modify_target_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.99.3 Example: Modify the name of a target

Client

 <modify_target target_id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6">
   <name>Upstairs Lab</name>
 </modify_target>

Manager

 <modify_target_response status="200"
                         status_text="OK"/>

7.100 Command `modify_tag`

In short: Modify a tag.

The client uses the modify_tag command to change an existing tag.

7.100.1 Structure

Command
- @tag_id (uuid)
- <name> ?
  A full tag name consisting of namespace and predicate.
- <resource> ?
  Identifies a resource the tag is to be attached to.
  - @id (uuid) ID of the resource the tag is to be attached to.
  - <type>
    OMP type of the resource the tag is to be attached to.
- <value> ?
  Value associated with the tag.
- <comment> ?
  Comment to add to the tag.
- <active> ?
  Whether the tag is active.
Response
- @status (status)
- @status_text (text)

7.100.2 RNC

Command

modify_tag
 = element modify_tag
     {
       attribute tag_id { uuid }
       & modify_tag_name?
       & modify_tag_resource?
       & modify_tag_value?
       & modify_tag_comment?
       & modify_tag_active?
     }

modify_tag_name
 = element name
     {
       text
     }

modify_tag_resource
 = element resource
     {
       attribute id { uuid }?
       & modify_tag_resource_type
     }

modify_tag_resource_type
 = element type
     {
       text
     }

modify_tag_value
 = element value
     {
       text
     }

modify_tag_comment
 = element comment
     {
       text
     }

modify_tag_active
 = element active
     {
       boolean
     }

Response

modify_tag_response
 = element modify_tag_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.100.3 Example: Deactivate a tag

Client

 <modify_tag tag_id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6">
   <active>0</active>
 </modify_tag>

Manager

 <modify_tag_response status="200"
                      status_text="OK"/>

7.101 Command `modify_task`

In short: Modify an existing task.

The client uses the modify_task command to change an existing task.

7.101.1 Structure

Command
- @task_id (uuid) ID of task to modify.
- One of
  - <comment>
    The comment on the task.
  - <alert> *
    Task alert.
    - @id (uuid)
  - <name>
    The name of the task.
  - <observers>
    Users allowed to observe this task.
  - <preferences>
    - <preference> *
      - <scanner_name>
        Compact name of preference, from scanner.
      - <value>
  - <schedule>
    Task schedule.
    - @id (uuid)
  - <schedule_periods>
    A limit to the number of times the task will be scheduled, or 0 for no limit.
  - <scanner>
    Task scanner.
    - @id (uuid)
  - <slave>
    Task slave.
    - @id (uuid)
  - <file>
    File to attach to task.
    - @name (text)
    - @action ("update" or "remove")
Response
- @status (status)
- @status_text (text)

7.101.2 RNC

Command

modify_task
 = element modify_task
     {
       attribute task_id { uuid }
       & ( modify_task_comment
           | modify_task_alert*
           | modify_task_name
           | modify_task_observers
           | modify_task_preferences
           | modify_task_schedule
           | modify_task_schedule_periods
           | modify_task_scanner
           | modify_task_slave
           | modify_task_file )
     }

modify_task_comment
 = element comment
     {
       text
     }

modify_task_alert
 = element alert
     {
       attribute id { uuid }
     }

modify_task_name
 = element name
     {
       name
     }

modify_task_observers
 = element observers
     {
       user_list
     }

modify_task_preferences
 = element preferences
     {
       modify_task_preferences_preference*
     }

modify_task_preferences_preference
 = element preference
     {
       modify_task_preferences_preference_scanner_name
       & modify_task_preferences_preference_value
     }

modify_task_preferences_preference_scanner_name
 = element scanner_name
     {
       text
     }

modify_task_preferences_preference_value
 = element value
     {
       text
     }

modify_task_schedule
 = element schedule
     {
       attribute id { uuid }
     }

modify_task_schedule_periods
 = element schedule_periods
     {
       integer
     }

modify_task_scanner
 = element scanner
     {
       attribute id { uuid }
     }

modify_task_slave
 = element slave
     {
       attribute id { uuid }
     }

modify_task_file
 = element file
     {
       text # RNC limitation: base64
       & attribute name { text }
       & attribute action { xsd:token { pattern = "update|remove" } }
     }

Response

modify_task_response
 = element modify_task_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.101.3 Example: Modify a task comment

Client

 <modify_task task_id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6">
   <comment>Monthly scan of the webserver.</comment>
 </modify_task>

Manager

 <modify_task_response status="200"
                       status_text="OK"/>

7.102 Command `modify_user`

In short: Modify a user.

The client uses the "modify_user" command to modify an user account on the OpenVAS server.

7.102.1 Structure

Command
- @user_id (uuid) ID of the user to be modified. Overrides NAME element.
- <name>
  The name of the user to be modified.
- <new_name> ?
  The new name for the user.
- <password> ?
  The password for the user.
- <role> *
  A role of the user.
  - @id (uuid)
- <hosts> ?
  User access rules: a textual list of hosts.
  - @allow (boolean) If 1, allow only listed, otherwise forbid listed.
- <ifaces> ?
  User access rules: a textual list of ifaces.
  - @allow (boolean) If 1, allow only listed, otherwise forbid listed.
- <sources> ?
  (sources)
  
  List of authentication sources for this user (if omitted, no changes).
Response
- @status (status)
- @status_text (text)

7.102.2 RNC

Command

modify_user
 = element modify_user
     {
       attribute user_id { uuid }
       & modify_user_name
       & modify_user_new_name?
       & modify_user_password?
       & modify_user_role*
       & modify_user_hosts?
       & modify_user_ifaces?
       & modify_user_sources?
     }

modify_user_name
 = element name
     {
       text
     }

modify_user_new_name
 = element new_name
     {
       text
     }

modify_user_hosts
 = element hosts
     {
       text
       & attribute allow { boolean }?
     }

modify_user_ifaces
 = element ifaces
     {
       text
       & attribute allow { boolean }?
     }

modify_user_password
 = element password
     {
       text
     }

modify_user_role
 = element role
     {
       attribute id { uuid }
     }

modify_user_sources
 = element sources    # type sources
     {
     }

Response

modify_user_response
 = element modify_user_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.102.3 Example: Modify a user

Client

 <modify_user>
   <name>Foobar</name>
   <password modify="0"/>
   <role id="8d453140-b74d-11e2-b0be-406186ea4fc5"/>
   <hosts allow="0"/>
 </modify_user>

Manager

 <modify_user_response status="200"
                       status_text="OK"/>

7.103 Command `restore`

In short: Restore a resource.

The client uses the restore a resource from the trashcan.

7.103.1 Structure

Command
- @id (uuid)
Response
- @status (status)
- @status_text (text)

7.103.2 RNC

Command

restore
 = element restore
     {
       attribute id { uuid }
     }

Response

restore_response
 = element restore_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.103.3 Example: Restore a target

Client

 <restore id="97390ade-e075-11df-9973-002264764cea"/>

Manager

 <restore_response status="200"
                   status_text="OK"/>

7.104 Command `resume_task`

In short: Resume a task.

The client uses the resume_task command to manually resume a stopped task.

7.104.1 Structure

Command
- @task_id (uuid)
Response
- @status (status)
- @status_text (text)
- <report_id>
  The id of the report.

7.104.2 RNC

Command

resume_task
 = element resume_task
     {
       attribute task_id { uuid }
     }

Response

resume_task_response
 = element resume_task_response
     {
       attribute status { status }
       & attribute status_text { text }
       & resume_task_response_report_id
     }

resume_task_response_report_id
 = element report_id
     {
       uuid
     }

7.104.3 Example: Resume a task

Client

 <resume_task task_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <resume_task_response status="200"
                       status_text="OK">
   <report_id>330ee785-c2c0-4d4c-ab96-725142c9b789</report_id>
 </resume_task_response>

7.105 Command `run_wizard`

In short: Run a wizard.

The client uses the run_wizard command to run a wizard.

7.105.1 Structure

Command
- <mode> ?
  The mode to run the wizard in.
- <name>
  The name of the wizard.
- <params>
  Parameters for the wizard.
  - <param> *
    - <name>
      Parameter name.
    - <value>
      Value of parameter.
- @read_only (boolean) Whether to only run wizards marked as read only.
Response
- @status (status)
- @status_text (text)
- <response>
  Contains the response of the command run in the last step.

7.105.2 RNC

Command

run_wizard
 = element run_wizard
     {
       run_wizard_mode?
       & run_wizard_name
       & run_wizard_params
       & attribute read_only { boolean }?
     }

run_wizard_mode
 = element mode
     {
       text
     }

run_wizard_name
 = element name
     {
       name
     }

run_wizard_params
 = element params
     {
       run_wizard_params_param*
     }

run_wizard_params_param
 = element param
     {
       run_wizard_params_param_name
       & run_wizard_params_param_value
     }

run_wizard_params_param_name
 = element name
     {
       text
     }

run_wizard_params_param_value
 = element value
     {
       text
     }

Response

run_wizard_response
 = element run_wizard_response
     {
       attribute status { status }
       & attribute status_text { text }
       & run_wizard_response_response
     }

run_wizard_response_response
 = element response
     {
       ""
     }

7.105.3 Example: Run the Quick Start wizard to scan localhost

Client

 <run_wizard>
   <name>quick_first_scan</name>
   <params>
     <param>
       <name>hosts</name>
       <value>localhost</value>
     </param>
   </params>
 </run_wizard>

Manager

 <run_wizard_response status="202"
                      status_text="OK, request submitted">
   <response>
     <start_task_response status="202"
                          status_text="OK, request submitted">
       <report_id>a06d21f7-8e2f-4d7f-bceb-1df852d8b37d</report_id>
     </start_task_response>
   </response>
 </run_wizard_response>

7.106 Command `start_task`

In short: Manually start an existing task.

The client uses the start_task command to manually start an existing task.

7.106.1 Structure

Command
- @task_id (uuid)
Response
- @status (status)
- @status_text (text)
- <report_id>
  The id of the report.

7.106.2 RNC

Command

start_task
 = element start_task
     {
       attribute task_id { uuid }
     }

Response

start_task_response
 = element start_task_response
     {
       attribute status { status }
       & attribute status_text { text }
       & start_task_response_report_id
     }

start_task_response_report_id
 = element report_id
     {
       uuid
     }

7.106.3 Example: Start a task

Client

 <start_task task_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <start_task_response status="200"
                      status_text="OK">
   <report_id>330ee785-c2c0-4d4c-ab96-725142c9b789</report_id>
 </start_task_response>

7.107 Command `stop_task`

In short: Stop a running task.

The client uses the stop_task command to manually stop a running task.

7.107.1 Structure

Command
- @task_id (uuid)
Response
- @status (status)
- @status_text (text)

7.107.2 RNC

Command

stop_task
 = element stop_task
     {
       attribute task_id { uuid }
     }

Response

stop_task_response
 = element stop_task_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.107.3 Example: Stop a running task

Client

 <stop_task task_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <stop_task_response status="200"
                     status_text="OK"/>

7.108 Command `sync_cert`

In short: Synchronize with a CERT feed.

The client uses the "sync_cert" command to request a synchronization with the CERT feed service the Manager uses.

7.108.1 Structure

Command
Response
- @status (status)
- @status_text (text)

7.108.2 RNC

Command

sync_cert
 = element sync_cert
     {
       ""
     }

Response

sync_cert_response
 = element sync_cert_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.108.3 Example: Sync the feed

Client

 <sync_cert/>

Manager

 <sync_cert_response status="202"
                     status_text="OK, request submitted"/>

7.109 Command `sync_feed`

In short: Synchronize with an NVT feed.

The client uses the "sync_feed" command to request a synchronization with the NVT feed service the Manager uses.

7.109.1 Structure

Command
Response
- @status (status)
- @status_text (text)

7.109.2 RNC

Command

sync_feed
 = element sync_feed
     {
       ""
     }

Response

sync_feed_response
 = element sync_feed_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.109.3 Example: Sync the feed

Client

 <sync_feed/>

Manager

 <sync_feed_response status="202"
                     status_text="OK, request submitted"/>

7.110 Command `sync_scap`

In short: Synchronize with a SCAP feed.

The client uses the "sync_scap" command to request a synchronization with the SCAP feed service the Manager uses.

7.110.1 Structure

Command
Response
- @status (status)
- @status_text (text)

7.110.2 RNC

Command

sync_scap
 = element sync_scap
     {
       ""
     }

Response

sync_scap_response
 = element sync_scap_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.110.3 Example: Sync the feed

Client

 <sync_scap/>

Manager

 <sync_scap_response status="202"
                     status_text="OK, request submitted"/>

7.111 Command `test_alert`

In short: Run an alert.

The client uses the test_alert command to invoke a test run of an alert.

7.111.1 Structure

Command
- @alert_id (uuid)
Response
- @status (status)
- @status_text (text)

7.111.2 RNC

Command

test_alert
 = element test_alert
     {
       attribute alert_id { uuid }
     }

Response

test_alert_response
 = element test_alert_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.111.3 Example: Test an alert

Client

 <test_alert alert_id="97390ade-e075-11df-9973-002264764cea"/>

Manager

 <test_alert_response status="200"
                      status_text="OK"/>

7.112 Command `verify_agent`

In short: Verify an agent.

The client uses the verify_agent command to verify the trust level of an existing agent.

The Manager checks whether the signature of the agent currently matches the agent. This includes the agent installer file. The Manager searches for the signature first in the feed, then in the agent itself.

7.112.1 Structure

Command
- @agent_id (uuid)
Response
- @status (status)
- @status_text (text)

7.112.2 RNC

Command

verify_agent
 = element verify_agent
     {
       attribute agent_id { uuid }
     }

Response

verify_agent_response
 = element verify_agent_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.112.3 Example: Verify an agent

Client

 <verify_agent agent_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <verify_agent_response status="200"
                        status_text="OK"/>

7.113 Command `verify_report_format`

In short: Verify a report format.

The client uses the verify_report_format command to verify the trust level of an existing report format.

The Manager checks whether the signature of the report format currently matches the report format. This includes the script and files used to generate reports of this format. The Manager searches for the signature first in the feed, then in the report format itself.

7.113.1 Structure

Command
- @report_format_id (uuid)
Response
- @status (status)
- @status_text (text)

7.113.2 RNC

Command

verify_report_format
 = element verify_report_format
     {
       attribute report_format_id { uuid }
     }

Response

verify_report_format_response
 = element verify_report_format_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.113.3 Example: Verify a report format

Client

 <verify_report_format report_format_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>

Manager

 <verify_report_format_response status="200"
                                status_text="OK"/>

8 Compatibility Changes in Version 6.0

8.1 Change in `PAUSE_TASK, RESUME_PAUSED_TASK`

In short: Commands removed.

The task pausing feature has been removed and thus, the PAUSE_TASK and RESUME_PAUSED_TASK commands don't exist anymore.

8.2 Change in `GET_NOTES, GET_OVERRIDES, GET_REPORTS, GET_RESULTS`

In short: Element RISK_FACTOR removed from element NVT.

Risk factors have been replaced by CVSS scores in all NVTs, so the RISK_FACTOR element has been removed from the NVT elements in various commands.

8.3 Change in `RESUME_STOPPED_TASK, RESUME_TASK`

In short: RESUME_STOPPED_TASK renamed to RESUME_TASK.

The resuming of tasks is now done via the new command RESUME_TASK, which is the former RESUME_STOPPED_TASK. There is no other resumable status than "stopped" anymore and thus the command names are consolidated for consistency and to avoid confusion.

8.4 Change in `RESUME_OR_START_TASK`

In short: Command removed.

As part of the consolidation of the start/resume handling of tasks, the command RESUME_OR_START_TASK was removed. Use a combination of START_TASK and RESUME_TASK to establish the same functionality.

8.5 Change in `CREATE_TARGET, MODIFY_TARGET`

In short: Element TARGET_LOCATOR removed.

The element TARGET_LOCATOR was removed from CREATE_TARGET and MODIFY_TARGET. This was an older, unused feature.

8.6 Change in `GET_RESULTS`

In short: "result" elements moved to response root element.

The "result" elements returned by the GET_RESULTS command are no longer nested inside a "results" element but directly inside the "get_results_response". The "results" element is used to return the "max" and "start" attributes like similar elements for other types.

8.7 Change in `GET_TARGET_LOCATORS`

In short: Command removed.

The command GET_TARGET_LOCATORS was removed.

8.8 Change in `GET_TASKS`

In short: Attribute "rcfile" and associate RCFILE removed.

The attribute "rcfile" and associate response element RCFILE were removed. It is no longer possible to get an openvasrc configuration for a task. This feature was primarily introduced to support the GTK frontend openvas-client, which is no longer maintained.

8.9 Change in `CREATE_CONFIG, CREATE_TASK, MODIFY_TASK`

In short: RCFILE removed.

The element RCFILE was removed. It is no longer possible to create or modify a config or task from an openvasrc file. This feature was primarily introduced to support the GTK frontend openvas-client, which is no longer maintained.

8.10 Change in `CREATE_LSC_CREDENTIAL`

In short: KEY/PUBLIC removed.

The child PUBLIC of element KEY was removed, because public keys are now extracted from the private key.

This file was automatically generated.

OMP: OpenVAS Management Protocol

Contents

1 Summary of Data Types

2 Summary of Elements

3 Summary of Commands

4 RNC Preamble

5 Data Type Details

5.1 Data Type alive_test

5.1.1 RNC

5.2 Data Type base64

5.2.1 RNC

5.3 Data Type boolean

5.3.1 RNC

5.4 Data Type boolean_atoi

5.4.1 RNC

5.5 Data Type ctime

5.5.1 RNC

5.6 Data Type type_name

5.6.1 RNC

5.7 Data Type integer

5.7.1 RNC

5.8 Data Type iso_time

5.8.1 RNC

5.9 Data Type levels

5.9.1 RNC

5.10 Data Type name

5.10.1 RNC

5.11 Data Type port

5.11.1 RNC

5.12 Data Type user_list

5.12.1 RNC

5.13 Data Type oid

5.13.1 RNC

5.14 Data Type severity

5.14.1 RNC

5.15 Data Type sort_order

5.15.1 RNC

5.16 Data Type status

5.16.1 RNC

5.17 Data Type task_status

5.17.1 RNC

5.18 Data Type task_trend

5.18.1 RNC

5.19 Data Type threat

5.19.1 RNC

5.20 Data Type time_unit

5.20.1 RNC

5.21 Data Type timezone

5.21.1 RNC

5.22 Data Type uuid

5.22.1 RNC

5.23 Data Type uuid_or_empty

5.23.1 RNC

6 Element Details

6.1 Element c

6.1.1 Structure

6.1.2 RNC

6.2 Element e

6.2.1 Structure

6.2.2 RNC

6.3 Element r

6.3.1 Structure

6.3.2 RNC

6.4 Element o

6.4.1 Structure

6.4.2 RNC

6.5 Element g

6.5.1 Structure

6.5.2 RNC

6.6 Element any

6.6.1 Structure

6.6.2 RNC

6.7 Element pattern

6.7.1 Structure

6.7.2 RNC

6.8 Element command_definition

6.8.1 Structure

6.8.2 RNC

6.9 Element note

6.9.1 Structure

5.1 Data Type `alive_test`

5.2 Data Type `base64`

5.3 Data Type `boolean`

5.4 Data Type `boolean_atoi`

5.5 Data Type `ctime`

5.6 Data Type `type_name`

5.7 Data Type `integer`

5.8 Data Type `iso_time`

5.9 Data Type `levels`

5.10 Data Type `name`

5.11 Data Type `port`

5.12 Data Type `user_list`

5.13 Data Type `oid`

5.14 Data Type `severity`

5.15 Data Type `sort_order`

5.16 Data Type `status`

5.17 Data Type `task_status`

5.18 Data Type `task_trend`

5.19 Data Type `threat`

5.20 Data Type `time_unit`

5.21 Data Type `timezone`

5.22 Data Type `uuid`

5.23 Data Type `uuid_or_empty`

6.1 Element `c`

6.2 Element `e`

6.3 Element `r`

6.4 Element `o`

6.5 Element `g`

6.6 Element `any`

6.7 Element `pattern`

6.8 Element `command_definition`

6.9 Element `note`

6.10 Element `override`

6.11 Element `result`

6.12 Element `report`

7.1 Command `authenticate`

7.2 Command `commands`

7.3 Command `create_agent`

7.4 Command `create_config`

7.5 Command `create_alert`

7.6 Command `create_filter`

7.7 Command `create_group`

7.8 Command `create_lsc_credential`

7.9 Command `create_note`

7.10 Command `create_override`

7.11 Command `create_permission`

7.12 Command `create_port_list`

7.13 Command `create_port_range`

7.14 Command `create_report`

7.15 Command `create_report_format`