// Copyright (C) 2012-2016 Internet Systems Consortium, Inc. ("ISC") // // This Source Code Form is subject to the terms of the Mozilla Public // License, v. 2.0. If a copy of the MPL was not distributed with this // file, You can obtain one at http://mozilla.org/MPL/2.0/. #include #include "command_options.h" #include #include #include #include #include #include #include #include #include #include #include #include using namespace std; using namespace isc; namespace isc { namespace perfdhcp { // Refer to config_report so it will be embedded in the binary const char* const* perfdhcp_config_report = isc::detail::config_report; CommandOptions::LeaseType::LeaseType() : type_(ADDRESS) { } CommandOptions::LeaseType::LeaseType(const Type lease_type) : type_(lease_type) { } bool CommandOptions::LeaseType::is(const Type lease_type) const { return (lease_type == type_); } bool CommandOptions::LeaseType::includes(const Type lease_type) const { return (is(ADDRESS_AND_PREFIX) || (lease_type == type_)); } void CommandOptions::LeaseType::set(const Type lease_type) { type_ = lease_type; } void CommandOptions::LeaseType::fromCommandLine(const std::string& cmd_line_arg) { if (cmd_line_arg == "address-only") { type_ = ADDRESS; } else if (cmd_line_arg == "prefix-only") { type_ = PREFIX; } else if (cmd_line_arg == "address-and-prefix") { type_ = ADDRESS_AND_PREFIX; } else { isc_throw(isc::InvalidParameter, "value of lease-type: -e," " must be one of the following: 'address-only' or" " 'prefix-only'"); } } std::string CommandOptions::LeaseType::toText() const { switch (type_) { case ADDRESS: return ("address-only (IA_NA option added to the client's request)"); case PREFIX: return ("prefix-only (IA_PD option added to the client's request)"); case ADDRESS_AND_PREFIX: return ("address-and-prefix (Both IA_NA and IA_PD options added to the" " client's request)"); default: isc_throw(Unexpected, "internal error: undefined lease type code when" " returning textual representation of the lease type"); } } CommandOptions& CommandOptions::instance() { static CommandOptions options; return (options); } void CommandOptions::reset() { // Default mac address used in DHCP messages // if -b mac= was not specified uint8_t mac[6] = { 0x0, 0xC, 0x1, 0x2, 0x3, 0x4 }; // Default packet drop time if -D parameter // was not specified double dt[2] = { 1., 1. }; // We don't use constructor initialization list because we // will need to reset all members many times to perform unit tests ipversion_ = 0; exchange_mode_ = DORA_SARR; lease_type_.set(LeaseType::ADDRESS); rate_ = 0; renew_rate_ = 0; release_rate_ = 0; report_delay_ = 0; clients_num_ = 0; mac_template_.assign(mac, mac + 6); duid_template_.clear(); base_.clear(); mac_list_file_.clear(); mac_list_.clear(); num_request_.clear(); period_ = 0; drop_time_set_ = 0; drop_time_.assign(dt, dt + 2); max_drop_.clear(); max_pdrop_.clear(); localname_.clear(); is_interface_ = false; preload_ = 0; aggressivity_ = 1; local_port_ = 0; seeded_ = false; seed_ = 0; broadcast_ = false; rapid_commit_ = false; use_first_ = false; template_file_.clear(); rnd_offset_.clear(); xid_offset_.clear(); elp_offset_ = -1; sid_offset_ = -1; rip_offset_ = -1; diags_.clear(); wrapped_.clear(); server_name_.clear(); v6_relay_encapsulation_level_ = 0; generateDuidTemplate(); } bool CommandOptions::parse(int argc, char** const argv, bool print_cmd_line) { // Reset internal variables used by getopt // to eliminate undefined behavior when // parsing different command lines multiple times #ifdef __GLIBC__ // Warning: non-portable code. This is due to a bug in glibc's // getopt() which keeps internal state about an old argument vector // (argc, argv) from last call and tries to scan them when a new // argument vector (argc, argv) is passed. As the old vector may not // be main()'s arguments, but heap allocated and may have been freed // since, this becomes a use after free and results in random // behavior. According to the NOTES section in glibc getopt()'s // manpage, setting optind=0 resets getopt()'s state. Though this is // not required in our usage of getopt(), the bug still happens // unless we set optind=0. // // Setting optind=0 is non-portable code. optind = 0; #else optind = 1; #endif // optreset is declared on BSD systems and is used to reset internal // state of getopt(). When parsing command line arguments multiple // times with getopt() the optreset must be set to 1 every time before // parsing starts. Failing to do so will result in random behavior of // getopt(). #ifdef HAVE_OPTRESET optreset = 1; #endif opterr = 0; // Reset values of class members reset(); // Informs if program has been run with 'h' or 'v' option. bool help_or_version_mode = initialize(argc, argv, print_cmd_line); if (!help_or_version_mode) { validate(); } return (help_or_version_mode); } bool CommandOptions::initialize(int argc, char** argv, bool print_cmd_line) { int opt = 0; // Subsequent options returned by getopt() std::string drop_arg; // Value of -Dargument size_t percent_loc = 0; // Location of % sign in -D double drop_percent = 0; // % value (1..100) in -D int num_drops = 0; // Max number of drops specified in -D int num_req = 0; // Max number of dropped // requests in -n int offset_arg = 0; // Temporary variable holding offset arguments std::string sarg; // Temporary variable for string args std::ostringstream stream; stream << "perfdhcp"; int num_mac_list_files = 0; // In this section we collect argument values from command line // they will be tuned and validated elsewhere while((opt = getopt(argc, argv, "hv46A:r:t:R:b:n:p:d:D:l:P:a:L:M:" "s:iBc1T:X:O:E:S:I:x:w:e:f:F:")) != -1) { stream << " -" << static_cast(opt); if (optarg) { stream << " " << optarg; } switch (opt) { case '1': use_first_ = true; break; // Simulate DHCPv6 relayed traffic. case 'A': // @todo: At the moment we only support simulating a single relay // agent. In the future we should extend it to up to 32. // See comment in https://github.com/isc-projects/kea/pull/22#issuecomment-243405600 v6_relay_encapsulation_level_ = static_cast(positiveInteger("-A must" " be a positive integer")); if (v6_relay_encapsulation_level_ != 1) { isc_throw(isc::InvalidParameter, "-A only supports 1 at the moment."); } break; case '4': check(ipversion_ == 6, "IP version already set to 6"); ipversion_ = 4; break; case '6': check(ipversion_ == 4, "IP version already set to 4"); ipversion_ = 6; break; case 'a': aggressivity_ = positiveInteger("value of aggressivity: -a" " must be a positive integer"); break; case 'b': check(base_.size() > 3, "-b already specified," " unexpected occurrence of 5th -b"); base_.push_back(optarg); decodeBase(base_.back()); break; case 'B': broadcast_ = true; break; case 'c': rapid_commit_ = true; break; case 'd': check(drop_time_set_ > 1, "maximum number of drops already specified, " "unexpected 3rd occurrence of -d"); try { drop_time_[drop_time_set_] = boost::lexical_cast(optarg); } catch (boost::bad_lexical_cast&) { isc_throw(isc::InvalidParameter, "value of drop time: -d" " must be positive number"); } check(drop_time_[drop_time_set_] <= 0., "drop-time must be a positive number"); drop_time_set_ = true; break; case 'D': drop_arg = std::string(optarg); percent_loc = drop_arg.find('%'); check(max_pdrop_.size() > 1 || max_drop_.size() > 1, "values of maximum drops: -D already " "specified, unexpected 3rd occurrence of -D"); if ((percent_loc) != std::string::npos) { try { drop_percent = boost::lexical_cast(drop_arg.substr(0, percent_loc)); } catch (boost::bad_lexical_cast&) { isc_throw(isc::InvalidParameter, "value of drop percentage: -D" " must be 0..100"); } check((drop_percent <= 0) || (drop_percent >= 100), "value of drop percentage: -D must be 0..100"); max_pdrop_.push_back(drop_percent); } else { num_drops = positiveInteger("value of max drops number:" " -d must be a positive integer"); max_drop_.push_back(num_drops); } break; case 'e': initLeaseType(); break; case 'E': elp_offset_ = nonNegativeInteger("value of time-offset: -E" " must not be a negative integer"); break; case 'f': renew_rate_ = positiveInteger("value of the renew rate: -f" " must be a positive integer"); break; case 'F': release_rate_ = positiveInteger("value of the release rate:" " -F must be a" " positive integer"); break; case 'h': usage(); return (true); case 'i': exchange_mode_ = DO_SA; break; case 'I': rip_offset_ = positiveInteger("value of ip address offset:" " -I must be a" " positive integer"); break; case 'l': localname_ = std::string(optarg); initIsInterface(); break; case 'L': local_port_ = nonNegativeInteger("value of local port:" " -L must not be a" " negative integer"); check(local_port_ > static_cast(std::numeric_limits::max()), "local-port must be lower than " + boost::lexical_cast(std::numeric_limits::max())); break; case 'M': check(num_mac_list_files >= 1, "only -M option can be specified"); num_mac_list_files++; mac_list_file_ = std::string(optarg); loadMacs(); break; case 'n': num_req = positiveInteger("value of num-request:" " -n must be a positive integer"); if (num_request_.size() >= 2) { isc_throw(isc::InvalidParameter, "value of maximum number of requests: -n " "already specified, unexpected 3rd occurrence" " of -n"); } num_request_.push_back(num_req); break; case 'O': if (rnd_offset_.size() < 2) { offset_arg = positiveInteger("value of random offset: " "-O must be greater than 3"); } else { isc_throw(isc::InvalidParameter, "random offsets already specified," " unexpected 3rd occurrence of -O"); } check(offset_arg < 3, "value of random random-offset:" " -O must be greater than 3 "); rnd_offset_.push_back(offset_arg); break; case 'p': period_ = positiveInteger("value of test period:" " -p must be a positive integer"); break; case 'P': preload_ = nonNegativeInteger("number of preload packets:" " -P must not be " "a negative integer"); break; case 'r': rate_ = positiveInteger("value of rate:" " -r must be a positive integer"); break; case 'R': initClientsNum(); break; case 's': seed_ = static_cast (nonNegativeInteger("value of seed:" " -s must be non-negative integer")); seeded_ = seed_ > 0 ? true : false; break; case 'S': sid_offset_ = positiveInteger("value of server id offset:" " -S must be a" " positive integer"); break; case 't': report_delay_ = positiveInteger("value of report delay:" " -t must be a" " positive integer"); break; case 'T': if (template_file_.size() < 2) { sarg = nonEmptyString("template file name not specified," " expected -T"); template_file_.push_back(sarg); } else { isc_throw(isc::InvalidParameter, "template files are already specified," " unexpected 3rd -T occurrence"); } break; case 'v': version(); return (true); case 'w': wrapped_ = nonEmptyString("command for wrapped mode:" " -w must be specified"); break; case 'x': diags_ = nonEmptyString("value of diagnostics selectors:" " -x must be specified"); break; case 'X': if (xid_offset_.size() < 2) { offset_arg = positiveInteger("value of transaction id:" " -X must be a" " positive integer"); } else { isc_throw(isc::InvalidParameter, "transaction ids already specified," " unexpected 3rd -X occurrence"); } xid_offset_.push_back(offset_arg); break; default: isc_throw(isc::InvalidParameter, "unknown command line option"); } } // If the IP version was not specified in the // command line, assume IPv4. if (ipversion_ == 0) { ipversion_ = 4; } // If template packet files specified for both DISCOVER/SOLICIT // and REQUEST/REPLY exchanges make sure we have transaction id // and random duid offsets for both exchanges. We will duplicate // value specified as -X and -R for second // exchange if user did not specified otherwise. if (template_file_.size() > 1) { if (xid_offset_.size() == 1) { xid_offset_.push_back(xid_offset_[0]); } if (rnd_offset_.size() == 1) { rnd_offset_.push_back(rnd_offset_[0]); } } // Get server argument // NoteFF02::1:2 and FF02::1:3 are defined in RFC3315 as // All_DHCP_Relay_Agents_and_Servers and All_DHCP_Servers // addresses check(optind < argc -1, "extra arguments?"); if (optind == argc - 1) { server_name_ = argv[optind]; stream << " " << server_name_; // Decode special cases if ((ipversion_ == 4) && (server_name_.compare("all") == 0)) { broadcast_ = true; // Use broadcast address as server name. server_name_ = DHCP_IPV4_BROADCAST_ADDRESS; } else if ((ipversion_ == 6) && (server_name_.compare("all") == 0)) { server_name_ = ALL_DHCP_RELAY_AGENTS_AND_SERVERS; } else if ((ipversion_ == 6) && (server_name_.compare("servers") == 0)) { server_name_ = ALL_DHCP_SERVERS; } } if (print_cmd_line) { std::cout << "Running: " << stream.str() << std::endl; } // Handle the local '-l' address/interface if (!localname_.empty()) { if (server_name_.empty()) { if (is_interface_ && (ipversion_ == 4)) { broadcast_ = true; server_name_ = DHCP_IPV4_BROADCAST_ADDRESS; } else if (is_interface_ && (ipversion_ == 6)) { server_name_ = ALL_DHCP_RELAY_AGENTS_AND_SERVERS; } } } if (server_name_.empty()) { isc_throw(InvalidParameter, "without an interface, server is required"); } // If DUID is not specified from command line we need to // generate one. if (duid_template_.empty()) { generateDuidTemplate(); } return (false); } void CommandOptions::initClientsNum() { const std::string errmsg = "value of -R must be non-negative integer"; try { // Declare clients_num as as 64-bit signed value to // be able to detect negative values provided // by user. We would not detect negative values // if we casted directly to unsigned value. long long clients_num = boost::lexical_cast(optarg); check(clients_num < 0, errmsg); clients_num_ = boost::lexical_cast(optarg); } catch (boost::bad_lexical_cast&) { isc_throw(isc::InvalidParameter, errmsg); } } void CommandOptions::initIsInterface() { is_interface_ = false; if (!localname_.empty()) { dhcp::IfaceMgr& iface_mgr = dhcp::IfaceMgr::instance(); if (iface_mgr.getIface(localname_) != NULL) { is_interface_ = true; } } } void CommandOptions::decodeBase(const std::string& base) { std::string b(base); boost::algorithm::to_lower(b); // Currently we only support mac and duid if ((b.substr(0, 4) == "mac=") || (b.substr(0, 6) == "ether=")) { decodeMacBase(b); } else if (b.substr(0, 5) == "duid=") { decodeDuid(b); } else { isc_throw(isc::InvalidParameter, "base value not provided as -b," " expected -b mac= or -b duid="); } } void CommandOptions::decodeMacBase(const std::string& base) { // Strip string from mac= size_t found = base.find('='); static const char* errmsg = "expected -b format for" " mac address is -b mac=00::0C::01::02::03::04 or" " -b mac=00:0C:01:02:03:04"; check(found == std::string::npos, errmsg); // Decode mac address to vector of uint8_t std::istringstream s1(base.substr(found + 1)); std::string token; mac_template_.clear(); // Get pieces of MAC address separated with : (or even ::) while (std::getline(s1, token, ':')) { // Convert token to byte value using std::istringstream if (token.length() > 0) { unsigned int ui = 0; try { // Do actual conversion ui = convertHexString(token); } catch (isc::InvalidParameter&) { isc_throw(isc::InvalidParameter, "invalid characters in MAC provided"); } // If conversion succeeded store byte value mac_template_.push_back(ui); } } // MAC address must consist of 6 octets, otherwise it is invalid check(mac_template_.size() != 6, errmsg); } void CommandOptions::decodeDuid(const std::string& base) { // Strip argument from duid= std::vector duid_template; size_t found = base.find('='); check(found == std::string::npos, "expected -b" " format for duid is -b duid="); std::string b = base.substr(found + 1); // DUID must have even number of digits and must not be longer than 64 bytes check(b.length() & 1, "odd number of hexadecimal digits in duid"); check(b.length() > 128, "duid too large"); check(b.length() == 0, "no duid specified"); // Turn pairs of hexadecimal digits into vector of octets for (size_t i = 0; i < b.length(); i += 2) { unsigned int ui = 0; try { // Do actual conversion ui = convertHexString(b.substr(i, 2)); } catch (isc::InvalidParameter&) { isc_throw(isc::InvalidParameter, "invalid characters in DUID provided," " expected hex digits"); } duid_template.push_back(static_cast(ui)); } // @todo Get rid of this limitation when we manage add support // for DUIDs other than LLT. Shorter DUIDs may be useful for // server testing purposes. check(duid_template.size() < 6, "DUID must be at least 6 octets long"); // Assign the new duid only if successfully generated. std::swap(duid_template, duid_template_); } void CommandOptions::generateDuidTemplate() { using namespace boost::posix_time; // Duid template will be most likely generated only once but // it is ok if it is called more then once so we simply // regenerate it and discard previous value. duid_template_.clear(); const uint8_t duid_template_len = 14; duid_template_.resize(duid_template_len); // The first four octets consist of DUID LLT and hardware type. duid_template_[0] = static_cast(static_cast(isc::dhcp::DUID::DUID_LLT) >> 8); duid_template_[1] = static_cast(static_cast(isc::dhcp::DUID::DUID_LLT) & 0xff); duid_template_[2] = HWTYPE_ETHERNET >> 8; duid_template_[3] = HWTYPE_ETHERNET & 0xff; // As described in RFC3315: 'the time value is the time // that the DUID is generated represented in seconds // since midnight (UTC), January 1, 2000, modulo 2^32.' ptime now = microsec_clock::universal_time(); ptime duid_epoch(from_iso_string("20000101T000000")); time_period period(duid_epoch, now); uint32_t duration_sec = htonl(period.length().total_seconds()); memcpy(&duid_template_[4], &duration_sec, 4); // Set link layer address (6 octets). This value may be // randomized before sending a packet to simulate different // clients. memcpy(&duid_template_[8], &mac_template_[0], 6); } uint8_t CommandOptions::convertHexString(const std::string& text) const { unsigned int ui = 0; // First, check if we are dealing with hexadecimal digits only for (size_t i = 0; i < text.length(); ++i) { if (!std::isxdigit(text[i])) { isc_throw(isc::InvalidParameter, "The following digit: " << text[i] << " in " << text << "is not hexadecimal"); } } // If we are here, we have valid string to convert to octet std::istringstream text_stream(text); text_stream >> std::hex >> ui >> std::dec; // Check if for some reason we have overflow - this should never happen! if (ui > 0xFF) { isc_throw(isc::InvalidParameter, "Can't convert more than" " two hex digits to byte"); } return ui; } void CommandOptions::loadMacs() { std::string line; std::ifstream infile(mac_list_file_.c_str()); while (std::getline(infile, line)) { check(decodeMacString(line), "invalid mac in input"); } } bool CommandOptions::decodeMacString(const std::string& line) { // decode mac string into a vector of uint8_t returns true in case of error. std::istringstream s(line); std::string token; std::vector mac; while(std::getline(s, token, ':')) { // Convert token to byte value using std::istringstream if (token.length() > 0) { unsigned int ui = 0; try { // Do actual conversion ui = convertHexString(token); } catch (isc::InvalidParameter&) { return (true); } // If conversion succeeded store byte value mac.push_back(ui); } } mac_list_.push_back(mac); return (false); } void CommandOptions::validate() const { check((getIpVersion() != 4) && (isBroadcast() != 0), "-B is not compatible with IPv6 (-6)"); check((getIpVersion() != 6) && (isRapidCommit() != 0), "-6 (IPv6) must be set to use -c"); check(getIpVersion() == 4 && isUseRelayedV6(), "Can't use -4 with -A, it's a V6 only option."); check((getIpVersion() != 6) && (getReleaseRate() != 0), "-F may be used with -6 (IPv6) only"); check((getExchangeMode() == DO_SA) && (getNumRequests().size() > 1), "second -n is not compatible with -i"); check((getIpVersion() == 4) && !getLeaseType().is(LeaseType::ADDRESS), "-6 option must be used if lease type other than '-e address-only'" " is specified"); check(!getTemplateFiles().empty() && !getLeaseType().is(LeaseType::ADDRESS), "template files may be only used with '-e address-only'"); check((getExchangeMode() == DO_SA) && (getDropTime()[1] != 1.), "second -d is not compatible with -i"); check((getExchangeMode() == DO_SA) && ((getMaxDrop().size() > 1) || (getMaxDropPercentage().size() > 1)), "second -D is not compatible with -i"); check((getExchangeMode() == DO_SA) && (isUseFirst()), "-1 is not compatible with -i"); check((getExchangeMode() == DO_SA) && (getTemplateFiles().size() > 1), "second -T is not compatible with -i"); check((getExchangeMode() == DO_SA) && (getTransactionIdOffset().size() > 1), "second -X is not compatible with -i"); check((getExchangeMode() == DO_SA) && (getRandomOffset().size() > 1), "second -O= 0), "-E is not compatible with -i"); check((getExchangeMode() == DO_SA) && (getServerIdOffset() >= 0), "-S is not compatible with -i"); check((getExchangeMode() == DO_SA) && (getRequestedIpOffset() >= 0), "-I is not compatible with -i"); check((getExchangeMode() == DO_SA) && (getRenewRate() != 0), "-f is not compatible with -i"); check((getExchangeMode() == DO_SA) && (getReleaseRate() != 0), "-F is not compatible with -i"); check((getExchangeMode() != DO_SA) && (isRapidCommit() != 0), "-i must be set to use -c"); check((getRate() == 0) && (getReportDelay() != 0), "-r must be set to use -t"); check((getRate() == 0) && (getNumRequests().size() > 0), "-r must be set to use -n"); check((getRate() == 0) && (getPeriod() != 0), "-r must be set to use -p"); check((getRate() == 0) && ((getMaxDrop().size() > 0) || getMaxDropPercentage().size() > 0), "-r must be set to use -D"); check((getRate() != 0) && (getRenewRate() + getReleaseRate() > getRate()), "The sum of Renew rate (-f) and Release rate" " (-F) must not be greater than the exchange" " rate specified as -r"); check((getRate() == 0) && (getRenewRate() != 0), "Renew rate specified as -f must not be specified" " when -r parameter is not specified"); check((getRate() == 0) && (getReleaseRate() != 0), "Release rate specified as -F must not be specified" " when -r parameter is not specified"); check((getTemplateFiles().size() < getTransactionIdOffset().size()), "-T must be set to use -X"); check((getTemplateFiles().size() < getRandomOffset().size()), "-T must be set to use -O"); check((getTemplateFiles().size() < 2) && (getElapsedTimeOffset() >= 0), "second/request -T must be set to use -E"); check((getTemplateFiles().size() < 2) && (getServerIdOffset() >= 0), "second/request -T must be set to " "use -S"); check((getTemplateFiles().size() < 2) && (getRequestedIpOffset() >= 0), "second/request -T must be set to " "use -I"); check((!getMacListFile().empty() && base_.size() > 0), "Can't use -b with -M option"); } void CommandOptions::check(bool condition, const std::string& errmsg) const { // The same could have been done with macro or just if statement but // we prefer functions to macros here std::ostringstream stream; stream << errmsg << "\n"; if (condition) { isc_throw(isc::InvalidParameter, errmsg); } } int CommandOptions::positiveInteger(const std::string& errmsg) const { try { int value = boost::lexical_cast(optarg); check(value <= 0, errmsg); return (value); } catch (boost::bad_lexical_cast&) { isc_throw(InvalidParameter, errmsg); } } int CommandOptions::nonNegativeInteger(const std::string& errmsg) const { try { int value = boost::lexical_cast(optarg); check(value < 0, errmsg); return (value); } catch (boost::bad_lexical_cast&) { isc_throw(InvalidParameter, errmsg); } } std::string CommandOptions::nonEmptyString(const std::string& errmsg) const { std::string sarg = optarg; if (sarg.length() == 0) { isc_throw(isc::InvalidParameter, errmsg); } return sarg; } void CommandOptions::initLeaseType() { std::string lease_type_arg = optarg; lease_type_.fromCommandLine(lease_type_arg); } void CommandOptions::printCommandLine() const { std::cout << "IPv" << static_cast(ipversion_) << std::endl; if (exchange_mode_ == DO_SA) { if (ipversion_ == 4) { std::cout << "DISCOVER-OFFER only" << std::endl; } else { std::cout << "SOLICIT-ADVERTISE only" << std::endl; } } std::cout << "lease-type=" << getLeaseType().toText() << std::endl; if (rate_ != 0) { std::cout << "rate[1/s]=" << rate_ << std::endl; } if (getRenewRate() != 0) { std::cout << "renew-rate[1/s]=" << getRenewRate() << std::endl; } if (getReleaseRate() != 0) { std::cout << "release-rate[1/s]=" << getReleaseRate() << std::endl; } if (report_delay_ != 0) { std::cout << "report[s]=" << report_delay_ << std::endl; } if (clients_num_ != 0) { std::cout << "clients=" << clients_num_ << std::endl; } for (size_t i = 0; i < base_.size(); ++i) { std::cout << "base[" << i << "]=" << base_[i] << std::endl; } for (size_t i = 0; i < num_request_.size(); ++i) { std::cout << "num-request[" << i << "]=" << num_request_[i] << std::endl; } if (period_ != 0) { std::cout << "test-period=" << period_ << std::endl; } for (size_t i = 0; i < drop_time_.size(); ++i) { std::cout << "drop-time[" << i << "]=" << drop_time_[i] << std::endl; } for (size_t i = 0; i < max_drop_.size(); ++i) { std::cout << "max-drop{" << i << "]=" << max_drop_[i] << std::endl; } for (size_t i = 0; i < max_pdrop_.size(); ++i) { std::cout << "max-pdrop{" << i << "]=" << max_pdrop_[i] << std::endl; } if (preload_ != 0) { std::cout << "preload=" << preload_ << std::endl; } std::cout << "aggressivity=" << aggressivity_ << std::endl; if (getLocalPort() != 0) { std::cout << "local-port=" << local_port_ << std::endl; } if (seeded_) { std::cout << "seed=" << seed_ << std::endl; } if (broadcast_) { std::cout << "broadcast" << std::endl; } if (rapid_commit_) { std::cout << "rapid-commit" << std::endl; } if (use_first_) { std::cout << "use-first" << std::endl; } if (!mac_list_file_.empty()) { std::cout << "mac-list-file=" << mac_list_file_ << std::endl; } for (size_t i = 0; i < template_file_.size(); ++i) { std::cout << "template-file[" << i << "]=" << template_file_[i] << std::endl; } for (size_t i = 0; i < xid_offset_.size(); ++i) { std::cout << "xid-offset[" << i << "]=" << xid_offset_[i] << std::endl; } if (elp_offset_ != 0) { std::cout << "elp-offset=" << elp_offset_ << std::endl; } for (size_t i = 0; i < rnd_offset_.size(); ++i) { std::cout << "rnd-offset[" << i << "]=" << rnd_offset_[i] << std::endl; } if (sid_offset_ != 0) { std::cout << "sid-offset=" << sid_offset_ << std::endl; } if (rip_offset_ != 0) { std::cout << "rip-offset=" << rip_offset_ << std::endl; } if (!diags_.empty()) { std::cout << "diagnostic-selectors=" << diags_ << std::endl; } if (!wrapped_.empty()) { std::cout << "wrapped=" << wrapped_ << std::endl; } if (!localname_.empty()) { if (is_interface_) { std::cout << "interface=" << localname_ << std::endl; } else { std::cout << "local-addr=" << localname_ << std::endl; } } if (!server_name_.empty()) { std::cout << "server=" << server_name_ << std::endl; } } void CommandOptions::usage() const { std::cout << "perfdhcp [-hv] [-4|-6] [-A] [-e]" " [-r] [-f]\n" " [-F] [-t] [-R] [-b]\n" " [-n] [-p] [-d]\n" " [-D] [-l] [-P]\n" " [-a] [-L] [-s] [-i] [-B]\n" " [-c] [-1] [-M] [-T]\n" " [-X] [-O]\n" " [-S] [-I] [-x]\n" " [-w] [server]\n" "\n" "The [server] argument is the name/address of the DHCP server to\n" "contact. For DHCPv4 operation, exchanges are initiated by\n" "transmitting a DHCP DISCOVER to this address.\n" "\n" "For DHCPv6 operation, exchanges are initiated by transmitting a DHCP\n" "SOLICIT to this address. In the DHCPv6 case, the special name 'all'\n" "can be used to refer to All_DHCP_Relay_Agents_and_Servers (the\n" "multicast address FF02::1:2), or the special name 'servers' to refer\n" "to All_DHCP_Servers (the multicast address FF05::1:3). The [server]\n" "argument is optional only in the case that -l is used to specify an\n" "interface, in which case [server] defaults to 'all'.\n" "\n" "The default is to perform a single 4-way exchange, effectively pinging\n" "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 request 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: A type of lease being requested from the server. It\n" " may be one of the following: address-only, prefix-only or\n" " address-and-prefix. The address-only indicates that the regular\n" " address (v4 or v6) will be requested. The prefix-only indicates\n" " that the IPv6 prefix will be requested. The address-and-prefix\n" " indicates that both IPv6 address and prefix will be requested.\n" " The '-e prefix-only' and -'e address-and-prefix' must not be\n" " used with -4.\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" "-f: Rate at which DHCPv4 or DHCPv6 renew requests are sent\n" " to a server. This value is only valid when used in conjunction\n" " with the exchange rate (given by -r). Furthermore the sum of\n" " this value and the release-rate (given by -F: 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" "-M: A text file containing a list of MAC addresses,\n" " one per line. If provided, a MAC address will be chosen randomly\n" " from this list for every new exchange. In the DHCPv6 case, MAC\n" " addresses are used to generate DUID-LLs. This parameter must not be\n" " used in conjunction with the -b parameter.\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" "-F: Rate at which IPv6 Release requests are sent to\n" " a server. This value is only valid when used in conjunction with\n" " the exchange rate (given by -r). Furthermore the sum of\n" " this value and the renew-rate (given by -f: Specifies that relayed traffic must be\n" " generated. The argument specifies the level of encapsulation, i.e.\n" " how many relay agents are simulated. Currently the only supported\n" " value is 1, which means that the generated\n" " traffic is an equivalent of the traffic passing through a single\n" " relay agent.\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" "Exit status:\n" "The exit status is:\n" "0 on complete success.\n" "1 for a general error.\n" "2 if an error is found in the command line arguments.\n" "3 if there are no general failures in operation, but one or more\n" " exchanges are not successfully completed.\n"; } void CommandOptions::version() const { std::cout << "VERSION: " << VERSION << std::endl; } } // namespace perfdhcp } // namespace isc