From 2cf3bca8decc54469ab02d035512d939f3782986 Mon Sep 17 00:00:00 2001 From: Jeremy Long Date: Sun, 2 Mar 2014 19:23:04 -0500 Subject: [PATCH] updated documentation Former-commit-id: 026a64cd80c9870830dd11a37dcdeae0c6274659 --- .../src/site/markdown/configuration.md | 40 +++++++------- .../src/site/markdown/arguments.md | 54 +++++++++---------- 2 files changed, 47 insertions(+), 47 deletions(-) diff --git a/dependency-check-ant/src/site/markdown/configuration.md b/dependency-check-ant/src/site/markdown/configuration.md index 48465e4b0..ef16d1f18 100644 --- a/dependency-check-ant/src/site/markdown/configuration.md +++ b/dependency-check-ant/src/site/markdown/configuration.md @@ -22,28 +22,28 @@ The following table lists the configurable properties: Property | Description | Requirement | Default Value ----------------------|-------------|-------------|------------ -ApplicationName | The name of the application to use in the generated report. | Required | -ReportFormat | The format of the report to be generated. Allowed values are: HTML, XML, VULN, or ALL. The default value is HTML.| Optional | -ReportOutputDirectory | The directory where dependency-check will store data used for analysis. Defaults to the current working directory. | Optional | -FailBuildOn | If set and a CVE is found that is greater then the specified value the build will fail. The default value is 11 which means that the build will not fail. Valid values are 0-11. | Optional | -AutoUpdate | If set to false the NVD CVE data is not automatically updated. Setting this to false could result in false negatives. However, this may be required in some environments. The default value is true. | Optional | -DataDirectory | The directory where dependency-check will store data used for analysis. Defaults to a folder called, called 'dependency-check-data', that is in the same directory as the dependency-check-ant jar file was installed in. *It is not recommended to change this.* | Optional | -LogFile | The file path to write verbose logging information. | Optional | -SuppressionFile | An XML file conforming to the suppression schema that suppresses findings; this is used to hide [false positives](../suppression.html). | Optional | -ProxyUrl | Defines the proxy used to connect to the Internet. | Optional | -ProxyPort | Defines the port for the proxy. | Optional | -ProxyUsername | Defines the proxy user name. | Optional | -ProxyPassword | Defines the proxy password. | Optional | -ConnectionTimeout | The connection timeout used when downloading data files from the Internet. | Optional | -nexusAnalyzerEnabled | The connection timeout used when downloading data files from the Internet. | Optional | -nexusUrl | The connection timeout used when downloading data files from the Internet. | Optional | +ApplicationName | The name of the application to use in the generated report. | Required |   +ReportFormat | The format of the report to be generated. Allowed values are: HTML, XML, VULN, or ALL. The default value is HTML.| Optional | HTML +ReportOutputDirectory | The directory where dependency-check will store data used for analysis. Defaults to the current working directory. | Optional |   +FailBuildOn | If set and a CVE is found that is greater then the specified value the build will fail. The default value is 11 which means that the build will not fail. Valid values are 0-11. | Optional | 11 +AutoUpdate | If set to false the NVD CVE data is not automatically updated. Setting this to false could result in false negatives. However, this may be required in some environments. | Optional | true +DataDirectory | The directory where dependency-check will store data used for analysis. Defaults to a folder called, called 'dependency-check-data', that is in the same directory as the dependency-check-ant jar file was installed in. *It is not recommended to change this.* | Optional |   +LogFile | The file path to write verbose logging information. | Optional |   +SuppressionFile | An XML file conforming to the suppression schema that suppresses findings; this is used to hide [false positives](../suppression.html). | Optional |   +ProxyUrl | Defines the proxy used to connect to the Internet. | Optional |   +ProxyPort | Defines the port for the proxy. | Optional |   +ProxyUsername | Defines the proxy user name. | Optional |   +ProxyPassword | Defines the proxy password. | Optional |   +ConnectionTimeout | The connection timeout used when downloading data files from the Internet. | Optional |   +nexusAnalyzerEnabled | The connection timeout used when downloading data files from the Internet. | Optional |   +nexusUrl | The connection timeout used when downloading data files from the Internet. | Optional |   nexusUsesProxy | Whether or not the defined proxy should be used when connecting to Nexus. | Optional | true -databaseDriverName | The name of the database driver. Example: org.h2.Driver. | Optional | -databaseDriverPath | The path to the database driver JAR file; only used if the driver is not in the class path. | Optional | -connectionString | The connection string used to connect to the database. | Optional | +databaseDriverName | The name of the database driver. Example: org.h2.Driver. | Optional |   +databaseDriverPath | The path to the database driver JAR file; only used if the driver is not in the class path. | Optional |   +connectionString | The connection string used to connect to the database. | Optional |   databaseUser | The username used when connecting to the database. | Optional | dcuser -databasePassword | The password used when connecting to the database. | Optional | -zipExtensions | A comma-separated list of additional file extensions to be treated like a ZIP file, the contents will be extracted and analyzed. | Optional +databasePassword | The password used when connecting to the database. | Optional |   +zipExtensions | A comma-separated list of additional file extensions to be treated like a ZIP file, the contents will be extracted and analyzed. | Optional |   cveUrl12Modified | URL for the modified CVE 1.2 | Optional | http://nvd.nist.gov/download/nvdcve-modified.xml cveUrl20Modified | URL for the modified CVE 2.0 | Optional | http://static.nvd.nist.gov/feeds/xml/cve/nvdcve-2.0-modified.xml cveUrl12Base | Base URL for each year's CVE 1.2, the %d will be replaced with the year | Optional | http://nvd.nist.gov/download/nvdcve-%d.xml diff --git a/dependency-check-cli/src/site/markdown/arguments.md b/dependency-check-cli/src/site/markdown/arguments.md index e16bab883..bee424390 100644 --- a/dependency-check-cli/src/site/markdown/arguments.md +++ b/dependency-check-cli/src/site/markdown/arguments.md @@ -3,30 +3,30 @@ Command Line Arguments The following table lists the command line arguments: -Short | Argument Name | Parameter | Description | Requirement --------|-----------------------|-------------|-------------|------------ - \-a | \-\-app | \ | The name of the application being scanned. This is a required argument. | - \-c | \-\-connectiontimeout | \ | The connection timeout (in milliseconds) to use when downloading resources. | Optional - \-d | \-\-data | \ | The location of the data directory used to store persistent data. This option should generally not be set. | Optional - \-f | \-\-format | \ | The output format to write to (XML, HTML, VULN, ALL). The default is HTML. | - \-h | \-\-help | | Print the help message. | Optional - \-l | \-\-log | \ | The file path to write verbose logging information. | Optional - \-n | \-\-noupdate | | Disables the automatic updating of the CPE data. | Optional - \-o | \-\-out | \ | The folder to write reports to. This defaults to the current directory. | Optional - \-p | \-\-proxyport | \ | The proxy port to use when downloading resources. | Optional - | \-\-proxypass | \ | The proxy password to use when downloading resources. | Optional - | \-\-proxyuser | \ | The proxy username to use when downloading resources. | Optional - \-s | \-\-scan | \ | The path to scan \- this option can be specified multiple times. | - | \-\-suppression | \ | The file path to the suppression XML file; used to suppress [false positives](../suppression.html). | Optional - \-u | \-\-proxyurl | \ | The proxy url to use when downloading resources. | Optional - \-v | \-\-version | | Print the version information. | Optional - | \-\-advancedHelp | | Print the advanced help message. | Optional - | \-\-connectionString | \ | The connection string to the database. | Optional - | \-\-dbDriverName | \ | The database driver name. | Optional - | \-\-dbDriverPath | \ | The path to the database driver; note, this does not need to be set unless the JAR is outside of the class path. | Optional - | \-\-dbPassword | \| The password for connecting to the database. | Optional - | \-\-dbUser | \ | The username used to connect to the database. | Optional - | \-\-disableNexus | | Disable the Nexus Analyzer. | Optional - | \-\-nexus | \ | The url to the Nexus Server. | Optional - | \-\-nexusUsesProxy | \ | Whether or not the defined proxy should be used when connecting to Nexus. | Optional - | \-\-zipExtensions | \ | A comma-separated list of additional file extensions to be treated like a ZIP file, the contents will be extracted and analyzed. | Optional \ No newline at end of file +Short | Argument Name | Parameter | Description | Requirement +-------|-----------------------|-----------------|-------------|------------ + \-a | \-\-app | \ | The name of the application being scanned. This is a required argument. | Required + \-c | \-\-connectiontimeout | \ | The connection timeout (in milliseconds) to use when downloading resources. | Optional + \-d | \-\-data | \ | The location of the data directory used to store persistent data. This option should generally not be set. | Optional + \-f | \-\-format | \ | The output format to write to (XML, HTML, VULN, ALL). The default is HTML. | Required + \-h | \-\-help | | Print the help message. | Optional + \-l | \-\-log | \ | The file path to write verbose logging information. | Optional + \-n | \-\-noupdate | | Disables the automatic updating of the CPE data. | Optional + \-o | \-\-out | \ | The folder to write reports to. This defaults to the current directory. | Optional + \-p | \-\-proxyport | \ | The proxy port to use when downloading resources. | Optional + | \-\-proxypass | \ | The proxy password to use when downloading resources. | Optional + | \-\-proxyuser | \ | The proxy username to use when downloading resources. | Optional + \-s | \-\-scan | \ | The path to scan \- this option can be specified multiple times. | Required + | \-\-suppression | \ | The file path to the suppression XML file; used to suppress [false positives](../suppression.html). | Optional + \-u | \-\-proxyurl | \ | The proxy url to use when downloading resources. | Optional + \-v | \-\-version | | Print the version information. | Optional + | \-\-advancedHelp | | Print the advanced help message. | Optional + | \-\-connectionString | \ | The connection string to the database. | Optional + | \-\-dbDriverName | \ | The database driver name. | Optional + | \-\-dbDriverPath | \ | The path to the database driver; note, this does not need to be set unless the JAR is outside of the class path. | Optional + | \-\-dbPassword | \ | The password for connecting to the database. | Optional + | \-\-dbUser | \ | The username used to connect to the database. | Optional + | \-\-disableNexus | | Disable the Nexus Analyzer. | Optional + | \-\-nexus | \ | The url to the Nexus Server. | Optional + | \-\-nexusUsesProxy | \ | Whether or not the defined proxy should be used when connecting to Nexus. | Optional + | \-\-zipExtensions | \ | A comma-separated list of additional file extensions to be treated like a ZIP file, the contents will be extracted and analyzed. | Optional \ No newline at end of file