.TH NESSUS 1 "December 2004" "The Nessus Project" "Users Manuals"
.SH NAME
nessus-fetch \- A simple utility to retrieve plugins from www.nessus.org
.SH SYNOPSIS
.B nessus-fetch --plugins 
.P
.B nessus-fetch --plugins-md5
.P
.B nessus-fetch --register <code> 
.P
.B nessus-fetch --check
.P
.B nessus-fetch --url <url> <localfile> [<http_login> <http_password>]
.P

.SH DESCRIPTION
.B nessus-fetch
is a simple utility is used by 
.B nessus-update-plugins
to fetch the newest Nessus plugins from www.nessus.org and to register a Nessus installation with plugins.nessus.org. It can also be used to retrieve arbitrary files from third party servers.


.SH OPTIONS
.TP
.BI "--register <code> "
Register the current Nessus installation to http://plugins.nessus.org. Registering entitles you to receive a complete feed of the newest Nessus plugins. To register, an
.B activation code
is required. Please see http://plugins.nessus.org for more details on how to get such a code.

.TP
.BI "--check "
Makes sure that nessus-fetch is properly configured to receive a direct plugin feed from plugins.nessus.org by attempting to login into the remote server with the username and password obtained with nessus-fetch --register.
Please see http://plugins.nessus.org for more details on how to get a direct plugin feed.

.TP
.BI "--plugins-md5"
Obtains the MD5 of the remote plugin archive. Depending if the user registered or not, the file will be fetched from www.nessus.org or plugins.nessus.org. A file named 'all-2.0.tar.gz.md5' will be created in the current working directory.

.TP
.B "--plugins"
Obtains the newest Nessus plugins from www.nessus.org or plugins.nessus.org, as well as their signature file. The files 'all-2.0.tar.gz' and 'all-2.0.tar.gz.sig' will be created in the current working directory.

.TP 
.B "--url <url> <localfile> [<http_login> <http_password>]
Retrieves the file located at <url> (ie: http://www.nessus.org/index.html) and stores in in <localfile>. An optional http login and passwords can be provided if the remote server requires Basic authentication.


.SH "PROXY SUPPORT"
.P
If you need to connect to the internet through a proxy, nessus-fetch can be configured to use one. Simply edit the file
.B nessus-fetch.rc
and add the following lines, changing the appropriate values where necessary :
.P
proxy=192.168.0.1
.P
proxy_port=3128
.P
proxy_username=renaud
.P
proxy_password=s3cr3t
.P



.SH "BUGS"

nessus-fetch will not retrieve files bigger than 40MB.

.SH "SEE ALSO"
.BR nessus-update-plugins (1)

.SH MORE INFORMATION ABOUT THE NESSUS PROJECT
The canonical place where you will find more information
about the Nessus project is :

.RS
.UR
http://www.nessus.org/
.UE

.SH AUTHORS
nessus-fetch is (C) 2004 Tenable Network Security