Browse Source

[4271] Mostly typo level clean up

Shawn Routhier 8 years ago
parent
commit
d6fa702fef

+ 5 - 5
doc/guide/classify.xml

@@ -202,7 +202,7 @@
 -->
 -->
             <row>
             <row>
               <entry>Option existence</entry>
               <entry>Option existence</entry>
-              <entry>option[123].exist</entry>
+              <entry>option[123].exists</entry>
               <entry>'true'</entry>
               <entry>'true'</entry>
               <entry>If the option with given code is present in the
               <entry>If the option with given code is present in the
               packet "true" else "false"</entry>
               packet "true" else "false"</entry>
@@ -294,7 +294,7 @@
 
 
             <row>
             <row>
               <entry>Vendor option existence (any vendor)</entry>
               <entry>Vendor option existence (any vendor)</entry>
-              <entry>vendor[*].exist</entry>
+              <entry>vendor[*].exists</entry>
               <entry>true</entry>
               <entry>true</entry>
               <entry>Returns whether a vendor option from any vendor
               <entry>Returns whether a vendor option from any vendor
               is present ('true') or absent ('false').</entry>
               is present ('true') or absent ('false').</entry>
@@ -335,7 +335,7 @@
 
 
             <row>
             <row>
               <entry>Vendor class option existence (any vendor)</entry>
               <entry>Vendor class option existence (any vendor)</entry>
-              <entry>vendor-class[*].exist</entry>
+              <entry>vendor-class[*].exists</entry>
               <entry>true</entry>
               <entry>true</entry>
               <entry>Returns whether a vendor class option from any vendor
               <entry>Returns whether a vendor class option from any vendor
               is present ('true') or absent ('false').</entry>
               is present ('true') or absent ('false').</entry>
@@ -359,7 +359,7 @@
             <row>
             <row>
               <entry>First data chunk from vendor class option</entry>
               <entry>First data chunk from vendor class option</entry>
               <entry>vendor-class[4491].data</entry>
               <entry>vendor-class[4491].data</entry>
-              <entry>true</entry>
+              <entry>docsis3.0</entry>
               <entry>Returns content of the first data chunk from
               <entry>Returns content of the first data chunk from
               the vendor class option with specified enterprise-id.
               the vendor class option with specified enterprise-id.
               Returns '' if missing.</entry>
               Returns '' if missing.</entry>
@@ -399,7 +399,7 @@
       </para>
       </para>
 
 
       <para>
       <para>
-      "option[code].exist" checks if an option with the code "code" is present
+      "option[code].exists" checks if an option with the code "code" is present
       in the incoming packet. It can be used with empty options.
       in the incoming packet. It can be used with empty options.
       </para>
       </para>
 
 

+ 5 - 5
src/lib/eval/eval_context.h

@@ -101,20 +101,20 @@ public:
     uint16_t convertOptionName(const std::string& option_name,
     uint16_t convertOptionName(const std::string& option_name,
                                const isc::eval::location& loc);
                                const isc::eval::location& loc);
 
 
-    /// @brief Attempts to convert string to unsinged 32bit integer
+    /// @brief Attempts to convert string to unsigned 32bit integer
     ///
     ///
     /// @param number string to be converted
     /// @param number string to be converted
     /// @param loc the location of the token
     /// @param loc the location of the token
-    /// @return the option code
+    /// @return the integer value
     /// @throw EvalParseError if conversion fails or the value is out of range.
     /// @throw EvalParseError if conversion fails or the value is out of range.
     uint32_t convertUint32(const std::string& number,
     uint32_t convertUint32(const std::string& number,
                            const isc::eval::location& loc);
                            const isc::eval::location& loc);
 
 
-    /// @brief Attempts to convert string to unsinged 8bit integer
+    /// @brief Attempts to convert string to unsigned 8bit integer
     ///
     ///
     /// @param number string to be converted
     /// @param number string to be converted
     /// @param loc the location of the token
     /// @param loc the location of the token
-    /// @return the option code
+    /// @return the integer value
     /// @throw EvalParseError if conversion fails or the value is out of range.
     /// @throw EvalParseError if conversion fails or the value is out of range.
     uint8_t convertUint8(const std::string& number,
     uint8_t convertUint8(const std::string& number,
                          const isc::eval::location& loc);
                          const isc::eval::location& loc);
@@ -123,7 +123,7 @@ public:
     ///
     ///
     /// @param nest_level a string representing the integer nesting level
     /// @param nest_level a string representing the integer nesting level
     /// @param loc the location of the token
     /// @param loc the location of the token
-    /// @result the nesting level
+    /// @return the nesting level
     /// @throw calls the syntax error function if the value is not in
     /// @throw calls the syntax error function if the value is not in
     ///        the range 0..31
     ///        the range 0..31
     uint8_t convertNestLevelNumber(const std::string& nest_level,
     uint8_t convertNestLevelNumber(const std::string& nest_level,

+ 1 - 1
src/lib/eval/eval_messages.mes

@@ -156,7 +156,7 @@ client classification expressions.
 
 
 % EVAL_DEBUG_VENDOR_CLASS_DATA Data %1 (out of %2 received) in vendor class found, pushing result '%3'
 % EVAL_DEBUG_VENDOR_CLASS_DATA Data %1 (out of %2 received) in vendor class found, pushing result '%3'
 This debug message indicates that vendor class option was found and passed
 This debug message indicates that vendor class option was found and passed
-enterprise-id checks and has sufficient number of data chunks. Total numer
+enterprise-id checks and has sufficient number of data chunks. The total number
 of chunks and value pushed are reported as debugging aid.
 of chunks and value pushed are reported as debugging aid.
 
 
 % EVAL_DEBUG_VENDOR_CLASS_DATA_NOT_FOUND Requested data index %1, but option with enterprise-id %2 has only %3 data tuple(s), pushing result '%4'
 % EVAL_DEBUG_VENDOR_CLASS_DATA_NOT_FOUND Requested data index %1, but option with enterprise-id %2 has only %3 data tuple(s), pushing result '%4'

+ 3 - 3
src/lib/eval/tests/context_unittest.cc

@@ -462,8 +462,8 @@ public:
     ///
     ///
     /// This test checks if EXISTS representation is set correctly.
     /// This test checks if EXISTS representation is set correctly.
     /// It covers cases like:
     /// It covers cases like:
-    /// - vendor-class[4491].exist
-    /// - vendor-class[*].exist
+    /// - vendor-class[4491].exists
+    /// - vendor-class[*].exists
     ///
     ///
     /// @param expr expression to be parsed
     /// @param expr expression to be parsed
     /// @param u universe (V4 or V6)
     /// @param u universe (V4 or V6)
@@ -481,7 +481,7 @@ public:
 
 
     /// @brief Tests if specified token vendor class expression can be parsed
     /// @brief Tests if specified token vendor class expression can be parsed
     ///
     ///
-    /// This test assumes the first token will be token vendor. Any additional
+    /// This test assumes the first token will be token vendor-class. Any additional
     /// tokens are ignored. Tests experssions:
     /// tokens are ignored. Tests experssions:
     /// - vendor-class[4491].exists
     /// - vendor-class[4491].exists
     /// - vendor-class[*].exists
     /// - vendor-class[*].exists

+ 10 - 8
src/lib/eval/tests/token_unittest.cc

@@ -429,7 +429,7 @@ public:
         evaluate(u, expected_result);
         evaluate(u, expected_result);
     }
     }
 
 
-    /// @brief Tests if vendor class token can handle sub-options properly.
+    /// @brief Tests if vendor token can handle sub-options properly.
     ///
     ///
     /// @param u universe (V4 or V6)
     /// @param u universe (V4 or V6)
     /// @param token_vendor_id enterprise-id used in the token
     /// @param token_vendor_id enterprise-id used in the token
@@ -1917,7 +1917,7 @@ TEST_F(TokenTest, pkt6Fields) {
     EXPECT_TRUE(checkFile());
     EXPECT_TRUE(checkFile());
 }
 }
 
 
