OpenVAS Management Protocol (OMP) Version 5.0 - Greenbone OS 3.0

Contents

  1. Summary of Data Types
  2. Summary of Elements
  3. Summary of Commands
  4. RNC Preamble
  5. Data Type Details
  6. Element Details
  7. Command Details
  8. Compatibility Changes in Version 5.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.
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.
result_notes
Notes on a result.
result_overrides
Overrides on a result.
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_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_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 all agents.
get_configs
Get all configs.
get_alerts
Get all alerts.
get_filters
Get all filters.
get_groups
Get all groups.
get_info
Get information for items of given type.
get_lsc_credentials
Get all LSC credentials.
get_notes
Get all notes.
get_nvts
Get all NVTs.
get_nvt_families
Get a list of all NVT families.
get_nvt_feed_version
Get NVT Feed version.
get_overrides
Get all overrides.
get_permissions
Get all permissions.
get_port_lists
Get all port lists.
get_preferences
Get all preferences.
get_reports
Get all reports.
get_report_formats
Get all report formats.
get_results
Get results.
get_roles
Get all roles.
get_schedules
Get all schedules.
get_settings
Get all settings.
get_slaves
Get all slaves.
get_system_reports
Get all system reports.
get_tags
Get all tags.
get_target_locators
Get configured target locators.
get_targets
Get all targets.
get_tasks
Get all tasks.
get_users
Get all 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_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.
pause_task
Pause a running task.
restore
Restore a resource.
resume_or_start_task
Resume task if stopped, else start task.
resume_paused_task
Resume a paused task.
resume_stopped_task
Resume a stopped 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_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_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_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_schedules
    | get_settings
    | get_slaves
    | get_system_reports
    | get_tags
    | get_target_locators
    | 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_schedule
    | modify_setting
    | modify_slave
    | modify_target
    | modify_tag
    | modify_task
    | modify_user
    | pause_task
    | restore
    | resume_or_start_task
    | resume_paused_task
    | resume_stopped_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_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_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_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_schedules_response
    | get_settings_response
    | get_slaves_response
    | get_system_reports_response
    | get_tags_response
    | get_target_locators_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_schedule_response
    | modify_setting_response
    | modify_slave_response
    | modify_target_response
    | modify_tag_response
    | modify_task_response
    | modify_user_response
    | pause_task_response
    | restore_response
    | resume_or_start_task_response
    | resume_paused_task_response
    | resume_stopped_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|Pause Requested|Paused|Requ↵
ested|Resume Requested|Running|Stop Requested|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 uuid

In short: A Universally Unique Identifier (UUID).

5.21.1 RNC

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

5.22 Data Type uuid_or_empty

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

5.22.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

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

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

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

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

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 result_notes

In short: Notes on a result.

6.9.1 Structure

6.9.2 RNC

result_notes
 = element result_notes
     {
       result_notes_note*
     }

result_notes_note
 = element note
     {
       result_notes_note_nvt
       & result_notes_note_text
       & result_notes_note_orphan
     }

result_notes_note_nvt
 = element nvt
     {
       attribute oid { oid }
       & result_notes_note_nvt_name
     }

result_notes_note_nvt_name
 = element name
     {
       name
     }

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

result_notes_note_orphan
 = element orphan
     {
       boolean
     }

6.10 Element result_overrides

In short: Overrides on a result.

6.10.1 Structure

6.10.2 RNC

result_overrides
 = element result_overrides
     {
       result_overrides_override*
     }

result_overrides_override
 = element override
     {
       result_overrides_override_nvt
       & result_overrides_override_text
       & result_overrides_override_threat
       & result_overrides_override_severity
       & result_overrides_override_new_threat
       & result_overrides_override_new_severity
       & result_overrides_override_orphan
     }

result_overrides_override_nvt
 = element nvt
     {
       attribute oid { oid }
       & result_overrides_override_nvt_name
     }

result_overrides_override_nvt_name
 = element name
     {
       name
     }

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

result_overrides_override_threat
 = element threat
     {
       threat
     }

result_overrides_override_severity
 = element severity
     {
       severity
     }

result_overrides_override_new_threat
 = element new_threat
     {
       threat
     }

result_overrides_override_new_severity
 = element new_severity
     {
       severity
     }

result_overrides_override_orphan
 = element orphan
     {
       boolean
     }

6.11 Element result

In short: A result.

6.11.1 Structure

6.11.2 RNC

result
 = element result
     {
       attribute id { uuid }
       & result_user_tags?
       & result_report?
       & result_task?
       & result_host
       & result_port
       & result_nvt
       & result_threat
       & result_severity
       & result_original_threat?
       & result_original_severity?
       & result_description
       & result_delta?
       & result_details
       & result_detection
       & result_notes?
       & result_overrides?
     }

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_risk_factor
       & 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_risk_factor
 = element risk_factor
     {
       integer
     }

result_nvt_cve
 = element cve
     {
       text
     }

result_nvt_bid
 = element bid
     {
       text
     }

result_nvt_tags
 = element tags
     {
       text
     }

result_nvt_cert
 = element cert
     {
       text
     }

result_nvt_xref
 = element xref
     {
       text
     }

result_threat
 = element threat
     {
       threat
     }

result_severity
 = element severity
     {
       severity
     }

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_user_tags?
       & result_report?
       & result_task?
       & result_host
       & result_port
       & result_nvt
       & result_threat
       & result_severity
       & 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    # type result_notes
     {
       result_notes_note*
     }

result_delta_overrides
 = element overrides    # type result_overrides
     {
       result_overrides_override*
     }

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    # type result
     {
       attribute id { uuid }
       & result_user_tags?
       & result_report?
       & result_task?
       & result_host
       & result_port
       & result_nvt
       & result_threat
       & result_severity
       & result_original_threat?
       & result_original_severity?
       & result_description
       & result_delta?
       & result_details
       & result_detection
       & result_notes?
       & result_overrides?
     }

result_notes
 = element notes    # type result_notes
     {
       result_notes_note*
     }

result_overrides
 = element overrides    # type result_overrides
     {
       result_overrides_override*
     }

6.12 Element report

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

6.12.1 Structure

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" } }?
       & report_owner
       & report_name
       & report_comment
       & report_creation_time
       & report_modification_time
       & report_writable
       & report_in_use
       & 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_report
 = element report
     {
       attribute id { uuid }
       & attribute type { xsd:token { pattern = "scan|assets" } }?
       & report_report_report_format
       & report_report_delta?
       & ( report_report_sort
           & report_report_filters
           & report_report_permissions
           & report_report_user_tags
           & report_report_scan_run_status
           & report_report_result_count
           & report_report_severity
           & report_report_severity_class
           & report_report_host_count?
           & report_report_task
           & report_report_scan
           & report_report_ports
           & report_report_results
           & report_report_hosts?
           & report_report_host*
           & report_report_timestamp
           & report_report_scan_start
           & report_report_host_start*
           & report_report_host_end*
           & report_report_scan_end )?
     }

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_autofp
       & report_report_filters_show_closed_cves
       & 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_autofp
 = element autofp
     {
       xsd:token { pattern = "0|1|2" }
     }

