Update version number is source files and .md file for release (#78)

* Update coreMQTT submodule pointer * Update core_mqtt_config.h * Update lexicon.txt * Update the version number for release
FreeRTOS · Oct 14, 2022 · 86c51db · 86c51db
1 parent 263fc55
commit 86c51db
Show file tree

Hide file tree

Showing 50 changed files with 56 additions and 50 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # Changelog for coreMQTT Agent Library
 
+## v1.2.0 (October 2022)
+
+### Changes
+ - [#77](https://github.com/FreeRTOS/coreMQTT-Agent/pull/77) Update coreMQTT-Agent to work with the coreMQTT v2.1.0. No breaking changes from the previous version.
+ - [#75](https://github.com/FreeRTOS/coreMQTT-Agent/pull/75) Update coreMQTT-Agent to work with the coreMQTT v2.0.0.
+
 ## v1.1.0 (November 2021)
 
 ### Changes

diff --git a/docs/doxygen/config.doxyfile b/docs/doxygen/config.doxyfile
@@ -38,7 +38,7 @@ PROJECT_NAME           = "coreMQTT Agent"
 # could be handy for archiving the generated documentation or if some version
 # control system is used.
 
-PROJECT_NUMBER         = v1.1.0
+PROJECT_NUMBER         = v1.2.0
 
 # Using the PROJECT_BRIEF tag one can provide an optional one line description
 # for a project that appears at the top of each page and should give viewer a

diff --git a/manifest.yml b/manifest.yml
@@ -1,10 +1,10 @@
 name : "coreMQTT Agent"
-version: "v1.1.0"
+version: "v1.2.0"
 description: |
   "Agent for thread-safe use of coreMQTT.\n"
 dependencies:
   - name : "coreMQTT"
-    version: "v1.2.0"
+    version: "v2.1.0"
     repository:
       type: "git"
       url: "https://github.com/FreeRTOS/coreMQTT/"

diff --git a/source/core_mqtt_agent.c b/source/core_mqtt_agent.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/source/core_mqtt_agent_command_functions.c b/source/core_mqtt_agent_command_functions.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/source/include/core_mqtt_agent.h b/source/include/core_mqtt_agent.h
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/source/include/core_mqtt_agent_command_functions.h b/source/include/core_mqtt_agent_command_functions.h
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/source/include/core_mqtt_agent_config_defaults.h b/source/include/core_mqtt_agent_config_defaults.h
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/source/include/core_mqtt_agent_default_logging.h b/source/include/core_mqtt_agent_default_logging.h
@@ -1,5 +1,5 @@
 /*
- * coreMQTT-Agent v1.1.0
+ * coreMQTT-Agent v1.2.0
  * Copyright (C) 2022 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/source/include/core_mqtt_agent_message_interface.h b/source/include/core_mqtt_agent_message_interface.h
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/include/agent_command_pool_stubs.h b/test/cbmc/include/agent_command_pool_stubs.h
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/include/agent_message_stubs.h b/test/cbmc/include/agent_message_stubs.h
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/include/core_mqtt_config.h b/test/cbmc/include/core_mqtt_config.h
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/include/get_time_stub.h b/test/cbmc/include/get_time_stub.h
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/include/incoming_publish_callback_stub.h b/test/cbmc/include/incoming_publish_callback_stub.h
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/include/mqtt_agent_cbmc_state.h b/test/cbmc/include/mqtt_agent_cbmc_state.h
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/include/network_interface_stubs.h b/test/cbmc/include/network_interface_stubs.h
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/proofs/MQTTAgentCommand_Connect/MQTTAgentCommand_Connect_harness.c b/test/cbmc/proofs/MQTTAgentCommand_Connect/MQTTAgentCommand_Connect_harness.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/proofs/MQTTAgentCommand_Disconnect/MQTTAgentCommand_Disconnect_harness.c b/test/cbmc/proofs/MQTTAgentCommand_Disconnect/MQTTAgentCommand_Disconnect_harness.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/proofs/MQTTAgentCommand_Ping/MQTTAgentCommand_Ping_harness.c b/test/cbmc/proofs/MQTTAgentCommand_Ping/MQTTAgentCommand_Ping_harness.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/proofs/MQTTAgentCommand_ProcessLoop/MQTTAgentCommand_ProcessLoop_harness.c b/test/cbmc/proofs/MQTTAgentCommand_ProcessLoop/MQTTAgentCommand_ProcessLoop_harness.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/proofs/MQTTAgentCommand_Publish/MQTTAgentCommand_Publish_harness.c b/test/cbmc/proofs/MQTTAgentCommand_Publish/MQTTAgentCommand_Publish_harness.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/proofs/MQTTAgentCommand_Subscribe/MQTTAgentCommand_Subscribe_harness.c b/test/cbmc/proofs/MQTTAgentCommand_Subscribe/MQTTAgentCommand_Subscribe_harness.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/proofs/MQTTAgentCommand_Terminate/MQTTAgentCommand_Terminate_harness.c b/test/cbmc/proofs/MQTTAgentCommand_Terminate/MQTTAgentCommand_Terminate_harness.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/proofs/MQTTAgentCommand_Unsubscribe/MQTTAgentCommand_Unsubscribe_harness.c b/test/cbmc/proofs/MQTTAgentCommand_Unsubscribe/MQTTAgentCommand_Unsubscribe_harness.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/proofs/MQTTAgent_CancelAll/MQTTAgent_CancelAll_harness.c b/test/cbmc/proofs/MQTTAgent_CancelAll/MQTTAgent_CancelAll_harness.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/proofs/MQTTAgent_CommandLoop/MQTTAgent_CommandLoop_harness.c b/test/cbmc/proofs/MQTTAgent_CommandLoop/MQTTAgent_CommandLoop_harness.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/proofs/MQTTAgent_Connect/MQTTAgent_Connect_harness.c b/test/cbmc/proofs/MQTTAgent_Connect/MQTTAgent_Connect_harness.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/proofs/MQTTAgent_Disconnect/MQTTAgent_Disconnect_harness.c b/test/cbmc/proofs/MQTTAgent_Disconnect/MQTTAgent_Disconnect_harness.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/proofs/MQTTAgent_Init/MQTTAgent_Init_harness.c b/test/cbmc/proofs/MQTTAgent_Init/MQTTAgent_Init_harness.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/proofs/MQTTAgent_Ping/MQTTAgent_Ping_harness.c b/test/cbmc/proofs/MQTTAgent_Ping/MQTTAgent_Ping_harness.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/proofs/MQTTAgent_ProcessLoop/MQTTAgent_ProcessLoop_harness.c b/test/cbmc/proofs/MQTTAgent_ProcessLoop/MQTTAgent_ProcessLoop_harness.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/proofs/MQTTAgent_Publish/MQTTAgent_Publish_harness.c b/test/cbmc/proofs/MQTTAgent_Publish/MQTTAgent_Publish_harness.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/proofs/MQTTAgent_ResumeSession/MQTTAgent_ResumeSession_harness.c b/test/cbmc/proofs/MQTTAgent_ResumeSession/MQTTAgent_ResumeSession_harness.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/proofs/MQTTAgent_Subscribe/MQTTAgent_Subscribe_harness.c b/test/cbmc/proofs/MQTTAgent_Subscribe/MQTTAgent_Subscribe_harness.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/proofs/MQTTAgent_Terminate/MQTTAgent_Terminate_harness.c b/test/cbmc/proofs/MQTTAgent_Terminate/MQTTAgent_Terminate_harness.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/proofs/MQTTAgent_Unsubscribe/MQTTAgent_Unsubscribe_harness.c b/test/cbmc/proofs/MQTTAgent_Unsubscribe/MQTTAgent_Unsubscribe_harness.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/sources/mqtt_agent_cbmc_state.c b/test/cbmc/sources/mqtt_agent_cbmc_state.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/stubs/agent_command_functions_stub.c b/test/cbmc/stubs/agent_command_functions_stub.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/stubs/agent_command_pool_stubs.c b/test/cbmc/stubs/agent_command_pool_stubs.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/stubs/agent_message_stubs.c b/test/cbmc/stubs/agent_message_stubs.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/stubs/core_mqtt_stubs.c b/test/cbmc/stubs/core_mqtt_stubs.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/stubs/get_time_stub.c b/test/cbmc/stubs/get_time_stub.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/stubs/incoming_publish_callback_stub.c b/test/cbmc/stubs/incoming_publish_callback_stub.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/cbmc/stubs/network_interface_stubs.c b/test/cbmc/stubs/network_interface_stubs.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/unit-test/config/core_mqtt_config.h b/test/unit-test/config/core_mqtt_config.h
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/unit-test/logging/logging_levels.h b/test/unit-test/logging/logging_levels.h
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/unit-test/logging/logging_stack.h b/test/unit-test/logging/logging_stack.h
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/unit-test/mqtt_agent_command_functions_utest.c b/test/unit-test/mqtt_agent_command_functions_utest.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of

diff --git a/test/unit-test/mqtt_agent_utest.c b/test/unit-test/mqtt_agent_utest.c
@@ -1,5 +1,5 @@
 /*
- * coreMQTT Agent v1.1.0
+ * coreMQTT Agent v1.2.0
  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy of