Lines Matching refs:reference
175 reference-counted mechanism to allow them to be dynamically loaded in and
192 the underlying ENGINE object. Ie. one should obtain a new reference when
196 ENGINE objects have two levels of reference-counting to match the way in
198 inherently a B<structural> reference - a structural reference is required
199 to use the pointer value at all, as this kind of reference is a guarantee
200 that the structure can not be deallocated until the reference is released.
202 However, a structural reference provides no guarantee that the ENGINE is
207 B<functional> reference. This kind of reference can be considered a
208 specialised form of structural reference, because each functional reference
209 implicitly contains a structural reference as well - however to avoid
211 kinds of reference independently. If you have a functional reference to an
214 until after you have released your reference.
218 This basic type of reference is used for instantiating new ENGINEs,
221 reference is sufficient if you only need to query or manipulate the data of
224 The ENGINE_new() function returns a structural reference to a new (empty)
230 the last structural reference is released.
233 structural reference will internally obtain another reference - typically
237 then OpenSSL will have stored a new structural reference internally so the
238 caller is still responsible for freeing their own reference with
240 functions will automatically release the structural reference passed to it
243 ENGINE list - they will return a new structural reference to the next (or
245 list, but in either case the structural reference passed to the function is
256 reference can be obtained in one of two ways; from an existing structural
257 reference to the required ENGINE, or by asking OpenSSL for the default
260 To obtain a functional reference from an existing structural reference,
265 have allocated a new B<functional> reference to the ENGINE. All functional
267 implicit structural reference as well).
269 The second way to get a functional reference is by asking OpenSSL for a
291 functional reference to an initialised ENGINE whose implementation should be
301 operational. If it returns a functional reference to an ENGINE, it will
302 also cache another reference to speed up processing future queries (without
379 /* Release the functional reference from ENGINE_init() */
381 /* Release the structural reference from ENGINE_by_id() */
468 * ENGINE_init() returned a functional reference, so free the structural
469 * reference from ENGINE_by_id().
498 structural reference. Note that some control commands are defined by OpenSSL