report_report_filters_show_closed_cves
 = element show_closed_cves    # type boolean
     {
     }

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_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
       & target
     }

report_report_task_name
 = element name
     {
       name
     }

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_user_tags?
       & result_report?
       & result_task?
       & result_host
       & result_port
       & result_nvt
       & result_threat
       & result_severity
       & 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_host
 = element host
     {
       report_report_host_ip
       & report_report_host_start
       & report_report_host_end
       & 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_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
     }

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

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 UserAdminObserver
     {
     }

authenticate_response_timezone
 = element timezone
     {
       text
     }

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

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_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_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_schedules
           | get_settings
           | get_slaves
           | get_system_reports
           | get_tags
           | get_target_locators
           | 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_schedule
           | modify_setting
           | modify_slave
           | modify_tag
           | modify_target
           | modify_task
           | modify_user
           | pause_task
           | restore
           | resume_or_start_task
           | resume_paused_task
           | resume_stopped_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_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_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_schedules_response
           | get_settings_response
           | get_system_reports_response
           | get_tags_response
           | get_target_locators_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_schedule_response
           | modify_setting_response
           | modify_slave_response
           | modify_tag_response
           | modify_target_response
           | modify_task_response
           | modify_user_response
           | pause_task_response
           | restore_response
           | resume_or_start_task_response
           | resume_paused_task_response
           | resume_stopped_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

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:

7.4.1 Structure

7.4.2 RNC

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

create_config_comment
 = element comment
     {
       text
     }

create_config_copy
 = element copy
     {
       uuid
     }

create_config_rcfile
 = element rcfile
     {
       base64
     }

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 an RC file

Client
 <create_config>
   <rcfile>asdf3235saf3kjBVF...</rcfile>
   <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

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

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

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
     {
     }

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

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_public
     }

create_lsc_credential_key_phrase
 = element phrase
     {
       text
     }

create_lsc_credential_key_private
 = element private
     {
       text
     }

create_lsc_credential_key_public
 = element public
     {
       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

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

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

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_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

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

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

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" } }?
       & report_owner
       & report_name
       & report_comment
       & report_creation_time
       & report_modification_time
       & report_writable
       & report_in_use
       & 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>
   <get_reports_response>
     <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>
   </get_reports_response>
   <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

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

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
     {
     }

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_schedule

In short: Create a schedule.

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

7.17.1 Structure

7.17.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
     {
       text
     }
Response
create_schedule_response
 = element create_schedule_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.17.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.18 Command create_slave

In short: Create a slave.

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

7.18.1 Structure

7.18.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.18.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.19 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.19.1 Structure

7.19.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.19.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.20 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.20.1 Structure

7.20.2 RNC

Command
create_target
 = element create_target
     {
       create_target_name
       & create_target_comment?
       & create_target_copy?
       & create_target_hosts
       & create_target_ssh_lsc_credential
       & create_target_smb_lsc_credential
       & create_target_target_locator
       & 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_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_target_locator
 = element target_locator
     {
       create_target_target_locator_username?
       & create_target_target_locator_password?
     }

create_target_target_locator_username
 = element username
     {
       text
     }

create_target_target_locator_password
 = element password
     {
       text
     }

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.20.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.21 Command create_task

In short: Create a task.

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

If an rcfile is given, then config and target should actually be left out. This form of the command is special support for OpenVAS-Client, and will likely be removed in future versions.

7.21.1 Structure

7.21.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_alert*
       & create_task_schedule?
       & create_task_slave?
       & create_task_observers?
       & create_task_preferences?
       & create_task_rcfile?
     }

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_alert
 = element alert
     {
       attribute id { uuid }
     }

create_task_schedule
 = element schedule
     {
       attribute id { uuid }
     }

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
     }

create_task_rcfile
 = element rcfile
     {
       base64
     }
Response
create_task_response
 = element create_task_response
     {
       attribute status { status }
       & attribute status_text { text }
       & attribute id { uuid }
     }

7.21.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"/>
 </create_task>
Manager
 <create_task_response status="201"
                       status_text="OK, resource created"
                       id="254cd3ef-bbe1-4d58-859d-21b8d0c046c6"/>

7.22 Command create_user

In short: Create a user.

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

7.22.1 Structure

7.22.2 RNC

