From: Jeremy C. Reed Date: Thu, 26 Sep 2013 00:58:15 +0000 (-0500) Subject: [2307] add command-line options X-Git-Tag: bind10-1.2.0beta1-release~21^2~9 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=9e5ea3de86bb6c16fcaf8e7b4e666fb5ab39e03b;p=thirdparty%2Fkea.git [2307] add command-line options This is not formatted or organized yet. --- diff --git a/tests/tools/perfdhcp/perfdhcp.xml b/tests/tools/perfdhcp/perfdhcp.xml index bf75bdf58b..f9e26f7772 100644 --- a/tests/tools/perfdhcp/perfdhcp.xml +++ b/tests/tools/perfdhcp/perfdhcp.xml @@ -66,13 +66,125 @@ The arguments are as follows: - - - - Enable verbose logging mode. This enables logging of - diagnostic messages at the maximum debug level. - - + + Take the server-ID option from the first received message. + + DHCPv4 operation (default). This is incompatible with the -6 option. + + DHCPv6 operation. This is incompatible with the -4 option. + + aggressivityWhen the target sending rate is not yet reached, + control how many exchanges are initiated before the next pause. + + + baseThe base mac, duid, IP, etc, used to simulate different + clients. This can be specified multiple times, each instance is + in the type=value form, for instance: + (and default) mac=00:0c:01:02:03:04. + + drop-timeSpecify the time after which a request is treated as + having been lost. The value is given in seconds and may contain a + fractional component. The default is 1 second. + + time-offsetOffset of the (DHCPv4) secs field / (DHCPv6) + elapsed-time option in the (second/request) template. + The value 0 disables it. + + Print help. + + Do only the initial part of an exchange: DO or SA, depending on + whether -6 is given. + + ip-offsetOffset of the (DHCPv4) IP address in the requested-IP + option / (DHCPv6) IA_NA option in the (second/request) template. + + local-addr|interface>For DHCPv4 operation, specify the local + hostname/address to use when communicating with the server. By + default, the interface address through which traffic would + normally be routed to the server is used. + For DHCPv6 operation, specify the name of the network interface + via which exchanges are initiated. + + local-portSpecify the local port to use + (the value 0 means to use the default). + + random-offsetOffset of the last octet to randomize in the template. + + preloadInitiate first preload exchanges back to back at startup. + + rateInitiate rate DORA/SARR (or if -i is given, DO/SA) + exchanges per second. A periodic report is generated showing the + number of exchanges which were not completed, as well as the + average response latency. The program continues until + interrupted, at which point a final report is generated. + + rangeSpecify how many different clients are used. With 1 + (the default), all requests seem to come from the same client. + + seedSpecify the seed for randomization, making it repeatable. + + srvid-offsetOffset of the server-ID option in the +(second/request) template. + + template-fileThe name of a file containing the template to use + as a stream of hexadecimal digits. + + Report the version number of this program. + + wrappedCommand to call with start/stop at the beginning/end of + the program. + + diagnostic-selectorInclude extended diagnostics in the output. + diagnostic-selector is a string of single-keywords specifying + the operations for which verbose output is desired. The selector + keyletters are: +* 'a' print the decoded command line arguments +* 'e' print the exit reason +* 'i' print rate processing details +* 's' print first server-id +* 't' when finished, print timers of all successful exchanges +* 'T' when finished, print templates + + + xid-offsetTransaction ID (aka. xid) offset in the template. + +DHCPv4 only option: + + Force broadcast handling. + +DHCPv6 only options: + + Add a rapid commit option (exchanges will be SA). + +The remaining options are used only in conjunction with -r: + + max-dropAbort the test if more than max-drop requests have + been dropped. Use -D0 to abort if even a single request has been + dropped. If max-drop includes the suffix '%', it specifies a + maximum percentage of requests that may be dropped before abort. + In this case, testing of the threshold begins after 10 requests + have been expected to be received. + + num-requestInitiate num-request transactions. No report is + generated until all transactions have been initiated/waited-for + after which a report is generated and the program terminates. + + test-periodSend requests for the given test period, which is + specified in the same manner as -d. This can be used as an + alternative to -n, or both options can be given, in which case the + testing is completed when either limit is reached. + + reportDelay in seconds between two periodic reports. + + @@ -162,92 +274,4 @@ "the server.\n" "The -r option is used to set up a performance test, without\n" "it exchanges are initiated as fast as possible.\n" - "\n" - "Options:\n" - "-1: Take the server-ID option from the first received message.\n" - "-4: DHCPv4 operation (default). This is incompatible with the -6 option.\n" - "-6: DHCPv6 operation. This is incompatible with the -4 option.\n" - "-a: When the target sending rate is not yet reached,\n" - " control how many exchanges are initiated before the next pause.\n" - "-b: The base mac, duid, IP, etc, used to simulate different\n" - " clients. This can be specified multiple times, each instance is\n" - " in the = form, for instance:\n" - " (and default) mac=00:0c:01:02:03:04.\n" - "-d: Specify the time after which a requeqst is treated as\n" - " having been lost. The value is given in seconds and may contain a\n" - " fractional component. The default is 1 second.\n" - "-E: Offset of the (DHCPv4) secs field / (DHCPv6)\n" - " elapsed-time option in the (second/request) template.\n" - " The value 0 disables it.\n" - "-h: Print this help.\n" - "-i: Do only the initial part of an exchange: DO or SA, depending on\n" - " whether -6 is given.\n" - "-I: Offset of the (DHCPv4) IP address in the requested-IP\n" - " option / (DHCPv6) IA_NA option in the (second/request) template.\n" - "-l: For DHCPv4 operation, specify the local\n" - " hostname/address to use when communicating with the server. By\n" - " default, the interface address through which traffic would\n" - " normally be routed to the server is used.\n" - " For DHCPv6 operation, specify the name of the network interface\n" - " via which exchanges are initiated.\n" - "-L: Specify the local port to use\n" - " (the value 0 means to use the default).\n" - "-O: Offset of the last octet to randomize in the template.\n" - "-P: Initiate first exchanges back to back at startup.\n" - "-r: Initiate DORA/SARR (or if -i is given, DO/SA)\n" - " exchanges per second. A periodic report is generated showing the\n" - " number of exchanges which were not completed, as well as the\n" - " average response latency. The program continues until\n" - " interrupted, at which point a final report is generated.\n" - "-R: Specify how many different clients are used. With 1\n" - " (the default), all requests seem to come from the same client.\n" - "-s: Specify the seed for randomization, making it repeatable.\n" - "-S: Offset of the server-ID option in the\n" - " (second/request) template.\n" - "-T: The name of a file containing the template to use\n" - " as a stream of hexadecimal digits.\n" - "-v: Report the version number of this program.\n" - "-w: Command to call with start/stop at the beginning/end of\n" - " the program.\n" - "-x: Include extended diagnostics in the output.\n" - " is a string of single-keywords specifying\n" - " the operations for which verbose output is desired. The selector\n" - " keyletters are:\n" - " * 'a': print the decoded command line arguments\n" - " * 'e': print the exit reason\n" - " * 'i': print rate processing details\n" - " * 's': print first server-id\n" - " * 't': when finished, print timers of all successful exchanges\n" - " * 'T': when finished, print templates\n" - "-X: Transaction ID (aka. xid) offset in the template.\n" - "\n" - "DHCPv4 only options:\n" - "-B: Force broadcast handling.\n" - "\n" - "DHCPv6 only options:\n" - "-c: Add a rapid commit option (exchanges will be SA).\n" - "\n" - "The remaining options are used only in conjunction with -r:\n" - "\n" - "-D: Abort the test if more than requests have\n" - " been dropped. Use -D0 to abort if even a single request has been\n" - " dropped. If includes the suffix '%', it specifies a\n" - " maximum percentage of requests that may be dropped before abort.\n" - " In this case, testing of the threshold begins after 10 requests\n" - " have been expected to be received.\n" - "-n: Initiate transactions. No report is\n" - " generated until all transactions have been initiated/waited-for,\n" - " after which a report is generated and the program terminates.\n" - "-p: Send requests for the given test period, which is\n" - " specified in the same manner as -d. This can be used as an\n" - " alternative to -n, or both options can be given, in which case the\n" - " testing is completed when either limit is reached.\n" - "-t: Delay in seconds between two periodic reports.\n" - "\n" - "Errors:\n" - "- tooshort: received a too short message\n" - "- orphans: received a message which doesn't match an exchange\n" - " (duplicate, late or not related)\n" - "- locallimit: reached to local system limits when sending a message.\n" - "\n" -->