Browse Source

[3857] warn about the loose terminology (aka DSO vs shared library)

Francis Dupont 10 years ago
parent
commit
a452fe20cf
2 changed files with 10 additions and 7 deletions
  1. 4 2
      src/lib/hooks/hooks_component_developer.dox
  2. 6 5
      src/lib/hooks/hooks_user.dox

+ 4 - 2
src/lib/hooks/hooks_component_developer.dox

@@ -1,4 +1,4 @@
-// Copyright (C) 2013  Internet Systems Consortium, Inc. ("ISC")
+// Copyright (C) 2013, 2015  Internet Systems Consortium, Inc. ("ISC")
 //
 //
 // Permission to use, copy, modify, and/or distribute this software for any
 // Permission to use, copy, modify, and/or distribute this software for any
 // purpose with or without fee is hereby granted, provided that the above
 // purpose with or without fee is hereby granted, provided that the above
@@ -20,7 +20,9 @@
 The hooks framework is a Kea system that simplifies the way that
 The hooks framework is a Kea system that simplifies the way that
 users can write code to modify the behavior of Kea.  Instead of
 users can write code to modify the behavior of Kea.  Instead of
 altering the Kea source code, they write functions that are compiled
 altering the Kea source code, they write functions that are compiled
-and linked into a shared library.  The library is specified in the Kea
+and linked into a dynamic shared object called here a shared library
+(even the concepts are different they are implemented in the same
+way with a common naming).  The library is specified in the Kea
 configuration and at run time Kea dynamically loads the library
 configuration and at run time Kea dynamically loads the library
 into its address space.  At various points in the processing, the component
 into its address space.  At various points in the processing, the component
 "calls out" to functions in the library, passing to them the data is it
 "calls out" to functions in the library, passing to them the data is it

+ 6 - 5
src/lib/hooks/hooks_user.dox

@@ -1,4 +1,4 @@
-// Copyright (C) 2013-2014  Internet Systems Consortium, Inc. ("ISC")
+// Copyright (C) 2013-2015  Internet Systems Consortium, Inc. ("ISC")
 //
 //
 // Permission to use, copy, modify, and/or distribute this software for any
 // Permission to use, copy, modify, and/or distribute this software for any
 // purpose with or without fee is hereby granted, provided that the above
 // purpose with or without fee is hereby granted, provided that the above
@@ -52,10 +52,11 @@ Kea uses the modified data in the remainder of its processing.
 
 
 In order to minimize the interaction between Kea and the user
 In order to minimize the interaction between Kea and the user
 code, the latter is built independently of Kea in the form of
 code, the latter is built independently of Kea in the form of
-a shared library (or libraries).  These are made known to Kea
-through its configuration mechanism, and Kea loads the library at
-run time. Libraries can be unloaded and reloaded as needed while Kea
-is running.
+a dynamic shared object (or objects). Even they are conceptually
+different dynamic shared objects are called here shared libraries.
+These are made known to Kea through its configuration mechanism, and
+Kea loads the library at run time. Libraries can be unloaded and
+reloaded as needed while Kea is running.
 
 
 Use of a defined API and the Kea configuration mechanism means that
 Use of a defined API and the Kea configuration mechanism means that
 as new versions of Kea are released, there is no need to modify
 as new versions of Kea are released, there is no need to modify