Command
create_user
 = element create_user
     {
       create_user_name
       & create_user_copy?
       & create_user_hosts?
       & 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_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.22.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.23 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.23.1 Structure

7.23.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.23.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.24 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.24.1 Structure

7.24.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.24.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.25 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.25.1 Structure

7.25.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.25.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.26 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.26.1 Structure

7.26.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.26.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.27 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.27.1 Structure

7.27.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.27.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.28 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.28.1 Structure

7.28.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.28.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.29 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.29.1 Structure

7.29.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.29.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.30 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.30.1 Structure

7.30.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.30.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.31 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.31.1 Structure

7.31.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.31.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.32 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.32.1 Structure

7.32.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.32.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.33 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.33.1 Structure

7.33.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.33.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.34 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.34.1 Structure

7.34.2 RNC

Command
delete_port_range
 = element delete_port_range
     {
       attribute port_range_id { uuid }
       & attribute ultimate { boolean }
     }
Response
delete_port_range_response
 = element delete_port_range_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.34.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.35 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.35.1 Structure

7.35.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.35.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.36 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.36.1 Structure

7.36.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.36.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.37 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.37.1 Structure

7.37.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.37.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.38 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.38.1 Structure

7.38.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.38.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.39 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.39.1 Structure

7.39.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.39.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.40 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.40.1 Structure

7.40.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.40.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.41 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.41.1 Structure

7.41.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.41.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.42 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.42.1 Structure

7.42.2 RNC

Command
delete_user
 = element delete_user
     {
       attribute user_id { uuid }
       & attribute ultimate { boolean }
       & 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.42.3 Example: Delete a user

Client
 <delete_user name="foobar"/>
Manager
 <delete_user_response status="200"
                       status_text="OK"/>

7.43 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.43.1 Structure

7.43.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.43.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.44 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.44.1 Structure

7.44.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.44.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.45 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.45.1 Structure

7.45.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.45.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.46 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.46.1 Structure

7.46.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.46.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.47 Command empty_trashcan

In short: Empty the trashcan.

The client uses the empty_trashcan command to empty the trashcan.

7.47.1 Structure

7.47.2 RNC

Command
empty_trashcan
 = element empty_trashcan
     {
       ""
     }
Response
empty_trashcan_response
 = element empty_trashcan_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.47.3 Example: Empty the trashcan

Client
 <empty_trashcan/>
Manager
 <empty_trashcan_response status="200"
                          status_text="OK"/>

7.48 Command get_agents

In short: Get all 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.48.1 Structure

7.48.2 RNC

Command
get_agents
 = element get_agents
     {
       attribute agent_id { uuid }?
       & attribute filter { uuid }?
       & 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_keywords
     }

get_agents_response_filters_term
 = element term
     {
       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.48.3 Example: Get all 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.48.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.48.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.49 Command get_configs

In short: Get all 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.49.1 Structure

7.49.2 RNC

Command
get_configs
 = element get_configs
     {
       attribute config_id { uuid }?
       & attribute filter { uuid }?
       & attribute filt_id { uuid }?
       & attribute trash { boolean }?
       & attribute details { boolean }?
       & attribute export { 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_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_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_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_name
 = element name
     {
       name
     }

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_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_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_filters
 = element filters
     {
       attribute id { uuid }
       & get_configs_response_filters_term
       & get_configs_response_filters_keywords
     }

get_configs_response_filters_term
 = element term
     {
       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.49.3 Example: Get all 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.49.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.50 Command get_alerts

In short: Get all 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.50.1 Structure

7.50.2 RNC

Command
get_alerts
 = element get_alerts
     {
       attribute alert_id { uuid }?
       & attribute filter { uuid }?
       & 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_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_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_trash
     }

get_alerts_response_alert_filter_name
 = element name
     {
       name
     }

get_alerts_response_alert_filter_trash
 = element trash
     {
       boolean
     }

7.50.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.51 Command get_filters

In short: Get all filters.

The client uses the get_filters command to get filter information.

7.51.1 Structure

7.51.2 RNC

Command
get_filters
 = element get_filters
     {
       attribute filter_id { uuid }?
       & attribute filter { uuid }?
       & 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_name
 = element name
     {
       name
     }

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

get_filters_response_filters_term
 = element term
     {
       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.51.3 Example: Get all 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.51.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.52 Command get_groups

In short: Get all groups.

The client uses the get_groups command to get group information.

7.52.1 Structure

7.52.2 RNC

Command
get_groups
 = element get_groups
     {
       attribute group_id { uuid }?
       & attribute filter { uuid }?
       & 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_keywords
     }

get_groups_response_filters_term
 = element term
     {
       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.52.3 Example: Get all 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.53 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.53.1 Structure

7.53.2 RNC

Command
get_info
 = element get_info
     {
       attribute type { text }
       & attribute name { text }?
       & attribute info_id { text }?
       & attribute filter { uuid }?
       & 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_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_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_deprecated_by?
       & 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_deprecated_by
 = element deprecated_by
     {
       integer
     }

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_keywords
     }

get_info_response_filters_term
 = element term    # type 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.53.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.53.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.54 Command get_lsc_credentials

In short: Get all 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.54.1 Structure

7.54.2 RNC

Command
get_lsc_credentials
 = element get_lsc_credentials
     {
       attribute lsc_credential_id { uuid }?
       & attribute filter { uuid }?
       & 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_name
 = element name
     {
       name
     }

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_keywords
     }

get_lsc_credentials_response_filters_term
 = element term
     {
       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.54.3 Example: Get all 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.54.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.54.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.55 Command get_notes

In short: Get all 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.55.1 Structure

7.55.2 RNC

Command
get_notes
 = element get_notes
     {
       attribute note_id { uuid }?
       & attribute filter { uuid }?
       & 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_keywords
     }

get_notes_response_filters_term
 = element term
     {
       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
     {
       get_notes_response_note_nvt
       & get_notes_response_note_text
       & get_notes_response_note_orphan
       & get_notes_response_note_permissions
       & get_notes_response_note_user_tags
       & ( get_notes_response_note_owner
           & get_notes_response_note_creation_time
           & get_notes_response_note_modification_time
           & get_notes_response_note_hosts
           & get_notes_response_note_port
           & get_notes_response_note_severity
           & get_notes_response_note_threat
           & get_notes_response_note_task
           & get_notes_response_note_active
           & get_notes_response_note_end_time?
           & get_notes_response_note_result? )?
     }

get_notes_response_note_nvt
 = element nvt
     {
       attribute oid { oid }
       & get_notes_response_note_nvt_name
     }

get_notes_response_note_nvt_name
 = element name
     {
       name
     }

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

get_notes_response_note_orphan
 = element orphan
     {
       boolean
     }

get_notes_response_note_permissions
 = element permissions
     {
       get_notes_response_note_permissions_permission*
     }

get_notes_response_note_permissions_permission
 = element permission
     {
       get_notes_response_note_permissions_permission_name
     }

get_notes_response_note_permissions_permission_name
 = element name
     {
       name
     }

get_notes_response_note_user_tags
 = element user_tags
     {
       get_notes_response_note_user_tags_count
       & get_notes_response_note_user_tags_tag*
     }

get_notes_response_note_user_tags_count
 = element count
     {
       integer
     }

get_notes_response_note_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_notes_response_note_user_tags_tag_name
       & get_notes_response_note_user_tags_tag_value
       & get_notes_response_note_user_tags_tag_comment
     }

get_notes_response_note_user_tags_tag_name
 = element name
     {
       text
     }

get_notes_response_note_user_tags_tag_value
 = element value
     {
       text
     }

get_notes_response_note_user_tags_tag_comment
 = element comment
     {
       text
     }

get_notes_response_note_owner
 = element owner
     {
       get_notes_response_note_owner_name
     }

get_notes_response_note_owner_name
 = element name
     {
       name
     }

get_notes_response_note_creation_time
 = element creation_time
     {
       iso_time
     }

get_notes_response_note_modification_time
 = element modification_time
     {
       iso_time
     }

get_notes_response_note_hosts
 = element hosts
     {
       text
     }

get_notes_response_note_port
 = element port
     {
       text
     }

get_notes_response_note_severity
 = element severity
     {
       severity
     }

get_notes_response_note_threat
 = element threat
     {
       threat
     }

get_notes_response_note_task
 = element task
     {
       attribute id { uuid }
     }

get_notes_response_note_active
 = element active
     {
       integer
     }

get_notes_response_note_end_time
 = element end_time
     {
       text
     }

get_notes_response_note_result
 = element result
     {
       attribute id { uuid }
       & get_notes_response_note_result_host
       & get_notes_response_note_result_port
       & get_notes_response_note_result_nvt
       & get_notes_response_note_result_severity
       & get_notes_response_note_result_threat
       & get_notes_response_note_result_description
     }

get_notes_response_note_result_host
 = element host
     {
       text
     }

get_notes_response_note_result_port
 = element port
     {
       text
     }

get_notes_response_note_result_nvt
 = element nvt
     {
       attribute oid { oid }
       & get_notes_response_note_result_nvt_name
       & get_notes_response_note_result_nvt_cvss_base
       & get_notes_response_note_result_nvt_risk_factor
       & get_notes_response_note_result_nvt_cve?
       & get_notes_response_note_result_nvt_bid?
     }

get_notes_response_note_result_nvt_name
 = element name
     {
       name
     }

get_notes_response_note_result_nvt_cvss_base
 = element cvss_base
     {
       text
     }

get_notes_response_note_result_nvt_risk_factor
 = element risk_factor
     {
       text
     }

get_notes_response_note_result_nvt_cve
 = element cve
     {
       text
     }

get_notes_response_note_result_nvt_bid
 = element bid
     {
       integer
     }

get_notes_response_note_result_severity
 = element severity
     {
       severity
     }

get_notes_response_note_result_threat
 = element threat
     {
       threat
     }

get_notes_response_note_result_description
 = element description
     {
       text
     }

7.55.3 Example: Get all 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.55.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/>
         <risk_factor/>
         <cve/>
         <bid/>
       </nvt>
       <threat>Medium</threat>
       <description>Warning with control char between fullstops: . .</description>
     </result>
   </note>
   ...
 </get_notes_response>

7.56 Command get_nvts

In short: Get all 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 and checksum.

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.56.1 Structure

7.56.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 id { uuid }
       & get_nvts_response_nvt_name
       & get_nvts_response_nvt_checksum
       & get_nvts_response_nvt_creation_time
       & get_nvts_response_nvt_modification_time
       & get_nvts_response_nvt_permissions
       & get_nvts_response_nvt_user_tags
       & ( get_nvts_response_nvt_category
           & get_nvts_response_nvt_copyright
           & get_nvts_response_nvt_description
           & 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_risk_factor
           & 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_permissions
 = element permissions
     {
       get_nvts_response_nvt_permissions_permission*
     }

get_nvts_response_nvt_permissions_permission
 = element permission
     {
       get_nvts_response_nvt_permissions_permission_name
     }

get_nvts_response_nvt_permissions_permission_name
 = element name
     {
       name
     }

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_description
 = element description
     {
       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_risk_factor
 = element risk_factor
     {
       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_checksum
 = element checksum
     {
       text
       & get_nvts_response_nvt_checksum_algorithm
     }

get_nvts_response_nvt_checksum_algorithm
 = element algorithm
     {
       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_default
     }

get_nvts_response_nvt_preferences_preference_nvt
 = element nvt
     {
       oid
     }

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_default
 = element default
     {
       text
     }

7.56.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>
     <description>
       This script attempts to detect which service is running on which port.
     </description>
     <summary>Find what is listening on which port</summary>
     <family>Service detection</family>
     <version>$Revision: 1852 $</version>
     <cvss_base/>
     <risk_factor>None</risk_factor>
     <cve_id>NOCVE</cve_id>
     <bugtraq_id>NOBID</bugtraq_id>
     <cert_refs/>
     <xrefs>NOXREF</xrefs>
     <tags>NOTAG</tags>
     <preference_count>-1</preference_count>
     <timeout/>
     <checksum>
       2397586ea5cd3a69f953836f7be9ef7b
       <algorithm>md5</algorithm>
     </checksum>
     <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.56.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>
     <checksum>
       2397586ea5cd3a69f953836f7be9ef7b
       <algorithm>md5</algorithm>
     </checksum>
   </nvt>
 </get_nvts_response>

7.57 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.57.1 Structure

7.57.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.57.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.58 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.58.1 Structure

7.58.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.58.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.59 Command get_overrides

In short: Get all 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.59.1 Structure

7.59.2 RNC

Command
get_overrides
 = element get_overrides
     {
       attribute override_id { uuid }?
       & attribute filter { uuid }?
       & 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_keywords
     }

get_overrides_response_filters_term
 = element term
     {
       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
     {
       get_overrides_response_override_nvt
       & get_overrides_response_override_owner
       & get_overrides_response_override_creation_time
       & get_overrides_response_override_modification_time
       & get_overrides_response_override_writable
       & get_overrides_response_override_in_use
       & get_overrides_response_override_text
       & get_overrides_response_override_threat
       & get_overrides_response_override_severity
       & get_overrides_response_override_new_threat
       & get_overrides_response_override_new_severity
       & get_overrides_response_override_orphan
       & get_overrides_response_override_permissions
       & get_overrides_response_override_user_tags
       & ( get_overrides_response_override_hosts
           & get_overrides_response_override_port
           & get_overrides_response_override_task
           & get_overrides_response_override_active
           & get_overrides_response_override_end_time?
           & get_overrides_response_override_result? )?
     }

get_overrides_response_override_nvt
 = element nvt
     {
       attribute oid { oid }
       & get_overrides_response_override_nvt_name
     }

get_overrides_response_override_nvt_name
 = element name
     {
       name
     }

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

get_overrides_response_override_owner
 = element owner
     {
       get_overrides_response_override_owner_name
     }

get_overrides_response_override_owner_name
 = element name
     {
       name
     }

get_overrides_response_override_creation_time
 = element creation_time
     {
       iso_time
     }

get_overrides_response_override_modification_time
 = element modification_time
     {
       iso_time
     }

get_overrides_response_override_writable
 = element writable
     {
       boolean
     }

get_overrides_response_override_in_use
 = element in_use
     {
       boolean
     }

get_overrides_response_override_threat
 = element threat
     {
       threat
     }

get_overrides_response_override_severity
 = element severity
     {
       severity
     }

get_overrides_response_override_new_threat
 = element new_threat
     {
       threat
     }

get_overrides_response_override_new_severity
 = element new_severity
     {
       severity
     }

get_overrides_response_override_orphan
 = element orphan
     {
       boolean
     }

get_overrides_response_override_permissions
 = element permissions
     {
       get_overrides_response_override_permissions_permission*
     }

get_overrides_response_override_permissions_permission
 = element permission
     {
       get_overrides_response_override_permissions_permission_name
     }

get_overrides_response_override_permissions_permission_name
 = element name
     {
       name
     }

get_overrides_response_override_user_tags
 = element user_tags
     {
       get_overrides_response_override_user_tags_count
       & get_overrides_response_override_user_tags_tag*
     }

get_overrides_response_override_user_tags_count
 = element count
     {
       integer
     }

get_overrides_response_override_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_overrides_response_override_user_tags_tag_name
       & get_overrides_response_override_user_tags_tag_value
       & get_overrides_response_override_user_tags_tag_comment
     }

get_overrides_response_override_user_tags_tag_name
 = element name
     {
       text
     }

get_overrides_response_override_user_tags_tag_value
 = element value
     {
       text
     }

get_overrides_response_override_user_tags_tag_comment
 = element comment
     {
       text
     }

get_overrides_response_override_hosts
 = element hosts
     {
       text
     }

get_overrides_response_override_port
 = element port
     {
       text
     }

get_overrides_response_override_task
 = element task
     {
       attribute id { uuid }
     }

get_overrides_response_override_active
 = element active
     {
       integer
     }

get_overrides_response_override_end_time
 = element end_time
     {
       text
     }

get_overrides_response_override_result
 = element result
     {
       attribute id { uuid }
       & get_overrides_response_override_result_host
       & get_overrides_response_override_result_port
       & get_overrides_response_override_result_nvt
       & get_overrides_response_override_result_threat
       & get_overrides_response_override_result_severity
       & get_overrides_response_override_result_description
     }

get_overrides_response_override_result_host
 = element host
     {
       text
     }

get_overrides_response_override_result_port
 = element port
     {
       text
     }

get_overrides_response_override_result_nvt
 = element nvt
     {
       attribute oid { oid }
       & get_overrides_response_override_result_nvt_name
       & get_overrides_response_override_result_nvt_cvss_base
       & get_overrides_response_override_result_nvt_risk_factor
       & get_overrides_response_override_result_nvt_cve?
       & get_overrides_response_override_result_nvt_bid?
     }

get_overrides_response_override_result_nvt_name
 = element name
     {
       name
     }

get_overrides_response_override_result_nvt_cvss_base
 = element cvss_base
     {
       text
     }

get_overrides_response_override_result_nvt_risk_factor
 = element risk_factor
     {
       text
     }

get_overrides_response_override_result_nvt_cve
 = element cve
     {
       text
     }

get_overrides_response_override_result_nvt_bid
 = element bid
     {
       integer
     }

get_overrides_response_override_result_threat
 = element threat
     {
       threat
     }

get_overrides_response_override_result_severity
 = element severity
     {
       severity
     }

get_overrides_response_override_result_description
 = element description
     {
       text
     }

7.59.3 Example: Get all 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.59.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.60 Command get_permissions

In short: Get all permissions.

The client uses the get_permissions command to get permission information.

7.60.1 Structure

7.60.2 RNC

Command
get_permissions
 = element get_permissions
     {
       attribute permission_id { uuid }?
       & attribute filter { uuid }?
       & attribute filt_id { uuid }?
       & attribute trash { boolean }?
       & attribute resource_id { uuid }?
     }
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_keywords
     }

get_permissions_response_filters_term
 = element term
     {
       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.60.3 Example: Get all 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.61 Command get_port_lists

In short: Get all port lists.

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

7.61.1 Structure

7.61.2 RNC

Command
get_port_lists
 = element get_port_lists
     {
       attribute port_list_id { uuid }?
       & attribute filter { uuid }?
       & 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_name
 = element name
     {
       name
     }

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

get_port_lists_response_filters_term
 = element term
     {
       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.61.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.62 Command get_preferences

In short: Get all 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.62.1 Structure

7.62.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_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_default
 = element default
     {
       text
     }

7.62.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.62.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.62.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.62.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.63 Command get_reports

In short: Get all 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.63.1 Structure

7.63.2 RNC

Command
get_reports
 = element get_reports
     {
       attribute report_id { uuid }?
       & attribute filter { uuid }?
       & attribute 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 levels { levels }?
       & attribute search_phrase { text }?
       & attribute min_cvss_base { 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 {  }?
       & attribute show_closed_cves { boolean }?
     }
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" } }?
       & report_owner
       & report_name
       & report_comment
       & report_creation_time
       & report_modification_time
       & report_writable
       & report_in_use
       & report_report
     }

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

get_reports_response_filters_term
 = element term
     {
       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.63.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.63.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">
       <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>
         <show_closed_cves>0</show_closed_cves>
         <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>
       <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>
       <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>
             <risk_factor>Medium</risk_factor>
             <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>
       <scan_start>Mon Feb 1 19:11:21 2010</scan_start>
       <host_start>
         Mon Feb 1 19:11:21 2010
         <host>127.0.1.1</host>
       </host_start>
       <host_end>
         Mon Feb 1 19:11:52 2010
         <host>127.0.1.1</host>
       </host_end>
       <scan_end>Mon Feb 1 19:11:52 2010</scan_end>
     </report>
   </report>
 </get_reports_response>

7.64 Command get_report_formats

In short: Get all report formats.

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

7.64.1 Structure

7.64.2 RNC

Command
get_report_formats
 = element get_report_formats
     {
       attribute report_format_id { uuid }?
       & attribute filter { uuid }?
       & 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_name
 = element name
     {
       name
     }

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_keywords
     }

get_report_formats_response_filters_term
 = element term
     {
       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.64.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.64.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.65 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.65.1 Structure

7.65.2 RNC

Command
get_results
 = element get_results
     {
       attribute result_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 details { boolean }?
     }
Response
get_results_response
 = element get_results_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_results_response_results
     }

get_results_response_results
 = element results
     {
       get_results_response_results_result*
     }

get_results_response_results_result
 = element result
     {
       attribute id { uuid }
       & get_results_response_results_result_permissions
       & get_results_response_results_result_user_tags
       & get_results_response_results_result_report?
       & get_results_response_results_result_task?
       & get_results_response_results_result_host
       & get_results_response_results_result_port
       & get_results_response_results_result_nvt
       & get_results_response_results_result_scan_nvt_version
       & get_results_response_results_result_threat
       & get_results_response_results_result_severity
       & get_results_response_results_result_description
       & get_results_response_results_result_original_severity?
       & get_results_response_results_result_notes?
       & get_results_response_results_result_overrides?
     }

get_results_response_results_result_permissions
 = element permissions
     {
       get_results_response_results_result_permissions_permission*
     }

get_results_response_results_result_permissions_permission
 = element permission
     {
       get_results_response_results_result_permissions_permission_name
     }

get_results_response_results_result_permissions_permission_name
 = element name
     {
       name
     }

get_results_response_results_result_user_tags
 = element user_tags
     {
       get_results_response_results_result_user_tags_count
       & get_results_response_results_result_user_tags_tag*
     }

get_results_response_results_result_user_tags_count
 = element count
     {
       integer
     }

get_results_response_results_result_user_tags_tag
 = element tag
     {
       attribute id { uuid }
       & get_results_response_results_result_user_tags_tag_name
       & get_results_response_results_result_user_tags_tag_value
       & get_results_response_results_result_user_tags_tag_comment
     }

get_results_response_results_result_user_tags_tag_name
 = element name
     {
       text
     }

get_results_response_results_result_user_tags_tag_value
 = element value
     {
       text
     }

get_results_response_results_result_user_tags_tag_comment
 = element comment
     {
       text
     }

get_results_response_results_result_report
 = element report
     {
       attribute id { uuid }
     }

get_results_response_results_result_task
 = element task
     {
       attribute id { uuid }
       & get_results_response_results_result_task_name
     }

get_results_response_results_result_task_name
 = element name
     {
       text
     }

get_results_response_results_result_host
 = element host
     {
       text
     }

get_results_response_results_result_port
 = element port
     {
       text
     }

get_results_response_results_result_nvt
 = element nvt
     {
       attribute oid { oid }
       & get_results_response_results_result_nvt_name
       & get_results_response_results_result_nvt_cvss_base
       & get_results_response_results_result_nvt_risk_factor
       & get_results_response_results_result_nvt_cve
       & get_results_response_results_result_nvt_bid
       & get_results_response_results_result_nvt_tags
       & get_results_response_results_result_nvt_cert
       & get_results_response_results_result_nvt_xref
     }

get_results_response_results_result_nvt_name
 = element name
     {
       name
     }

get_results_response_results_result_nvt_cvss_base
 = element cvss_base
     {
       integer
     }

get_results_response_results_result_nvt_risk_factor
 = element risk_factor
     {
       integer
     }

get_results_response_results_result_nvt_cve
 = element cve
     {
       text
     }

get_results_response_results_result_nvt_bid
 = element bid
     {
       integer
     }

get_results_response_results_result_nvt_tags
 = element tags
     {
       text
     }

get_results_response_results_result_nvt_cert
 = element cert
     {
       get_results_response_results_result_nvt_cert_cert_ref*
     }

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

get_results_response_results_result_nvt_xref
 = element xref
     {
       text
     }

get_results_response_results_result_scan_nvt_version
 = element scan_nvt_version
     {
       text
     }

get_results_response_results_result_threat
 = element threat
     {
       threat
     }

get_results_response_results_result_severity
 = element severity
     {
       severity
     }

get_results_response_results_result_description
 = element description
     {
       text
     }

get_results_response_results_result_original_severity
 = element original_severity
     {
       severity
     }

get_results_response_results_result_notes
 = element notes    # type result_notes
     {
       result_notes_note*
     }

get_results_response_results_result_overrides
 = element overrides    # type result_overrides
     {
       result_overrides_override*
     }

7.65.3 Example: Get all results

Client
 <get_results/>
Manager
 <get_results_response status="200"
                       status_text="OK">
   <results>
     <result id="634f7a2e-8ca1-43b7-b6d7-0d4841449508">
       <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>
         <risk_factor>Medium</risk_factor>
         <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>
     ...
   </results>
 </get_results_response>

7.65.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">
   <results>
     <result id="cac9e7c8-c726-49fd-a710-5f99079ab93e">
       <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>
         <risk_factor>High</risk_factor>
         <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>
   </results>
 </get_results_response>

7.66 Command get_roles

In short: Get all roles.

The client uses the get_roles command to get role information.

7.66.1 Structure

7.66.2 RNC

Command
get_roles
 = element get_roles
     {
       attribute role_id { uuid }?
       & attribute filter { uuid }?
       & 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_keywords
     }

get_roles_response_filters_term
 = element term
     {
       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.66.3 Example: Get all 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.67 Command get_schedules

In short: Get all schedules.

The client uses the get_schedules command to get schedule information.

7.67.1 Structure

7.67.2 RNC

Command
get_schedules
 = element get_schedules
     {
       attribute schedule_id { uuid }?
       & attribute filter { uuid }?
       & 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_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
     {
       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_name
 = element name
     {
       name
     }

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

get_schedules_response_filters_term
 = element term
     {
       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.67.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>
     <tasks>
       <task id="d4daf4c4-25c7-40ac-87d3-38e489f34330">
         <name>Task 1</name>
       </task>
     </tasks>
   </schedule>
   <truncate>...</truncate>
 </get_schedules_response>

7.68 Command get_settings

In short: Get all settings.

The client uses the get_settings command to get the settings.

7.68.1 Structure

7.68.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.68.3 Example: Get all 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.69 Command get_slaves

In short: Get all slaves.

The client uses the get_slaves command to get slave information.

7.69.1 Structure

7.69.2 RNC

Command
get_slaves
 = element get_slaves
     {
       attribute slave_id { uuid }?
       & attribute filter { uuid }?
       & 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_name
 = element name
     {
       name
     }

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

get_slaves_response_filters_term
 = element term
     {
       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.69.3 Example: Get all 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.70 Command get_system_reports

In short: Get all system reports.

The client uses the get_system_reports command to get system reports.

7.70.1 Structure

7.70.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 { "png" }
       & attribute duration { integer }
     }

7.70.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.70.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.71 Command get_tags

In short: Get all tags.

The client uses the get_tags command to get tag information.

7.71.1 Structure

7.71.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_owner
       & get_tags_response_tag_name
       & ( 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_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_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_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_keywords
     }

get_tags_response_filters_term
 = element term
     {
       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.71.3 Example: Get all 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.72 Command get_target_locators

In short: Get configured target locators.

The client uses the get_target_locators command to get target locators.

7.72.1 Structure

7.72.2 RNC

Command
get_target_locators
 = element get_target_locators
     {
       ""
     }
Response
get_target_locators_response
 = element get_target_locators_response
     {
       attribute status { status }
       & attribute status_text { text }
       & get_target_locators_response_target_locator*
     }

get_target_locators_response_target_locator
 = element target_locator
     {
       get_target_locators_response_target_locator_name
     }

get_target_locators_response_target_locator_name
 = element name
     {
       name
     }

7.72.3 Example: Get target locators

Client
 <get_target_locators/>
Manager
 <get_target_locators_response status="200"
                               status_text="OK">
   <target_locator>
     <name>ldap</name>
   </target_locator>
   ...
 </get_target_locators_response>

7.73 Command get_targets

In short: Get all targets.

The client uses the get_targets command to get target information.

7.73.1 Structure

7.73.2 RNC

Command
get_targets
 = element get_targets
     {
       attribute target_id { uuid }?
       & attribute filter { uuid }?
       & 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_max_hosts
       & get_targets_response_target_ssh_lsc_credential
       & get_targets_response_target_smb_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_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_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_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_trash
     }

get_targets_response_target_smb_lsc_credential_name
 = element name
     {
       name
     }

get_targets_response_target_smb_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_trash
     }

get_targets_response_target_port_list_name
 = element name
     {
       name
     }

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_name
 = element name
     {
       name
     }

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

get_targets_response_filters_term
 = element term
     {
       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.73.3 Example: Get all 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>
   </target>
   ...
 </get_targets_response>

7.73.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>
     <tasks>
       <task id="13bb418a-4220-4575-b35b-ec398bff7417">
         <name>dik mm</name>
       </task>
       ...
     </tasks>
   </target>
 </get_targets_response>

7.74 Command get_tasks

In short: Get all 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.74.1 Structure

7.74.2 RNC

Command
get_tasks
 = element get_tasks
     {
       attribute task_id { uuid }?
       & attribute filter { uuid }?
       & attribute filt_id { uuid }?
       & attribute trash { boolean }?
       & attribute details { boolean }?
       & attribute rcfile { boolean }?
       & attribute apply_overrides { 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_alert
       & get_tasks_response_task_observers
       & get_tasks_response_task_schedule
       & 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_rcfile?
       & get_tasks_response_task_reports*
       & 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_trash
     }

get_tasks_response_task_config_name
 = element name
     {
       name
     }

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_trash
     }

get_tasks_response_task_target_name
 = element name
     {
       name
     }

get_tasks_response_task_target_trash
 = element trash
     {
       boolean
     }

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

get_tasks_response_task_alert_name
 = element name
     {
       name
     }

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_trash
     }

get_tasks_response_task_schedule_name
 = element name
     {
       name
     }

get_tasks_response_task_schedule_trash
 = element trash
     {
       boolean
     }

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

get_tasks_response_task_slave_name
 = element name
     {
       name
     }

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_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_result_count
 = element result_count
     {
       get_tasks_response_task_first_report_report_result_count_debug
       & 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_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_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_result_count
 = element result_count
     {
       get_tasks_response_task_last_report_report_result_count_debug
       & 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_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_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_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_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_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_rcfile
 = element rcfile
     {
       base64
     }

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_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_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_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_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_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_keywords
     }

get_tasks_response_filters_term
 = element term
     {
       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.74.3 Example: Get all 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>
     <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.74.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.75 Command get_users

In short: Get all users.

The client uses the "get_users" command to retrieve the list of user accounts on the Scanner.

7.75.1 Structure

7.75.2 RNC

Command
get_users
 = element get_users
     {
       attribute user_id { uuid }?
       & attribute filter { uuid }?
       & attribute filt_id { uuid }?
       & attribute trash { boolean }?
     }
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_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_name
 = element name
     {
       name
     }

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_name
 = element name
     {
       name
     }

get_users_response_user_hosts
 = element hosts
     {
       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_keywords
     }

get_users_response_filters_term
 = element term
     {
       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.75.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.76 Command get_version

In short: Get the OpenVAS Manager Protocol version.

7.76.1 Structure

7.76.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.76.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.77 Command help

In short: Get the help text.

7.77.1 Structure

7.77.2 RNC

Command
help
 = element help
     {
       attribute format { xsd:token { pattern = "html|HTML|rnc|RNC|text|TEXT|xml|XML" } }?
     }
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
     {
       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.77.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_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_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 all agents.
            GET_ALERTS             Get all alerts.
            GET_CONFIGS            Get all configs.
            GET_FILTERS            Get all filters.
            GET_GROUPS             Get all groups.
            GET_INFO               Get raw information for a given item.
            GET_LSC_CREDENTIALS    Get all local security check credentials.
            GET_NOTES              Get all 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 all overrides.
            GET_PERMISSIONS        Get all permissions.
            GET_PORT_LISTS         Get all port lists.
            GET_PREFERENCES        Get preferences for all available NVTs.
            GET_REPORTS            Get all reports.
            GET_REPORT_FORMATS     Get all report formats.
            GET_RESULTS            Get results.
            GET_ROLES              Get all roles.
            GET_SCHEDULES          Get all schedules.
            GET_SETTINGS           Get all settings.
            GET_SLAVES             Get all slaves.
            GET_SYSTEM_REPORTS     Get all system reports.
            GET_TAGS               Get all tags.
            GET_TARGET_LOCATORS    Get configured target locators.
            GET_TARGETS            Get all targets.
            GET_TASKS              Get all tasks.
            GET_USERS              Get all 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_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.
            PAUSE_TASK             Pause a running task.
            RESTORE                Restore a resource.
            RESUME_OR_START_TASK   Resume task if stopped, else start task.
            RESUME_PAUSED_TASK     Resume a paused task.
            RESUME_STOPPED_TASK    Resume a stopped 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.77.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.78 Command modify_agent

In short: Modify an existing agent.

The client uses the modify_agent command to change an existing agent.

7.78.1 Structure

7.78.2 RNC

Command
modify_agent
 = element modify_agent
     {
       attribute agent { 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.78.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.79 Command modify_alert

In short: Modify an existing alert.

The client uses the modify_alert command to change an existing alert.

7.79.1 Structure

7.79.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.79.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.80 Command modify_auth

In short: Modify the authentication methods.

The client uses the "modify_auth" command to modify the authentication methods.

7.80.1 Structure

7.80.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.80.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.81 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.81.1 Structure

7.81.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.81.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.81.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.81.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.81.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.82 Command modify_filter

In short: Modify an existing filter.

The client uses the modify_filter command to change an existing filter.

7.82.1 Structure

7.82.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.82.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.83 Command modify_group

In short: Modify an existing group.

The client uses the modify_group command to change an existing group.

7.83.1 Structure

7.83.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
     {
     }

7.83.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.84 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.84.1 Structure

7.84.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.84.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.85 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.85.1 Structure

7.85.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.85.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.86 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.86.1 Structure

7.86.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.86.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.87 Command modify_permission

In short: Modify a permission.

The client uses the modify_permission command to change an existing permission.

7.87.1 Structure

7.87.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_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.87.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.88 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.88.1 Structure

7.88.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.88.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.89 Command modify_report

In short: Modify an existing report.

The client uses the modify_report command to change an existing report.

7.89.1 Structure

7.89.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.89.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.90 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.90.1 Structure

7.90.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.90.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.90.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.91 Command modify_role

In short: Modify an existing role.

The client uses the modify_role command to change an existing role.

7.91.1 Structure

7.91.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
     {
     }

7.91.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.92 Command modify_schedule

In short: Modify an existing schedule.

The client uses the modify_schedule command to change an existing schedule.

7.92.1 Structure

7.92.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
     {
       text
     }

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.92.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.93 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.93.1 Structure

7.93.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.93.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.94 Command modify_slave

In short: Modify an existing slave.

The client uses the modify_slave command to change an existing slave.

7.94.1 Structure

7.94.2 RNC

Command
modify_slave
 = element modify_slave
     {
       attribute slave { 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.94.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.95 Command modify_target

In short: Modify an existing target.

The client uses the modify_target command to change an existing target.

7.95.1 Structure

7.95.2 RNC

Command
modify_target
 = element modify_target
     {
       attribute target_id { uuid }
       & modify_target_comment?
       & modify_target_name?
       & modify_target_hosts?
       & modify_target_ssh_lsc_credential?
       & modify_target_smb_lsc_credential?
       & modify_target_port_list?
       & modify_target_target_locator?
       & 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_ssh_lsc_credential
 = element ssh_lsc_credential
     {
       attribute id { uuid }
     }

modify_target_smb_lsc_credential
 = element smb_lsc_credential
     {
       attribute id { uuid }
     }

modify_target_port_list
 = element port_list
     {
       attribute id { uuid }
     }

modify_target_target_locator
 = element target_locator
     {
       modify_target_target_locator_username
       & modify_target_target_locator_password
     }

modify_target_target_locator_username
 = element username
     {
       text
     }

modify_target_target_locator_password
 = element password
     {
       text
     }

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.95.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.96 Command modify_tag

In short: Modify a tag.

The client uses the modify_tag command to change an existing tag.

7.96.1 Structure

7.96.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.96.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.97 Command modify_task

In short: Modify an existing task.

The client uses the modify_task command to change an existing task.

7.97.1 Structure

7.97.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_rcfile
           | modify_task_schedule
           | 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_rcfile
 = element rcfile
     {
       base64
     }

modify_task_schedule
 = element schedule
     {
       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.97.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.98 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.98.1 Structure

7.98.2 RNC

Command
modify_user
 = element modify_user
     {
       modify_user_name
       & modify_user_password?
       & modify_user_role*
       & modify_user_hosts?
       & modify_user_sources?
     }

modify_user_name
 = element name
     {
       text
     }

modify_user_hosts
 = element hosts
     {
       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.98.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.99 Command pause_task

In short: Pause a running task.

The client uses the pause_task command to manually pause a running task.

7.99.1 Structure

7.99.2 RNC

Command
pause_task
 = element pause_task
     {
       attribute task_id { uuid }
     }
Response
pause_task_response
 = element pause_task_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.99.3 Example: Pause a running task

Client
 <pause_task task_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>
Manager
 <pause_task_response status="200"
                      status_text="OK"/>

7.100 Command restore

In short: Restore a resource.

The client uses the restore a resource from the trashcan.

7.100.1 Structure

7.100.2 RNC

Command
restore
 = element restore
     {
       attribute id { uuid }
     }
Response
restore_response
 = element restore_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.100.3 Example: Restore a target

Client
 <restore id="97390ade-e075-11df-9973-002264764cea"/>
Manager
 <restore_response status="200"
                   status_text="OK"/>

7.101 Command resume_or_start_task

In short: Resume task if stopped, else start task.

The client uses the resume_or_start_task command to manually start an existing task, ensuring that the task will resume from its previous position if the task is in the Stopped state.

7.101.1 Structure

7.101.2 RNC

Command
resume_or_start_task
 = element resume_or_start_task
     {
       attribute task_id { uuid }
     }
Response
resume_or_start_task_response
 = element resume_or_start_task_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.101.3 Example: Resume a running task

Client
 <resume_or_start_task task_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>
Manager
 <resume_or_start_task_response status="200"
                                status_text="OK"/>

7.102 Command resume_paused_task

In short: Resume a paused task.

The client uses the resume_paused_task command to manually resume a paused task.

7.102.1 Structure

7.102.2 RNC

Command
resume_paused_task
 = element resume_paused_task
     {
       attribute task_id { uuid }
     }
Response
resume_paused_task_response
 = element resume_paused_task_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.102.3 Example: Resume a paused task

Client
 <resume_paused_task task_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>
Manager
 <resume_paused_task_response status="200"
                              status_text="OK"/>

7.103 Command resume_stopped_task

In short: Resume a stopped task.

The client uses the resume_stopped_task command to manually resume a stopped task.

7.103.1 Structure

7.103.2 RNC

Command
resume_stopped_task
 = element resume_stopped_task
     {
       attribute task_id { uuid }
     }
Response
resume_stopped_task_response
 = element resume_stopped_task_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.103.3 Example: Resume a stopped task

Client
 <resume_stopped_task task_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>
Manager
 <resume_stopped_task_response status="200"
                               status_text="OK"/>

7.104 Command run_wizard

In short: Run a wizard.

The client uses the run_wizard command to run a wizard.

7.104.1 Structure

7.104.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.104.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.105 Command start_task

In short: Manually start an existing task.

The client uses the start_task command to manually start an existing task.

7.105.1 Structure

7.105.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 }
     }

7.105.3 Example: Start a task

Client
 <start_task task_id="267a3405-e84a-47da-97b2-5fa0d2e8995e"/>
Manager
 <start_task_response status="200"
                      status_text="OK"/>

7.106 Command stop_task

In short: Stop a running task.

The client uses the stop_task command to manually stop a running task.

7.106.1 Structure

7.106.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.106.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.107 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.107.1 Structure

7.107.2 RNC

Command
sync_cert
 = element sync_cert
     {
       ""
     }
Response
sync_cert_response
 = element sync_cert_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.107.3 Example: Sync the feed

Client
 <sync_cert/>
Manager
 <sync_cert_response status="202"
                     status_text="OK, request submitted"/>

7.108 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.108.1 Structure

7.108.2 RNC

Command
sync_feed
 = element sync_feed
     {
       ""
     }
Response
sync_feed_response
 = element sync_feed_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.108.3 Example: Sync the feed

Client
 <sync_feed/>
Manager
 <sync_feed_response status="202"
                     status_text="OK, request submitted"/>

7.109 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.109.1 Structure

7.109.2 RNC

Command
sync_scap
 = element sync_scap
     {
       ""
     }
Response
sync_scap_response
 = element sync_scap_response
     {
       attribute status { status }
       & attribute status_text { text }
     }

7.109.3 Example: Sync the feed

Client
 <sync_scap/>
Manager
 <sync_scap_response status="202"
                     status_text="OK, request submitted"/>

7.110 Command test_alert

In short: Run an alert.

The client uses the test_alert command to invoke a test run of an alert.

7.110.1 Structure

7.110.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.110.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.111 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.111.1 Structure

7.111.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.111.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.112 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.112.1 Structure

7.112.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.112.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 5.0

8.1 Change in GET_FILTERS, CREATE_FILTER, MODIFY_FILTER

In short: Filter type "report" is now "result".

The filter type "report" has been renamed to "result". Filters of this type apply to the results in a report, as used for example on the GSA "Report: Results" page.

The name "report" is now used for a new filter type. This filter type applies to lists of reports, as used for example on the GSA "Reports" page.

8.2 Change in CREATE_USER, MODIFY_USER

In short: ROLE is identified by "id" attribute.

In OMP 4.0 these commands were served by OpenVAS Administrator.

The attribute "id" is now used to specify a user's role, in the ROLE element. Previously this was done using the NAME element inside ROLE.

8.3 Change in GET_USERS

In short: Attributes name and sort_order removed.

In OMP 4.0 this command was served by OpenVAS Administrator.

The attributes name and sort_order have been remove from the GET_USERS in OpenVAS Manager. Equivalent functionality is available using filters (with the filter and filt_id attributes).

8.4 Change in GET_USERS

In short: ROLE is optional, and role name has moved into NAME.

In OMP 4.0 this command was served by OpenVAS Administrator.

With the new role management, zero or more ROLEs may be present in USER. The name of the role is now in ROLE/NAME instead of directly in the text of ROLE.

8.5 Change in GET_NVTS

In short: Fingerprint element removed.

The fingerprint element has been removed as signature keys aren't sent by the scanner anymore and thus, aren't stored in Manager DB anymore.

8.6 Change in GET_DEPENDENCIES

In short: Command removed.

The command GET_DEPENDENCIES has been removed.

8.7 Change in MODIFY_TARGET

In short: Missing elements now leave the associate target property alone.

MODIFY_TARGET now allows the user to modify one or more of the Target elements in a single command, instead of requiring all elements to be modified at once.

As a side effect of this, leaving out an element will no longer set the associated target value to a default, but will leave the associated target value untouched. For example, if SSH_LSC_CREDENTIAL is omitted from the MODIFY_TARGET command, the command will no longer reset the SSH credential of the target, but will leave the target's current SSH credential intact.