Skip to content

Commit e8498dc

Browse files
baentscht8m
authored andcommitted
document provider dependency handling
Reviewed-by: Paul Dale <ppzgs1@gmail.com> Reviewed-by: Tomas Mraz <tomas@openssl.org> (Merged from openssl#24884)
1 parent 2478d3b commit e8498dc

1 file changed

Lines changed: 12 additions & 0 deletions

File tree

doc/man7/provider.pod

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -227,6 +227,18 @@ MODE is only present where applicable.
227227
Other aliases may exist for example where standards bodies or common practice
228228
use alternative names or names that OpenSSL has used historically.
229229

230+
=head3 Provider dependencies
231+
232+
Providers may depend for their proper operation on the availability of
233+
(functionality implemented in) other providers. As there is no mechanism to
234+
express such dependencies towards the OpenSSL core, provider authors must
235+
take care that such dependencies are either completely avoided or made visible
236+
to users, e.g., by documentation and/or defensive programming, e.g.,
237+
outputting error messages if required external dependencies are not available,
238+
e.g., when no provider implementing the required functionality has been
239+
activated. In particular, provider initialization should not depend on other
240+
providers already having been initialized.
241+
230242
=head1 OPENSSL PROVIDERS
231243

232244
OpenSSL provides a number of its own providers. These are the default, base,

0 commit comments

Comments
 (0)