Commit 4a6df767 authored by Mati's avatar Mati

Imported Upstream version 1.1.4

parents
openvas-cli 1.1.5 (2012-07-19)
This is the 1.1.5 release of the OpenVAS Command Line Interface (CLI) for the
Open Vulnerability Assessment System (OpenVAS).
OpenVAS CLI 1.1 is part of OpenVAS 4 and OpenVAS 5 and supports OMP 2.0,
OMP 3.0 and compatible subsets of future versions.
This release fixes build issues and allows it to use future OMP versions
as long as commands are still compatible.
Many thanks to everyone who has contributed to this release:
Matthew Mundell, Michael Wiegand and Jan-Oliver Wagner.
Main changes compared to 1.1.4:
* Clean up CMake infrastructure and ensure that compilation with modern
gccs works.
* If the OMP version is unknown just treat it like version 3.0, as later
versions may still work with the 3.0 settings.
openvas-cli 1.1.4 (2011-12-06)
This is the 1.1.4 release of the OpenVAS Command Line Interface (CLI) for the
Open Vulnerability Assessment System (OpenVAS).
OpenVAS CLI 1.1 is part of OpenVAS 4 and supports both the OMP 2.0 and the
upcoming OMP 3.0 protocol.
This release adds support for OMP 3.0 when retrieving reports.
Many thanks to everyone who has contributed to this release:
Henri Doreau, Matthew Mundell and Michael Wiegand.
Main changes compared to 1.1.3:
* Support for OMP 3.0 when retrieving reports has been added.
openvas-cli 1.1.3 (2011-10-12)
This is the 1.1.3 release of the OpenVAS Command Line Interface (CLI) for the
Open Vulnerability Assessment System (OpenVAS).
OpenVAS CLI 1.1 is part of OpenVAS 4 and supports the protocol OMP 2.0 protocol.
This release adds support for reading XML input from stdin.
Many thanks to everyone who has contributed to this release:
Matthew Mundell and Michael Wiegand.
Main changes compared to 1.1.2:
* The "omp" command now accepts XML input from stdin when using the "-X"
parameter.
openvas-cli 1.1.2 (2011-02-21)
This is the 1.1.2 release of the OpenVAS Command Line Interface (CLI) for the
Open Vulnerability Assessment System (OpenVAS).
OpenVAS CLI 1.1 is part of OpenVAS 4 and supports the protocol OMP 2.0 protocol.
This release features cleanups in the build process and fixes an issue with
incorrect documentation on the man page.
Many thanks to everyone who has contributed to this release:
Michael Wiegand.
Main changes compared to 1.1.0:
* The build environment has been consolidated.
* The documentation for the password parameter on the man page has been
corrected.
openvas-cli 1.1.1 (2011-02-04)
This is the 1.1.1 release of the OpenVAS Command Line Interface (CLI) for the
Open Vulnerability Assessment System (OpenVAS).
OpenVAS CLI 1.1 is part of OpenVAS 4 and supports the protocol OMP 2.0 protocol.
This release feature updates to the build process, improved documentation and
an improved handling of authentication passwords.
Many thanks to everyone who has contributed to this release:
Matthew Mundell, Jan-Oliver Wagner and Michael Wiegand
Main changes compared to 1.1.0:
* Hardening flags are now enabled during compile time to increase code quality.
* The output of --version is now compliant with the GNU Coding Standards.
* The omp binary now warns about revealing passwords when verbose output is
requested.
* OpenVAS CLI now use pkg-config to find required libraries.
* OpenVAS CLI now provides a manual page for the omp binary.
* The authentication password can now be entered interactively.
openvas-cli 1.1.0 (2010-12-03)
This is the 1.1.0 release of the OpenVAS Command Line Interface
(CLI) for the Open Vulnerability Assessment System (OpenVAS).
The mission of OpenVAS CLI Client is to allow creating
batch processes for OpenVAS Manager using the protocol OMP.
The command line tool runs on various Windows, MacOSX,
GNU/Linux and other unixoid operating systems.
OpenVAS CLI 1.1 is part of OpenVAS 4 and supports the
upcoming protocol OMP 2.0.
Main changes compared to 1.1+rc1:
* New parameter: --get-configs for retrieving a list of scan configs.
* New parameter: --get-targets for retrieving a list of targets.
openvas-cli 1.1+rc1 (2010-11-22)
This release is the first release candidate of the upcoming 1.1 release
of the OpenVAS Command Line Client. It is the command line interface
that allows to create batch processes for OpenVAS Manager using
the protocol OMP.
Release 1.1 is part of OpenVAS 4, the next generation
of the Open Vulnerability Assessment System.
This release features improved compatibility across different OMP versions,
improved documentation, two new command shortcuts and ensures that special
characters are handled correctly in OMP requests.
Many thanks to everyone who has contributed to this release since 1.0.0:
Matthew Mundell, Michael Wiegand and Felix Wolfsteller.
Main changes compared to 1.0:
* Special characters in OMP commands (like umlauts) are now handled correctly.
* The documentation has been improved; source code documentation can now be
generated using the "make doc" and "make doc-full" commands.
* Compatibility with different OMP versions has been improved.
* New parameter: --get-report-formats for retrieving the available report
formats (OMP 2.0 only).
* New parameter: --get-omp-version for determining the OMP version used by the
server.
openvas-cli 1.0.0 (2010-08-03)
This is the 1.0.0 release of the openvas-cli module, an OMP command line client
for the Open Vulnerability Assessment System (OpenVAS).
The OpenVAS CLI contains the command line tool "omp" which allows to send any
command of the OpenVAS Management Protocol (OMP) in original form and some of
the commands as short cuts. This allows to create batch processes for remote
control of OpenVAS.
OpenVAS CLI is licensed under GNU General Public License Version 2 or any later
version.
Many thanks to everyone who has contributed to this release since 0.2.0:
Jan-Oliver Wagner and Michael Wiegand
Main changes compared to 0.2.0:
* The build environment and the code have been cleaned up and made more
consistent with the other OpenVAS modules.
* The documentation has been updated.
openvas-cli 0.2.0 (2010-07-19)
This is the second public release of the openvas-cli module for the Open
Vulnerability Assessment System (OpenVAS).
Many thanks to everyone who has contributed to this release:
Stephan Kleine, Matthew Mundell, Jan-Oliver Wagner, Michael Wiegand and Felix
Wolfsteller.
Main changes compared to 0.1.0:
* The build environment has been improved. It is now possible to use MinGW to
compile openvas-cli for Microsoft Windows.
* Support for storing the connection credentials in a configuration file has
been added.
* The --get-status parameter has been renamed to --get-tasks to reflect the
updates in the OMP specification.
* The openvas-libraries dependency has been raised to 3.1.0.
openvas-cli 0.1.0 (2010-03-22)
This is the first public release of the openvas-cli module for the Open
Vulnerability Assessment System (OpenVAS).
The OpenVAS CLI module collects command line tools to communication
with OpenVAS services. Primarily this is the "omp" tool
to use the OpenVAS Management Protocol (OMP) to communicate
with the OpenVAS Manager.
# OpenVAS
# $Id$
# Description: Top-level cmake control for openvas-cli.
#
# Authors:
# Matthew Mundell <matthew.mundell@intevation.de>
#
# Copyright:
# Copyright (C) 2010 Greenbone Networks GmbH
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License version 2,
# or, at your option, any later version as published by the Free
# Software Foundation
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
message ("-- Configuring openvas-cli ...")
project (openvas-cli C)
cmake_minimum_required (VERSION 2.6)
if (POLICY CMP0005)
cmake_policy (SET CMP0005 OLD)
endif (POLICY CMP0005)
include (FindPkgConfig)
if (NOT CMAKE_BUILD_TYPE)
set (CMAKE_BUILD_TYPE Debug)
endif (NOT CMAKE_BUILD_TYPE)
## Retrieve svn revision (at configure time)
# Not using Subversion_WC_INFO, as it would have to connect to the repo
find_program (SVN_EXECUTABLE svn DOC "subversion command line client")
macro (Subversion_GET_REVISION dir variable)
execute_process (COMMAND ${SVN_EXECUTABLE} info ${CMAKE_SOURCE_DIR}/${dir}
OUTPUT_VARIABLE ${variable}
OUTPUT_STRIP_TRAILING_WHITESPACE)
string (REGEX REPLACE "^(.*\n)?Revision: ([^\n]+).*"
"\\2" ${variable} "${${variable}}")
endmacro (Subversion_GET_REVISION)
if (NOT CMAKE_BUILD_TYPE MATCHES "Release")
if (EXISTS ".svn/")
if (SVN_EXECUTABLE)
Subversion_GET_REVISION(. ProjectRevision)
set (SVN_REVISION ".SVN.r${ProjectRevision}")
else (SVN_EXECUTABLE)
set (SVN_REVISION ".SVN")
endif (SVN_EXECUTABLE)
endif (EXISTS ".svn/")
endif (NOT CMAKE_BUILD_TYPE MATCHES "Release")
## CPack configuration
set (CPACK_CMAKE_GENERATOR "Unix Makefiles")
set (CPACK_GENERATOR "TGZ")
set (CPACK_INSTALL_CMAKE_PROJECTS ".;openvas-cli;ALL;/")
set (CPACK_MODULE_PATH "")
set (CPACK_RESOURCE_FILE_LICENSE "${CMAKE_SOURCE_DIR}/COPYING")
set (CPACK_RESOURCE_FILE_README "${CMAKE_SOURCE_DIR}/README")
set (CPACK_RESOURCE_FILE_WELCOME "${CMAKE_SOURCE_DIR}/README")
set (CPACK_SOURCE_GENERATOR "TGZ")
set (CPACK_SOURCE_TOPLEVEL_TAG "")
set (CPACK_SYSTEM_NAME "")
set (CPACK_TOPLEVEL_TAG "")
set (CPACK_PACKAGE_VERSION_MAJOR "1")
set (CPACK_PACKAGE_VERSION_MINOR "1")
# Use this scheme for stable releases:
set (CPACK_PACKAGE_VERSION_PATCH "5${SVN_REVISION}")
set (CPACK_PACKAGE_VERSION "${CPACK_PACKAGE_VERSION_MAJOR}.${CPACK_PACKAGE_VERSION_MINOR}.${CPACK_PACKAGE_VERSION_PATCH}")
# Use this scheme for +betaN and +rcN releases:
#set (CPACK_PACKAGE_VERSION_PATCH "+beta1${SVN_REVISION}")
#set (CPACK_PACKAGE_VERSION "${CPACK_PACKAGE_VERSION_MAJOR}.${CPACK_PACKAGE_VERSION_MINOR}${CPACK_PACKAGE_VERSION_PATCH}")
set (CPACK_PACKAGE_FILE_NAME "${PROJECT_NAME}-${CPACK_PACKAGE_VERSION}")
set (CPACK_SOURCE_PACKAGE_FILE_NAME "${PROJECT_NAME}-${CPACK_PACKAGE_VERSION}")
set (CPACK_PACKAGE_VENDOR "The OpenVAS Project")
set (CPACK_SOURCE_IGNORE_FILES
"/.svn/"
"/_CPack_Packages/"
"/CMakeFiles/"
"cmake$"
"swp$"
"Cache.txt$"
".tar.gz"
"install_manifest.txt"
"Makefile"
"/doc/generated/"
"Doxyfile$"
"Doxyfile_full$"
"VERSION$"
)
include (CPack)
## Variables
if (SYSCONF_INSTALL_DIR)
set (SYSCONFDIR "${SYSCONF_INSTALL_DIR}")
endif (SYSCONF_INSTALL_DIR)
if (NOT SYSCONFDIR)
set (SYSCONFDIR "${CMAKE_INSTALL_PREFIX}/etc")
endif (NOT SYSCONFDIR)
if (NOT EXEC_PREFIX)
set (EXEC_PREFIX "${CMAKE_INSTALL_PREFIX}")
endif (NOT EXEC_PREFIX)
if (NOT BINDIR)
set (BINDIR "${EXEC_PREFIX}/bin")
endif (NOT BINDIR)
if (NOT SBINDIR)
set (SBINDIR "${EXEC_PREFIX}/sbin")
endif (NOT SBINDIR)
if (NOT LIBDIR)
set (LIBDIR "${EXEC_PREFIX}/lib")
endif (NOT LIBDIR)
if (NOT LOCALSTATEDIR)
set (LOCALSTATEDIR "${CMAKE_INSTALL_PREFIX}/var")
endif (NOT LOCALSTATEDIR)
if (NOT DATADIR)
set (DATADIR "${CMAKE_INSTALL_PREFIX}/share")
endif (NOT DATADIR)
if (NOT INCLUDEDIR)
set (INCLUDEDIR "${CMAKE_INSTALL_PREFIX}/include")
endif (NOT INCLUDEDIR)
message ("-- Install prefix: ${CMAKE_INSTALL_PREFIX}")
## Dependency checks
##
## TODO Also check for headers where needed.
## Improve for workflow: First collect list of missing libs, then print the
## list and throw an error, otherwise long install-cmake-install-cmake cycles
## might occur.
pkg_check_modules (LIBOPENVAS REQUIRED libopenvas>=4.0.0)
pkg_check_modules (GNUTLS REQUIRED gnutls)
pkg_check_modules (GLIB REQUIRED glib-2.0)
execute_process (COMMAND pkg-config --cflags glib-2.0
OUTPUT_VARIABLE GLIB_CFLAGS
OUTPUT_STRIP_TRAILING_WHITESPACE)
execute_process (COMMAND pkg-config --libs glib-2.0
OUTPUT_VARIABLE GLIB_LDFLAGS
OUTPUT_STRIP_TRAILING_WHITESPACE)
execute_process (COMMAND pkg-config --cflags libopenvas
OUTPUT_VARIABLE OPENVAS_CFLAGS
OUTPUT_STRIP_TRAILING_WHITESPACE)
execute_process (COMMAND pkg-config --libs libopenvas
OUTPUT_VARIABLE OPENVAS_LDFLAGS
OUTPUT_STRIP_TRAILING_WHITESPACE)
execute_process (COMMAND pkg-config --cflags gnutls
OUTPUT_VARIABLE GNUTLS_CFLAGS
OUTPUT_STRIP_TRAILING_WHITESPACE)
execute_process (COMMAND pkg-config --libs gnutls
OUTPUT_VARIABLE GNUTLS_LDFLAGS
OUTPUT_STRIP_TRAILING_WHITESPACE)
## Version
string (REPLACE "
" "" OPENVASCLI_VERSION ${CPACK_PACKAGE_VERSION})
# Configure Doxyfile with version number
configure_file (doc/Doxyfile.in doc/Doxyfile)
configure_file (doc/Doxyfile_full.in doc/Doxyfile_full)
configure_file (VERSION.in VERSION)
## Program
set (HARDENING_FLAGS "-Wformat -Wformat-security -O2 -D_FORTIFY_SOURCE=2 -fstack-protector -Wl,-z,relro -Wl,-z,now")
set (CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS_DEBUG}")
set (CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${HARDENING_FLAGS} -Wall -Werror")
add_subdirectory (omp)
## Documentation
add_subdirectory (doc)
## Tests
enable_testing ()
## End
This diff is collapsed.
This diff is collapsed.
INSTALLATION INSTRUCTIONS FOR OPENVAS-CLI
=========================================
Please note: The reference systems used by most of the developers is Debian
GNU/Linux 'Squeeze' 6.0. The build might fail on any other systems.
Also it is necessary to install dependent development packages.
Prerequisites for openvas-cli
-----------------------------
Prerequisites:
* cmake
* glib-2.0
* gnutls
* openvas-libraries (>= 4.0.0)
* pkg-config
Prerequisites for building documentation:
* Doxygen
* xmltoman (optional, for building man page)
Compiling openvas-cli
---------------------
If you have installed required libraries to a non-standard location, remember to
set the PKG_CONFIG_PATH environment variable to the location of you pkg-config
files before configuring:
$ export PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/your/location/lib/pkgconfig
Then configure the build with
$ cmake -DCMAKE_INSTALL_PREFIX=/path/to/your/installation .
or (if you want to use the default installation path /usr/local)
$ cmake .
This only needs to be done once. Note: It is assumed that the other
OpenVAS components are installed to the same path. If not, you need to set
some paths separately, see below for details.
Thereafter, the following commands are useful.
$ make # build openvas-cli
$ make doc # build the documentation
$ make doc-full # build more developer-oriented documentation
$ make install # install the build
$ make rebuild_cache # rebuild the make system cache
About OpenVAS-CLI
-----------------
The module OpenVAS-CLI collects command line tools
to handle with the OpenVAS services via the respective
protocols.
The best supported service is currently the OpenVAS-Manager (openvasmd).
OpenVAS-CLI is licensed under GNU General Public License Version 2 or
any later version. Please see file COPYING for details.
All parts of OpenVAS-CLI are Copyright (C) by Greenbone Networks GmbH
(see http://www.greenbone.net).
Howto use
---------
The command line tools will access a service.
The service must be reachable via the network.
The program usage message follows.
Usage:
omp [OPTION...] - OpenVAS OMP Command Line Interface
Help Options:
-?, --help Show help options
Application Options:
-h, --host=<host> Connect to manager on host <host>
-p, --port=<number> Use port number <number>
-V, --version Print version.
-v, --verbose Verbose messages.
-u, --username=<username> OMP username
-w, --password=<password> OMP password
--configfile=<configfile> Configuration file for connection parameters.
-P, --prompt Prompt to exit.
-n, --name=<name> Name for create-task.
-C, --create-task Create a task.
-m, --comment=<name> Comment for create-task.
-c, --config=<config> Config for create-task.
-r, --rc Create task with RC read from stdin.
-t, --target=<target> Target for create-task.
-E, --delete-report Delete one or more reports.
-D, --delete-task Delete one or more tasks.
-R, --get-report Get report of one task.
-f, --format=<format> Format for get-report.
-G, --get-status Get status of one, many or all tasks.
-i, --pretty-print In combination with -X, pretty print the response.
-S, --start-task Start one or more tasks.
-M, --modify-task Modify a task.
--file Add text in stdin as file on task.
-X, --xml=<command> XML command (e.g. "<help/>", "<get_version/>")
Configuration file of omp
-------------------------
The configuration file ~/omp.config can be used to store connection parameter
like host, port, username and password. Alternatively, the connection
parameter can be passed with the respective options (e.g. --username, see
above) or read from a file specified with the --configfile option.
An exemplary configuration file looks like
[Connection]
host=localhost
port=9390
username=exampleuser
password=examplepassword
@CPACK_PACKAGE_VERSION@
\ No newline at end of file
# OpenVAS
# $Id$
# Description: CMakefile for the OpenVAS CLI documentation
#
# Authors:
# Matthew Mundell <matt@mundell.ukfsn.org>
#
# Copyright:
# Copyright (C) 2009,2010 Greenbone Networks GmbH
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Library General Public
# License as published by the Free Software Foundation; either
# version 2 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# Library General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
## Find xml2man
message (STATUS "Looking for xmltoman...")
find_program (XMLTOMAN_EXECUTABLE xmltoman
PATHS /bin /usr/bin /usr/local/bin/
DOC "xmltoman location")
message (STATUS "Looking for xmltoman... ${XMLTOMAN_EXECUTABLE}")
find_program (XMLMANTOHTML_EXECUTABLE xmlmantohtml
PATHS /bin /usr/bin /usr/local/bin/
DOC "xmlmantohtml location")
message (STATUS "Looking for xmlmantohtml... ${XMLMANTOHTML_EXECUTABLE}")
# FIX find_program seems to follow symlink
if (XMLMANTOHTML_EXECUTABLE)
set (XMLMANTOHTML_EXECUTABLE xmlmantohtml)
endif (XMLMANTOHTML_EXECUTABLE)
## build
set_directory_properties (PROPERTIES CLEAN_NO_CUSTOM true)
set_directory_properties (PROPERTIES ADDITIONAL_MAKE_CLEAN_FILES ".built-html;.built-html_full")
include (FindDoxygen)
## Emit warning if Doxygen not found.
## Otherwise, create doc and doc-full targets.
if (NOT DOXYGEN_EXECUTABLE)
message (WARNING "Doxygen is required to build the HTML docs.")
else (NOT DOXYGEN_EXECUTABLE)
set (DOC_FILES
../omp/omp.c
../README
../INSTALL)
add_custom_target (doc COMMENT "Building documentation..."
DEPENDS .built-html Doxyfile)
add_custom_target (doc-full COMMENT "Building documentation..."
DEPENDS Doxyfile_full .built-html_full)
endif (NOT DOXYGEN_EXECUTABLE)
add_custom_command (OUTPUT .built-html
COMMAND sh
ARGS -c \"cd .. && ${DOXYGEN_EXECUTABLE} doc/Doxyfile && touch doc/.built-html\;\"
DEPENDS Doxyfile ${DOC_FILES})
add_custom_command (OUTPUT .built-html_full
COMMAND sh
ARGS -c \"cd .. && ${DOXYGEN_EXECUTABLE} doc/Doxyfile_full && touch doc/.built-html_full\;\"
DEPENDS Doxyfile_full ${DOC_FILES})
if (XMLTOMAN_EXECUTABLE)
add_custom_target (man COMMENT "Building manual page..."
DEPENDS omp.8)
add_custom_command (OUTPUT omp.8
COMMAND sh
ARGS -c \"${XMLTOMAN_EXECUTABLE} omp.8.xml > omp.8\;\"
DEPENDS omp.8.xml)
else (XMLTOMAN_EXECUTABLE)
message (STATUS "WARNING: xmltoman is required to generate manpage.")
add_custom_command (OUTPUT omp.8
COMMAND echo "[Error: xmltoman required to see manpage here]" > omp.8)
endif (XMLTOMAN_EXECUTABLE)
if (XMLMANTOHTML_EXECUTABLE)
add_custom_target (man-html COMMENT "Building manual page HTML..."
DEPENDS omp.html)
add_custom_command (OUTPUT omp.html
COMMAND sh
ARGS -c \"${XMLMANTOHTML_EXECUTABLE} omp.8.xml > omp.html\;\"
DEPENDS omp.8.xml)
else (XMLMANTOHTML_EXECUTABLE)
message (STATUS "WARNING: xmlmantohtml is required for manpage in HTML docs.")
add_custom_command (OUTPUT omp.html
COMMAND echo "[Error: xmlmantohtml required to see manpage here]" > omp.html)
endif (XMLMANTOHTML_EXECUTABLE)
install (FILES omp.8
DESTINATION ${DATADIR}/man/man8 )
This diff is collapsed.
This diff is collapsed.
.TH omp 8 User Manuals
.SH NAME
omp \- OMP command line client for the Open Vulnerability Assessment System (OpenVAS)
.SH SYNOPSIS
\fBomp OPTIONS
\f1
.SH DESCRIPTION
Together, OpenVAS Scanner (openvassd(8)) and OpenVAS Manager (openvasmd(8)) provide the core functionality of the Open Vulnerability Assessment System (OpenVAS), with OpenVAS Scanner handling the actual scan process and OpenVAS Manager adding various management functionalities to handle and organise scan results.
The omp binary is a command line client which uses the OMP protocol to connect to the OpenVAS Manager and makes it easy to access the full functionality provided by the OpenVAS Manager conveniently from the command line and allows quick integration in a scripted environment.
.SH OPTIONS
.TP
\fB-h, --host=\fIHOST\fB\f1
Connect to OpenVAS Manager on host HOST.
.TP
\fB-p, --port=\fIPORT\fB\f1
Connect to OpenVAS Manager on port PORT.
.TP
\fB-u, --username=\fIUSER\fB\f1
Use the username USER to access the OpenVAS Manager.
.TP
\fB-w, --password=\fIPASSWORD\fB\f1
Use the password PASSWORD to access the OpenVAS Manager. If the password is not set as parameter, it will be requested interactively.
.TP
\fB--config-file=\fIFILE\fB\f1
Use the information provided in FILE as parameters for the connection to the OpenVAS Manager.
.TP
\fB-P, --prompt\f1
Prompt to exit.
.TP
\fB-O, --get-omp-version\f1
Display the OMP version used by OpenVAS Manager.
.TP
\fB-C, --create-task\f1
Create a task.
.TP
\fB-n, --name=\fINAME\fB\f1
Use NAME as the name for the newly created task.
.TP
\fB-c, --comment=\fICOMMENT\fB\f1
Use COMMENT as the comment for the newly created task.
.TP
\fB-t, --target=\fITARGET\fB\f1
Use TARGET as the target for the newly created task.
.TP
\fB-r, --rc\f1
Create task with RC read from stdin.
.TP
\fB--file\f1
Add text in stdin as file on task..
.TP
\fB-E, --delete-report\f1
Delete one or more reports.
.TP
\fB-D, --delete-task\f1
Delete one or more tasks.
.TP
\fB-R, --get-report\f1
Get report of one task.
.TP
\fB-F, --get-report-formats\f1
Get report formats (OMP 2.0 only).
.TP
\fB-f, --format=\fIFORMAT\fB\f1
Get report in format FORMAT.
.TP
\fB-G, --get-tasks\f1
Get status of one, many or all tasks.
.TP
\fB-g, --get-configs\f1
Get configs.
.TP
\fB-G, --get-targets\f1
Get targets.
.TP
\fB-M, --modify-task\f1
Modify a task.
.TP
\fB-S, --start-task\f1
Start one or more tasks.
.TP
\fB-X, --xml=\fICOMMAND\fB\f1
Send COMMAND as XML to the OpenVAS Manager (e.g. "<help/>", "<get_version/>").
.TP
\fB-i, --pretty-print\f1
In combination with -X, pretty print the response.
.TP
\fB-v, --version\f1
Print version.
.TP
\fB-?, --help\f1
Show help.
.SH EXAMPLES
omp --username foobar --get-tasks
Connect to the OpenVAS Manager as user foobar and get the list of tasks.
.SH SEE ALSO
\fBopenvassd(8)\f1 \fBopenvasad(8)\f1 \fBgsad(8)\f1 \fBopenvasmd(8)\f1 \fBgsd(8)\f1
.SH MORE INFORMATION ABOUT THE OPENVAS PROJECT
The canonical places where you will find more information about the OpenVAS project are: \fBhttp://www.openvas.org/\f1 (Official site) \fBhttp://wald.intevation.org/projects/openvas/\f1 (Development Platform)
.SH COPYRIGHT
The omp command line client is released under the GNU GPL, version 2, or, at your option, any later version.
<?xml version="1.0" standalone='no'?>
<!DOCTYPE manpage SYSTEM "/usr/share/xmltoman/xmltoman.dtd">
<?xml-stylesheet type="text/xsl" href="/usr/share/xmltoman/xmltoman.xsl" ?>
<!-- OpenVAS
$Id$
Description: omp manpage
Authors:
Matthew Mundell <matthew.mundell@greenbone.net>
Michael Wiegand <michael.wiegand@greenbone.net>
Copyright:
Copyright (C) 2011 Greenbone Networks GmbH
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License version 2,
or, at your option, any later version as published by the Free
Software Foundation
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
-->
<manpage name="omp" section="8" desc="OMP command line client for the Open Vulnerability Assessment System (OpenVAS)">
<synopsis>
<cmd>omp OPTIONS</cmd>
</synopsis>