-// This test verifies if expression vendor[4491].exist works properly in DHCPv4.
+// This test verifies if expression vendor[4491].exists works properly in DHCPv4.
 TEST_F(TokenTest, vendor4SpecificVendorExists) {
 TEST_F(TokenTest, vendor4SpecificVendorExists) {
     // Case 1: no option, should evaluate to false
     // Case 1: no option, should evaluate to false
     testVendorExists(Option::V4, 4491, 0, "false");
     testVendorExists(Option::V4, 4491, 0, "false");
@@ -1925,7 +1925,7 @@ TEST_F(TokenTest, vendor4SpecificVendorExists) {
     // Case 2: option present, but uses different enterprise-id, should fail
     // Case 2: option present, but uses different enterprise-id, should fail
     testVendorExists(Option::V4, 4491, 1234, "false");
     testVendorExists(Option::V4, 4491, 1234, "false");
 
 
-    // Case 3: option present and has matchin enterprise-id, should suceed
+    // Case 3: option present and has matchin enterprise-id, should succeed
     testVendorExists(Option::V4, 4491, 4491, "true");
     testVendorExists(Option::V4, 4491, 4491, "true");
 
 
     // Check if the logged messages are correct.
     // Check if the logged messages are correct.
@@ -1938,7 +1938,7 @@ TEST_F(TokenTest, vendor4SpecificVendorExists) {
     EXPECT_TRUE(checkFile());
     EXPECT_TRUE(checkFile());
 }
 }
 
 
-// This test verifies if expression vendor[4491].exist works properly in DHCPv6.
+// This test verifies if expression vendor[4491].exists works properly in DHCPv6.
 TEST_F(TokenTest, vendor6SpecificVendorExists) {
 TEST_F(TokenTest, vendor6SpecificVendorExists) {
     // Case 1: no option, should evaluate to false
     // Case 1: no option, should evaluate to false
     testVendorExists(Option::V6, 4491, 0, "false");
     testVendorExists(Option::V6, 4491, 0, "false");
@@ -2406,7 +2406,8 @@ TEST_F(TokenTest, vendorClass4AnyVendorData) {
     testVendorClassData(Option::V4, 0, 0, 4491, 0, "");
     testVendorClassData(Option::V4, 0, 0, 4491, 0, "");
 
 
     // Case 4: Expression looks for any vendor-id (0), data[0], there is
     // Case 4: Expression looks for any vendor-id (0), data[0], there is
-    // vendor-class with vendor-id 1234 and 1 data tuple, expected result is empty string
+    // vendor-class with vendor-id 1234 and 1 data tuple, expected result is
+    // content of that data ("alpha")
     testVendorClassData(Option::V4, 0, 0, 1234, 1, "alpha");
     testVendorClassData(Option::V4, 0, 0, 1234, 1, "alpha");
 
 
     // Case 5: Expression looks for any vendor-id (0), data[0], there is
     // Case 5: Expression looks for any vendor-id (0), data[0], there is
@@ -2444,7 +2445,8 @@ TEST_F(TokenTest, vendorClass6AnyVendorData) {
     testVendorClassData(Option::V6, 0, 0, 4491, 0, "");
     testVendorClassData(Option::V6, 0, 0, 4491, 0, "");
 
 
     // Case 4: Expression looks for any vendor-id (0), data[0], there is
     // Case 4: Expression looks for any vendor-id (0), data[0], there is
-    // vendor-class with vendor-id 1234 and 1 data tuple, expected result is empty string
+    // vendor-class with vendor-id 1234 and 1 data tuple, expected result is
+    // content of that data ("alpha")
     testVendorClassData(Option::V6, 0, 0, 1234, 1, "alpha");
     testVendorClassData(Option::V6, 0, 0, 1234, 1, "alpha");
 
 
     // Case 5: Expression looks for any vendor-id (0), data[0], there is
     // Case 5: Expression looks for any vendor-id (0), data[0], there is
@@ -2484,11 +2486,11 @@ TEST_F(TokenTest, vendorClass4DataIndex) {
     testVendorClassData(Option::V4, 4491, 3, 4491, 0, "");
     testVendorClassData(Option::V4, 4491, 3, 4491, 0, "");
 
 
     // Case 4: Expression looks for vendor-id 4491, data[3], there is
     // Case 4: Expression looks for vendor-id 4491, data[3], there is
-    // vendor-class with vendor-id 1234 and 2 data tuples, expected result is empty string.
+    // vendor-class with vendor-id 1234 and 1 data tuples, expected result is empty string.
     testVendorClassData(Option::V4, 4491, 3, 1234, 1, "");
     testVendorClassData(Option::V4, 4491, 3, 1234, 1, "");
 
 
     // Case 5: Expression looks for vendor-id 4491, data[3], there is
     // Case 5: Expression looks for vendor-id 4491, data[3], there is
-    // vendor-class with vendor-id 4491, but has only 2 data tuples, expected
+    // vendor-class with vendor-id 4491, but has only 3 data tuples, expected
     // result is empty string.
     // result is empty string.
     testVendorClassData(Option::V4, 4491, 3, 4491, 3, "");
     testVendorClassData(Option::V4, 4491, 3, 4491, 3, "");
 
 

+ 1 - 1
src/lib/eval/token.cc

@@ -810,7 +810,7 @@ void TokenVendorClass::evaluate(Pkt& pkt, ValueStack& values) {
     {
     {
         size_t max = vendor->getTuplesNum();
         size_t max = vendor->getTuplesNum();
         if (index_ + 1 > max) {
         if (index_ + 1 > max) {
-            // The index specified if out of bound, e.g. there are only
+            // The index specified is out of bounds, e.g. there are only
             // 2 tuples and index specified is 5.
             // 2 tuples and index specified is 5.
             LOG_DEBUG(eval_logger, EVAL_DBG_STACK, EVAL_DEBUG_VENDOR_CLASS_DATA_NOT_FOUND)
             LOG_DEBUG(eval_logger, EVAL_DBG_STACK, EVAL_DEBUG_VENDOR_CLASS_DATA_NOT_FOUND)
                 .arg(index_)
                 .arg(index_)

+ 7 - 7
src/lib/eval/token.h

@@ -698,10 +698,10 @@ private:
 /// In particular, it allows retrieving enterprise-id.
 /// In particular, it allows retrieving enterprise-id.
 ///
 ///
 /// It can represent the following expressions:
 /// It can represent the following expressions:
-/// vendor[4491].exist - if vendor option with enterprise-id = 4491 exists
-/// vendor[*].exist - if any vendor option exists
+/// vendor[4491].exists - if vendor option with enterprise-id = 4491 exists
+/// vendor[*].exists - if any vendor option exists
 /// vendor.enterprise - returns enterprise-id from vendor option
 /// vendor.enterprise - returns enterprise-id from vendor option
-/// vendor[4491].option[1].exist - check if suboption 1 exists for vendor 4491
+/// vendor[4491].option[1].exists - check if suboption 1 exists for vendor 4491
 /// vendor[4491].option[1].hex - return content of suboption 1 for vendor 4491
 /// vendor[4491].option[1].hex - return content of suboption 1 for vendor 4491
 class TokenVendor : public TokenOption {
 class TokenVendor : public TokenOption {
 public:
 public:
@@ -793,7 +793,7 @@ protected:
 
 
     /// @brief Enterprise-id value
     /// @brief Enterprise-id value
     ///
     ///
-    /// Yeah, I know it's technically should be called enterprise-id, but that's
+    /// Yeah, I know it technically should be called enterprise-id, but that's
     /// too long and everyone calls it vendor-id.
     /// too long and everyone calls it vendor-id.
     uint32_t vendor_id_;
     uint32_t vendor_id_;
 
 
@@ -813,8 +813,8 @@ protected:
 /// enterprise handling field and field type.
 /// enterprise handling field and field type.
 ///
 ///
 /// It can represent the following expressions:
 /// It can represent the following expressions:
-/// vendor-class[4491].exist
-/// vendor-class[*].exist
+/// vendor-class[4491].exists
+/// vendor-class[*].exists
 /// vendor-class[*].enterprise
 /// vendor-class[*].enterprise
 /// vendor-class[4491].data - content of the opaque-data of the first tuple
 /// vendor-class[4491].data - content of the opaque-data of the first tuple
 /// vendor-class[4491].data[3] - content of the opaque-data of the 4th tuple
 /// vendor-class[4491].data[3] - content of the opaque-data of the 4th tuple
@@ -860,7 +860,7 @@ protected:
     ///
     ///
     /// If FieldType is DATA, get specified data chunk represented by index_.
     /// If FieldType is DATA, get specified data chunk represented by index_.
     ///
     ///
-    /// If FieldType is EXISTS, return true of vendor-id matches.
+    /// If FieldType is EXISTS, return true if vendor-id matches.
     ///
     ///
     /// @throw EvalTypeError for any other FieldType values.
     /// @throw EvalTypeError for any other FieldType values.
     ///
     ///